Crie esquemas

Este artigo mostra como criar esquemas em Unity Catalog e no legado Hive metastore.

Para saber mais sobre esquemas em Databricks, incluindo uma comparação do comportamento do esquema em Unity Catalog e Hive metastore, consulte O que são esquemas em Databricks?

Antes de começar

Para criar um esquema no Unity Catalog:

• O senhor deve ter um metastore Unity Catalog vinculado ao workspace onde realiza a criação do esquema.
• Você deve ter as permissões de dados USE CATALOG e CREATE SCHEMA no catálogo principal do esquema. Tanto o administrador da metastore quanto o proprietário do catálogo podem conceder esses privilégios a você. Se você for administrador da metastore, poderá conceder esses privilégios a si mesmo.
• Para especificar um local de armazenamento gerenciar opcional para as tabelas e os volumes no esquema, um local externo deve ser definido em Unity Catalog e o senhor deve ter o privilégio CREATE MANAGED STORAGE no local externo. Consulte Especificar um local de armazenamento gerenciar em Unity Catalog.
• O clustering que o senhor usa para executar um Notebook para criar um esquema 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 esquema em Hive metastore:

• As permissões necessárias dependem do fato de o senhor estar usando o controle de acesso da tabela. Consulte Hive metastore privileges and securable objects (legacy).

Crie um esquema

Para criar um esquema em Unity Catalog, o senhor pode usar o Catalog Explorer ou o comando SQL. Para criar um esquema em Hive metastore, o senhor deve usar o comando SQL.

Catalog Explorer

1. Faça login em um workspace que esteja vinculado ao metastore Unity Catalog.
2. Clique em Catálogo .
3. No painel Catálogo à esquerda, clique no catálogo no qual você deseja criar o esquema.
4. No painel de detalhes, clique em Criar esquema .
5. Dê 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 gerenciar em Unity Catalog e gerenciar locais para esquemas.
7. Clique em Criar .
8. Conceda privilégios no esquema. Consulte gerenciar privilégios em Unity Catalog.
9. Clique em 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 do espaço reservado:

   • <catalog-name>: o nome do catálogo principal do esquema. Se estiver criando um esquema em Hive metastore e estiver em um workspace habilitado para o Unity Catalog, use hive_metastore como o nome do catálogo. Se o seu workspace não estiver habilitado para Unity Catalog, não especifique um catálogo.
   • <schema-name>: um nome para o esquema.
   • <location-path>: Caminho opcional para um local de armazenamento gerenciar. Use com MANAGED LOCATION para Unity Catalog e com LOCATION para Hive metastore. No Unity Catalog, o senhor deve ter o privilégio CREATE MANAGED STORAGE no local externo para o caminho que especificar. Consulte Especificar um local de armazenamento gerenciar em Unity Catalog e gerenciar locais para esquemas.
   • <comment>: descrição opcional ou outro comentário.
   • <property-key> = <property-value> [ , ... ]: Opcional. Propriedades e valores do Spark SQL a serem definidos para o esquema.

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

   SQL

   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. Conceda privilégios no esquema. Para obter os privilégios do site Unity Catalog, consulte gerenciar privilégios em Unity Catalog.

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

Próximas etapas

• Para saber como adicionar tabelas, visualizações e volumes ao seu esquema, consulte O que é uma tabela?, O que é um view? e O que são volumes Unity Catalog?
• Para saber como adicionar modelos AI ao seu esquema, consulte gerenciar o ciclo de vida do modelo em Unity Catalog.
• Para saber como view, atualizar e eliminar esquemas existentes, consulte gerenciar esquemas.