Criar catálogos

Este artigo mostra como criar catálogos em Unity Catalog. Um catálogo contém esquemas (bancos de dados), e um esquema contém tabelas, visualizações, volumes, modelos e funções.

Para saber mais sobre catálogos, consulte O que são catálogos no Databricks?

Observação

Para saber como criar um catálogo externo, um objeto do Unity Catalog que espelha um banco de dados em um sistema de dados externo, consulte Criar um catálogo externo. Consulte também gerenciar e trabalhar com catálogos estrangeiros.

Requisitos

Para criar um catálogo, independentemente do tipo de catálogo:

O senhor deve ser um administrador do metastore da Databricks ou ter o privilégio CREATE CATALOG no metastore.
O recurso compute que o senhor usa para executar a Notebook criação de um catálogo deve estar no Databricks Runtime 11.3 ou superior e deve usar um modo de acesso compatível com o Unity Catalog. Consulte Modos de acesso. SQL O armazém sempre oferece suporte ao site Unity Catalog.

Para criar um catálogo compartilhado:

O compartilhamento Delta Sharing já deve existir em seu site workspace. Consulte Como faço para disponibilizar dados compartilhados para minha equipe?
O senhor deve ser administrador do metastore, ter o privilégio USE PROVIDER no metastore ou possuir o objeto do provedor que inclui o compartilhamento.

Para criar um catálogo padrão:

Se o senhor especificar um local de armazenamento gerenciar para o catálogo, deverá ter o privilégio CREATE MANAGED STORAGE no local externo de destino.
Se não houver armazenamento gerenciar no nível do metastore, o senhor deverá especificar um local de armazenamento gerenciar para o catálogo.

Para criar um catálogo externo:

O senhor deve ser o proprietário da conexão que usa para criar o catálogo externo ou ter o privilégio CREATE FOREIGN CATALOG na conexão.
O senhor deve usar o site compute em Databricks Runtime 13.1 ou acima. SQL O armazém deve ser Pro ou serverless.

Criar um catálogo

Para criar um catálogo, o senhor pode usar o Catalog Explorer, um comando SQL, a API REST, a CLI do Databricks ou o Terraform. Quando o senhor cria um catálogo, dois esquemas (bancos de dados) são criados automaticamente: default e information_schema.

O senhor pode usar o Catalog Explorer para atualizar o proprietário, tags, os comentários, os vínculos workspace e as permissões a qualquer momento após a criação do catálogo.

Para criar um catálogo padrão, execute o seguinte comando SQL em um editor de consultas Notebook ou SQL. Os itens entre parênteses são opcionais. Substitua os valores do espaço reservado:

<catalog-name>: Um nome para o catálogo.
<location-path>: Opcional, mas altamente recomendado. Forneça um caminho de local de armazenamento se quiser que as tabelas gerenciais desse catálogo sejam armazenadas em um local diferente do armazenamento raiz default configurado para o metastore.

Importante

Se o site workspace não tiver um local de armazenamento em nível de metastore, o senhor deverá especificar um local de armazenamento gerenciar ao criar um catálogo.

Esse caminho deve ser definido em uma configuração de local externo e o senhor deve ter o privilégio CREATE MANAGED STORAGE na configuração de local externo. O senhor pode usar o caminho definido na configuração do local externo ou um subcaminho (em outras palavras, 's3://depts/finance' ou 's3://depts/finance/product').
<comment>: Descrição opcional ou outro comentário.

CREATE CATALOG [ IF NOT EXISTS ] <catalog-name>
   [ MANAGED LOCATION '<location-path>' ]
   [ COMMENT <comment> ];

Por exemplo, para criar um catálogo chamado example:

CREATE CATALOG IF NOT EXISTS example;

Para criar um catálogo compartilhado, execute o seguinte comando em um editor de consultas Notebook ou SQL. Os itens entre parênteses são opcionais.

CREATE CATALOG [IF NOT EXISTS] <catalog-name>
USING SHARE <provider-name>.<share-name>;
[ COMMENT <comment> ];

Para criar um catálogo externo, execute o seguinte comando em um editor de consultas Notebook ou SQL. Os itens entre parênteses são opcionais. Substitua os valores do espaço reservado:

<catalog-name>: Nome do catálogo no Databricks.
<connection-name>: O objeto de conexão que especifica a fonte de dados, o caminho e as credenciais de acesso.
<database-name>: Nome do banco de dados que o senhor deseja espelhar como um catálogo no Databricks. Não é necessário para o MySQL, que usa um namespace de duas camadas. Para Databricks-to-Databricks lakehouse Federação, use catalog '<external-catalog-name>' em vez disso.
<external-catalog-name>: Databricks-to-Databricks Somente: Nome do catálogo no site externo Databricks workspace que o senhor está espelhando. Veja a execução de consultas federadas em outro site Databricks workspace .

CREATE FOREIGN CATALOG [IF NOT EXISTS] <catalog-name> USING CONNECTION <connection-name>
OPTIONS [(database '<database-name>') | (catalog '<external-catalog-name>')];

Consulte também Criar um catálogo externo.

Para limitar o acesso ao catálogo a um espaço de trabalho específico em seu account, também conhecido como workspace-catalog binding, consulte Limitar o acesso ao catálogo a um espaço de trabalho específico.

Para obter descrições detalhadas dos parâmetros, consulte CREATE CATALOG.

Depois de criar o catálogo, atribua privilégios a ele. Consulte Privilégios e objetos protegidos do Unity Catalog.

Terraform: O senhor pode criar um catálogo usando o provedor Databricks Terraform e databricks_catalog. O senhor pode recuperar informações sobre catálogos usando databricks_catalogs.

API REST: Use POST /api/2.1/unity-catalog/catalogs.

Databricks CLI: databricks catalogs create <catalog-name> [options] Para uma lista de opções, execução databricks catalogs create -h. As opções também são descritas na referência da API. Siga o link da API no parágrafo anterior.

Depois de criar o catálogo, atribua privilégios a ele. Consulte Privilégios e objetos protegidos do Unity Catalog.

Criar catálogos

Requisitos

Criar um catálogo

Mais informações