Aller au contenu principal

groupe de commandesexternal-lineage

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 external-lineage au sein de l'CLI Databricks contient des commandes pour définir et gérer les relations de lignage entre les objets Databricks et les systèmes externes.

databricks external-lineage create-external-lineage-relationship

Créez une relation de traçabilité externe entre un objet Databricks ou un objet de métadonnées externe et un autre objet de métadonnées externe.

databricks external-lineage create-external-lineage-relationship SOURCE TARGET [flags]

Arguments

SOURCE

Objet source de la relation de traçabilité externe.

TARGET

Objet cible de la relation de traçabilité externe.

Options

--json JSON

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

Indicateurs globaux

Exemples

L'exemple suivant crée une relation de traçabilité externe à l'aide de JSON :

Bash
databricks external-lineage create-external-lineage-relationship source_object target_object --json '{"column_mappings": [{"source_column": "id", "target_column": "external_id"}]}'

L'exemple suivant crée une relation de traçabilité externe à l'aide d'un fichier JSON :

Bash
databricks external-lineage create-external-lineage-relationship source_object target_object --json @lineage.json

databricks external-lineage delete-external-lineage-relationship

Supprimez une relation de lignée externe entre un objet Databricks ou de métadonnées externes et un autre objet de métadonnées externes.

databricks external-lineage delete-external-lineage-relationship [flags]

Options

--json JSON

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

Indicateurs globaux

Exemples

L’exemple suivant supprime une relation de traçabilité externe à l’aide de JSON :

Bash
databricks external-lineage delete-external-lineage-relationship --json '{"source": "source_object", "target": "target_object"}'

L'exemple suivant supprime une relation de traçabilité externe à l'aide d'un fichier JSON :

Bash
databricks external-lineage delete-external-lineage-relationship --json @delete-lineage.json

databricks external-lineage list-external-lineage-relationships

Répertorier les relations de lignage externe d’un objet Databricks ou de métadonnées externes selon une direction donnée.

databricks external-lineage list-external-lineage-relationships [flags]

Options

--json JSON

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

--page-size int

Nombre maximal de relations de traçabilité externes à renvoyer par page.

--page-token string

Jeton pour récupérer la page suivante de résultats.

Indicateurs globaux

Exemples

L'exemple suivant liste les relations de lignage externes en utilisant JSON :

Bash
databricks external-lineage list-external-lineage-relationships --json '{"object": "my_catalog.my_schema.my_table", "direction": "DOWNSTREAM"}'

L'exemple suivant répertorie les relations de traçabilité externes avec pagination :

Bash
databricks external-lineage list-external-lineage-relationships --json '{"object": "my_catalog.my_schema.my_table", "direction": "UPSTREAM"}' --page-size 10

L'exemple suivant répertorie les relations de traçabilité externes à l'aide d'un fichier JSON :

Bash
databricks external-lineage list-external-lineage-relationships --json @list-lineage.json

databricks external-lineage update-external-lineage-relationship

Mettre à jour une relation de lignée externe entre un objet de métadonnées Databricks ou externe et un autre objet de métadonnées externe.

databricks external-lineage update-external-lineage-relationship UPDATE_MASK SOURCE TARGET [flags]

Arguments

UPDATE_MASK

Le masque de champ doit être une chaîne unique, avec plusieurs champs séparés par des virgules (sans espaces). Le chemin de champ est relatif à l’objet ressource, en utilisant un point (.) pour naviguer dans les sous-champs (par exemple, author.given_name). La spécification d’éléments dans des champs de séquence ou de carte n’est pas autorisée, car seul le champ de collection entier peut être spécifié. Les noms de champs doivent correspondre exactement aux noms des champs de ressource.

Un masque de champ astérisque (*) indique un remplacement complet. Il est recommandé de toujours lister explicitement les champs mis à jour et d'éviter l'utilisation de caractères génériques, car cela peut entraîner des résultats inattendus si l'API change à l'avenir.

SOURCE

Objet source de la relation de traçabilité externe.

TARGET

Objet cible de la relation de traçabilité externe.

Options

--json JSON

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

Indicateurs globaux

Exemples

L'exemple suivant met à jour une relation de traçabilité externe à l'aide de JSON :

Bash
databricks external-lineage update-external-lineage-relationship "column_mappings" source_object target_object --json '{"column_mappings": [{"source_column": "updated_id", "target_column": "new_external_id"}]}'

L'exemple suivant met à jour une relation de traçabilité externe à l'aide d'un fichier JSON :

Bash
databricks external-lineage update-external-lineage-relationship "column_mappings" source_object target_object --json @update-lineage.json

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 de log, 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