Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 catalogs groupe de commandes dans l’interface CLI Databricks vous permet de gérer les catalogues dans le catalogue Unity. Un catalogue est la première couche de l’espace de noms à trois niveaux dans Unity Catalog. Il est utilisé pour organiser vos ressources de données. Consultez Qu’est-ce que Unity Catalog ?.
databricks créer des catalogues
Créez une instance de catalogue dans le metastore parent si l’appelant est un administrateur de metastore ou a le CREATE_CATALOG privilège.
databricks catalogs create NAME [flags]
Arguments
NAME
Nom du catalogue
Options
--comment string
Description de texte libre fournie par l’utilisateur
--connection-name string
Nom de la connexion à une source de données externe
--json JSON
Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête
--provider-name string
Nom du fournisseur de partage delta
--share-name string
Nom du partage sous le fournisseur de partage
--storage-root string
URL racine de stockage pour les tables managées dans le catalogue
Examples
L’exemple suivant crée un catalogue nommé sales:
databricks catalogs create sales
L’exemple suivant crée un catalogue avec un commentaire :
databricks catalogs create sales --comment "Sales data catalog"
databricks supprimer les catalogues
Supprimez le catalogue qui correspond au nom fourni. L’appelant doit être un administrateur de metastore ou le propriétaire du catalogue.
databricks catalogs delete NAME [flags]
Arguments
NAME
Nom du catalogue
Options
--force
Forcer la suppression même si le catalogue n’est pas vide
Examples
L’exemple suivant supprime un catalogue nommé sales:
databricks catalogs delete sales
L’exemple suivant force la suppression d’un catalogue non vide :
databricks catalogs delete sales --force
récupération des catalogues Databricks
Obtenez le catalogue spécifié dans un metastore. L’appelant doit être un administrateur de metastore, le propriétaire du catalogue ou un utilisateur disposant du USE_CATALOG privilège défini pour son compte.
databricks catalogs get NAME [flags]
Arguments
NAME
Nom du catalogue
Options
--include-browse
Indique s’il faut inclure des catalogues dans la réponse, dans laquelle l'utilisateur principal peut uniquement accéder à des métadonnées sélectives.
Examples
L’exemple suivant obtient des informations sur un catalogue nommé sales:
databricks catalogs get sales
L'exemple suivant obtient des informations de catalogue, y compris les catalogues en consultation seule :
databricks catalogs get sales --include-browse
Liste des catalogues Databricks
Répertorier les catalogues dans le metastore. Si l’appelant est l’administrateur du metastore, tous les catalogues sont récupérés. Sinon, seuls les catalogues appartenant à l’appelant (ou pour lesquels l’appelant a le USE_CATALOG privilège) sont récupérés. Il n’existe aucune garantie d’un classement spécifique des éléments dans le tableau.
databricks catalogs list [flags]
Options
--include-browse
Indique s’il faut inclure des catalogues dans la réponse, dans laquelle l'utilisateur principal peut uniquement accéder à des métadonnées sélectives.
--max-results int
Nombre maximal de catalogues à retourner
--page-token string
Jeton de pagination opaque pour accéder à la page suivante en fonction de la requête précédente
Examples
L’exemple suivant répertorie tous les catalogues :
databricks catalogs list
L’exemple suivant répertorie les catalogues avec un maximum de 10 résultats :
databricks catalogs list --max-results 10
L’exemple suivant répertorie les catalogues, y compris les catalogues de navigation uniquement :
databricks catalogs list --include-browse
Mise à jour des catalogues Databricks
Mettez à jour le catalogue qui correspond au nom fourni. L’appelant doit être le propriétaire du catalogue ou un administrateur de metastore (lors de la modification du champ propriétaire du catalogue).
databricks catalogs update NAME [flags]
Arguments
NAME
Nom du catalogue
Options
--comment string
Description de texte libre fournie par l’utilisateur
--enable-predictive-optimization EnablePredictiveOptimization
Indique si l’optimisation prédictive doit être activée pour cet objet et ces objets. Valeurs prises en charge : DISABLE, ENABLE, INHERIT
--isolation-mode CatalogIsolationMode
Indique si la ressource sécurisée est accessible depuis tous les espaces de travail ou uniquement depuis un ensemble spécifique. Valeurs prises en charge : ISOLATED, OPEN
--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 pour le catalogue
--owner string
Nom d’utilisateur du propriétaire actuel du catalogue
Examples
L’exemple suivant met à jour le commentaire d’un catalogue :
databricks catalogs update sales --comment "Updated sales data catalog"
L’exemple suivant renomme un catalogue :
databricks catalogs update sales --new-name sales-prod
L’exemple suivant modifie le propriétaire d’un catalogue :
databricks catalogs update sales --owner someone@example.com
L’exemple suivant active l’optimisation prédictive pour un catalogue :
databricks catalogs update sales --enable-predictive-optimization ENABLE
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