Conecte-se e consulte uma instância de banco de dados.

info

O provisionamento Lakebase é a oferta original Lakebase que usa compute de provisionamento que você escala manualmente. Para regiões compatíveis, consulte Disponibilidade por região. Para obter a versão mais recente do Lakebase, com compute, redução de recursos a zero, ramificação e restauração instantânea, consulte a documentação sobre escalonamento automáticoLakebase.

Desde 12 de março de 2026, novas instâncias Lakebase são criadas como projetos de escalonamento automático. As instâncias de provisionamento existentes serão atualizadas automaticamente para escalonamento automático a partir de junho de 2026. Para obter detalhes, consulte Atualização para dimensionamento automático Lakebase.

Esta página descreve como conectar-se a uma instância de banco de dados de provisionamento Lakebase a partir do editor SQL e de clientes SQL externos.

Antes de começar

• Você possui uma função correspondente no Postgres para sua identidade no Databricks. Consulte Funções do Postgres.
• Sua função no Postgres recebeu as permissões necessárias para acessar o banco de dados, o esquema ou a tabela.
• Você pode se autenticar na instância do banco de dados. Consulte Autenticar em uma instância de banco de dados.

Conecte-se a partir do editor SQL.

Crie uma nova consulta SQL no editor SQL.

1. Clique Acesse os aplicativos no canto superior direito e selecione Lakebase Postgres .

2. Clique em provisionamento para abrir a página de instâncias de provisionamento .

3. Selecione a instância de banco de dados na qual deseja executar consultas PostgreSQL .

4. Clique em Nova Consulta no canto superior direito.

5. Para executar uma consulta somente leitura em instâncias secundárias legíveis:

   1. Clique no menu suspenso de recursos compute e selecione o compute que possui o rótulo "(Somente leitura)" .
   2. Clique em Alternar .

6. Selecione o banco de dados e o esquema desejados no seletor dropdown ao lado de execução all .

7. Escreva uma consulta PostgreSQL e clique em executar tudo .

Limitações

• Aplica-se o modelo de permissões da lista de controle de acesso (ACL) da consulta . A execução ocorre com a identidade Databricks do usuário que clica em Executar . Qualquer pessoa com pelo menos permissão de visualização (CAN VIEW) na consulta pode ver os resultados tal como aparecem no Editor SQL.
• Objetos com escopo de conexão, como tabelas temporárias e transações, funcionam apenas em uma única célula. Elas não funcionam em diferentes cliques de execução , pois cada uma é uma sessão separada.
• Se os blocos $$ contiverem instruções com ponto e vírgula, apenas os resultados da última instrução serão exibidos.

Conectar a partir de clientes SQL

Você pode acessar uma instância de banco de dados a partir de ferramentas externas como psql, DBeaver e pgAdmin4.

• psql É necessária a versão 14 ou superior. Instale-o a partir da página de download do PostgreSQL. Você também deve instalar a biblioteca libpq .
• Para DBeaver e pgAdmin, consulte a documentação do DBeaver e a documentação do pgAdmin.

Conecte-se com psql

1. Clique Acesse os aplicativos no canto superior direito e selecione Lakebase Postgres .
2. Clique em provisionamento para abrir a página de instâncias de provisionamento .
3. Selecione a instância do banco de dados que você deseja acessar.
4. Clique em Detalhes da conexão .
5. Copie as strings de conexão com o PSQL .
6. Cole o comando em seu terminal e execute-o.