Compartilhar via


Grupo de comandos providers

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em 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 provisionamentos de Dados de Uso.

O providers grupo de comandos dentro da CLI do Databricks contém comandos para gerenciar provedores de compartilhamento Delta. Um provedor de dados representa a organização no mundo real que compartilha os dados. Confira O que é o Compartilhamento Delta?.

Databricks criar provedores

Crie um novo provedor de autenticação minimamente com base em um nome e tipo de autenticação. O chamador deve ser um administrador no metastore.

databricks providers create NAME AUTHENTICATION_TYPE [flags]

Arguments

NAME

    O nome do fornecedor.

AUTHENTICATION_TYPE

    O tipo de autenticação do compartilhamento delta. Valores com suporte: DATABRICKS, OAUTH_CLIENT_CREDENTIALS, OIDC_FEDERATION, TOKEN

Opções

--comment string

    Descrição sobre o provedor.

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--recipient-profile-str string

    Esse campo é necessário quando o authentication_type é TOKEN, OAUTH_CLIENT_CREDENTIALS ou não fornecido.

Sinalizadores globais

Examples

O exemplo a seguir cria um provedor com autenticação TOKEN:

databricks providers create my_provider TOKEN --comment "My data provider" --recipient-profile-str "my_profile"

O exemplo a seguir cria um provedor com autenticação DATABRICKS:

databricks providers create my_provider DATABRICKS --comment "Internal provider"

exclusão de provedores do Databricks

Exclua um provedor de autenticação, se o chamador for um administrador metastore ou for o proprietário do provedor.

databricks providers delete NAME [flags]

Arguments

NAME

    Nome do provedor.

Opções

Sinalizadores globais

Examples

O exemplo a seguir exclui um provedor:

databricks providers delete my_provider

os provedores do databricks obtêm

Obtenha um provedor de autenticação específico. O chamador deve fornecer o nome do provedor e deve ser um administrador de metastore ou o proprietário do provedor.

databricks providers get NAME [flags]

Arguments

NAME

    Nome do provedor.

Opções

Sinalizadores globais

Examples

O exemplo a seguir obtém detalhes de um provedor:

databricks providers get my_provider

Lista de provedores do Databricks

Listar provedores de autenticação disponíveis. O chamador deve ser um administrador metastore ou o proprietário dos provedores. Provedores não pertencentes ao chamador não são incluídos na resposta. Não há garantia de uma ordenação específica dos elementos na matriz.

databricks providers list [flags]

Opções

--data-provider-global-metastore-id string

    Se não for fornecido, todos os provedores serão retornados.

--max-results int

    Número máximo de provedores a serem retornados.

--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 todos os provedores:

databricks providers list

O exemplo a seguir lista provedores com paginação:

databricks providers list --max-results 10

O exemplo a seguir lista provedores para um metastore específico:

databricks providers list --data-provider-global-metastore-id "my-metastore-id"

provedores databricks list-provider-share-assets

Liste ativos associados ao compartilhamento de um provedor especificado. O chamador é o destinatário do compartilhamento.

databricks providers list-provider-share-assets PROVIDER_NAME SHARE_NAME [flags]

Arguments

PROVIDER_NAME

    O nome do provedor que possui o compartilhamento.

SHARE_NAME

    O nome do compartilhamento.

Opções

--function-max-results int

    Número máximo de funções a serem retornadas.

--notebook-max-results int

    Número máximo de notebooks a serem retornados.

--table-max-results int

    Número máximo de tabelas a serem retornadas.

--volume-max-results int

    Número máximo de volumes a serem retornados.

Sinalizadores globais

Examples

O exemplo a seguir lista todos os ativos no compartilhamento de um provedor:

databricks providers list-provider-share-assets my_provider my_share

O exemplo a seguir lista ativos com limites em cada tipo:

databricks providers list-provider-share-assets my_provider my_share --table-max-results 5 --function-max-results 3

lista de compartilhamentos de provedores do databricks

Liste os compartilhamentos do provedor especificado dentro do metastore onde:

  • o chamador é um administrador metastore,
  • ou o chamador é o proprietário.
databricks providers list-shares NAME [flags]

Arguments

NAME

    Nome do provedor no qual listar compartilhamentos.

Opções

--max-results int

    Número máximo de compartilhamentos a serem retornados.

--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 todos os compartilhamentos de um provedor:

databricks providers list-shares my_provider

O exemplo a seguir lista compartilhamentos com paginação:

databricks providers list-shares my_provider --max-results 10

atualização dos provedores do Databricks

Atualize as informações de um provedor de autenticação, se o chamador for um administrador do metastore ou for o proprietário do provedor. Se a atualização alterar o nome do provedor, o chamador deverá ser um administrador metastore e o proprietário do provedor.

databricks providers update NAME [flags]

Arguments

NAME

    Nome do provedor.

Opções

--comment string

    Descrição sobre o provedor.

--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 o provedor.

--owner string

    Nome de usuário do proprietário do provedor.

--recipient-profile-str string

    Esse campo é necessário quando o authentication_type é TOKEN, OAUTH_CLIENT_CREDENTIALS ou não fornecido.

Sinalizadores globais

Examples

O exemplo a seguir atualiza o comentário de um provedor:

databricks providers update my_provider --comment "Updated provider description"

O exemplo a seguir atualiza o nome e o proprietário de um provedor:

databricks providers update my_provider --new-name "my_new_provider" --owner "new_owner@example.com"

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 de comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg para usar ao executar o 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