As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Trabalhar com o Amazon Redshift usando o kit de ferramentas para VS Code
As seções a seguir descrevem como começar a trabalhar com o Amazon Redshift usando o AWS Toolkit for Visual Studio Code.
Para obter informações detalhadas sobre o serviço Amazon Redshift, consulte os tópicos do Guia do usuário do [Amazon Redshift](https://docs.aws.amazon.com/redshift/).
## Começar
Antes de começar a trabalhar com o Amazon Redshift usando o AWS Toolkit for Visual Studio Code, os requisitos a seguir devem ser atendidos.
1. Você se conectou a uma ou mais contas da AWS pelo kit de ferramentas. Para obter mais informações sobre como conectar-se à conta da AWS pelo kit de ferramentas, consulte o tópico [Conectar-se à AWS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/connect.html) neste guia do usuário.
1. Você criou um data warehouse provisionado ou sem servidor.
Se você ainda não criou um cluster do Amazon Redshift sem servidor ou um cluster provisionado do Amazon Redshift, os procedimentos a seguir descrevem como criar um data warehouse com um conjunto de dados de amostra no Console da AWS.
**Criar um data warehouse provisionado**
Para obter mais informações sobre a criação de um data warehouse de cluster provisionado do Amazon Redshift, consulte o tópico [Criar um cluster de amostra do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/gsg/rs-gsg-sample-data-load-create-cluster.html) no *Guia de conceitos básicos do Amazon Redshift*.
1. No navegador da internet de sua preferência, faça login no Console de Gerenciamento da AWS e abra o console do Amazon Redshift em [https://console.aws.amazon.com/redshift/](https://console.aws.amazon.com/redshift/).
1. No console do Amazon Redshift, selecione **Painel de clusters provisionados**.
1. Em **Painel de clusters provisionados**, selecione o botão **Criar cluster** para abrir o painel **Criar cluster**.
1. Preencha os campos obrigatórios na seção **Configuração do cluster**.
1. Na seção **Dados de exemplo**, selecione a caixa **Carregar dados de exemplo** para carregar o conjunto de dados de amostra **Tickit** no banco de dados padrão **Dev** com o esquema **public**.
1. Na seção **Configurações do banco de dados**, insira valores nos campos **Nome de usuário administrador** e **Senha do usuário administrador**.
1. Selecione **Criar cluster** para criar o data warehouse provisionado.
**Criar um data warehouse sem servidor**
Para obter mais informações sobre a criação de um data warehouse do Amazon Redshift sem servidor, consulte a seção [Criar um data warehouse com o Amazon Redshift sem servidor](https://docs.aws.amazon.com/redshift/latest/gsg/new-user-serverless.html#serverless-console-resource-creation) em *Guia de conceitos básicos do Amazon Redshift*.
1. No navegador da internet de sua preferência, faça login no Console de Gerenciamento da AWS e abra o console do Amazon Redshift em [https://console.aws.amazon.com/redshift/](https://console.aws.amazon.com/redshift/).
1. No console do Amazon Redshift, selecione o botão **Experimente o Amazon Redshift sem servidor** para abrir o painel **Conceitos básicos do Amazon Redshift sem servidor**.
1. Na seção **Configurações**, selecione o radial **Usar configurações padrão**.
1. Na parte inferior do painel **Conceitos básicos do Amazon Redshift sem servidor**, selecione **Salvar configuração** para criar um data warehouse sem servidor com configurações padrão de grupo de trabalho, namespace, credencial e criptografia.
## Conectar-se a um data warehouse pelo kit de ferramentas
Existem três métodos para conexão com um banco de dados por meio do kit de ferramentas:
+ **Nome de usuário e senha do banco de dados**
+ **AWS Secrets Manager**
+ **Credenciais temporárias**
Para se conectar a um banco de dados localizado em um cluster provisionado existente ou data warehouse sem servidor usando o kit de ferramentas, siga as etapas abaixo.
**Importante**
Se você seguiu as etapas na seção *Pré-requisitos* deste tópico do guia do usuário e o data warehouse não estiver visível no Explorer do kit de ferramentas, verifique se você está trabalhando na região correta da AWS no Explorer.
**Conectar-se ao data warehouse com o método de **Nome de usuário e senha do banco de dados****
1. No Explorer do kit de ferramentas, expanda a Região da AWS em que o data warehouse está localizado.
1. Expanda o **Redshift** e selecione o data warehouse para abrir a caixa de diálogo **Selecionar um tipo de conexão** no VS Code.
1. Na caixa de diálogo **Selecionar um tipo de conexão**, escolha **Nome de usuário e senha do banco de dados** e forneça as informações exigidas por cada um dos prompts.
1. Os bancos de dados, tabelas e esquemas disponíveis ficam visíveis no Explorer do kit de ferramentas quando o kit de ferramentas se conecta ao data warehouse e o procedimento é concluído.
**Conectar-se ao data warehouse com o **AWS Secrets Manager****
**nota**
Este procedimento requer um segredo de banco de dados do AWS Secrets Manager para ser concluído. Para obter instruções sobre como configurar um segredo de banco de dados, consulte [Criação de um segredo de banco de dados do AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html) no *Guia do usuário do AWS Secrets Manager*.
1. No Explorer do kit de ferramentas, expanda a Região da AWS em que o data warehouse está localizado.
1. Expanda o **Redshift** e selecione o data warehouse para abrir a caixa de diálogo **Selecionar um tipo de conexão** no VS Code.
1. Na caixa de diálogo **Selecionar um tipo de conexão**, escolha **Secrets Manager** e forneça as informações exigidas por cada um dos prompts.
1. Os bancos de dados, tabelas e esquemas disponíveis ficam visíveis no Explorer do kit de ferramentas quando o kit de ferramentas se conecta ao data warehouse e o procedimento é concluído.
**Conectar-se ao data warehouse usando **credenciais temporárias****
1. No Explorer do kit de ferramentas, expanda a região da AWS em que o data warehouse está localizado.
1. Expanda o **Redshift** e selecione o data warehouse para abrir a caixa de diálogo **Selecionar um tipo de conexão** no VS Code.
1. Na caixa de diálogo **Selecionar um tipo de conexão**, selecione **Credenciais temporárias** e forneça as informações exigidas por cada um dos prompts.
1. Os bancos de dados, tabelas e esquemas disponíveis ficam visíveis no Explorer do kit de ferramentas quando o kit de ferramentas se conecta ao data warehouse e o procedimento é concluído.
**Editar a conexão usando o data warehouse**
Você pode editar a conexão usando o data warehouse para alterar com qual banco de dados estabelecer conexão.
1. No Explorer do kit de ferramentas, expanda a Região da AWS em que o data warehouse está localizado.
1. Expanda o **Redshift**, clique com o botão direito no data warehouse ao qual você estabeleceu conexão, selecione **Editar conexão** e forneça o nome do banco de dados ao qual deseja se conectar.
1. Os bancos de dados, tabelas e esquemas disponíveis ficam visíveis no Explorer do kit de ferramentas quando o kit de ferramentas se conecta ao data warehouse e o procedimento é concluído.
**Excluir a conexão usando o data warehouse**
1. No Explorer do kit de ferramentas, expanda a Região da AWS em que o data warehouse está localizado.
1. Expanda o **Redshift**, clique com o botão direito no data warehouse usando a conexão que deseja excluir e selecione **Excluir conexão**. Essa ação remove os bancos de dados, tabelas e esquemas disponíveis do Explorer do kit de ferramentas.
1. Para se reconectar ao data warehouse, selecione **Clique para se conectar** e forneça as informações exigidas por cada um dos prompts. Por padrão, a reconexão usa o método anterior de autenticação para estabelecer a conexão com o data warehouse. Para usar outro método, selecione a seta para voltar na caixa de diálogo até chegar ao prompt de autenticação.
## Executar instruções SQL
Os procedimentos a seguir descrevem como criar e executar instruções SQL no banco de dados usando o AWS Toolkit for Visual Studio Code.
**nota**
Para seguir as etapas em cada um dos procedimentos, primeiro você deve concluir a seção *Conectar-se a um data warehouse pelo kit de ferramentas*, localizada neste tópico do guia do usuário.
1. No Explorer do kit de ferramentas, expanda o **Redshift** e, em seguida, expanda o data warehouse que contém o banco de dados que você deseja consultar.
1. Selecione **Create-Notebook** para especificar um nome de arquivo e um local para armazenar o bloco de anotações localmente e, em seguida, escolha **OK** para abrir o bloco de anotações no editor do VS Code.
1. No editor do VS Code, insira as instruções SQL que deseja armazenar nesse bloco de anotações.
1. Selecione o botão **Executar tudo** para executar as instruções SQL que você inseriu.
1. A saída para as instruções SQL é exibida abaixo das instruções que você inseriu.
**Adicionar Markdown no bloco de anotações**
1. No bloco de anotações no editor do VS Code, selecione o botão **Markdown** para adicionar uma célula Markdown ao bloco de anotações.
1. Insira o Markdown na célula fornecida.
1. A célula Markdown pode ser editada usando as ferramentas do editor localizadas no canto superior direito da célula Markdown.
**Adicionar código ao bloco de anotações**
1. No bloco de anotações no editor do VS Code, selecione o botão **Código** para adicionar uma célula de código ao bloco de anotações.
1. Insira o código na célula fornecida.
1. Você pode executar o código acima ou abaixo da célula Código selecionando o botão apropriado nas ferramentas do editor de célula, localizado no canto superior direito da célula Código.