Grupo de comandos storage-credentials

O storage-credentials grupo de comandos dentro do CLI do Databricks contém comandos para gerenciar 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 a políticas de controle de acesso do Catálogo do 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 Catálogo do Unity, a solicitação falhará e o Catálogo do Unity não tentará autenticar seu locatário de nuvem em nome do usuário. Confira 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 de serviço dentro do metastore.

Opções

--comment string

    Comentário associado à credencial.

--json JSON

    A cadeia de caracteres JSON inserida em linha 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

    Fornecer o valor true a esse argumento ignora a validação da credencial criada.

Sinalizadores globais

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

databricks storage-credentials delete

Exclua uma credencial de armazenamento do metastore. O chamador deve ser o proprietário da credencial de armazenamento.

databricks storage-credentials delete NAME [flags]

Arguments

NAME

    Nome da credencial de armazenamento.

Opções

--force

    Force uma atualização mesmo que existam localizações externas ou tabelas externas dependentes (quando o propósito for STORAGE) ou serviços dependentes (quando o propósito for SERVICE).

Sinalizadores globais

Examples

O exemplo a seguir exclui uma credencial de armazenamento:

databricks storage-credentials delete my-storage-credential

O exemplo a seguir demonstra como excluir forçadamente uma credencial de armazenamento.

databricks storage-credentials delete my-storage-credential --force

obter credenciais de armazenamento do databricks

Obtenha uma credencial de armazenamento do metastore. O chamador deve ser um administrador 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

Sinalizadores globais

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 do 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 do metastore, a recuperação de credenciais será irrestrita. 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 não transparente que permite ir para a próxima página com base na consulta anterior.

Sinalizadores globais

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 de um administrador do metastore. Se o chamador for um administrador do metastore, somente 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

    Force atualização mesmo que existam localizações externas ou tabelas externas dependentes.

--isolation-mode IsolationMode

    Se o protegível atual é acessível a partir de todos os workspaces ou de um conjunto específico de workspaces. Valores com suporte: [MODO_ISOLAMENTO_ISOLADO, MODO_ISOLAMENTO_ABERTO]

--json JSON

    A cadeia de caracteres JSON inserida em linha 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

    Ao fornecer true para este argumento, a validação da credencial atualizada é ignorada.

Sinalizadores globais

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

Comando para validar as credenciais de armazenamento no Databricks: databricks storage-credentials validate

Valide uma credencial de armazenamento. Pelo menos um dos parâmetros external_location_name ou url deve 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.

É necessário fornecer a credencial storage_credential_name ou a credencial específica da nuvem.

O chamador deve ser um administrador do 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 uma localização externa existente a ser validada.

--json JSON

    A cadeia de caracteres JSON inserida em linha 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 de localização externa para validar.

Sinalizadores globais

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 contra uma URL:

databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

    Exiba ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.

--log-file corda

    Uma cadeia de caracteres que representa o arquivo para o qual gravar logs de saída. Se esse sinalizador não for especificado, o padrão será gravar logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    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á desabilitado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg para usar na execução do comando. Se esse sinalizador não for especificado, se existir, o perfil nomeado DEFAULT será usado.

--progress-format formato

    O formato para exibir logs de progresso: default, append, inplace, ou json

-t, --target corda

    Se aplicável, o destino do pacote a ser usado