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 storage-credentials grupo de comandos dentro da CLI Databricks contém comandos para gerir credenciais de armazenamento no Unity Catalog. Uma credencial de armazenamento representa um mecanismo de autenticação e autorização para acessar dados armazenados em seu locatário de nuvem. Cada credencial de armazenamento está sujeita às políticas de controle de acesso do Catálogo Unity que controlam quais usuários e grupos podem acessar a credencial. Se um usuário não tiver acesso a uma credencial de armazenamento no Unity Catalog, a solicitação falhará e o Unity Catalog não tentará autenticar seu locatário de nuvem em nome do usuário. Consulte Gerenciar credenciais de armazenamento.
Criar credenciais de armazenamento do Databricks
Crie uma nova credencial de armazenamento.
O chamador deve ser um administrador do metastore ou ter o CREATE_STORAGE_CREDENTIAL privilégio no metastore.
databricks storage-credentials create NAME [flags]
Arguments
NAME
O nome da credencial. O nome deve ser exclusivo entre as credenciais de armazenamento e serviço dentro do metastore.
Opções
--comment string
Comentário associado à credencial.
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
--read-only
Se a credencial é utilizável apenas para operações de leitura.
--skip-validation
O fornecimento de true para este argumento ignora a validação da credencial criada.
Examples
O exemplo a seguir cria uma nova credencial de armazenamento:
databricks storage-credentials create my-storage-credential
O exemplo a seguir cria uma credencial de armazenamento com um comentário:
databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"
O exemplo a seguir cria uma credencial de armazenamento somente leitura:
databricks storage-credentials create my-storage-credential --read-only
Apague credenciais de armazenamento do Databricks
Exclua uma credencial de armazenamento do metastore. O chamador deve ser proprietário da credencial de armazenamento.
databricks storage-credentials delete NAME [flags]
Arguments
NAME
Nome da credencial de armazenamento.
Opções
--force
Forçar uma atualização mesmo que existam locais externos ou tabelas externas dependentes (quando a finalidade é STORAGE) ou serviços dependentes (quando a finalidade é SERVICE).
Examples
O exemplo a seguir exclui uma credencial de armazenamento:
databricks storage-credentials delete my-storage-credential
O exemplo a seguir elimina à força uma credencial de armazenamento:
databricks storage-credentials delete my-storage-credential --force
Obter as credenciais de armazenamento do Databricks
Obtenha uma credencial de armazenamento do metastore. O chamador deve ser um administrador de metastore, o proprietário da credencial de armazenamento ou ter alguma permissão na credencial de armazenamento.
databricks storage-credentials get NAME [flags]
Arguments
NAME
Nome da credencial de armazenamento.
Opções
Examples
O exemplo a seguir obtém informações sobre uma credencial de armazenamento:
databricks storage-credentials get my-storage-credential
Lista de credenciais de armazenamento da Databricks
Listar credenciais de armazenamento. A lista é limitada apenas às credenciais de armazenamento que o chamador tem permissão para acessar. Se o chamador for um administrador de metastore, a recuperação de credenciais não terá restrições. Não há garantia de uma ordenação específica dos elementos na matriz.
databricks storage-credentials list [flags]
Opções
--max-results int
Número máximo de credenciais de armazenamento a serem retornadas.
--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 todas as credenciais de armazenamento:
databricks storage-credentials list
Atualização de credenciais de armazenamento do Databricks
Atualize uma credencial de armazenamento no metastore.
O chamador deve ser o proprietário da credencial de armazenamento ou um administrador de metastore. Se o chamador for um administrador de metastore, apenas o owner campo poderá ser alterado.
databricks storage-credentials update NAME [flags]
Arguments
NAME
Nome da credencial de armazenamento.
Opções
--comment string
Comentário associado à credencial.
--force
Forçar a atualização mesmo que haja locais externos dependentes ou tabelas externas.
--isolation-mode IsolationMode
Se o objeto protegível atual é acessível a partir de todos os espaços de trabalho ou apenas de um conjunto específico deles. Valores suportados: [ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN]
--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 a credencial de armazenamento.
--owner string
Nome de usuário do proprietário atual da credencial.
--read-only
Se a credencial é utilizável apenas para operações de leitura.
--skip-validation
Introduzir o valor true para este argumento ignora a validação da credencial atualizada.
Examples
O exemplo a seguir atualiza o comentário de uma credencial de armazenamento:
databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"
O exemplo a seguir altera o proprietário de uma credencial de armazenamento:
databricks storage-credentials update my-storage-credential --owner someone@example.com
O exemplo a seguir renomeia uma credencial de armazenamento:
databricks storage-credentials update my-storage-credential --new-name updated-credential
As credenciais de armazenamento do Databricks validam
Valide uma credencial de armazenamento. Pelo menos um dos external_location_name e url precisa ser fornecido. Se apenas um deles for fornecido, ele será usado para validação. E se ambos forem fornecidos, o url será usado para validação e external_location_name será ignorado ao verificar urls sobrepostas.
Ou a storage_credential_name ou a credencial específica da nuvem deve ser fornecida.
O chamador deve ser um administrador de metastore ou o proprietário da credencial de armazenamento ou ter o CREATE_EXTERNAL_LOCATION privilégio no metastore e na credencial de armazenamento.
databricks storage-credentials validate [flags]
Opções
--external-location-name string
O nome de um local externo existente a ser validado.
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
--read-only
Se a credencial de armazenamento só pode ser usada para operações de leitura.
--storage-credential-name string
Required.
--url string
A url do local externo a ser validada.
Examples
O exemplo a seguir valida uma credencial de armazenamento em um local externo:
databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location
O exemplo a seguir valida uma credencial de armazenamento em relação a uma URL:
databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path
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