Quero usar meu computador local para acessar um cluster do Amazon Redshift que está em uma sub-rede privada da Amazon Virtual Private Cloud (Amazon VPC).
Breve descrição
Use uma instância do Amazon Elastic Compute Cloud (Amazon EC2) e o SQL Workbench/J para criar um túnel SSH. O túnel encaminha todo o tráfego de entrada da máquina local para o cluster privado do Amazon Redshift.
Resolução
Criar o Amazon VPC, a instância EC2 e o cluster do Amazon Redshift
Para criar o Amazon VPC, a instância EC2 e o cluster Amazon Redshift, realize as etapas a seguir:
-
Crie uma VPC com sub-redes públicas e privadas.
-
Execute uma instância do EC2 de uma imagem de máquina da Amazon (AMI) do Amazon Linux 2023 na sub-rede pública da Amazon VPC. Selecione as seguintes opções:
Para Auto-assign Public IP (Atribuir IP público automaticamente), escolha Enable (Habilitar). Ou atribua um endereço IP elástico à instância. Crie um novo grupo de segurança com uma regra SSH.
Em Source (Origem), escolha Custom (Personalizado), em seguida, insira o bloco CIDR. Ou escolha My IP (Meu IP).
-
No console do Amazon Redshift, crie uma sub-rede de cluster. Insira as informações a seguir:
Para VPC ID (ID da VPC), escolha a ID da sua Amazon VPC.
Em Subnet ID (ID de sub-rede), escolha a ID da sub-rede privada.
-
Crie um grupo de segurança para a VPC.
-
Adicione uma regra ao grupo de segurança que permita o tráfego de entrada do grupo de segurança da instância. Insira as informações a seguir:
Em Type (Tipo), escolha Custom TCP (TCP personalizada).
Em Port Range (Intervalo de porta), insira a porta padrão para o Amazon Redshift, 5439.
Em Source (Origem), escolha Custom (Personalizado) e insira o nome do seu grupo de segurança.
-
Inicie um novo cluster do Amazon Redshift ou restaure um cluster a partir de um snapshot. Na página Configuração adicional, escolha as opções a seguir:
Em Choose a VPC (Escolha uma VPC), escolha sua Amazon VPC.
Em subnet group (grupo de sub-redes) do cluster, escolha seu grupo de sub-redes.
Para Publicly accessible (Publicamente acessível), escolha No (Não).
Para VPC security groups (grupos de segurança da VPC), escolha seu grupo de segurança. Espere até que o cluster esteja no estado disponível.
-
Para se conectar à instância do EC2 a partir de sua máquina local, execute o seguinte comando:
ssh -i "your_key.pem" ec2-user@your_EC2_endpoint
Observação: substitua your_key.pem pelo seu arquivo .pem e seu your_EC2_endpoint pelo endpoint EC2. Para mais informações, consulte Conectar-se à sua instância do Linux a partir do Linux ou macOS usando SSH.
-
Para instalar o telnet, execute o seguinte comando:
sudo yum install telnet
-
Para usar o telnet para testar a conexão com seu cluster do Amazon Redshift, execute o comando a seguir:
telnet cluster-endpoint cluster-port
Observação: Substitua o cluster-endpoint pelo endpoint do cluster e cluster-port pela porta do cluster.
Ou execute o comando a seguir para usar dig para confirmar que sua máquina local pode acessar o endereço IP privado do cluster do Amazon Redshift:
dig cluster-endpoint
Observação: substitua cluster-endpoint pelo endpoint do cluster.
Criar o túnel
Para criar um túnel, conclua as etapas a seguir:
- Instale o SQL Workbench/J em sua máquina local.
- Baixe o mais recente driver JDBC Amazon Redshift.
- No SQL Workbench/J, use o driver JDBC para criar um perfil de conexão.
- Para configurar a conexão SSH no SQL Workbench/J, escolha SSH e insira as seguintes informações:
Em SSH hostname (Nome do host SSH), insira o endereço IP público ou o DNS da instância EC2.
Para SSH port (Porta SSH), digite 22. Para Username (Nome de usuário), digite ec2-user.
Em Private key file (Arquivo de chave privada), insira o arquivo .pem que você baixou ao criar a instância EC2.
Em Password (Senha), mantenha o campo em branco.
Em Local port (Porta local), insira qualquer porta local livre. Seu cluster do Amazon Redshift usa a porta 5439 por padrão.
Em DB hostname (Nome do host do DB), insira o endpoint do cluster. O endpoint não pode incluir o número da porta ou o nome do banco de dados.
Para a DB port (Porta do DB), digite 5439.
Selecione a opção Reescrever URL do JDBC.
- Escolha OK.
- Certifique-se de inserir corretamente o URL do JDBC, o nome do superusuário e a senha.
- Para confirmar se a conexão funciona, escolha Test (Testar). Para obter mais informações, consulte Connecting through an SSH tunnel (Conectando-se por meio de um túnel SSH) no site do SQL Workbench/J.
(Opcional) Modificar a conexão de um usuário do AWS Identity and Access Management (AWS IAM)
Para modificar o perfil de conexão do cluster do Amazon Redshift como um usuário do IAM, conclua as seguintes etapas:
- Consulte a política de usuário do IAM. A política de usuário do IAM deve permitir as ações GetClusterCredentials, JoinGroup e CreateClusterUser do Amazon Redshift para os recursos dbgroup, dbuser e dbname.
Exemplo de política de usuário do IAM:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"redshift:GetClusterCredentials",
"redshift:CreateClusterUser",
"redshift:JoinGroup"
],
"Resource": [
"arn:aws:redshift:eu-west-2:012345678912:dbgroup:clustername/group_name",
"arn:aws:redshift:eu-west-2:012345678912:dbuser:clustername/user_name or * ",
"arn:aws:redshift:eu-west-2:012345678912:dbname:clustername/database_name"
]
}
]
}
Observação: substitua us-west-2 pela região da AWS em que seu cluster está, 012345678912 pelo ID da sua conta da AWS e user_name pelo nome do usuário do Amazon Redshift. Ou é possível usar "*" em vez de um nome de usuário específico.
- No SQL Workbench/J, altere a primeira parte da URL JDBC do perfil de conexão para jdbc:redshift:iam. Por exemplo, altere a URL do JDBC para jdbc:redshift:iam://127.0.0.1:5439/example.
- Escolha Extended Properties (Propriedades estendidas) e, em seguida, insira as seguintes informações:
Em AccessKeyID, insira o access key ID (ID da chave de acesso) do usuário do IAM.
Em SecretAccessKey, insira a chave de acesso secreta do usuário do IAM.
(Opcional) Em DbGroups, escolha essa opção para forçar o usuário do IAM a ingressar em um grupo existente.
Para DbUser, insira o nome do usuário do IAM. Para AutoCreate, defina a opção como true.
Em ClusterID, insira o nome do cluster do Amazon Redshift.
Em Region (Region), insira a região em que o cluster está, como, por exemplo, us-east-1.
- Na página de perfil de conexão do cluster, selecione Test (Testar).
Informações relacionadas
Why can't I connect to my Amazon Redshift cluster? (Por que não consigo me conectar ao meu cluster do Amazon Redshift?)