groupe de commandescatalogs
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 catalogs au sein de la CLI Databricks vous permet de gérer les catalogues dans Unity Catalog. Un catalogue est la première couche de l'espace de noms à trois niveaux d'Unity Catalog. Il est utilisé pour organiser vos ressources de données. Voir Qu'est-ce que Unity Catalog ?.
databricks catalogs create
Créez une nouvelle instance de catalogue dans le métastore parent si l’appelant est un administrateur de métastore ou dispose du privilège CREATE_CATALOG.
databricks catalogs create NAME [flags]
Arguments
NAME
Nom du catalogue
Options
--comment string
Description textuelle libre fournie par l’utilisateur
--connection-name string
Le nom de la connexion à une source de données externe
--json JSON
La chaîne JSON en ligne ou le @path vers le fichier JSON avec le corps de la requête
--provider-name string
Le nom du fournisseur OpenSharing
--share-name string
Le nom du partage sous le fournisseur de partage
--storage-root string
URL racine de stockage pour les tables gérées dans le catalogue
Exemples
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"
supprimer les catalogues Databricks
Supprimez le catalogue qui correspond au nom fourni. L'appelant doit être un administrateur du métastore ou le propriétaire du catalogue.
databricks catalogs delete NAME [flags]
Arguments
NAME
Le nom du catalogue
Options
--force
Forcer la suppression même si le catalogue n'est pas vide
Exemples
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
databricks catalogs get
Obtenir le catalogue spécifié dans un métastore. L'appelant doit être un administrateur du métastore, le propriétaire du catalogue ou un utilisateur disposant du privilège USE_CATALOG défini pour son compte.
databricks catalogs get NAME [flags]
Arguments
NAME
Le nom du catalogue
Options
--include-browse
Indique s'il faut inclure les catalogues dans la réponse pour lesquels le principal n'a accès qu'à des métadonnées sélectives.
Exemples
L'exemple suivant obtient des informations sur un catalogue nommé sales:
databricks catalogs get sales
L'exemple suivant obtient les informations du catalogue, y compris les catalogues en lecture seule :
databricks catalogs get sales --include-browse
liste des catalogues databricks
Listez les catalogues dans le métastore. Si l’appelant est l’administrateur du métastore, tous les catalogues seront récupérés. Sinon, seuls les catalogues appartenant à l’appelant (ou pour lesquels l’appelant dispose du privilège USE_CATALOG) seront récupérés. Il n'y a aucune garantie d'un ordre spécifique des éléments dans le tableau.
databricks catalogs list [flags]
Options
--include-browse
Indique s'il faut inclure les catalogues dans la réponse pour lesquels le principal n'a accès qu'à des métadonnées sélectives.
--max-results int
Nombre maximal de catalogues à retourner
--page-token string
Jeton de pagination opaque pour passer à la page suivante basé sur la query précédente
Exemples
L’exemple suivant répertorie tous les catalogues :
databricks catalogs list
L'exemple suivant liste 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 en lecture seule :
databricks catalogs list --include-browse
mise à jour des catalogues Databricks
Mettez à jour le catalogue qui correspond au nom fourni. L'appelant doit être soit le propriétaire du catalogue, soit un administrateur du métastore (lors de la modification du champ propriétaire du catalogue).
databricks catalogs update NAME [flags]
Arguments
NAME
Le nom du catalogue
Options
--comment string
Description textuelle libre fournie par l’utilisateur
--enable-predictive-optimization EnablePredictiveOptimization
Indique si l'optimisation prédictive doit être activée pour cet objet et les objets qui en dépendent. Valeurs prises en charge : DISABLE, ENABLE, INHERIT
--isolation-mode CatalogIsolationMode
Que l'élément sécurisable actuel soit accessible depuis tous les workspaces ou un ensemble spécifique de workspaces. Valeurs supportées : ISOLATED, OPEN
--json JSON
La chaîne JSON en ligne ou le @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
Exemples
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 mondiaux
--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