gerenciar bancos de dados

Um banco de dados é um contêiner para objetos SQL , como esquemas, tabelas, visualizações, funções e índices. No Lakebase, um banco de dados existe dentro de uma ramificação de um projeto, com um limite de 500 bancos de dados por ramificação.

Visão geral do banco de dados

O branch default de cada projeto é criado com um banco de dados chamado databricks_postgres, que pertence à função Postgres para sua identidade Databricks (por exemplo, user@databricks.com).

Os bancos de dados criados no aplicativo Lakebase são criados no esquema default do Postgres public .

Se você gerencia seu projeto com Terraform e quiser trazer este banco de dados databricks_postgres implícito sob o gerenciamento de IaC, consulte Configuração típica de projeto Lakebase com Terraform para o padrão de adoção replace_existing.

Se você usar Pacotes de Automação Declarativa, consulte configuração de projeto típica do Lakebase com Pacotes de Automação Declarativa para o mesmo padrão.

nota

Os bancos de dados são independentes entre as filiais. Ao criar uma ramificação, ela reflete os bancos de dados Postgres da ramificação pai no momento da criação da ramificação. Após a ramificação, os bancos de dados de cada ramificação evoluem independentemente — os bancos de dados criados ou excluídos em uma ramificação não afetam nenhuma outra ramificação, incluindo a ramificação pai. Não existe sincronização automática de bancos de dados entre filiais.

visualizar bancos de dados

Para view os bancos de dados de uma filial, acesse a tab Funções e Bancos de Dados da sua filial no aplicativo Lakebase.

A seção de bancos de dados exibe informações sobre todos os bancos de dados na filial selecionada:

Detalhe	Descrição
Nome da base de dados	O nome do banco de dados
Proprietário	A função do Postgres que possui e tem privilégios totais no banco de dados
Criado em	Quando o banco de dados foi criado
Última atualização	A última vez que o banco de dados foi atualizado.

Detalhe	Descrição
Nome da base de dados	O nome do banco de dados
Proprietário	A função do Postgres que possui e tem privilégios totais no banco de dados
Criado em	Quando o banco de dados foi criado
Última atualização	A última vez que o banco de dados foi atualizado.

Criar um banco de dados

Você pode criar bancos de dados Postgres adicionais em sua ramificação usando o aplicativo Lakebase ou o comando SQL .

Para criar um banco de dados usando o aplicativo Lakebase:

1. Acesse a tab "Funções e Bancos de Dados" da sua filial no aplicativo Lakebase.
2. Clique em Adicionar banco de dados , insira um nome de banco de dados seguindo as convenções de nomenclatura do Postgres e selecione a função de proprietário.

importante

Alguns nomes de banco de dados são reservados e não podem ser usados: databricks_postgres (já usado como nome de banco de dados default ), postgres, template0, template1.

Gerenciar bancos de dados com SQL

Criar um banco de dados

Crie bancos de dados usando o comando SQL padrão do Postgres:

SQL

CREATE DATABASE my_application_db
    WITH OWNER = my_app_role
    ENCODING = 'UTF8';

nota

Os bancos de dados criados usando o comando SQL aparecerão automaticamente no aplicativo Lakebase, na tab Funções e Bancos de Dados da sua filial.

Listar bancos de dados

Veja todos os bancos de dados do seu projeto:

SQL

SELECT datname FROM pg_database WHERE datistemplate = false;

Alternar entre bancos de dados

Mudar para um banco de dados diferente:

• No editor SQL do Lakebase: Selecione o banco de dados no menu dropdown de bancos de dados.

• No cliente SQL psql :

  SQL

  \c my_application_db

Monitorar o tamanho do banco de dados

Verifique o tamanho lógico de um banco de dados:

SQL

SELECT
    datname AS database_name,
    pg_size_pretty(pg_database_size(datname)) AS size
FROM pg_database
WHERE datistemplate = false
ORDER BY pg_database_size(datname) DESC;

Excluir um banco de dados

importante

Excluir um banco de dados remove permanentemente todos os esquemas, tabelas e dados contidos nesse banco de dados. Esta ação não pode ser desfeita.

Para excluir um banco de dados usando o aplicativo Lakebase:

1. Acesse a tab "Funções e Bancos de Dados" da sua filial no aplicativo Lakebase.
2. Clique no No menu do banco de dados, selecione Excluir banco de dados e digite o nome do banco de dados para confirmar.

Para excluir usando SQL:

SQL

-- Drop the database
DROP DATABASE database_to_delete;