registre seu banco de dados em Unity Catalog

info

Visualização

Esse recurso está em Public Preview nas seguintes regiões: us-east-1, us-west-2, eu-west-1, ap-southeast-1, ap-southeast-2, eu-central-1, us-east-2, ap-south-1.

Esta página explica como registrar o banco de dados do Lakebase como um catálogo Unity Catalog somente para leitura. Isso permite que o senhor use os privilégios do Unity Catalog para gerenciar o acesso aos dados e aproveitar integrações como a sincronização de dados do gerenciar.

Propriedade e permissões

• Se o banco de dados não existir, ele poderá ser criado junto com o catálogo. Nesse caso, a propriedade dos objetos seguirá essas diretrizes.
• Além disso, o criador do catálogo deve ter privilégios CREATE CATALOG no metastore do Unity Catalog.

Crie um catálogo

Para registrar um banco de dados com Unity Catalog, use a UI Databricks ou uma chamada API.

UI

1. Clique em Computação na barra lateral do workspace.

2. Em Database instances (Instâncias de banco de dados) tab, selecione a instância do banco de dados.

3. Em Catalogs (Catálogos ) tab, clique em Create catalog (Criar catálogo ).

4. O senhor pode registrar um banco de dados existente como um catálogo Unity Catalog ou criar um novo. Use uma das seguintes opções:

   • Para usar um banco de dados existente: digite o nome do catálogo do Unity Catalog desejado e o nome do banco de dados Postgres existente. O banco de dados default databricks_postgres pode ser usado como o nome do banco de dados.
   • Para criar um novo banco de dados Postgres e um catálogo do Unity Catalog ao mesmo tempo: digite o nome do catálogo desejado e ative a opção Create new database (Criar novo banco de dados ).

5. Clique em Criar .

6. Após a criação, clique no catálogo na lista Catalogs para ver o Catalog Explorer view.

curl

Bash

export PG_DATABASE_NAME="<name of the PG database to sync to UC>"
export CATLAOG_NAME="<name of UC catalog to create>"

Bash

// Optional
export CREATE_DATABASE_IF_NOT_EXISTS="<whether to create a new database>"

Bash

curl -X POST --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/catalogs \
--data-binary @- << EOF
{
  "name": "$CATALOG_NAME",
  "database_name": "$PG_DATABASE_NAME",
  "instance_name": "$INSTANCE_NAME",
  "create_database_if_not_exists": "$CREATE_DATABASE_IF_NOT_EXISTS" // optional
}

Limitações

• Os nomes dos bancos de dados devem conter apenas caracteres alfanuméricos ou sublinhados. Observe que os nomes dos bancos de dados não podem incluir hífens.

• O catálogo criado no Unity Catalog com base no banco de dados é somente leitura.

• Os nomes do catálogo devem seguir as restrições existentes para nomes de objetos protegíveis do Unity Catalog.

Explorar objetos Postgres no Unity Catalog por meio de um Database Catalog

Para view o catálogo, verifique se o senhor tem um serverless SQL warehouse em execução anexado.

1. Clique em Catalog na barra lateral workspace.
2. No navegador de catálogo , clique no clustering e selecione um serverless SQL warehouse em execução como seu recurso compute.
3. Clique em começar e fechar .

Ao abrir o catálogo, os esquemas e as tabelas, as sincronizações devem ser acionadas automaticamente. No entanto, a interface do usuário pode armazenar dados em cache para reduzir o número de solicitações do Postgres, portanto, novos objetos podem não aparecer imediatamente.

Para acionar um refresh completo, clique em .

Excluir um catálogo de banco de dados no Unity Catalog

Você precisa ser proprietário de um catálogo de banco de dados ou administrador da metastore para excluí-lo.

A Databricks recomenda que o senhor exclua primeiro todas as tabelas sincronizadas do catálogo do banco de dados. Cada tabela de origem só pode ser usada para criar 20 tabelas sincronizadas, e pode levar até três dias para que as tabelas sincronizadas sejam limpas no Unity Catalog depois que um catálogo de banco de dados for excluído. As tabelas sincronizadas pendentes de exclusão no Unity Catalog contam para o limite de 20 tabelas sincronizadas por tabela de origem.

Use a interface do usuário do Databricks para excluir um catálogo de banco de dados.

1. Clique em Catalog na barra lateral workspace.
2. Selecione o catálogo do banco de dados que você deseja excluir no painel Catálogo .
3. Clique e clique em Excluir .

Depois que o catálogo for excluído, você poderá renomear ou descartar o banco de dados Postgres.