Aller au contenu principal

groupe de commandesrecipients

remarque

L'utilisation de Databricks CLI est soumise à la licence Databricks et à la politique de confidentialité Databricks, y compris toutes les dispositions relatives aux données d'utilisation.

Le groupe de commandes recipients au sein de la CLI Databricks contient des commandes pour gérer les destinataires de partages dans Unity Catalog. Consultez Qu'est-ce que OpenSharing ?

créer des destinataires Databricks

Créez un nouveau destinataire avec le type d'authentification OpenSharing dans le metastore. L'appelant doit être un administrateur de metastore ou disposer du privilège CREATE_RECIPIENT sur le metastore.

databricks recipients create NAME AUTHENTICATION_TYPE [flags]

Arguments

NAME

Nom du destinataire.

AUTHENTICATION_TYPE

Le type d'authentification OpenSharing. Valeurs prises en charge : DATABRICKS, OAUTH_CLIENT_CREDENTIALS, OIDC_FEDERATION, TOKEN

Options

--comment string

Description du destinataire.

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

L'identifiant global du metastore Unity Catalog fourni par le destinataire des données.

--expiration-time int

Timestamp d'expiration du jeton, en millisecondes d'époque.

--json JSON

La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.

--owner string

Nom d'utilisateur du propriétaire destinataire.

--sharing-code string

Le code de partage à usage unique fourni par le destinataire des données.

Indicateurs globaux

supprimer des destinataires Databricks

Supprimer le destinataire spécifié du metastore. L'appelant doit être le propriétaire du destinataire.

databricks recipients delete NAME [flags]

Arguments

NAME

Nom du destinataire.

Options

Indicateurs globaux

Les destinataires Databricks obtiennent

Obtenir un destinataire de partage du metastore si :

  • l'appelant est le propriétaire du destinataire du partage,
  • ou est administrateur du métastore.
databricks recipients get NAME [flags]

Arguments

NAME

Nom du destinataire.

Options

Indicateurs globaux

liste des destinataires Databricks

Répertoriez tous les destinataires de partage dans le métastore actuel où :

  • l'appelant est un administrateur de metastore,
  • ou si l'appelant est le propriétaire.

Il n’y a aucune garantie d’un ordre spécifique des éléments dans le tableau.

databricks recipients list [flags]

Arguments

Aucun

Options

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

S'il n'est pas fourni, tous les destinataires seront renvoyés.

--max-results int

Nombre maximal de destinataires à renvoyer.

--page-token string

Jeton de pagination opaque pour aller à la page suivante basé sur la query précédente.

Indicateurs globaux

databricks recipients rotate-token

Faites tourner le jeton d'authentification OpenSharing du destinataire spécifié avec les informations de jeton fournies. L'appelant doit être le propriétaire du destinataire.

databricks recipients rotate-token NAME EXISTING_TOKEN_EXPIRE_IN_SECONDS [flags]

Arguments

NAME

Le nom du destinataire.

EXISTING_TOKEN_EXPIRE_IN_SECONDS

L'heure d'expiration du jeton porteur au format ISO 8601. Cela ne définira l'expiration_time du jeton existant qu'à un Timestamp plus petit, cela ne peut pas prolonger l'expiration_time. Utilisez 0 pour expirer le jeton existant immédiatement, un nombre négatif entraînera une erreur.

Options

--json JSON

La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Mise à jour pour les destinataires Databricks

Mettez à jour un destinataire existant dans le métastore. L'appelant doit être un administrateur de metastore ou le propriétaire du destinataire. Si le nom du destinataire est mis à jour, l'utilisateur doit être à la fois un administrateur du métastore et le propriétaire du destinataire.

databricks recipients update NAME [flags]

Arguments

NAME

Nom du destinataire.

Options

--comment string

Description du destinataire.

--expiration-time int

Timestamp d'expiration du jeton, en millisecondes d'époque.

--json JSON

La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.

--new-name string

Nouveau nom pour le destinataire.

--owner string

Nom d'utilisateur du propriétaire destinataire.

Indicateurs globaux

Autorisations de partage des destinataires Databricks

Obtenez les autorisations de partage pour le destinataire spécifié. L'appelant doit être un administrateur du métastore ou le propriétaire du destinataire.

databricks recipients share-permissions NAME [flags]

Arguments

NAME

Nom du destinataire.

Options

--max-results int

Nombre maximal d'autorisations à renvoyer.

--page-token string

Jeton de pagination opaque pour aller à la page suivante basé sur la query précédente.

Indicateurs globaux

Drapeaux globaux

--debug

Activer ou non la journalisation de débogage.

-h OU --help

Afficher l'aide de Databricks CLI ou du groupe de commandes associé ou de la commande associée.

--log-file chaîne

Une chaîne représentant le fichier dans lequel écrire les logs de sortie. Si cet indicateur n'est pas spécifié, la default est d'écrire les logs de sortie dans stderr.

--log-format Format

Le type de format des logs, text ou json. La valeur par default est text.

--log-level chaîne

Une chaîne représentant le niveau de format du log. S'il n'est pas spécifié, le niveau de format du log est désactivé.

-o, --output Type

Le type de sortie de commande, text ou json. La valeur par default est text.

-p, --profile chaîne

Nom du profil dans le fichier ~/.databrickscfg à utiliser pour exécuter la commande. Si cet indicateur n'est pas spécifié, alors s'il existe, le profil nommé DEFAULT est utilisé.

--progress-format Format

Le format pour afficher les logs de progression : default, append, inplace ou json

-t, --target chaîne

Le cas échéant, la cible de bundle à utiliser