Pular para o conteúdo principal

recipients grupo de comando

nota

Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.

Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.

O grupo de comandos recipients dentro do Databricks CLI contém comandos para gerenciar destinatários de compartilhamentos no Unity Catalog. Consulte O que é o Delta Sharing?

destinatários do databricks criam

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

databricks recipients create NAME AUTHENTICATION_TYPE [flags]

Argumentos

NAME

Nome do destinatário.

AUTHENTICATION_TYPE

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

Opções

--comment string

Descrição sobre o destinatário.

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

O identificador global do metastore Unity Catalog fornecido pelo destinatário dos dados.

--expiration-time int

Carimbo de data e hora de expiração dos tokens, em milissegundos da época.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--owner string

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

--sharing-code string

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

Bandeiras globais

destinatários do databricks excluem

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

databricks recipients delete NAME [flags]

Argumentos

NAME

Nome do destinatário.

Opções

Bandeiras globais

os destinatários do databricks recebem

Obtenha um destinatário do compartilhamento da metastore se:

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

Argumentos

NAME

Nome do destinatário.

Opções

Bandeiras globais

lista de destinatários do databricks

Liste todos os destinatários de ações na metastore atual, onde:

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

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

databricks recipients list [flags]

Argumentos

Nenhuma

Opções

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

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

--max-results int

Número máximo de destinatários a serem devolvidos.

--page-token string

Tokens de paginação opacos para avançar para a próxima página com base na consulta anterior.

Bandeiras globais

destinatários do databricks tokens rotativos

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

databricks recipients rotate-token NAME EXISTING_TOKEN_EXPIRE_IN_SECONDS [flags]

Argumentos

NAME

O nome do destinatário.

EXISTING_TOKEN_EXPIRE_IN_SECONDS

O prazo de validade dos tokens portadores no formato ISO 8601. Isso definirá o expiration_time dos tokens existentes apenas para um timestamp menor, não podendo estender o expiration_time. Utilize 0 para expirar os tokens existentes imediatamente; um número negativo retornará um erro.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

atualização de destinatários do databricks

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

databricks recipients update NAME [flags]

Argumentos

NAME

Nome do destinatário.

Opções

--comment string

Descrição sobre o destinatário.

--expiration-time int

Carimbo de data e hora de expiração dos tokens, em milissegundos da época.

--json JSON

As cadeias de caracteres JSON ou o caminho @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 do destinatário.

Bandeiras globais

permissões de compartilhamento de destinatários do databricks

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

databricks recipients share-permissions NAME [flags]

Argumentos

NAME

O nome do destinatário.

Opções

--max-results int

Número máximo de permissões para retornar.

--page-token string

Tokens de paginação opacos para avançar para a próxima página com base na consulta anterior.

Bandeiras globais

Bandeiras globais

--debug

Se deve habilitar o registro de depuração.

-h ou --help

Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.

--log-format Formato

O tipo de formato do log, text ou json. O valor de default é text.

--log-level string

Uma string que representa o nível de formato do log. Se não for especificado, o nível de formato do log será desativado.

-o, --output Tipo

O tipo de saída do comando, text ou json. O valor de default é text.

-p, --profile string

O nome do perfil no arquivo ~/.databrickscfg a ser utilizado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil chamado DEFAULT será usado.

--progress-format Formato

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

-t, --target string

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