Partager via

shares groupe de commande

Note

Ces informations s’appliquent à Databricks CLI versions 0.205 et ultérieures. L’interface CLI Databricks est en préversion publique.

L’utilisation de l’interface CLI Databricks est soumise à la licence Databricks et à la notification de confidentialité Databricks, y compris les dispositions relatives aux données d’utilisation.

Le shares groupe de commandes dans l’interface CLI Databricks vous permet de gérer des partages dans le catalogue Unity.

Un partage est un conteneur instancié avec la commande shares create. Une fois que vous l'avez créé, vous pouvez inscrire de manière itérative une collection de ressources de données existantes définies dans le metastore à l’aide de shares update. Vous pouvez inscrire des ressources de données sous leur nom d’origine, qualifiées par leur schéma d’origine ou fournir d’autres noms exposés.

databricks partages créer

Créez un nouveau partage pour les objets de données. Les objets de données peuvent être ajoutés après la création avec update. L’appelant doit être un administrateur de metastore ou avoir le CREATE_SHARE privilège sur le metastore.

databricks shares create NAME [flags]

Arguments

NAME

    Nom du partage.

Options

--comment string

    Description de texte libre fournie par l’utilisateur.

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

--storage-root string

    URL racine de stockage pour les fichiers de bloc-notes dans le partage.

Indicateurs globaux

Examples

Les exemples suivants créent un partage nommé my-analytics-share avec un commentaire :

databricks shares create my-analytics-share --comment "Sales analytics data share"

L’exemple suivant crée un partage avec une racine de stockage spécifique :

databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"

suppression des partages databricks

Supprime un partage du metastore. L’appelant doit être propriétaire du partage.

databricks shares delete NAME [flags]

Arguments

NAME

    Nom du partage.

Options

Indicateurs globaux

Examples

L’exemple suivant supprime un partage nommé my-analytics-share:

databricks shares delete my-analytics-share

databricks partages get

Récupère un partage depuis le metastore. L’appelant doit être un administrateur de metastore ou le propriétaire du partage.

databricks shares get NAME [flags]

Arguments

NAME

    Nom du partage.

Options

--include-shared-data

    Recherchez les données à inclure dans le partage.

Indicateurs globaux

Examples

L’exemple suivant obtient des informations sur un partage nommé my-analytics-share:

databricks shares get my-analytics-share

L’exemple suivant récupère un partage avec des informations sur les données partagées :

databricks shares get my-analytics-share --include-shared-data

(Déconseillé) liste des partages de databricks

Deprecated. Liste les partages depuis le metastore. L’appelant doit être un administrateur de metastore ou le propriétaire du partage. L’ordre des éléments dans le tableau n’est pas garanti.

databricks shares list [flags]

Arguments

None

Options

--max-results int

    Nombre maximal de parts à retourner.

--page-token string

    Jeton de pagination opaque pour accéder à la page suivante en fonction de la requête précédente.

Indicateurs globaux

databricks partage des partages de liste

Liste les partages depuis le metastore. L’appelant doit être un administrateur de metastore ou le propriétaire du partage. L’ordre des éléments dans le tableau n’est pas garanti.

databricks shares list-shares [flags]

Arguments

None

Options

--max-results int

    Nombre maximal de parts à retourner.

--page-token string

    Jeton de pagination opaque pour accéder à la page suivante en fonction de la requête précédente.

Indicateurs globaux

Examples

L’exemple suivant répertorie tous les partages :

databricks shares list-shares

mise à jour des partages databricks

Mettez à jour le partage avec les modifications et les objets de données dans la requête. L’appelant doit être le propriétaire du partage ou d’un administrateur de metastore.

Lorsque l’appelant est un administrateur de metastore, seul le owner champ peut être mis à jour.

Dans le cas où le nom du partage est modifié, updateShare exige que l’appelant soit le propriétaire du partage et dispose du CREATE_SHARE privilège.

S’il existe des fichiers de bloc-notes dans le partage, le storage_root champ ne peut pas être mis à jour.

Pour chaque table ajoutée via cette méthode, le propriétaire du partage doit également disposer du privilège SELECT pour la table. Ce privilège doit être conservé indéfiniment pour que les destinataires puissent accéder à la table. En général, il est recommandé d’utiliser un groupe comme propriétaire du partage.

Les suppressions de tables via update ne nécessitent pas de privilèges supplémentaires.

databricks shares update NAME [flags]

Arguments

NAME

    Nom du partage.

Options

--comment string

    Description de texte libre fournie par l’utilisateur.

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

--new-name string

    Nouveau nom du partage.

--owner string

    Nom d’utilisateur du propriétaire actuel du partage.

--storage-root string

    URL racine de stockage pour les fichiers de bloc-notes dans le partage.

Indicateurs globaux

Examples

L’exemple suivant met à jour le commentaire d’un partage :

databricks shares update my-analytics-share --comment "Updated sales analytics data share"

L’exemple suivant modifie le nom d’un partage :

databricks shares update my-analytics-share --new-name "sales-analytics-share"

L’exemple suivant met à jour le propriétaire d’un partage :

databricks shares update my-analytics-share --owner "someone@example.com"

L’exemple suivant met à jour un partage à l’aide de la configuration JSON :

databricks shares update my-analytics-share --json '{
  "comment": "Updated share with new tables",
  "objects": [
    {
      "name": "sales.customers",
      "data_object_type": "TABLE"
    }
  ]
}'

databricks partage des autorisations de partage

Obtenez des autorisations pour un partage de données à partir du metastore. L’appelant doit être un administrateur de metastore ou le propriétaire du partage.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    Nom du partage.

Options

--max-results int

    Nombre maximal d’autorisations à renvoyer.

--page-token string

    Jeton de pagination opaque pour accéder à la page suivante en fonction de la requête précédente.

Indicateurs globaux

Examples

L’exemple suivant obtient des autorisations pour un partage nommé my-analytics-share:

databricks shares share-permissions my-analytics-share

databricks partage les autorisations de mise à jour

Mettez à jour les autorisations d’un partage de données dans le metastore. L’appelant doit être un administrateur de metastore ou un des propriétaires du partage.

Pour les nouvelles autorisations accordées à un destinataire, l’utilisateur doit également être le propriétaire du destinataire ou un administrateur de metastore. Les révocations d’autorisations pour un destinataire ne nécessitent pas de privilèges supplémentaires.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    Nom du partage.

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

--omit-permissions-list

    Optional.

Indicateurs globaux

Examples

L’exemple suivant accorde des autorisations à un destinataire :

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "add": ["SELECT"]
    }
  ]
}'

L’exemple suivant révoque les autorisations d’un destinataire :

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "remove": ["SELECT"]
    }
  ]
}'

Indicateurs globaux

--debug

  Active la journalisation du débogage.

-h ou --help

    Affiche l’aide pour l’interface CLI de Databricks, le groupe de commandes associé ou la commande concernée.

--log-file chaîne

    Chaîne représentant le fichier dans lequel écrire les journaux de sortie. Si cet indicateur n’est pas défini, les journaux de sortie sont écrits par défaut dans stderr.

--log-format format

    Format des journaux : text ou json. La valeur par défaut est text.

--log-level chaîne

    Chaîne représentant le niveau de journalisation. Si cet indicateur n’est pas défini, le niveau de format de journal est désactivé.

Type -o, --output

    Type de sortie de commande, text ou json. La valeur par défaut est text.

-p, --profile chaîne

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

--progress-format format

    Format d’affichage des journaux d’activité de progression : default, append, inplace ou json

-t, --target chaîne

    Le cas échéant, la cible d’offre groupée à utiliser

  • Last updated on