Início rápido

Conecte-se ao seu banco de dados usando tokens OAuth ou senhas do Postgres. Para gerenciar a infraestrutura do Lakebase (criar projetos, branches, computação), consulte Permissões do projeto.

Escolha seu método de autenticação

Antes de se conectar, decida qual método de autenticação funciona melhor para o seu caso de uso:

• FunçãoOAuth : Autentique-se usando sua identidade Databricks com um token OAuth . O responsável pelo projeto pode entrar em contato imediatamente. Para permitir que outras identidades do Databricks usem a autenticação OAuth, crie suas funções do Postgres usando a interface do usuário do Lakebase, SQL ou API REST. Consulte Criar uma função OAuth.
• Autenticação nativa de senha do Postgres: Autentique-se usando uma função do Postgres com uma senha de banco de dados tradicional. Consulte Criar uma função de senha nativa do Postgres.

OAuth oferece expiração automática de credenciais e integração de identidade workspace , mas requer rotação de tokens para aplicativos de longa duração. As senhas do Postgres não expiram nem precisam ser rotacionadas, mas não possuem a expiração automática e o gerenciamento de segurança centralizado do OAuth.

Conecte-se ao seu banco de dados

Ao se conectar pela internet pública, se você usar um firewall no lado do cliente, adicione os endereços IP usados pelo Lakebase à sua lista de permissões. Consulte Endereços IP e domínios para serviços do Databricks.

Os exemplos abaixo usam psql, um cliente Postgres padrão. Para obter mais informações sobre como usar o psql para se conectar, consulte Conectar com psql. Você também pode acessar seu banco de dados através do Databricks Notebook, do Editor SQL do Lakebase, do Editor de Tabelas ou de ferramentas de terceiros como o pgAdmin e outros clientes compatíveis com o Postgres. Consulte a seção "Consulte seus dados" para obter mais opções.

Cada projeto contém um banco de dados default chamado databricks_postgres ao qual você pode se conectar. Este banco de dados pertence à função Postgres da sua identidade Databricks (por exemplo, user@databricks.com), que é criada automaticamente quando você cria um projeto. Para criar funções adicionais do Postgres, consulte Gerenciar funções do Postgres.

nota

Todas as conexões com o banco de dados estão sujeitas a um tempo limite de 24 horas do Parado e a um tempo máximo de conexão de 3 dias. Consulte Tempo limite de conexão.

Conecte-se com uma função OAuth

As funções OAuth permitem que você se conecte usando sua identidade Databricks com autenticação baseada em tokens. A função OAuth do proprietário do projeto é criada automaticamente. Para permitir que outras identidades do Databricks usem a autenticação OAuth, crie suas funções do Postgres usando a interface do usuário do Lakebase, SQL ou API REST. Consulte Criar uma função OAuth.

Para gerar tokens OAuth programaticamente ou para fluxo de trabalho automatizado, consulte Obter tokens OAuth em um fluxo de usuário para máquina para sessões interativas ou Obter tokens OAuth em um fluxo de máquina para máquina para entidade de serviço.

importante

Os tokens OAuth expiram após uma hora.

Para aplicações que mantêm conexões de longa duração com o banco de dados, é necessário implementar a rotação de tokens para refresh automaticamente as credenciais antes que elas expirem. Sem a rotação de tokens, seu aplicativo perderá a conectividade com o banco de dados após uma hora.

Consulte os exemplos de rotação de tokens para ver exemplos de código.

Para conectar-se a uma função OAuth:

1. No aplicativo Lakebase, selecione seu projeto e clique em Conectar .

2. Selecione a filial, compute e o banco de dados aos quais deseja se conectar e, em seguida, selecione sua identidade Databricks na seção FunçõesOAuth do menu suspenso Função .

3. Clique em Copiar token OAuth e, em seguida, exporte o token para a variável de ambiente PGPASSWORD em seu terminal:

   Bash

   export PGPASSWORD='<oauth-token>'

4. Selecione psql no menu suspenso acima do snippet e, em seguida, copie o snippet para o seu terminal e faça a execução. psql lê os tokens de PGPASSWORD, então você não será solicitado a fornecer uma senha. Se você ainda assim for solicitado, consulte Solucionar problemas de conexões OAuth.

Os tokens OAuth expiram uma hora depois de serem gerados. Para se reconectar após o token expirar, copie um novo token e exporte-o para PGPASSWORD novamente.

nota

Copiar token OAuth gera tokens apenas para sua identidade de login atual, não para Service Principal ou outros usuários. Para gerar tokens para outras identidades, use a CLI ou SDK.

Solucionar problemas de conexões OAuth

• psql para de responder quando você cola o token no prompt de senha. Os tokens OAuth são longos e, em alguns terminais, colar um no prompt interativo faz com que psql pare de responder. Exporte o token para PGPASSWORD antes da execução psql, conforme descrito nos passos anteriores.

• psql solicita uma senha, embora PGPASSWORD esteja definido. Outras configurações do Postgres em seu ambiente podem ter precedência sobre PGPASSWORD, como um arquivo de serviço de conexão definido por seu perfil de shell. Para conectar independentemente dessas configurações, adicione o tokens à string de conexão. Use aspas duplas para que seu shell expanda a variável:

  Bash

  psql "postgresql://your-email%40databricks.com:${PGPASSWORD}@ep-abc-123.databricks.com/databricks_postgres?sslmode=require"

  Para corrigir a causa subjacente, execução env | grep '^PG' para verificar variáveis PGSERVICE ou PGSERVICEFILE. Se qualquer um estiver definido, desdefina-os para sua sessão atual:

  Bash

  unset PGSERVICE PGSERVICEFILE

  Para evitar que as variáveis retornem em novas sessões, remova as linhas export que as definem no perfil do seu shell, como ~/.bashrc ou ~/.zshrc.

Conecte-se com a senha nativa do Postgres

A autenticação nativa por senha do Postgres permite que você se conecte usando uma função do Postgres com uma senha de banco de dados tradicional.

Para conectar-se com a autenticação de senha nativa do Postgres:

1. No aplicativo Lakebase, selecione seu projeto e clique em Conectar .
2. Selecione a ramificação, compute e o banco de dados aos quais deseja se conectar e, em seguida, selecione uma função do Postgres na seção Funções do Postgres do menu suspenso Função .
3. Selecione psql no menu suspenso acima do snippet, depois copie o snippet para o terminal e execução para conectar.

nota

Lakebase inclui um gerenciador de conexões integrado para funções de senha nativas do Postgres. Para reduzir a sobrecarga de conexão para aplicativos de alta taxa de transferência, consulte Usar agrupamento de conexões.

Recursos adicionais

• Consulte seus dados
• Gerenciar funções do Postgres
• Gerenciar permissões
• Saiba mais sobre autenticação
• Referência strings de conexão
• Agrupamento de conexões
• Exemplos de estrutura