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

stringsde conexão

info

Lakebase autoscale é a versão mais recente do Lakebase, com recursos como autoscale compute, escala-to-zero, branching e instant restore. Para regiões compatíveis, consulte Disponibilidade por região. Se você é usuário de provisionamento Lakebase , consulte ProvisionamentoLakebase.

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 UID do compute, um identificador gerado pelo sistema com um prefixo ep- (por exemplo, ep-abc-123). Isso é diferente do nome compute que você fornece ao criar o compute. Consulte os identificadores de cálculo.

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 dimensionamento automático do Lakebase oferece suporte à conectividade por meio Databricks Configure o link privado de entrada para serviços que exigem alto desempenho.

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 IP e domínios para Databricks serviço e ativo.

Próximos passos​