Partilhar via


recipients 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 recipients grupo de comandos dentro da CLI Databricks contém comandos para gerir destinatários de partilha no Unity Catalog. Consulte O que é Delta Sharing?.

Os destinatários do Databricks criam

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 Delta Sharing. 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

    A ID do metastore global do Unity Catalog fornecida pelo destinatário dos dados.

--expiration-time int

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

--json JSON

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

--owner string

    Nome de utilizador 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]

Arguments

NAME

    Nome do destinatário.

Opções

Bandeiras globais

Os destinatários do Databricks obtêm

Obtenha um destinatário de compartilhamento do metastore se:

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

Arguments

NAME

    Nome do destinatário.

Opções

Bandeiras globais

Lista de destinatários do Databricks

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

  • o chamador é um administrador de 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 devolvidos.

--max-results int

    Número máximo de destinatários a devolver.

--page-token string

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

Bandeiras 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

    O tempo de expiração do token ao portador no formato ISO 8601. Isso definirá o tempo de expiração do token existente apenas para um carimbo de data/hora menor, sendo impossível 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 embutida ou o @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 no metastore. O chamador deve ser um administrador de metastore ou o proprietário do destinatário. Se o nome do destinatário for atualizado, o usuário deverá ser um administrador de 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 embutida 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 utilizador do proprietário do destinatário.

Bandeiras globais

Permissões de compartilhamento dos destinatários do Databricks

Obtenha as permissões de compartilhamento para o destinatário especificado. O chamador deve ser um administrador de 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 para devolução.

--page-token string

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

Bandeiras globais

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