Conectar usando a CLI gcloud

O comando gcloud beta alloydb connect permite estabelecer uma conexão autorizada e criptografada com uma instância do AlloyDB para PostgreSQL. Ele automatiza a inicialização do proxy de autenticação do AlloyDB e a execução da ferramenta de cliente psql.

Use esse comando para administração e desenvolvimento manuais de bancos de dados em ambientes como sua máquina local ou o Cloud Shell.

Para saber mais, consulte Visão geral da conexão.

Antes de começar

  1. Instale a CLI do Google Cloud.
  2. Instale a ferramenta de cliente psql.
  3. Verifique se o principal do Identity and Access Management (IAM) tem o papel de cliente do AlloyDB (roles/alloydb.client). Para mais informações, consulte Gerenciar a autenticação do IAM.

Conectar-se a uma instância

Para se conectar a uma instância usando o usuário e o banco de dados postgres padrão por IP particular, execute:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID

Conectar por IP público

Se a instância tiver um endereço IP público ativado, será possível se conectar a ela adicionando a flag --public-ip:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --public-ip

Autenticar usando o IAM

O comando gcloud beta alloydb connect é compatível com a autenticação automática do IAM. Use a flag --auto-iam-authn para se autenticar como o usuário conectado da CLI gcloud ou uma conta de serviço.

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --auto-iam-authn

Para mais informações sobre a autenticação do IAM, consulte Autenticação de banco de dados do IAM.

Conectar pelo Private Service Connect

Se você estiver usando o Private Service Connect, adicione a flag --psc:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --psc

Conectar-se a um usuário e banco de dados específicos

Para se conectar como um usuário específico a um banco de dados específico, use as flags --user e --database:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --user=USER_NAME \
    --database=DATABASE_NAME

Identidade temporária de conta de serviço

É possível usar uma conta de serviço representada para autorizar a conexão. Quando você usa a representação, o proxy de autenticação usa as credenciais da conta de serviço especificada para recuperar as informações de conexão.

Para se conectar usando uma conta de serviço representada, adicione a flag --impersonate-service-account:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --impersonate-service-account=SERVICE_ACCOUNT_EMAIL

O proxy de autenticação usa a conta de serviço representada para recuperar informações de conexão. No entanto, ele não se autentica automaticamente no banco de dados. Para também autenticar no banco de dados como a conta de serviço representada, adicione a flag --auto-iam-authn. A conta de serviço representada precisa ser um usuário no banco de dados.

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
    --auto-iam-authn

A seguir