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 credentials grupo de comandos dentro da CLI Databricks permite-lhe gerir credenciais para aceder a serviços no seu tenant cloud. Cada credencial está sujeita às políticas de controle de acesso do Catálogo Unity que controlam quais usuários e grupos podem acessar a credencial.
Uma credencial representa um mecanismo de autenticação e autorização para acessar serviços em seu locatário de nuvem. Para criar credenciais, você deve ser um administrador de conta Databricks ou ter o CREATE SERVICE CREDENTIAL privilégio. O usuário que cria a credencial pode delegar a propriedade a outro usuário ou grupo para gerenciar permissões nela.
credenciais de criação de credenciais databricks
Crie uma nova credencial. O tipo de credencial a ser criada é determinado pelo purpose campo, que deve ser ou SERVICESTORAGE.
O chamador deve ser um administrador de metastore ou ter o privilégio CREATE_STORAGE_CREDENTIAL de metastore para credenciais de armazenamento ou CREATE_SERVICE_CREDENTIAL para credenciais de serviço.
databricks credentials create-credential 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
--purpose CredentialPurpose
Indica a finalidade da credencial. Valores suportados: SERVICE, STORAGE
--read-only
Se a credencial é utilizável apenas para operações de leitura
--skip-validation
Optional
Examples
O exemplo a seguir cria uma credencial de serviço chamada my-service-cred:
databricks credentials create-credential my-service-cred --purpose SERVICE
O exemplo a seguir cria uma credencial de armazenamento somente leitura:
databricks credentials create-credential readonly-storage --purpose STORAGE --read-only
credenciais de exclusão de credenciais databricks
Exclua uma credencial de serviço ou armazenamento do metastore. O chamador deve ser um proprietário da credencial.
databricks credentials delete-credential NAME_ARG [flags]
Arguments
NAME_ARG
Nome da credencial
Opções
--force
Forçar uma atualização mesmo que existam serviços dependentes (quando a finalidade é SERVICE) ou locais externos dependentes e tabelas externas (quando a finalidade é STORAGE)
Examples
O exemplo a seguir exclui uma credencial chamada my-service-cred:
databricks credentials delete-credential my-service-cred
O exemplo a seguir força a exclusão de uma credencial com dependências:
databricks credentials delete-credential my-storage-cred --force
credenciais databricks gerar-credencial-de-serviço-temporária
Gere uma credencial de serviço temporária usando a credencial de serviço especificada. O chamador deve ser um administrador de metastore ou ter o privilégio ACCESS de metastore na credencial de serviço.
databricks credentials generate-temporary-service-credential CREDENTIAL_NAME [flags]
Arguments
CREDENTIAL_NAME
O nome da credencial de serviço usada para gerar uma credencial temporária
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 gera credenciais temporárias para uma credencial de serviço:
databricks credentials generate-temporary-service-credential my-service-cred
credenciais databricks obter-credencial
Obtenha uma credencial de serviço ou armazenamento do metastore. O chamador deve ser um administrador de metastore, o proprietário da credencial ou possuir algum tipo de permissão na credencial.
databricks credentials get-credential NAME_ARG [flags]
Arguments
NAME_ARG
Nome da credencial
Opções
Examples
O exemplo a seguir obtém informações sobre uma credencial chamada my-service-cred:
databricks credentials get-credential my-service-cred
Databricks listar credenciais
Lista credenciais. A lista é limitada apenas às credenciais 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 credentials list-credentials [flags]
Opções
--max-results int
Número máximo de credenciais a devolver
--page-token string
Token opaco para recuperar a próxima página de resultados
--purpose CredentialPurpose
Retorne apenas credenciais para a finalidade especificada. Valores suportados: SERVICE, STORAGE
Examples
O exemplo a seguir lista todas as credenciais:
databricks credentials list-credentials
O exemplo a seguir lista apenas credenciais de serviço:
databricks credentials list-credentials --purpose SERVICE
O exemplo a seguir lista credenciais com um máximo de 10 resultados:
databricks credentials list-credentials --max-results 10
Databricks atualizar-credencial
Atualize uma credencial de serviço ou armazenamento no metastore.
O chamador deve ser proprietário da credencial, administrador do metastore, ou possuir a permissão MANAGE. Se o chamador for um administrador de metastore, apenas o owner campo poderá ser alterado.
databricks credentials update-credential NAME_ARG [flags]
Arguments
NAME_ARG
Nome da credencial
Opções
--comment string
Comentário associado à credencial
--force
Forçar uma atualização mesmo que existam serviços dependentes (quando a finalidade é SERVICE) ou locais externos dependentes e tabelas externas (quando a finalidade é STORAGE)
--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 da credencial
--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
Forneça o valor verdadeiro a este argumento para ignorar a validação da credencial que foi atualizada.
Examples
O exemplo a seguir atualiza o comentário de uma credencial:
databricks credentials update-credential my-service-cred --comment "Updated service credential"
O exemplo a seguir renomeia uma credencial:
databricks credentials update-credential my-service-cred --new-name my-renamed-cred
O exemplo a seguir altera o proprietário de uma credencial:
databricks credentials update-credential my-service-cred --owner someone@example.com
O exemplo a seguir torna uma credencial somente leitura:
databricks credentials update-credential my-storage-cred --read-only
credenciais databricks validate-credential
Valide uma credencial.
Para credenciais de serviço (cujo propósito é SERVICE), deve ser fornecida ou a credential_name credencial ou a credencial específica da nuvem.
Para credenciais de armazenamento (a finalidade é STORAGE), pelo menos uma das external_location_name e url precisa ser fornecida. 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 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 ou ter a permissão necessária no metastore e na credencial (por exemplo, CREATE_EXTERNAL_LOCATION quando a finalidade é STORAGE).
databricks credentials validate-credential [flags]
Opções
--credential-name string
Required
--external-location-name string
O nome de um local externo existente para validar
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação
--purpose CredentialPurpose
A finalidade da credencial. Valores suportados: SERVICE, STORAGE
--read-only
Se a credencial só pode ser usada para operações de leitura
--url string
O URL da localização externa para validar
Examples
O exemplo a seguir valida uma credencial de serviço:
databricks credentials validate-credential --credential-name my-service-cred --purpose SERVICE
O exemplo a seguir valida uma credencial de armazenamento com um local externo:
databricks credentials validate-credential --credential-name my-storage-cred --purpose STORAGE --external-location-name my-external-location
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