Pular para o conteúdo principal

schemas grupo de comando

nota

Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.

Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.

O grupo de comandos schemas dentro do Databricks CLI contém comando para gerenciar esquemas em Unity Catalog. Um esquema é a segunda camada do namespace de três níveis do Unity Catalog. Um esquema organiza tabelas, visualizações e funções. Consulte O que são esquemas no Databricks?

criação de esquemas de databricks

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

databricks schemas create NAME CATALOG_NAME [flags]

Argumentos

NAME

Nome do esquema, em relação ao catálogo principal.

CATALOG_NAME

Nome do catálogo principal.

Opções

--comment string

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

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--storage-root string

URL raiz de armazenamento para tabelas gerenciar dentro do esquema.

Bandeiras globais

Exemplos

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

Bash
databricks schemas create analytics main

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

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

esquemas de databricks excluídos

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

databricks schemas delete FULL_NAME [flags]

Argumentos

FULL_NAME

Nome completo do esquema.

Opções

--force

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

Bandeiras globais

Exemplos

O exemplo a seguir exclui um esquema:

Bash
databricks schemas delete main.analytics

O exemplo a seguir força a exclusão de um esquema mesmo que ele não esteja vazio:

Bash
databricks schemas delete main.analytics --force

esquemas de databricks obtêm

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

databricks schemas get FULL_NAME [flags]

Argumentos

FULL_NAME

Nome completo do esquema.

Opções

--include-browse

Se deve incluir esquemas na resposta para os quais o diretor só pode acessar metadados seletivos.

Bandeiras globais

Exemplos

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

Bash
databricks schemas get main.analytics

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

Bash
databricks schemas get main.analytics --include-browse

lista de esquemas de databricks

Liste os esquemas de um catálogo no metastore. Se o chamador for o administrador da 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 os quais o chamador tenha o privilégio USE_SCHEMA) serão recuperados. Não há garantia de uma ordem específica dos elementos na matriz.

databricks schemas list CATALOG_NAME [flags]

Argumentos

CATALOG_NAME

Catálogo principal para esquemas de interesse.

Opções

--include-browse

Se deve incluir esquemas na resposta para os quais o diretor só pode acessar metadados seletivos.

--max-results int

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

--page-token string

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

Bandeiras globais

Exemplos

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

Bash
databricks schemas list main

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

Bash
databricks schemas list main --max-results 10

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

Bash
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 da metastore. Se o chamador for um administrador da metastore, somente o campo owner poderá ser alterado na atualização. Se o campo name precisar ser atualizado, o chamador deverá ser administrador da metastore ou ter o privilégio CREATE_SCHEMA no catálogo principal.

databricks schemas update FULL_NAME [flags]

Argumentos

FULL_NAME

Nome completo do esquema.

Opções

--comment string

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

--enable-predictive-optimization EnablePredictiveOptimization

Se a otimização preditiva deve ser habilitada para esse objeto e os objetos abaixo dele. Valores suportados: [DISABLE, ENABLE, INHERIT]

--json JSON

As cadeias de caracteres JSON ou o caminho @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 atual proprietário do esquema.

Bandeiras globais

Exemplos

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

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

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

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

O exemplo a seguir renomeia um esquema:

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

Bandeiras globais

--debug

Se deve habilitar o registro de depuração.

-h ou --help

Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.

--log-format Formato

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

--log-level string

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

-o, --output Tipo

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

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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