Conectar e consultar uma instância de banco de dados

Importante

Lakebase Provisioned é a oferta original do Lakebase que usa a computação provisionada que você dimensiona manualmente. Para regiões com suporte, consulte a disponibilidade da região. Para obter a versão mais recente do Lakebase, com computação de dimensionamento automático, escala para zero, ramificação e restauração instantânea, consulte Lakebase Autoscaling.

Desde 12 de março de 2026, novas instâncias do Lakebase são criadas como projetos de dimensionamento automático. As instâncias provisionadas existentes estão sendo atualizadas automaticamente para o Dimensionamento Automático, a partir de junho de 2026. Para mais detalhes, consulte Fazer upgrade para o escalonamento automático do Lakebase.

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

Antes de começar

  • Você tem um perfil do Postgres correspondente à sua identidade no Azure Databricks. Consulte as funções do Postgres.
  • Sua função Postgres recebe as permissões necessárias para acessar o banco de dados, o esquema ou a tabela.
  • Você pode autenticar-se à instância do banco de dados. Consulte Autenticar em uma instância de banco de dados.

Conectar-se a partir do editor do SQL

Crie uma nova consulta SQL no editor do SQL.

  1. Clique no ícone aplicativo.Aplicativos no canto superior direito e selecione Lakebase Postgres.
  2. Clique em Provisionado para abrir a página Instâncias Provisionadas.
  3. Selecione a instância de banco de dados na qual você deseja executar consultas PostgreSQL.
  4. Clique em Nova Consulta no canto superior direito.
  5. Para executar uma consulta de leitura em secundários legíveis:
    1. Clique no menu suspenso de recursos de computação e selecione o recurso de computação que tem o rótulo (somente leitura).
    2. Clique em Alternar.
  6. Selecione o banco de dados e o esquema desejados no seletor suspenso ao lado de Executar tudo.
  7. Escreva uma consulta PostgreSQL e clique em Executar tudo.

Limitações

  • O modelo de permissões acl (lista de controle de acesso à consulta) se aplica. A execução ocorre com a identidade do Databricks do usuário que clica em Executar. Qualquer pessoa com pelo menos acesso CAN VIEW na consulta pode ver os resultados como eles aparecem no Editor SQL.
  • Objetos com escopo de conexão, como tabelas temporárias e transações, funcionam somente em uma única célula. Eles não funcionam entre diferentes cliques de Execução, pois cada uma é sua própria sessão.
  • Se $$ os blocos contiverem instruções com ponto-e-vírgula, somente os resultados da última instrução serão mostrados.

Conectar usando clientes SQL

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

Conectar-se com o psql

  1. Clique no ícone aplicativo.Aplicativos no canto superior direito e selecione Lakebase Postgres.
  2. Clique em Provisionado para abrir a página Instâncias Provisionadas.
  3. Selecione a instância de banco de dados que você deseja acessar.
  4. Clique em Detalhes da Conexão.
  5. Copie a cadeia de caracteres Conectar com PSQL.
  6. Cole o comando no terminal e execute-o.
  • Last updated on