groupe de commandesschemas
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 schemas dans le Databricks CLI contient des commandes pour gérer les schémas dans Unity Catalog. Un schéma est la deuxième couche de l'espace de noms à trois niveaux de Unity Catalog. Un schéma organise les tables, les vues et les fonctions. Voir Qu’est-ce qu’un schéma dans Databricks ?.
databricks schemas create
Créer un nouveau schéma pour le catalogue dans le metastore. L'appelant doit être un administrateur de métastore, ou disposer du privilège CREATE_SCHEMA dans le catalogue parent.
databricks schemas create NAME CATALOG_NAME [flags]
Arguments
NAME
Nom du schéma, relatif au catalogue parent.
CATALOG_NAME
Nom du catalogue parent.
Options
--comment string
Description textuelle libre fournie par l'utilisateur.
--json JSON
La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.
--storage-root string
URL racine de stockage pour les tables gérées au sein du schéma.
Exemples
L'exemple suivant crée un nouveau schéma nommé analytics dans le catalogue main :
databricks schemas create analytics main
L'exemple suivant crée un nouveau schéma avec un commentaire :
databricks schemas create analytics main --comment "Schema for analytics data"
databricks schemas delete
Supprimez le schéma spécifié du catalogue parent. L'appelant doit être le propriétaire du schéma ou un propriétaire du catalogue parent.
databricks schemas delete FULL_NAME [flags]
Arguments
FULL_NAME
Nom complet du schéma.
Options
--force
Forcer la suppression même si le schéma n'est pas vide.
Exemples
L’exemple suivant supprime un schéma :
databricks schemas delete main.analytics
L'exemple suivant supprime un schéma de force, même s'il n'est pas vide :
databricks schemas delete main.analytics --force
databricks schemas get
Obtenez le schéma spécifié dans le métastore. L'appelant doit être un administrateur de métastore, le propriétaire du schéma ou un utilisateur qui dispose du privilège USE_SCHEMA sur le schéma.
databricks schemas get FULL_NAME [flags]
Arguments
FULL_NAME
Nom complet du schéma.
Options
--include-browse
Indique si les schémas pour lesquels le principal n'a accès qu'à des métadonnées sélectives doivent être inclus dans la réponse.
Exemples
L'exemple suivant fournit des informations sur un schéma :
databricks schemas get main.analytics
L’exemple suivant obtient les informations de schéma, y compris les autorisations de navigation :
databricks schemas get main.analytics --include-browse
Liste des schémas Databricks
Répertoriez les schémas d'un catalogue dans le métastore. Si l'appelant est l'administrateur du metastore ou le propriétaire du catalogue parent, tous les schémas du catalogue sont récupérés. Autrement, seuls les schémas appartenant à l'appelant (ou pour lesquels l'appelant a le privilège USE_SCHEMA) seront récupérés. Il n'y a aucune garantie d'un ordre spécifique des éléments dans le tableau.
databricks schemas list CATALOG_NAME [flags]
Arguments
CATALOG_NAME
Catalogue parent pour les schémas d'intérêt.
Options
--include-browse
Indique si les schémas pour lesquels le principal n'a accès qu'à des métadonnées sélectives doivent être inclus dans la réponse.
--max-results int
Nombre maximal de schémas à renvoyer.
--page-token string
Jeton de pagination opaque pour aller à la page suivante basé sur la query précédente.
Exemples
L'exemple suivant liste tous les schémas dans le catalogue main :
databricks schemas list main
L'exemple suivant liste les schémas avec un maximum de 10 résultats :
databricks schemas list main --max-results 10
L’exemple suivant liste les schémas à l’aide de la pagination :
databricks schemas list main --page-token <token>
Mise à jour des schémas Databricks
Mettre à jour un schéma pour un catalogue. L'appelant doit être le propriétaire du schéma ou un administrateur du metastore. Si l'appelant est un administrateur de metastore, seul le champ owner peut être modifié dans la mise à jour. Si le champ name doit être mis à jour, l'appelant doit être un administrateur du métastore ou disposer du privilège CREATE_SCHEMA sur le catalogue parent.
databricks schemas update FULL_NAME [flags]
Arguments
FULL_NAME
Nom complet du schéma.
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]
--json JSON
La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.
--new-name string
Nouveau nom du schéma.
--owner string
Nom d'utilisateur du propriétaire actuel du schéma.
Exemples
L'exemple suivant met à jour le commentaire d'un schéma :
databricks schemas update main.analytics --comment "Updated analytics schema"
L'exemple suivant modifie le propriétaire d'un schéma :
databricks schemas update main.analytics --owner someone@example.com
L'exemple suivant renomme un schéma :
databricks schemas update main.analytics --new-name analytics_v2
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