Pular para o conteúdo principal
Última atualização em

stringsde conexão

info

O dimensionamento automático do Lakebase está disponível nas seguintes regiões: us-east-1, us-east-2, eu-central-1, eu-west-1, eu-west-2, ap-south-1, ap-southeast-1, ap-southeast-2.

O Lakebase autoscale é a versão mais recente do Lakebase com recursos como autoscale compute, escala-to-zero, branching e instant restore. Para comparação de recursos com o provisionamento do Lakebase, veja escolhendo entre versões.

Uma string de conexão do Lakebase inclui a função, hostname e o nome do banco de dados. Para autenticação nativa por senha no Postgres, as strings de conexão também incluem a senha. Para autenticação OAuth , você fornece um token OAuth em vez de uma senha. Consulte Obter tokens OAuth.

Formato das cadeias de conexão​

Autenticação OAuth:

postgresql://your-email@example.com@ep-abc-123.databricks.com/databricks_postgres?sslmode=require
             ^                      ^                         ^
       role -|                      |- hostname               |- database

Autenticação nativa de senha do Postgres:

postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require
             ^         ^        ^                         ^
       role -|         |        |- hostname               |- database
                       |
                       |- password
nota

O hostname inclui o ID do endpoint compute , que tem um prefixo ep- (por exemplo, ep-abc-123). Isso identifica o compute específico que atende ao seu banco de dados.

Componentes de cadeias de conexão​

Você pode configurar o Postgres com variáveis de ambiente separadas ou com um único DATABASE_URL, dependendo do que sua aplicação ou framework espera.

Para usar componentes individuais:

Bash
PGHOST=ep-abc-123.databricks.com
PGDATABASE=databricks_postgres
PGUSER=role_name
PGPASSWORD=your-password or token
PGPORT=5432

Para usar uma única variável de ambiente:

Bash
DATABASE_URL="postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require"

Segurança da conexão​

  • CriptografiaSSL/TLS : O recurso de escalonamento automático do Lakebase exige que todas as conexões utilizem criptografia SSL/TLS. O parâmetro sslmode=require impõe esse requisito. Todas strings de conexão fornecidas no aplicativo Lakebase incluem esse parâmetro por default.
  • Conectividade privada : o recurso de escalonamento automático do Lakebase oferece suporte à conectividade por meio do PrivateLink Databricks Front-end.

Porta​

O Lakebase usa a porta default do Postgres, 5432 .

Configuração de rede​

Ao conectar-se ao seu banco de dados Lakebase, considere os seguintes requisitos de rede:

  • Conexões compute clássica: Para conectar compute clássica ao PostgreSQL, abra a porta TCP 5432 no seu grupo de segurança de rede para o endereço IP ou intervalo de IP da sua ACL workspace .

  • Firewalls do lado do cliente: Se você tiver um firewall do lado do cliente, adicione o endereço IP usado pelo dimensionamento automático do Lakebase à sua lista de permissões. Para view endereços IP por região, consulte Endereços do plano de controleDatabricks.

Próximos passos​