Visão geral dos conectores do Cloud SQL

Esta página resume os conectores de idioma do Cloud SQL e como usá-los com suas instâncias.

Os conectores do Cloud SQL são bibliotecas que fornecem criptografia e autorização do IAM ao se conectar a uma instância do Cloud SQL. Os conectores do Cloud SQL criam conexões autorizadas com o servidor do lado do proxy em nome do aplicativo de um usuário e transmitem essa conexão ao driver de banco de dados do aplicativo. Não é possível fornecer um caminho de rede para uma instância do Cloud SQL caso ainda não exista uma.

Os conectores do Cloud SQL usam um componente do lado do cliente para se conectar a um servidor proxy na instância do Cloud SQL. O conector cria um certificado temporário que autoriza o detentor a se conectar ao proxy do lado do servidor. O proxy do lado do servidor limita o acesso ao banco de dados do Cloud SQL exigindo um certificado TLS válido para se conectar.

O Cloud SQL é compatível com os seguintes conectores de linguagem do Cloud SQL:

O Cloud SQL recomenda o uso de conectores do Cloud SQL para se conectar à instância do Cloud SQL. Também é possível se conectar a uma instância do Cloud SQL usando um cliente de banco de dados ou o proxy do Cloud SQL Auth. Para mais informações sobre a conexão com uma instância do Cloud SQL, consulte Opções de conexão.

Requisitos

Se a instância do Cloud SQL usar autoridade certificadora (AC) compartilhada como serverCaMode, no lado do cliente, verifique se os conectores de linguagem do Cloud SQL que você está usando atendem aos seguintes requisitos de versão:

Se a instância do Cloud SQL usar AC gerenciada pelo cliente como serverCaMode, no lado do cliente, verifique se os conectores de linguagem do Cloud SQL que você está usando atendem aos seguintes requisitos de versão:

Quando uma instância usa a AC gerenciada pelo cliente como modo de AC do servidor, é possível configurar a instância com um nome DNS personalizado. Forneça o nome DNS personalizado no campo de nome alternativo do assunto (SAN) personalizado do certificado do servidor.

Depois de configurar um nome DNS personalizado para a instância, é possível se conectar a ela nos conectores de linguagem do Cloud SQL usando o nome DNS.

Benefícios dos conectores de linguagem do Cloud SQL

Os conectores do Cloud SQL oferecem os seguintes benefícios na conexão com uma instância do Cloud SQL:

  • Autorização do IAM: usa permissões de gerenciamento de identidade e acesso (IAM) para controlar quem ou o que pode se conectar às instâncias do Cloud SQL.
  • Conveniência: remove o requisito para gerenciar certificados SSL, configurar regras de firewall ou ativar redes autorizadas.

Limitações

Não é possível usar os conectores de linguagem do Cloud SQL se você estiver usando o acesso contextual e a autenticação de banco de dados do IAM. Quando você tenta fazer login na instância, a autenticação do IAM falha.

Aplicar o uso de conectores de linguagem do Cloud SQL

Ao usar a aplicação do conector, é possível aplicar o uso apenas do proxy do Cloud SQL Auth ou dos conectores de linguagem do Cloud SQL para se conectar a instâncias do Cloud SQL. Com a aplicação do conector, o Cloud SQL rejeita conexões diretas com o banco de dados.

Se você estiver usando uma instância ativada pelo Private Service Connect, haverá uma limitação. Se a instância tiver a aplicação do conector ativada, não será possível criar réplicas de leitura para ela. Da mesma forma, se a instância tiver réplicas de leitura, não será possível ativar a aplicação do conector para ela.

Para mais informações sobre como aplicar o uso apenas do proxy do Cloud SQL Auth ou dos conectores de linguagem do Cloud SQL para se conectar a uma instância, consulte Conectar usando os conectores de linguagem do Cloud SQL.

A seguir