Partilhar via


Acessar uma instância de banco de dados a partir de clientes SQL

Importante

Esta funcionalidade está na Pré-visualização Pública nas seguintes regiões: westus, westus2, eastus, eastus2, centralussouthcentralusnortheuropewesteuropeaustraliaeastbrazilsouthcanadacentralcentralindiasoutheastasiauksouth.

Esta página descreve como acessar uma instância de banco de dados Lakebase a partir de clientes SQL e explica como se conectar a uma instância de banco de dados a partir de psql.

Você pode acessar uma instância de banco de dados a partir de ferramentas externas, como psql, DBeaver e pgAdmin4. Essas ferramentas também permitem que você crie painéis para visualizar métricas de banco de dados para desempenho, uso de armazenamento e eficiência de consulta.

A psql ferramenta de linha de comando é o cliente interno do PostgreSQL que fornece acesso direto e interativo à sua instância de banco de dados. O uso psql oferece funcionalidade completa do Postgres e integra-se com fluxos de trabalho e ferramentas existentes do Postgres.

DBeaver e pgAdmin são ferramentas de código aberto que permitem gerenciar seu banco de dados Postgres. Para obter instruções sobre como instalar e conectar, consulte a documentação do DBeaver e a documentação do pgAdmin.

Antes de começar

  • Você deve instalar o psql. Para obter mais detalhes, consulte as ferramentas e o guia de instalação do PostgreSQL. psql É necessária a versão 14 ou superior.
  • Você deve instalar a libpq biblioteca.
  • Você tem uma função Postgres correspondente à sua identidade do Azure Databricks para iniciar sessão na instância do banco de dados. Consulte Gerenciar funções do Postgres.
  • Sua função Postgres recebe as permissões necessárias para acessar o banco de dados, esquema ou tabela.
  • Você pode autenticar-se à instância do banco de dados. Se você precisar obter um token OAuth para sua instância de banco de dados, consulte Autenticar em uma instância de banco de dados.

Considerações sobre identidades e funções de banco de dados

  • O proprietário padrão da instância é o usuário ou entidade de serviço do Azure Databricks que provisiona a instância de banco de dados.
  • Durante o provisionamento, um nome de função Postgres correspondente é criado automaticamente para a identidade:
    • Usuário do Databricks: O nome da função Postgres é o endereço de e-mail do usuário.
    • Entidade de serviço Databricks: O nome da função Postgres é a ID da aplicação da entidade de serviço.

Conecte-se com psql

Assim que o estado da instância da base de dados indicar Disponível, ligue-se a ela usando a ferramenta de linha de comando psql. Copie o comando connection da página de configuração da instância do banco de dados.

  1. Clique em Computação na barra lateral do espaço de trabalho.
  2. Clique em Banco de dados OLTP.
  3. Selecione a instância de banco de dados que você deseja acessar em psql.
  4. Clique em Detalhes da conexão.
  5. Copie a cadeia de caracteres Connect with PSQL .
  6. Cole o comando em seu terminal e execute-o para se conectar à instância do banco de dados usando psql.