Configurar o agrupamento de conexões gerenciado

Esta página descreve como ativar, conectar e monitorar o pool de conexões gerenciadas no AlloyDB para PostgreSQL. O pooling de conexões gerenciado é um padrão de design que otimiza o gerenciamento de conexões de banco de dados mantendo 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 escalonar as cargas de trabalho do banco de dados otimizando o uso de recursos e a latência de conexão das instâncias do AlloyDB. O pooling de conexões gerenciado atribui dinamicamente conexões de servidor a solicitações recebidas quando possível usando pooling e multiplexação. Essa abordagem oferece melhorias de desempenho, especialmente para conexões escalonadas, absorvendo picos repentinos de conexão 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 gerenciadas, um aplicativo se conecta a um pooler, que oferece tempos de conexão mais curtos e escalonabilidade para suas 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 sofrer um aumento repentino de conexões.

Antes de começar

É preciso se conectar à instância usando uma conexão direta. O pooling de conexões gerenciadas não é compatível com a conexão com o proxy de autenticação ou os conectores de linguagem do AlloyDB.

Funções exigidas

Para receber a permissão necessária para ativar e usar o pool de conexões gerenciado, peça ao administrador para conceder a você o papel do IAM de Administrador do AlloyDB no Cloud (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 pooling de conexões gerenciado do AlloyDB é compatível com as seguintes opções avançadas de configuração de pooling. É possível personalizar o pool de conexões gerenciadas para atender às necessidades da sua instância usando estas opções de configuração. É possível definir essas configurações no nível da instância usando o consoleGoogle Cloud , a CLI gcloud ou a API AlloyDB.

Por padrão, o pool de conexões gerenciadas inicia conexões com o servidor do 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. Em seguida, a conexão do cliente é atribuída a uma conexão de servidor disponível. As conexões com o servidor são mantidas até serem fechadas explicitamente ou ficarem inativas por mais tempo do que o período de tempo limite de conexão inativa do servidor.

Ativar o pooling 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 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 consoleGoogle Cloud , a Google Cloud CLI ou a API AlloyDB.

Ativar para uma nova instância do pool de leitura

Para criar uma 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 consoleGoogle Cloud , a Google Cloud CLI ou a API AlloyDB.

Ativar para uma instância atual

É possível ativar o pool de conexões gerenciadas para uma instância atual usando o consoleGoogle Cloud , a Google Cloud CLI 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 pool de conexões gerenciado

A conexão com o pooling de conexões gerenciado é idêntica às conexões diretas de banco de dados, exceto em uma porta diferente. O pooling de conexões gerenciado detecta na 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 sua instância do AlloyDB ao pool de conexões gerenciadas 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 gerenciado. Por padrão, somente conexões SSL são aceitas. Para permitir conexões não criptografadas, use o seguinte comando gcloud alloydb instances update 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 pooling de conexões gerenciado para uma instância

Depois de ativar o pool de conexões gerenciadas, você pode personalizar as opções 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 pool 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çada.

É possível modificar as opções de configuração do pool de conexões gerenciadas para uma instância existente usando o console Google Cloud , a Google Cloud CLI 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 \
      | --connection-pooling-server-lifetime=SERVER_LIFETIME \
      | --connection-pooling-client-connection-idle-timeout=CLIENT_CONNECTION_IDLE_TIMEOUT \
    }

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"
    },
  }
}

Ver 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 Google Cloud , Google Cloud CLI 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 pool de conexões gerenciado para uma instância atual

É possível desativar o pool de conexões gerenciadas para uma instância atual usando o consoleGoogle Cloud , Google Cloud CLI 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 pooling de conexões gerenciado

O AlloyDB fornece as seguintes métricas para ajudar você a monitorar como o pool de conexões gerenciadas 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 seguintes limitações se aplicam durante a versão de prévia e estão sujeitas a mudanças ou remoção após a versão GA ou depois:

• O pooling de conexões gerenciado não é compatível com a conexão com o proxy de autenticação do AlloyDB ou com os conectores de linguagem do AlloyDB.
• Se você usar o pool de conexões gerenciado no modo de pool de transações, os seguintes recursos de SQL não serão compatíveis:
  • SET/RESET
  • LISTEN
  • WITH HOLD CURSOR
  • PREPARE/DEALLOCATE
  • PRESERVE/DELETE ROW tabelas temporárias
  • LOAD
  • Bloqueios consultivos no nível da sessão
  • Planos preparados no nível do protocolo
• O pooling de conexões gerenciado não é compatível com conexões de IP público.