Configurar o agrupamento de conexões gerenciado

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esta página descreve como ativar, se conectar e monitorar o agrupamento de conexões gerenciadas no AlloyDB para PostgreSQL. O pool de conexões gerenciado é um padrão de design que otimiza o gerenciamento de conexões de banco de dados ao manter um pool de conexões pré-estabelecidas. Esse pool de conexões é reutilizado pelo aplicativo em vez de abrir e fechar conexões para cada operação de banco de dados, o que melhora o desempenho e a utilização de recursos.

Com o pool de conexões gerenciado, é possível dimensionar as cargas de trabalho do banco de dados otimizando o uso de recursos e a latência de conexão para as instâncias do AlloyDB. O agrupamento de conexões gerenciado atribui dinamicamente conexões do servidor a solicitações recebidas sempre que possível usando agrupamento e multiplexação. Essa abordagem oferece melhorias de desempenho, especialmente para conexões escalonadas, absorvendo picos de conexão repentinos e reutilizando conexões de banco de dados existentes. Em vez de se conectar a um banco de dados específico, ao usar o pooling de conexões gerenciado, um aplicativo se conecta a um pooler, que oferece tempos de conexão mais curtos e escalonabilidade para as cargas de trabalho de leitura.

Embora seja possível usar o pooling de conexões gerenciado para qualquer carga de trabalho transacional, ele é mais adequado para aplicativos que contêm mais conexões de curta duração ou que podem ter um aumento de conexões.

Antes de começar

É necessário se conectar à instância usando uma conexão direta. O pooling de conexões gerenciado não oferece suporte à conexão com o proxy de autenticação do AlloyDB ou aos conectores de linguagem do AlloyDB.

Funções exigidas

Para receber a permissão necessária para ativar e usar o pool de conexões gerenciadas, peça ao administrador para conceder a você o papel do IAM de Administrador do Cloud AlloyDB (roles/alloydb.admin) na instância do AlloyDB. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão alloydb.instances.update, necessária para ativar e usar o pool de conexões gerenciadas.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Opções de configuração avançada

O pool de conexões gerenciado do AlloyDB é compatível com as seguintes opções de configuração avançadas de pool. É possível personalizar o pool de conexões gerenciadas para atender às necessidades da sua instância usando essas opções de configuração. É possível definir essas configurações no nível da instância usando o console do Google Cloud, a CLI do gcloud ou a API AlloyDB.

Por padrão, o pool de conexões gerenciadas inicia conexões com o servidor AlloyDB. Quando uma conexão de cliente é estabelecida e autenticada, o pool de conexões gerenciado pode criar uma ou mais conexões de servidor para que o tamanho do pool corresponda à configuração escolhida. A conexão do cliente é então atribuída a uma conexão de servidor disponível. As conexões do servidor são mantidas até serem explicitamente fechadas ou permanecerem inativas por mais tempo do que o tempo limite de conexão inativa do servidor.

Ativar o agrupamento de conexões gerenciado

É possível ativar o pool de conexões gerenciado para qualquer instância nova ou atual.

Ativar para uma nova instância principal

Para criar uma nova instância principal com o pool de conexões gerenciado ativado, consulte Criar uma instância principal. É possível ativar o pool de conexões gerenciadas para uma instância usando o console do Google Cloud, a CLI do Google Cloud ou a API AlloyDB.

Ativar para uma nova instância do pool de leitura

Para criar uma nova instância do pool de leitura com o pool de conexões gerenciado ativado, consulte Criar uma instância do pool de leitura. É possível ativar o pool de conexões gerenciadas para uma instância usando o console do Google Cloud, a CLI do Google Cloud ou a API AlloyDB.

Ativar para uma instância

É possível ativar o pool de conexões gerenciadas para uma instância usando o console do Google Cloud, a CLI do Google Cloud ou a API AlloyDB.

gcloud alpha alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --enable-connection-pooling

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

{
  "connectionPoolConfig": {
    "enabled": true
  }
}

Conectar-se ao agrupamento de conexões gerenciado

A conexão com o pool de conexões gerenciado é idêntica às conexões diretas do banco de dados, exceto em uma porta diferente. O agrupamento de conexões gerenciado detecta a porta 6432. Qualquer usuário adicionado à instância do AlloyDB pode se conectar usando o pool de conexões gerenciadas.

Conectar usando a autenticação integrada

O exemplo de comando conecta a instância do AlloyDB ao pool de conexões gerenciado usando a autenticação integrada.

psql postgresql://USERNAME:PASSWORD@IP_ADDRESS:6432/postgres

Conectar usando conexões SSL

O modo SSL da instância também se aplica a todas as conexões com o pool de conexões gerenciadas. Por padrão, somente conexões SSL são aceitas. Para permitir conexões não criptografadas, use o comando gcloud alloydb instances update abaixo para definir o modo SSL da instância como ALLOW_UNENCRYPTED_AND_ENCRYPTED.

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED

Modificar o agrupamento de conexões gerenciado de uma instância

Depois de ativar o agrupamento de conexões gerenciado, você pode personalizar as opções de agrupamento de conexões gerenciado para atender às necessidades da sua instância usando as opções de configuração avançada. Essas opções de configuração são chamadas de flags de agrupamento de conexões gerenciadas. Para mais informações sobre as opções de configuração, os valores padrão e os intervalos, consulte opções de configuração avançadas.

É possível modificar as opções de configuração do pool de conexões gerenciadas de uma instância existente usando o console do Google Cloud, a CLI do Google Cloud ou a API AlloyDB.

  gcloud alpha alloydb instances update INSTANCE_ID \
    --project=PROJECT_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    { \
      --connection-pooling-pool-mode=CONNECTION_MODE \
      | --connection-pooling-max-pool-size=MAX_POOL_SIZE \
      | --connection-pooling-min-pool-size=MIN_POOL_SIZE \
      | --connection-pooling-max-client-connections=MAX_CLIENT_CONNECTION \
      | --connection-pooling-server-idle-timeout=SERVER_IDLE_TIMEOUT_PERIOD \
      | --connection-pooling-query-wait-timeout=QUERY_WAIT_TIMEOUT_PERIOD \
      | --connection-pooling-ignore-startup-parameters=IGNORE_STARTUP_PARAMETERS \
    }

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connection": "MAX_CLIENT_CONNECTION",
      "server_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS"
    },
  }
}

Conferir o status do pool de conexões gerenciado de uma instância

É possível conferir o status do pool de conexões gerenciadas de uma instância usando o console do Google Cloud, a CLI do Google Cloud ou a API AlloyDB.

gcloud alpha alloydb instances describe INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --format="value(connectionPoolConfig.enabled)"

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Desativar o agrupamento de conexões gerenciado para uma instância

É possível desativar o pool de conexões gerenciadas para uma instância atual usando o console do Google Cloud, a CLI do Google Cloud ou a API AlloyDB.

gcloud alpha alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --no-enable-connection-pooling

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

{
  "connectionPoolConfig": {
    "enabled": false
  }
}

Monitorar o agrupamento de conexões gerenciado

O AlloyDB fornece as métricas a seguir para ajudar a monitorar como o pool de conexão gerenciado está sendo executado na sua instância. É possível conferir essas métricas usando o Metrics Explorer.

Para mais informações, consulte Métricas do AlloyDB.

Limitações

As limitações a seguir se aplicam à versão de pré-lançamento e estão sujeitas a alterações ou remoção após a versão de GA ou depois:

• O pooling de conexões gerenciado não oferece suporte à conexão com o proxy de autenticação do AlloyDB ou aos conectores de linguagem do AlloyDB.
• Se você usar o agrupamento de conexões gerenciado no modo de agrupamento de transações, os seguintes recursos do SQL não terão suporte:
  • SET/RESET
  • LISTEN
  • WITH HOLD CURSOR
  • PREPARE/DEALLOCATE
  • PRESERVE/DELETE ROW tabelas temporárias
  • LOAD
  • Bloqueios de aviso no nível da sessão
  • Planos preparados no nível do protocolo