Compartilhar via


Grupo de comandos recipients

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 recipients grupo de comando dentro da CLI do Databricks contém comandos para gerenciar destinatários de compartilhamento no Unity Catalog. Confira O que é o Compartilhamento Delta?.

criar destinatários do databricks

Crie um novo destinatário com o tipo de autenticação delta sharing no metastore. O chamador deve ser um administrador do metastore ou ter o CREATE_RECIPIENT privilégio no metastore.

databricks recipients create NAME AUTHENTICATION_TYPE [flags]

Arguments

NAME

    Nome do destinatário.

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 destinatário.

--data-recipient-global-metastore-id string

    O ID global do metastore do Unity Catalog fornecido pelo destinatário de dados.

--expiration-time int

    Carimbo de data/hora de expiração do token, em milissegundos de época.

--json JSON

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

--owner string

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

--sharing-code string

    O código de compartilhamento único fornecido pelo destinatário de dados.

Sinalizadores globais

excluir destinatários do databricks

Exclua o destinatário especificado do metastore. O chamador deve ser o proprietário do destinatário.

databricks recipients delete NAME [flags]

Arguments

NAME

    Nome do destinatário.

Opções

Sinalizadores globais

destinatários do Databricks recebem

Obtenha do metastore um destinatário de compartilhamento se:

  • o chamador é o proprietário do destinatário do compartilhamento,
  • ou é um administrador do metastore.
databricks recipients get NAME [flags]

Arguments

NAME

    Nome do destinatário.

Opções

Sinalizadores globais

lista de destinatários do databricks

Liste todos os destinatários de compartilhamento no metastore atual em que:

  • o chamador é um administrador metastore,
  • ou o chamador é o proprietário.

Não há garantia de uma ordenação específica dos elementos na matriz.

databricks recipients list [flags]

Arguments

None

Opções

--data-recipient-global-metastore-id string

    Se não for fornecido, todos os destinatários serão retornados.

--max-results int

    O número máximo de destinatários a ser retornado.

--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

databricks destinatários rotate-token

Gire o token de autenticação de compartilhamento delta do destinatário especificado com as informações de token fornecidas. O chamador deve ser o proprietário do destinatário.

databricks recipients rotate-token NAME EXISTING_TOKEN_EXPIRE_IN_SECONDS [flags]

Arguments

NAME

    O nome do Destinatário.

EXISTING_TOKEN_EXPIRE_IN_SECONDS

    A hora de expiração do token de portador no formato ISO 8601. Isso definirá o tempo de expiração do token existente somente para um carimbo de data/hora menor; ele não é capaz de estender o tempo de expiração. Use 0 para expirar o token existente imediatamente, o número negativo retornará um erro.

Opções

--json JSON

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

Sinalizadores globais

atualização de destinatários do databricks

Atualize um destinatário existente no metastore. O chamador deve ser um administrador metastore ou o proprietário do destinatário. Se o nome do destinatário for atualizado, o usuário deverá ser um administrador do metastore e o proprietário do destinatário.

databricks recipients update NAME [flags]

Arguments

NAME

    Nome do destinatário.

Opções

--comment string

    Descrição sobre o destinatário.

--expiration-time int

    Carimbo de data/hora de expiração do token, em milissegundos de época.

--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 destinatário.

--owner string

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

Sinalizadores globais

permissões de compartilhamento com destinatários do databricks

Obtenha as permissões de compartilhamento para o destinatário especificado. O chamador deve ser um administrador metastore ou o proprietário do destinatário.

databricks recipients share-permissions NAME [flags]

Arguments

NAME

    O nome do destinatário.

Opções

--max-results int

    Número máximo de permissões 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

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