Criar esquemas

Esta página mostra como criar esquemas no Unity Catalog e no metastore herdado do Hive.

Para saber mais sobre esquemas no Azure Databricks, incluindo uma comparação do comportamento do esquema no Catálogo do Unity e no metastore do Hive, consulte O que são os esquemas no Azure Databricks?.

Antes de começar

Para criar um esquema no catálogo do Unity:

• Você deve ter um metastore do Catálogo do Unity vinculado ao workspace em que executa a criação do esquema.
• Você deve ter as permissões USE CATALOG e CREATE SCHEMAde dados no catálogo pai do esquema. Um administrador metastore ou o proprietário do catálogo podem conceder esses privilégios. Se você for um administrador metastore, poderá conceder esses privilégios a si próprio.
• Para especificar um local de armazenamento gerenciado opcional para as tabelas e volumes no esquema, um local externo deve ser definido no Catálogo do Unity e você deve ter o privilégio CREATE MANAGED STORAGE no local externo. Consulte Especificar um local de armazenamento gerenciado no catálogo do Unity.
• O cluster que você utiliza para executar um notebook para criar um esquema deve usar um modo de acesso em conformidade com o Catálogo do Unity. Consulte Modos de acesso. Os warehouses SQL sempre dão suporte para o Catálogo do Unity.

Para criar um esquema no metastore do Hive:

• As permissões necessárias dependem se você está usando o controle de acesso à tabela. Consulte Privilégios do metastore do Hive e objetos securáveis (herdados).

Criar um esquema

Para criar um esquema no Catálogo do Unity, você pode usar o Explorador de catálogos ou comandos SQL. Para criar um esquema no metastore do Hive, você deve usar comandos SQL.

Explorador do Catálogo

1. Acesse um workspace vinculado ao metastore do Unity Catalog.
2. Clique no Catálogo.
3. No painel Catálogo à esquerda, clique no catálogo em que você deseja criar o esquema.
4. No painel de detalhes, clique em Criar esquema.
5. Forneça um nome ao esquema e adicione qualquer comentário que ajude os usuários a entender a finalidade do esquema.
6. (Opcional) Especifique um local de armazenamento gerenciado. Requer o privilégio CREATE MANAGED STORAGE no local externo de destino. Consulte Especificar um local de armazenamento gerenciado no Catálogo do Unity e Locais gerenciados para esquemas.
7. Clique em Criar.
8. Concessão de privilégios no esquema. Consulte Gerenciar privilégios no Catálogo do Unity.
9. Clique em Save (Salvar).

SQL

1. Execute o seguinte comando SQL em um notebook ou no editor de consultas SQL. Os itens entre colchetes são opcionais. Você pode usar SCHEMA ou DATABASE. Substitua os valores de espaço reservado:

   • <catalog-name>: o nome do catálogo pai do esquema. Se você estiver criando um esquema no metastore do Hive e estiver em um workspace habilitado para Catálogo do Unity, use hive_metastore como o nome do catálogo. Se seu workspace se não estiver habilitado para o Unity Catalog, não especifique nenhum catálogo.
   • <schema-name>: Um nome para o esquema.
   • <location-path>: Caminho opcional para um local de armazenamento gerenciado. Use com MANAGED LOCATION para o Catálogo do Unity e com LOCATION para metastore do Hive. No Catálogo da Unity, deverá ter o privilégio CREATE MANAGED STORAGE no local externo de destino. Consulte Especificar um local de armazenamento gerenciado no Catálogo do Unity e Locais gerenciados para esquemas.
   • <comment>: descrição opcional ou outro comentário.
   • <property-key> = <property-value> [ , ... ]: opcional. Propriedades SQL do Spark e valores a definir para o esquema.

   Para obter descrições de parâmetro mais detalhadas, consulte CREATE SCHEMA.

   CREATE { DATABASE | SCHEMA } [ IF NOT EXISTS ] <catalog-name>.<schema-name>
       [ MANAGED LOCATION '<location-path>' | LOCATION '<location-path>']
       [ COMMENT <comment> ]
       [ WITH DBPROPERTIES ( <property-key = property_value [ , ... ]> ) ];
   

2. Concessão de privilégios no esquema. Confira os privilégios no Catálogo do Unity em Gerenciar privilégios no Catálogo do Unity.

Você também pode criar um esquema usando o Provedor Terraform do Databricks e databricks_schema. Você pode recuperar uma lista de IDs de esquema usando databricks_schemas

Próximas etapas

• Para saber como adicionar tabelas, exibições e volumes ao esquema, consulte as tabelas do Azure Databricks, o que é uma exibição?e o que são volumes do Catálogo do Unity?.
• Para saber como adicionar modelos de IA ao esquema, consulte Gerenciar ciclo de vida do modelo no Catálogo do Unity.
• Para saber como exibir, atualizar e descartar esquemas existentes, consulte Gerenciar esquemas.