schemas grupo de comando

O schemas grupo de comandos dentro da CLI Databricks contém comandos para gerir esquemas no Catálogo Unity. Um esquema é a segunda camada do namespace de três níveis do Unity Catalog. Um esquema organiza tabelas, exibições e funções. Consulte O que são esquemas no Azure Databricks?.

Criar esquemas Databricks

Crie um novo esquema para catálogo no metastore. O chamador deve ser um administrador de metastore ou ter o CREATE_SCHEMA privilégio no catálogo pai.

databricks schemas create NAME CATALOG_NAME [flags]

Arguments

NAME

    Nome do esquema, relativo ao catálogo principal.

CATALOG_NAME

    Nome do catálogo pai.

Opções

--comment string

    Descrição de texto de forma livre fornecida pelo usuário.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--storage-root string

    URL raiz de armazenamento para tabelas gerenciadas dentro do esquema.

Bandeiras globais

Examples

O exemplo seguinte cria um novo esquema nomeado analytics no catálogo main.

databricks schemas create analytics main

O exemplo a seguir cria um novo esquema com um comentário:

databricks schemas create analytics main --comment "Schema for analytics data"

Exclusão de esquemas Databricks

Exclua o esquema especificado do catálogo pai. O chamador deve ser proprietário do esquema ou do catálogo pai.

databricks schemas delete FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo do esquema.

Opções

--force

    Forçar a eliminação mesmo que o esquema não esteja vazio.

Bandeiras globais

Examples

O exemplo a seguir exclui um esquema:

databricks schemas delete main.analytics

O exemplo a seguir força a exclusão de um esquema de base de dados mesmo quando não está vazio.

databricks schemas delete main.analytics --force

Obter esquemas Databricks

Obtenha o esquema especificado dentro do metastore. O chamador deve ser um administrador de metastore, o proprietário do esquema ou um usuário que tenha o USE_SCHEMA privilégio no esquema.

databricks schemas get FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo do esquema.

Opções

--include-browse

    Se deve incluir esquemas na resposta, para os quais o principal pode apenas acessar metadados seletivos.

Bandeiras globais

Examples

O exemplo a seguir obtém informações sobre um esquema:

databricks schemas get main.analytics

O exemplo a seguir obtém informações de esquema, incluindo permissões de navegação:

databricks schemas get main.analytics --include-browse

Lista de esquemas Databricks

Liste os esquemas para um catálogo no metastore. Se o chamador for o administrador do metastore ou o proprietário do catálogo pai, todos os esquemas para o catálogo serão recuperados. Caso contrário, apenas os esquemas de propriedade do chamador (ou para os quais o chamador tem o USE_SCHEMA privilégio) serão recuperados. Não há garantia de uma ordenação específica dos elementos na matriz.

databricks schemas list CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Catálogo pai para esquemas de interesse.

Opções

--include-browse

    Se deve incluir esquemas na resposta, para os quais o principal pode apenas acessar metadados seletivos.

--max-results int

    Número máximo de esquemas a serem retornados.

--page-token string

    Token de paginação opaco para avançar para a próxima página com base na consulta anterior.

Bandeiras globais

Examples

O exemplo seguinte lista todos os esquemas no catálogo main:

databricks schemas list main

O exemplo a seguir lista esquemas com um máximo de 10 resultados:

databricks schemas list main --max-results 10

O exemplo a seguir lista esquemas usando paginação:

databricks schemas list main --page-token <token>

Atualização de esquemas do Databricks

Atualize um esquema para um catálogo. O chamador deve ser o proprietário do esquema ou um administrador de metastore. Se o chamador for um administrador de metastore, apenas o owner campo poderá ser alterado na atualização. Se o name campo tiver de ser atualizado, o chamador deve ser um administrador de metastore ou ter o CREATE_SCHEMA privilégio sobre o catálogo pai.

databricks schemas update FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo do esquema.

Opções

--comment string

    Descrição de texto de forma livre fornecida pelo usuário.

--enable-predictive-optimization EnablePredictiveOptimization

    Se a otimização preditiva deve ser habilitada para este objeto e objetos sob ele. Valores suportados: [DESATIVAR, ATIVAR, HERDAR]

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

--new-name string

    Novo nome para o esquema.

--owner string

    Nome de usuário do proprietário atual do esquema.

Bandeiras globais

Examples

O exemplo a seguir atualiza o comentário de um esquema:

databricks schemas update main.analytics --comment "Updated analytics schema"

O exemplo a seguir altera o proprietário de um esquema:

databricks schemas update main.analytics --owner someone@example.com

O exemplo a seguir renomeia um esquema:

databricks schemas update main.analytics --new-name analytics_v2

Bandeiras globais

--debug

  Se o log de depuração deve ser habilitado.

-h ou --help

    Exiba a ajuda para a CLI do Databricks ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

    Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

    O tipo de formato de log, text ou json. O valor predefinido é text.

--log-level string

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desativado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor predefinido é text.

-p, --profile string

    O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se esse sinalizador não for especificado, se ele existir, o perfil nomeado DEFAULT será usado.

--progress-format Formato

    O formato para exibir logs de progresso: default, append, inplace, ou json

-t, --target string

    Se aplicável, o destino do pacote a ser usado