Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Note
Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-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 disposições de Dados de Uso.
O metastores grupo de comandos dentro da CLI Databricks permite-lhe gerir metastores. Um metastore é o contêiner de nível superior de objetos no Unity Catalog. Ele armazena ativos de dados (tabelas e exibições) e as permissões que regem o acesso a eles. Consulte Metastore.
Atribuir 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 identificador de espaço de trabalho.
METASTORE_ID
O ID único do metastore.
DEFAULT_CATALOG_NAME
Deprecated. Use "Default Namespace API" para configurar o catálogo padrão para um espaço de trabalho Databricks. O nome do catálogo padrão no metastore.
Opções
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
Examples
O exemplo a seguir atribui um metastore a um espaço de trabalho:
databricks metastores assign 123456789 abc123-def456-ghi789 main
Criação de metastores 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 é o usuário que chama 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
O nome especificado pelo utilizador do metastore.
Opções
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
--region string
Região da nuvem que o metastore serve (por exemplo, us-west-2, westus).
--storage-root string
O URL de 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
Databricks Metastores Atuais
Obtenha a atribuição de metastore para o espaço de trabalho que está sendo acessado.
databricks metastores current [flags]
Opções
Examples
O exemplo a seguir obtém a atribuição de metastore atual:
databricks metastores current
Exclusão de metastores do Databricks
Exclua um metastore. O chamador deve ser um administrador de metastore.
databricks metastores delete ID [flags]
Arguments
ID
ID exclusivo do metastore.
Opções
--force
Forçar a eliminação mesmo que o metastore não esteja 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 ele não esteja vazio:
databricks metastores delete abc123-def456-ghi789 --force
Os metastores Databricks obtêm
Obtenha um metastore que corresponda ao ID fornecido. O chamador deve ser um administrador de metastore para recuperar essas informações.
databricks metastores get ID [flags]
Arguments
ID
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 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 devolver.
--page-token string
Token de paginação opaco para avançar 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 seguinte lista metastores com paginação:
databricks metastores list --max-results 10 --page-token abc123token
Resumo dos metastores do Databricks
Obtenha informações resumidas sobre um metastore. Este resumo inclui a credencial de armazenamento, o fornecedor da nuvem, a região da nuvem e o ID do metastore global.
databricks metastores summary [flags]
Opções
Examples
O exemplo a seguir obtém um resumo do metastore:
databricks metastores summary
Desatribuir 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 identificador de espaço de trabalho.
METASTORE_ID
Consultar o ID do metastore a ser eliminado.
Opções
Examples
O exemplo a seguir cancela a atribuição de um metastore de um espaço de trabalho:
databricks metastores unassign 123456789 abc123-def456-ghi789
Atualização dos Metastores do Databricks
Atualizar dados de um metastore específico. O chamador deve ser um administrador de 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
ID exclusivo do metastore.
Opções
--delta-sharing-organization-name string
O nome da organização de uma entidade Delta Sharing, a ser usado 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 âmbito do Delta Sharing ativado para o metastore. Valores suportados: INTERNAL, INTERNAL_AND_EXTERNAL
--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 metastore.
--owner string
O proprietário do metastore.
--privilege-model-version string
Versão do modelo de privilégio do metastore, no formato maior.menor (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 de metastore:
databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore
O exemplo a seguir atualiza um metastore com a configuração Delta Sharing:
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. Esta operação pode ser usada para atualizar metastore_id ou default_catalog_name para um espaço de trabalho especificado, se o espaço de trabalho já tiver um metastore atribuído. O chamador deve ser um administrador de conta para atualizar metastore_id, caso contrário, o chamador pode ser um administrador de espaço de trabalho.
databricks metastores update-assignment WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
Um identificador de espaço de trabalho.
Opções
--default-catalog-name string
O nome do catálogo padrão no metastore.
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
--metastore-id string
O ID único do metastore.
Examples
O exemplo a seguir atualiza o catálogo padrão de uma atribuição de metastore:
databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog
O exemplo a seguir atualiza a ID do metastore de uma atribuição de metastore:
databricks metastores update-assignment 123456789 --metastore-id new-metastore-id
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