groupe de commandesmetastores
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 metastores dans l'interface de ligne de commande Databricks vous permet de gérer les métastores. Un métastore est le conteneur de premier niveau des objets dans Unity Catalog. Il stocke les assets de données (tables et vues) et les autorisations qui régissent leur accès. Consultez Metastore.
Attribution de métastores Databricks
Créez une nouvelle attribution de metastore. Si une attribution pour le même workspace_id existe, elle sera écrasée par les nouveaux metastore_id et default_catalog_name. L'appelant doit être un administrateur de compte.
databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]
Arguments
WORKSPACE_ID
Un ID de Workspace.
METASTORE_ID
L'ID unique du metastore.
DEFAULT_CATALOG_NAME
Obsolète. Utilisez « API Default Namespace » pour configurer le catalogue par default d’un Workspace Databricks. Le nom du catalogue par default dans le métastore.
Options
--json JSON
La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.
Exemples
L'exemple suivant attribue un métastore à un Workspace :
databricks metastores assign 123456789 abc123-def456-ghi789 main
créer des métastores Databricks
Créez un nouveau métastore basé sur un nom fourni et un chemin d'accès racine de stockage facultatif. By default (si le champ propriétaire n'est pas défini), le propriétaire du nouveau métastore est l'utilisateur qui appelle l'API createMetastore. Si le champ propriétaire est défini sur la chaîne vide (""), la propriété est plutôt attribuée à l'utilisateur système.
databricks metastores create NAME [flags]
Arguments
NAME
Le nom du metastore spécifié par l'utilisateur.
Options
--json JSON
La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.
--region string
Région Cloud que le metastore dessert (par exemple, us-west-2, westus).
--storage-root string
L’URL de la racine de stockage pour le metastore.
Exemples
L'exemple suivant crée un métastore avec un nom et une racine de stockage :
databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2
Métastores Databricks actuels
Obtenez l'affectation du métastore pour le Workspace en cours d'accès.
databricks metastores current [flags]
Options
Exemples
L'exemple suivant obtient l'affectation actuelle du métastore :
databricks metastores current
supprimer les métastores Databricks
Supprimer un métastore. L’appelant doit être un administrateur du métastore.
databricks metastores delete ID [flags]
Arguments
ID
ID unique du métastore.
Options
--force
Forcer la suppression même si le metastore n'est pas vide.
Exemples
L'exemple suivant supprime un metastore :
databricks metastores delete abc123-def456-ghi789
L’exemple suivant supprime un metastore de force même s’il n’est pas vide :
databricks metastores delete abc123-def456-ghi789 --force
Obtention des métastores Databricks
Obtenez un métastore qui correspond à l'ID fourni. L'appelant doit être un administrateur de metastore pour récupérer ces informations.
databricks metastores get ID [flags]
Arguments
ID
ID unique du métastore.
Options
Exemples
L'exemple suivant fournit des informations sur un métastore spécifique :
databricks metastores get abc123-def456-ghi789
Liste des métastores Databricks
Listez les métastores disponibles. L'appelant doit être un administrateur pour récupérer ces informations. Il n'y a aucune garantie d'un ordre spécifique des éléments dans la liste.
databricks metastores list [flags]
Options
--max-results int
Nombre maximal de metastores à retourner.
--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 metastores disponibles :
databricks metastores list
Voici un exemple qui répertorie les metastores avec pagination :
databricks metastores list --max-results 10 --page-token abc123token
Résumé des métastores Databricks
Obtenir des informations de synthèse sur un métastore. Ce résumé comprend les informations d'identification du stockage, le fournisseur cloud, la région cloud et l'ID du métastore global.
databricks metastores summary [flags]
Options
Exemples
L'exemple suivant obtient un résumé de métastore :
databricks metastores summary
désaffecter les métastores Databricks
Supprimer une attribution de métastore. L’appelant doit être un administrateur de compte.
databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]
Arguments
WORKSPACE_ID
Un ID de Workspace.
METASTORE_ID
Query pour l'ID du metastore à supprimer.
Options
Exemples
L'exemple suivant désattribue un metastore d'un workspace :
databricks metastores unassign 123456789 abc123-def456-ghi789
Mise à jour des métastores Databricks
Mettre à jour les informations pour un métastore spécifique. L'appelant doit être un administrateur du métastore. Si le champ propriétaire est défini sur la chaîne vide (""), la propriété est mise à jour pour l'utilisateur système.
databricks metastores update ID [flags]
Arguments
ID
ID unique du métastore.
Options
--delta-sharing-organization-name string
Le nom d'organisation d'une entité OpenSharing, à utiliser dans le Databricks-to-Databricks OpenSharing comme nom officiel.
--delta-sharing-recipient-token-lifetime-in-seconds int
La durée de vie du jeton de destinataire OpenSharing en secondes.
--delta-sharing-scope DeltaSharingScopeEnum
Le périmètre d'OpenSharing activé pour le metastore. Valeurs supportées : INTERNAL, INTERNAL_AND_EXTERNAL
--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 pour le métastore.
--owner string
Le propriétaire du métastore.
--privilege-model-version string
Version du modèle de privilège du metastore, sous la forme majeur.mineur (par exemple, 1.0).
--storage-root-credential-id string
UUID de l'identifiant de stockage pour accéder à la racine de stockage du metastore.
Exemples
L'exemple suivant met à jour un nom de métastore :
databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore
L'exemple suivant met à jour un métastore avec une configuration OpenSharing :
databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org
Mise à jour de l'affectation des métastores Databricks
Mettez à jour une affectation de métastore. Cette opération peut être utilisée pour mettre à jour metastore_id ou default_catalog_name pour un workspace spécifié, si le workspace est déjà attribué à un métastore. L'appelant doit être un administrateur de compte pour mettre à jour metastore_id; sinon, l'appelant peut être un administrateur de Workspace.
databricks metastores update-assignment WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
Un ID de Workspace.
Options
--default-catalog-name string
Le nom du catalogue **default** dans le métastore.
--json JSON
La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.
--metastore-id string
L'ID unique du metastore.
Exemples
L'exemple suivant met à jour le catalogue default d'une attribution de métastore :
databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog
L'exemple suivant met à jour l'ID d'un métastore attribué :
databricks metastores update-assignment 123456789 --metastore-id new-metastore-id
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