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 schemas groupe de commandes dans l’interface CLI Databricks contient des commandes pour gérer les schémas dans le catalogue Unity. Un schéma est la deuxième couche du système de noms à trois niveaux du catalogue Unity. Un schéma organise les tables, les vues et les fonctions. Découvrez quels sont les schémas dans Azure Databricks ?.
Créez des schémas dans Databricks
Créez un nouveau schéma pour le catalogue dans le metastore. L’appelant doit être un administrateur de metastore ou avoir le CREATE_SCHEMA privilège dans le catalogue parent.
databricks schemas create NAME CATALOG_NAME [flags]
Arguments
NAME
Nom du schéma, par rapport au catalogue parent.
CATALOG_NAME
Nom du catalogue parent.
Options
--comment string
Description de texte libre fournie par l’utilisateur.
--json JSON
Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.
--storage-root string
URL racine de stockage pour les tables managées au sein du schéma.
Examples
L’exemple suivant crée un schéma nommé analytics dans le main catalogue :
databricks schemas create analytics main
L’exemple suivant crée un schéma avec un commentaire :
databricks schemas create analytics main --comment "Schema for analytics data"
Suppression des schémas Databricks
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.
Examples
L’exemple suivant supprime un schéma :
databricks schemas delete main.analytics
L’exemple suivant force la suppression d’un schéma même s’il n’est pas vide :
databricks schemas delete main.analytics --force
databricks schémas obtenir
Obtient le schéma spécifié dans le metastore. L’appelant doit être un administrateur de metastore, le propriétaire du schéma ou un utilisateur disposant du USE_SCHEMA privilège sur le schéma.
databricks schemas get FULL_NAME [flags]
Arguments
FULL_NAME
Nom complet du schéma.
Options
--include-browse
Indique s’il faut inclure des schémas dans la réponse pour laquelle le principal ne peut accéder qu’aux métadonnées sélectives.
Examples
L’exemple suivant obtient des informations sur un schéma :
databricks schemas get main.analytics
L’exemple suivant obtient des informations de schéma, notamment 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 metastore. 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. Sinon, seuls les schémas appartenant à l’appelant (ou pour lesquels l’appelant a le USE_SCHEMA privilège) sont récupérés. Il n’existe aucune garantie d’un classement spécifique des éléments dans le tableau.
databricks schemas list CATALOG_NAME [flags]
Arguments
CATALOG_NAME
Catalogue parent pour les schémas intéressants.
Options
--include-browse
Indique s’il faut inclure des schémas dans la réponse pour laquelle le principal ne peut accéder qu’aux métadonnées sélectives.
--max-results int
Nombre maximal de schémas à 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 schémas du main catalogue :
databricks schemas list main
L’exemple suivant répertorie les schémas avec un maximum de 10 résultats :
databricks schemas list main --max-results 10
L’exemple suivant répertorie les schémas à l’aide de la pagination :
databricks schemas list main --page-token <token>
mise à jour des schémas Databricks
Mettez à jour un schéma pour un catalogue. L’appelant doit être le propriétaire du schéma ou d’un administrateur de metastore. Si l’appelant est un administrateur de metastore, seul le owner champ peut être modifié dans la mise à jour. Si le name champ doit être mis à jour, l’appelant doit être un administrateur de metastore ou avoir le CREATE_SCHEMA privilège sur le catalogue parent.
databricks schemas update FULL_NAME [flags]
Arguments
FULL_NAME
Nom complet du schéma.
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 : [DÉSACTIVER, ACTIVER, HÉRITER]
--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 schéma.
--owner string
Nom d’utilisateur du propriétaire actuel du schéma.
Examples
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
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