clean-rooms 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 clean-rooms groupe de commandes dans l’interface CLI Databricks vous permet de gérer les salles propres. Une salle blanche utilise le partage Delta et le calcul sans serveur pour fournir un environnement sécurisé et respectueux de la confidentialité où plusieurs parties peuvent collaborer sur des données sensibles de l'entreprise sans accéder directement aux données les unes des autres. Voir Qu’est-ce qu’Azure Databricks Clean Rooms ?.

databricks clean-rooms créer

Créez une salle propre avec les collaborateurs spécifiés. Cette méthode est asynchrone ; le champ de nom retourné à l’intérieur du champ clean_room peut être utilisé pour interroger l’état de la salle propre, à l’aide de la méthode get. Lorsque cette méthode renvoie une valeur, la clean room sera à l'état PROVISIONING, avec uniquement les champs name, owner, comment, created_at et status renseignés. La salle propre sera utilisable une fois qu'elle aura atteint un ACTIVE état.

L’appelant doit être un administrateur de metastore ou avoir le CREATE_CLEAN_ROOM privilège sur le metastore.

databricks clean-rooms create [flags]

Arguments

None

Options

--comment string

    Commentaire pour la clean room.

--json JSON

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

--name string

    Nom de la salle propre.

--owner string

    Il s’agit du nom d’utilisateur Databricks du propriétaire de la clean room locale sécurisable pour la gestion des autorisations.

Indicateurs globaux

Examples

L’exemple suivant crée une salle propre avec un nom et un propriétaire :

databricks clean-rooms create --name "my-clean-room" --owner "someone@example.com"

L’exemple suivant crée une salle propre avec un commentaire :

databricks clean-rooms create --name "analytics-clean-room" --owner "someone@example.com" --comment "Clean room for analytics collaboration"

databricks salles blanches créer-catalogue-de-sortie

Créez le catalogue de sortie de la clean room.

databricks clean-rooms create-output-catalog CLEAN_ROOM_NAME [flags]

Arguments

CLEAN_ROOM_NAME

    Nom de la salle propre.

Options

--catalog-name string

    Nom du catalogue de sortie dans le catalogue Unity.

--json JSON

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

Indicateurs globaux

Examples

L’exemple suivant crée un catalogue de sorties pour une salle propre :

databricks clean-rooms create-output-catalog my-clean-room --catalog-name "my_output_catalog"

Databricks supprimer les salles blanches

Supprimez une salle propre. Après la suppression, la clean room sera retirée du metastore. Si les autres collaborateurs n’ont pas supprimé la salle propre, ils auront toujours la salle propre dans leur metastore, mais il sera dans un état DELETED et aucune opération autre que la suppression ne peut être effectuée dessus.

databricks clean-rooms delete NAME [flags]

Arguments

NAME

    Nom de la salle propre.

Options

Indicateurs globaux

Examples

L’exemple suivant supprime une salle propre :

databricks clean-rooms delete my-clean-room

salles blanches de databricks obtenir

Obtenez les détails d’une clean room en fonction de son nom.

databricks clean-rooms get NAME [flags]

Arguments

NAME

    Nom de la salle propre.

Options

Indicateurs globaux

Examples

L’exemple suivant obtient les détails d’une salle propre :

databricks clean-rooms get my-clean-room

L'exemple suivant permet d'obtenir les détails d'une clean room à l'aide d'un profil spécifique :

databricks clean-rooms get analytics-clean-room --profile production

liste des salles propres databricks

Répertoriez toutes les clean rooms du metastore. Seules les clean rooms auxquelles l’appelant a accès sont retournées.

databricks clean-rooms list [flags]

Arguments

None

Options

--page-size int

    Nombre maximal de clean rooms à retourner (c’est-à-dire la longueur de la page).

--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 toutes les salles propres accessibles :

databricks clean-rooms list

L’exemple suivant répertorie les salles propres avec une taille de page spécifique :

databricks clean-rooms list --page-size 10

databricks mise à jour des salles blanches

Mettez à jour une salle propre. L’appelant doit être le propriétaire de la clean rooms, avoir le privilège MODIFY_CLEAN_ROOM ou être administrateur du metastore.

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

databricks clean-rooms update NAME [flags]

Arguments

NAME

    Nom de la salle propre.

Options

--json JSON

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

Indicateurs globaux

Examples

L’exemple suivant met à jour une salle propre à l’aide de la configuration JSON :

databricks clean-rooms update my-clean-room --json '{"comment": "Updated clean room description"}'

L'exemple suivant permet de mettre à jour le propriétaire d'une clean room (administrateur du metastore uniquement) :

databricks clean-rooms update my-clean-room --json '{"owner": "new-someone@example.com"}'

L’exemple suivant met à jour une salle propre à l’aide d’un fichier JSON :

databricks clean-rooms update my-clean-room --json @update-config.json

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