metastores
grupo de comando
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 metastores
dentro do Databricks CLI permite gerenciar metastores. Um metastore é o contêiner de nível superior dos objetos no Unity Catalog. Ele armazena dados ativos (tabelas e visualizações) e as permissões que controlam o acesso a eles. Veja Metastore.
atribuição de metástores de databricks
Crie uma nova tarefa de metastore. Se existir uma tarefa para o mesmo workspace_id
, ela será substituída pelos novos metastore_id
e default_catalog_name
. O autor da chamada deve ser um administrador do account.
databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]
Argumentos
WORKSPACE_ID
Identificação de um paciente com síndrome de imunodeficiência grave ( workspace ).
METASTORE_ID
O ID exclusivo da metastore.
DEFAULT_CATALOG_NAME
Obsoleto. Utilize o namespace padrão " API" para configurar o catálogo default para um Databricks workspace. O nome do catálogo " default " no metastore.
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
Exemplos
O exemplo a seguir atribui um metastore a um objeto de controle de versão ( workspace):
databricks metastores assign 123456789 abc123-def456-ghi789 main
metástores de databricks criam
Crie um novo metastore com base em um nome fornecido e no caminho raiz de armazenamento opcional. Por default (se o campo proprietário não estiver definido), o proprietário do novo metastore é o usuário que está chamando o createMetastore API. Se o campo proprietário estiver definido como uma string vazia (""
), a propriedade será atribuída ao usuário do sistema.
databricks metastores create NAME [flags]
Argumentos
NAME
O nome do metastore especificado pelo usuário.
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--region string
Região da nuvem que o metastore atende (por exemplo, us-west-2, westus).
--storage-root string
O URL raiz de armazenamento para metastore.
Exemplos
O exemplo a seguir cria uma 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 do metastore para o workspace que está sendo acessado.
databricks metastores current [flags]
Opções
Exemplos
O exemplo a seguir mostra a atribuição atual do metastore:
databricks metastores current
databricks metastores excluir
Exclua uma metastore. O chamador deve ser um administrador da metastore.
databricks metastores delete ID [flags]
Argumentos
ID
ID exclusivo da metastore.
Opções
--force
Força a exclusão mesmo que o metastore não esteja vazio.
Exemplos
O exemplo a seguir exclui um metastore:
databricks metastores delete abc123-def456-ghi789
O exemplo a seguir exclui com força uma metastore, mesmo que ela não esteja vazia:
databricks metastores delete abc123-def456-ghi789 --force
databricks metastores obtêm
Obtenha uma metastore que corresponda ao ID fornecido. O chamador deve ser um administrador da metastore para recuperar essas informações.
databricks metastores get ID [flags]
Argumentos
ID
ID exclusivo da metastore.
Opções
Exemplos
O exemplo a seguir obtém informações sobre um metastore específico:
databricks metastores get abc123-def456-ghi789
lista de metástores do databricks
Liste as metástores disponíveis. O chamador deve ser um administrador para recuperar essas informações. Não há garantia de um pedido específico dos itens da lista.
databricks metastores list [flags]
Opções
--max-results int
Número máximo de metástores 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.
Exemplos
O exemplo a seguir lista todas as metástores disponíveis:
databricks metastores list
O exemplo a seguir lista metástores com paginação:
databricks metastores list --max-results 10 --page-token abc123token
resumo das metástores do databricks
Obter informações resumidas sobre um metastore. Esse resumo inclui a credencial de armazenamento, o fornecedor da nuvem, a região da nuvem e a ID global da metastore.
databricks metastores summary [flags]
Opções
Exemplos
O exemplo a seguir obtém um resumo do metastore:
databricks metastores summary
As metástores do databricks não são atribuídas
Exclua uma tarefa de metastore. O autor da chamada deve ser um administrador do account.
databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]
Argumentos
WORKSPACE_ID
Identificação de um paciente com síndrome de imunodeficiência grave ( workspace ).
METASTORE_ID
Consulte o ID do metastore a ser excluído.
Opções
Exemplos
O exemplo a seguir desassocia um metastore de um workspace:
databricks metastores unassign 123456789 abc123-def456-ghi789
atualização de metastores do databricks
Atualizar informações para um metastore específico. O chamador deve ser um administrador da metastore. Se o campo proprietário estiver definido como uma string vazia (""
), a propriedade será atualizada para o usuário do sistema.
databricks metastores update ID [flags]
Argumentos
ID
ID exclusivo da metastore.
Opções
--delta-sharing-organization-name string
O nome da organização de uma entidade Delta Sharing, a ser utilizado em Databricks-to-Databricks Delta Sharing como nome oficial.
--delta-sharing-recipient-token-lifetime-in-seconds int
A duração dos tokens do destinatário delta compartilhamento em segundos.
--delta-sharing-scope DeltaSharingScopeEnum
O escopo do Delta Sharing habilitado para o metastore. Valores suportados: INTERNAL
, INTERNAL_AND_EXTERNAL
--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 a metastore.
--owner string
O dono da metastore.
--privilege-model-version string
Versão do modelo Privilege do metastore, na forma major.minor (por exemplo, 1.0).
--storage-root-credential-id string
UUID da credencial de armazenamento para acessar o metastore storage_root.
Exemplos
O exemplo a seguir atualiza o nome de um 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
atribuição de atualização de metástores do databricks
Atualize uma atribuição de metastore. Essas operações podem ser utilizadas para atualizar metastore_id
ou default_catalog_name
para um workspace especificado, caso o workspace já tenha um metastore atribuído. O autor da chamada deve ser um administrador do account para atualizar metastore_id
; caso contrário, o autor da chamada pode ser um administrador do workspace.
databricks metastores update-assignment WORKSPACE_ID [flags]
Argumentos
WORKSPACE_ID
Identificação de um paciente com síndrome de imunodeficiência grave ( workspace ).
Opções
--default-catalog-name string
O nome do catálogo default no metastore.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--metastore-id string
O ID exclusivo da metastore.
Exemplos
O exemplo a seguir atualiza o catálogo default de uma atribuição de metastore:
databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog
O exemplo a seguir atualiza o ID de metastore de uma atribuição de metastore:
databricks metastores update-assignment 123456789 --metastore-id new-metastore-id
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