external-locations 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 external-locations dentro do Databricks CLI contém comandos para criar e gerenciar locais externos para o Unity Catalog. Consulte O que são volumes de armazenamento de dados do Microsoft ( Unity Catalog )?.
locais externos criados por databricks
Crie uma nova entrada de localização externa no metastore. O chamador deve ser administrador da metastore ou ter o privilégio CREATE_EXTERNAL_LOCATION na metastore e na credencial de armazenamento associada.
databricks external-locations create NAME URL CREDENTIAL_NAME [flags]
Argumentos
NAME
Nome do local externo.
URL
URL do caminho do local externo.
CREDENTIAL_NAME
Nome da credencial de armazenamento usada com esse local.
Opções
--comment string
Descrição de texto em formato livre fornecida pelo usuário.
--enable-file-events
Se os eventos de arquivo devem ser ativados nesse local externo.
--fallback
Indica se o modo de fallback está habilitado para este local externo.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--read-only
Indica se o local externo é somente para leitura.
--skip-validation
Ignora a validação da credencial de armazenamento associada ao local externo.
Exemplos
O exemplo a seguir cria um local externo com um comentário:
databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"
O exemplo a seguir cria um local externo somente para leitura:
databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only
deletar localizações externas do databricks
Exclua o local externo especificado do metastore. O chamador deve ser o proprietário do local externo.
databricks external-locations delete NAME [flags]
Argumentos
NAME
Nome do local externo.
Opções
--force
Força a exclusão mesmo se houver tabelas ou montagens externas dependentes.
Exemplos
O exemplo a seguir exclui um local externo chamado my-external-location:
databricks external-locations delete my-external-location
O exemplo a seguir exclui com força um local externo, mesmo que haja dependências:
databricks external-locations delete my-external-location --force
localizações externas do databricks obtêm
Obtenha uma localização externa da metastore. O chamador deve ser um administrador da metastore, o proprietário do local externo ou um usuário que tenha algum privilégio no local externo.
databricks external-locations get NAME [flags]
Argumentos
NAME
Nome do local externo.
Opções
--include-browse
Se deve incluir locais externos na resposta para os quais o diretor só pode acessar metadados seletivos.
Exemplos
O exemplo a seguir obtém informações sobre um local externo denominado my-external-location:
databricks external-locations get my-external-location
O exemplo a seguir obtém informações, incluindo metadados de navegação:
databricks external-locations get my-external-location --include-browse
lista de localizações externas do databricks
Liste os locais externos do metastore. O chamador deve ser um administrador da metastore, o proprietário do local externo ou um usuário que tenha algum privilégio no local externo. Não há garantia de uma ordem específica dos elementos na matriz.
databricks external-locations list [flags]
Opções
--include-browse
Se deve incluir locais externos na resposta para os quais o diretor só pode acessar metadados seletivos.
--max-results int
Número máximo de locais externos a serem devolvidos.
--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 todos os locais externos:
databricks external-locations list
O exemplo a seguir lista locais externos com no máximo 10 resultados:
databricks external-locations list --max-results 10
atualização de localizações externas do databricks
Atualize um local externo na metastore. O chamador deve ser o proprietário do local externo ou ser um administrador da metastore. No segundo caso, o administrador só pode atualizar o nome do local externo.
databricks external-locations update NAME [flags]
Argumentos
NAME
Nome do local externo.
Opções
--comment string
Descrição de texto em formato livre fornecida pelo usuário.
--credential-name string
Nome da credencial de armazenamento usada com esse local.
--enable-file-events
Se os eventos de arquivo devem ser ativados nesse local externo.
--fallback
Indica se o modo de fallback está habilitado para este local externo.
--force
Força a atualização mesmo que a alteração do URL invalide tabelas ou montagens externas dependentes.
--isolation-mode IsolationMode
Valores suportados: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN
--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 local externo.
--owner string
O proprietário do local externo.
--read-only
Indica se o local externo é somente para leitura.
--skip-validation
Ignora a validação da credencial de armazenamento associada ao local externo.
--url string
URL do caminho do local externo.
Exemplos
O exemplo a seguir renomeia um local externo:
databricks external-locations update my-external-location --new-name my-renamed-location
O exemplo a seguir altera o proprietário de um local externo:
databricks external-locations update my-external-location --owner someone@example.com
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