Grupo de comandos schemas

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

criar esquemas do databricks

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

databricks schemas create NAME CATALOG_NAME [flags]

Arguments

NAME

    Nome do esquema, relativo ao catálogo principal.

CATALOG_NAME

    Nome do catálogo principal.

Opções

--comment string

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

--json JSON

    A cadeia de caracteres JSON inserida em linha 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.

Sinalizadores globais

Examples

O exemplo a seguir cria um novo esquema nomeado analytics no main catálogo:

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 do databricks

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

databricks schemas delete FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo do esquema.

Opções

--force

    Force a exclusão mesmo se o esquema não estiver vazio.

Sinalizadores globais

Examples

O exemplo a seguir exclui um esquema:

databricks schemas delete main.analytics

O seguinte exemplo exclui à força um esquema, mesmo que não esteja vazio:

databricks schemas delete main.analytics --force

obtenção de esquemas do databricks

Obtenha o esquema especificado dentro do metastore. O chamador deve ser um administrador 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

    Indica se deve incluir na resposta os esquemas para os quais a entidade de segurança tem acesso apenas a metadados seletivos.

Sinalizadores 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 schemas do Databricks

Liste os esquemas de um catálogo no metastore. Se o chamador for o administrador do metastore ou o proprietário do catálogo principal, todos os esquemas do catálogo serão recuperados. Caso contrário, somente esquemas pertencentes ao chamador (ou para o qual 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 principal para esquemas de interesse.

Opções

--include-browse

    Indica se deve incluir na resposta os esquemas para os quais a entidade de segurança tem acesso apenas a metadados seletivos.

--max-results int

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

--page-token string

    Token de paginação não transparente que permite ir para a próxima página com base na consulta anterior.

Sinalizadores globais

Examples

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

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 dos esquemas no Databricks

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

databricks schemas update FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo do esquema.

Opções

--comment string

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

--enable-predictive-optimization EnablePredictiveOptimization

    Se a otimização preditiva deve ser habilitada para esse objeto e objetos sob ele. Valores com suporte: [DISABLE (desativar), ENABLE (ativar), INHERIT (herdar)]

--json JSON

    A cadeia de caracteres JSON inserida em linha 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.

Sinalizadores 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

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

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

--log-file corda

    Uma cadeia de caracteres que representa o arquivo para o qual gravar logs de saída. Se esse sinalizador não for especificado, o padrão será gravar logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    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á desabilitado.

-o, --output tipo

    O tipo de saída de comando, text ou json. O valor padrão é text.

-p, --profile corda

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

--progress-format formato

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

-t, --target corda

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