Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Grupo de comandos
Note
Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Visualização Pública.
O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer provisionamentos de Dados de Uso.
O metastores grupo de comandos dentro da CLI do Databricks permite que você gerencie metastores. Um metastore é o contêiner de nível superior de objetos no Catálogo do Unity. Ele armazena ativos de dados (tabelas e exibições) e as permissões que regem o acesso a eles. Consulte Metastore.
atribuição de metastores do databricks
Crie uma nova atribuição de metastore. Se existir uma atribuição para o mesmo workspace_id , ela será substituída pelo novo metastore_id e default_catalog_name. O chamador deve ser um administrador de conta.
databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]
Arguments
WORKSPACE_ID
Um ID do workspace.
METASTORE_ID
O ID exclusiva do metastore.
DEFAULT_CATALOG_NAME
Deprecated. Use a "Default Namespace API" para configurar o catálogo padrão para um ambiente de trabalho do Databricks. O nome do catálogo padrão no metastore.
Opções
--json JSON
A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.
Examples
O seguinte exemplo atribui um metastore a um workspace:
databricks metastores assign 123456789 abc123-def456-ghi789 main
criação de metastores do databricks
Crie um novo metastore com base em um nome fornecido e um caminho raiz de armazenamento opcional. Por padrão (se o campo proprietário não estiver definido), o proprietário do novo metastore será o usuário que está chamando a API createMetastore. Se o campo proprietário estiver definido como a cadeia de caracteres vazia (""), a propriedade será atribuída ao Usuário do Sistema.
databricks metastores create NAME [flags]
Arguments
NAME
Nome do metastore especificado pelo usuário.
Opções
--json JSON
A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.
--region string
Região de nuvem que o metastore atende (por exemplo, us-west-2, westus).
--storage-root string
A URL raiz de armazenamento do metastore.
Examples
O exemplo a seguir cria um metastore com um nome e uma raiz de armazenamento:
databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2
metastores atuais do databricks
Obtenha a atribuição de metastore para o workspace que está sendo acessado.
databricks metastores current [flags]
Opções
Examples
O seguinte exemplo obtém a atribuição de metastore atual:
databricks metastores current
exclusão de metastores do databricks
Exclua um metastore. É necessário que o chamador seja um administrador metastore.
databricks metastores delete ID [flags]
Arguments
ID
O ID exclusivo do metastore.
Opções
--force
Force a exclusão mesmo se o metastore não estiver vazio.
Examples
O exemplo a seguir exclui um metastore:
databricks metastores delete abc123-def456-ghi789
O exemplo a seguir exclui com força um metastore mesmo que não esteja vazio:
databricks metastores delete abc123-def456-ghi789 --force
obter metastores do databricks
Obtenha um metastore que corresponda ao ID fornecido. O chamador deve ser um administrador do metastore para recuperar essas informações.
databricks metastores get ID [flags]
Arguments
ID
O ID exclusivo do metastore.
Opções
Examples
O exemplo a seguir obtém informações sobre um metastore específico:
databricks metastores get abc123-def456-ghi789
Lista de Metastores do Databricks
Liste os metastores disponíveis. O chamador deve ser um administrador para recuperar essas informações. Não há garantia de uma ordenação específica dos itens na lista.
databricks metastores list [flags]
Opções
--max-results int
Número máximo de metastores 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.
Examples
O exemplo a seguir lista todos os metastores disponíveis:
databricks metastores list
O exemplo a seguir lista metastores com paginação:
databricks metastores list --max-results 10 --page-token abc123token
resumo de metastores do databricks
Obtenha informações resumidas sobre um metastore. Este resumo inclui a credencial de armazenamento, o fornecedor de nuvem, a região de nuvem e a ID global do metastore.
databricks metastores summary [flags]
Opções
Examples
O seguinte exemplo obtém um resumo do metastore:
databricks metastores summary
cancelar atribuição de metastores do databricks
Exclua uma atribuição de metastore. O chamador deve ser um administrador de conta.
databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]
Arguments
WORKSPACE_ID
Um ID do workspace.
METASTORE_ID
Obtenha o ID do metastore que será excluído.
Opções
Examples
O seguinte exemplo cancela a atribuição de um metastore de um workspace:
databricks metastores unassign 123456789 abc123-def456-ghi789
atualização de metastores do databricks
Atualize as informações de um metastore específico. O chamador deve ser um administrador do metastore. Se o campo proprietário estiver definido como a cadeia de caracteres vazia (""), a propriedade será atualizada para o usuário do sistema.
databricks metastores update ID [flags]
Arguments
ID
O ID exclusivo do metastore.
Opções
--delta-sharing-organization-name string
O nome da organização de uma entidade do Delta Sharing que será usada no Databricks-to-Databricks Delta Sharing como o nome oficial.
--delta-sharing-recipient-token-lifetime-in-seconds int
O tempo de vida do token de destinatário de compartilhamento delta em segundos.
--delta-sharing-scope DeltaSharingScopeEnum
O escopo do Compartilhamento Delta habilitado para o metastore. Valores com suporte: INTERNAL, INTERNAL_AND_EXTERNAL
--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 repositório de metadados.
--owner string
O proprietário do metastore.
--privilege-model-version string
Versão do modelo de privilégios do metastore, no formato major.minor (por exemplo, 1.0).
--storage-root-credential-id string
UUID da credencial de armazenamento para acessar o metastore storage_root.
Examples
O exemplo a seguir atualiza um nome metastore:
databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore
O exemplo a seguir atualiza um metastore com a configuração de compartilhamento Delta:
databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org
atualização de atribuição de metastores do databricks
Atualize uma atribuição de metastore. Essa operação pode ser usada para atualizar metastore_id ou default_catalog_name para um workspace especificado, se o workspace já estiver atribuído a um metastore. O chamador deve ser um administrador de conta para atualizar metastore_id; senão, o chamador pode ser um administrador do espaço de trabalho.
databricks metastores update-assignment WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
Um ID do workspace.
Opções
--default-catalog-name string
O nome do catálogo padrão no metastore.
--json JSON
A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.
--metastore-id string
O ID exclusiva do metastore.
Examples
O exemplo a seguir atualiza o catálogo padrão de uma atribuição metastore:
databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog
O seguinte exemplo atualiza o ID do metastore de uma atribuição de metastore:
databricks metastores update-assignment 123456789 --metastore-id new-metastore-id
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