Partilhar via


credentials grupo de comando

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

Bandeiras globais

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)

Bandeiras globais

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

Bandeiras globais

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

Bandeiras globais

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

Bandeiras globais

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.

Bandeiras globais

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

Bandeiras globais

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