Pular para o conteúdo principal

metastores 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 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.

Bandeiras globais

Exemplos

O exemplo a seguir atribui um metastore a um objeto de controle de versão ( workspace):

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir cria uma metastore com um nome e uma raiz de armazenamento:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir mostra a atribuição atual do metastore:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir exclui um metastore:

Bash
databricks metastores delete abc123-def456-ghi789

O exemplo a seguir exclui com força uma metastore, mesmo que ela não esteja vazia:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir obtém informações sobre um metastore específico:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir lista todas as metástores disponíveis:

Bash
databricks metastores list

O exemplo a seguir lista metástores com paginação:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir obtém um resumo do metastore:

Bash
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

Bandeiras globais

Exemplos

O exemplo a seguir desassocia um metastore de um workspace:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza o nome de um metastore:

Bash
databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore

O exemplo a seguir atualiza um metastore com a configuração Delta Sharing:

Bash
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.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza o catálogo default de uma atribuição de metastore:

Bash
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:

Bash
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