Pular para o conteúdo principal

Conecte-se com a DBeaver

info

Beta

Este recurso está em versão Beta nas seguintes regiões: us-east-1, us-west-2, eu-west-1.

O Lakebase Postgres (beta com escalonamento automático) é a próxima versão do Lakebase, disponível apenas para avaliação. Para cargas de trabalho de produção, utilize a versão de pré-visualização pública do Lakebase. Consulte a seção "Como escolher entre as versões" para entender qual versão é a mais adequada para você.

O DBeaver é uma ferramenta universal e versátil de gerenciamento de banco de dados que oferece suporte a uma ampla variedade de bancos de dados, incluindo o PostgreSQL. Oferece um conjunto abrangente de recursos para administração de banco de dados, desenvolvimento de consultas e visualização de dados.

Pré-requisitos​

  • DBeaver Comunidade ou Enterprise Edition instalado em seu sistema
  • Um projeto de banco de dados Lakebase com uma função Postgres configurada.
nota

Recomendamos o uso da autenticação nativa por senha do Postgres ao conectar-se com o DBeaver. As senhas nativas do Postgres não expiram a cada hora como tokens OAuth , o que as torna mais adequadas para aplicações que não podem refresh as credenciais com frequência. Consulte a Visão geral da autenticação para obter detalhes sobre os métodos de autenticação.

Instale o DBeaver​

Se você não tiver DBeaver instalado, download e instale-o a partir do siteDBeaver.

Entendendo as cadeias de conexão​

O Lakebase fornece uma string de conexão que contém todas as informações necessárias para estabelecer a conexão. Eis como analisá-lo:

postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require
             ^         ^        ^                         ^
       user -|         |        |- hostname               |- database
                       |
                       |- password
nota

DBeaver e outras ferramentas baseadas em Java funcionam melhor quando você fornece os detalhes de conexão em campos separados, em vez de como uma string de conexão.

Para obter mais detalhes sobre strings de conexão, consulte Compreendendo stringsde conexão.

Conecte-se ao seu banco de dados​

  1. Obtenha os detalhes de conexão do Lakebase:

    • Acesse o aplicativo Lakebase e selecione seu projeto de banco de dados.
    • Clique em Conectar para abrir a janela de conexão com o banco de dados.
    • Selecione a filial, compute e o banco de dados aos quais deseja se conectar.
    • Selecione uma função do Postgres na dropdown (recomendamos usar uma função nativa do Postgres com autenticação por senha).
    • Observe os detalhes da conexão.

  2. Criar uma nova conexão de banco de dados no DBeaver:

    • Abra o DBeaver
    • Clique no botão Nova Conexão de Banco de Dados (ícone de plugue) ou selecione Banco de Dados > Nova Conexão de Banco de Dados no menu.
    • No assistente Conectar ao Banco de Dados , selecione PostgreSQL na lista de tipos de banco de dados.
    • Clique em Próximo

  3. Insira os detalhes da conexão:

    • Host : Insira hostname do seu endpoint compute (ex.: ep-abc-123.databricks.com)
    • Porto : 5432
    • Banco de dados : Insira o nome do seu banco de dados (ex.: databricks_postgres)
    • Nome de usuário : Insira o nome da sua função no Postgres (ex.: role_name)
    • Senha : Digite a senha da sua função Postgres
    • Exibir todos os bancos de dados : Ative esta opção para visualizar todos os bancos de dados do seu projeto.

  4. Configurar SSL:

    • Clique em Editar configurações do driver.
    • Na tab Propriedades do Driver , encontre sslmode e defina-o como require
    • Clique em OK para retornar à caixa de diálogo de conexão.

  5. Teste e salve a conexão:

    • Clique em Testar Conexão para verificar os detalhes da conexão.
    • Se a conexão for bem-sucedida, clique em Concluir para salvar a conexão.

Sua conexão com o banco de dados Lakebase agora aparecerá na barra lateral esquerda, em Navegador de Banco de Dados.

Usando o DBeaver​

Após a conexão, você poderá:

execução de consultas SQL​

  • Clique com o botão direito do mouse na sua conexão de banco de dados na barra lateral esquerda.
  • Selecione Editor SQL > Novo Script SQL
  • Insira suas consultas SQL no editor.
  • Clique no botão Executar (ícone de reprodução) para executá-los.
  • Veja os resultados no painel de resultados abaixo do editor.

mesas​

  • Expanda sua conexão com o banco de dados na barra lateral esquerda.
  • Navegue até Bancos de Dados > [seu banco de dados] > Esquemas > público > Tabelas
  • Clique com o botão direito do mouse em Tabelas para criar uma nova tabela.
  • Clique com o botão direito do mouse em uma tabela existente para view, editá-la ou gerenciá-la.

Dados de importação e exportação​

Para importar dados:

  • Clique com o botão direito do mouse em uma tabela e selecione Importar dados.
  • Escolha o formato do arquivo de origem (por exemplo, CSV, JSON)
  • Siga as instruções para mapear as colunas e importar.

Para exportar dados:

  • Clique com o botão direito do mouse em uma tabela e selecione Exportar dados.
  • Escolha o formato de exportação (ex.: CSV, JSON)
  • Siga as instruções para salvar o arquivo.

Construtor de consultas visuais​

O DBeaver inclui um construtor visual de consultas que permite criar consultas graficamente, selecionando tabelas, colunas e condições.

Solução de problemas​

Cadeias de conexão não são aceitas.​

DBeaver e outras ferramentas baseadas em Java que usam o driver pgJDBC podem não suportar a inclusão do nome da função e da senha em strings de conexão de banco de dados. Se você encontrar problemas com strings de conexão, use os campos de detalhes de conexão separados, conforme descrito neste guia.

Segurança da conexão​

A Lakebase exige que todas as conexões utilizem criptografia SSL/TLS. Certifique-se de que sslmode esteja definido como require nas propriedades do driver.

Para obter mais informações sobre strings de conexão e opções de autenticação, consulte Conectar-se ao seu projeto de banco de dados.

Última atualização em