Registrar um banco de dados Lakebase no Unity Catalog
Beta
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 registro de um banco de dados Lakebase no Unity Catalog cria um catálogo somente leitura que representa seu banco de dados Postgres, permitindo a governança unificada de dados e análises entre diferentes fontes em suas cargas de trabalho lakehouse e transacionais.
Por que se registrar no Unity Catalog
O registro oferece diversas vantagens:
Governança unificada : Aplique os controles de governança do Unity Catalog — permissões, acompanhamento de linhagem e logsde auditoria — aos seus dados do Lakebase, juntamente com os dados do seu lakehouse .
Consultas entre fontes : Consulte tabelas Unity Catalog e bancos de dados do Lakebase a partir de uma única interface SQL , permitindo análises que combinam dados transacionais e analíticos.
Descoberta centralizada : Navegue e descubra bancos de dados, esquemas e tabelas do Lakebase por meio do Catalog Explorer, juntamente com outras fontes de dados em seu workspace.
Fluxo de trabalho integrado : Utilize dados do Lakebase em dashboards e aplicativos Databricks sem precisar alternar entre contextos ou gerenciar conexões separadas.
Como funciona
O registro cria um catálogo Unity Catalog somente leitura que espelha a estrutura do seu banco de dados Postgres, fornecendo acesso aos metadados dos objetos do seu banco de dados (esquemas, tabelas, visualizações) por meio da camada de governança do Unity Catalog.
Você inicia o registro a partir do Catalog Explorer, em vez da interface do Lakebase, o que se integra naturalmente ao fluxo de trabalho de criação de catálogos do Unity Catalog.
Após o cadastro:
- Seu banco de dados Lakebase aparece como um catálogo no Unity Catalog
- As permissões Unity Catalog controlam quem pode view e consultar o banco de dados.
- O catálogo permanece somente leitura — você gerencia o banco de dados propriamente dito por meio do Lakebase.
Pré-requisitos
- Um projeto de banco de dados Lakebase existente com pelo menos um banco de dados.
- CREATE CATALOGprivilégios no metastore Unity Catalog
- Um SQL warehouse serverless para consultar o catálogo registrado.
registrar um banco de dados
Para registrar um banco de dados Lakebase no Unity Catalog:
- No Explorador de Catálogos, clique em Criar catálogo .
- Selecione Lakebase serverless como o tipo de catálogo.
- Insira o nome do catálogo e selecione seu projeto de banco de dados, ramificação e banco de dados Postgres.
- Clique em Criar .

O catálogo aparece no Explorador de Catálogo, onde você pode navegar por esquemas, tabelas e visualizações, além de consultá-los usando SQL Warehouse.
Explore as bases de dados registadas
Após o registro, acesse seu catálogo no Explorador de Catálogo para navegar pelos esquemas, tabelas e visualizações. Clique em qualquer tabela para view detalhes do esquema, dados de amostra e informações de linhagem.
O Unity Catalog sincroniza automaticamente os metadados do seu banco de dados Lakebase. Ao adicionar ou modificar tabelas no Lakebase, refresh a view do catálogo para ver as atualizações.
Consultar bancos de dados registrados
Consulte os bancos de dados Lakebase registrados usando SQL Warehouse ou qualquer ferramenta que se conecte ao Unity Catalog:
-- Query a registered :re[LKB] database
SELECT * FROM chatbot_catalog.public.conversations
WHERE created_at >= current_date - INTERVAL 7 DAYS;
-- Join :re[LKB] and lakehouse data
SELECT
  c.conversation_id,
  c.user_id,
  c.agent_response,
  u.user_name,
  u.subscription_tier
FROM chatbot_catalog.public.conversations c
JOIN main.user_analytics.users u
  ON c.user_id = u.user_id;
O catálogo somente leitura garante que as consultas não modifiquem seu banco de dados Lakebase por meio do Unity Catalog. Para modificar o uso de dados, utilize o Editor SQL do Lakebase ou conecte-se diretamente ao seu banco de dados.
Permissões e controle de acesso
As permissões Unity Catalog controlam o acesso aos bancos de dados Lakebase registrados:
- Propriedade do catálogo : O usuário que registra o banco de dados torna-se o proprietário do catálogo.
- Acesso de leitura : Conceda privilégios USE CATALOGeSELECTpara permitir que outros consultem o banco de dados.
- Administrador do Metastore : Os administradores do Metastore podem gerenciar todos os catálogos registrados.
Para conceder acesso a um banco de dados registrado:
-- Grant read access to a group
GRANT USE CATALOG ON CATALOG chatbot_catalog TO `ai-engineering`;
GRANT SELECT ON CATALOG chatbot_catalog TO `ai-engineering`;
As permissões definidas no Unity Catalog controlam o acesso às consultas por meio do banco de dados SQL . As conexões diretas com seu banco de dados Lakebase usam funções e permissões do Postgres de forma independente.
Cancelar o registro de um banco de dados
Para remover um banco de dados Lakebase do Unity Catalog, selecione o catálogo no Explorador de Catálogos e clique em  e selecione Excluir .
Excluir o catálogo o remove do Unity Catalog , mas não afeta seu banco de dados Lakebase. O banco de dados permanece acessível através do Lakebase e de conexões diretas com o Postgres.
Se você criou tabelas sincronizadas a partir do banco de dados registrado, exclua essas tabelas primeiro. Cada tabela de origem só pode ser usada para criar 20 tabelas sincronizadas, e as tabelas sincronizadas pendentes de exclusão contam para esse limite.
Limitações
Acesso somente leitura : Os catálogos registrados nos bancos de dados do Lakebase são somente leitura. Não é possível modificar dados por meio de consultas Unity Catalog .
Um único banco de dados por catálogo : Cada catálogo Unity Catalog representa um banco de dados do Lakebase. Para expor várias bases de dados, registre cada uma separadamente.
Sincronização de metadados : o Unity Catalog armazena metadados em cache para reduzir as solicitações ao Postgres. Novos objetos podem não aparecer imediatamente. Clique  Para acionar uma refresh completa.
Isolamento de filiais : Cataloga bancos de dados de registros de filiais específicas. Para acessar dados de várias filiais, registre um banco de dados de cada filial como um catálogo separado.
Próximos passos
- gerenciar bancos de dados para aprender como criar e gerenciar bancos de dados Lakebase
- Ramificações de banco de dados para entender como as ramificações organizam seus dados
- Utilize o Editor SQL para consultar diretamente seus bancos de dados Lakebase.