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.

Novas instâncias Lakebase serão criadas como projetos de escalonamento automático. O lançamento começará em 12 de março de 2026. Para mais detalhes, consulte dimensionamento automático por default.

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.