Gérer le catalogue par défaut

Cet article présente le catalogue de catalogue Unity par défaut, explique comment décider quel catalogue utiliser comme valeur par défaut et comment le modifier.

Qu’est-ce que le catalogue par défaut dans le catalogue Unity ?

Un catalogue par défaut est configuré dans chaque espace de travail dans lequel Unity Catalog est activé. Le catalogue par défaut vous permet d’effectuer des opérations de données sans spécifier de catalogue. Si vous omettez le nom du catalogue de premier niveau quand vous effectuez des opérations de données, le catalogue par défaut est utilisé.

Un administrateur d’espace de travail peut afficher ou changer le catalogue par défaut à l’aide de l’interface utilisateur des paramètres d’administration. Vous pouvez également définir le catalogue par défaut d’un cluster à l’aide d’une configuration Spark.

Les commandes qui ne spécifient pas le catalogue (par exemple, GRANT CREATE TABLE ON SCHEMA myschema TO mygroup) sont évaluées pour le catalogue dans l’ordre suivant :

1. Le catalogue est-il défini pour la session à l’aide d’une instruction USE CATALOG ou d’un paramètre JDBC ?
2. La configuration Spark spark.databricks.sql.initial.catalog.namespace est-elle définie sur le cluster ?
3. Existe-t-il un catalogue par défaut d’espace de travail défini pour le cluster ?

Configuration du catalogue par défaut quand Unity Catalog est activé

Le catalogue par défaut initialement configuré dans votre espace de travail dépend de la façon dont votre espace de travail a été activé pour Unity Catalog :

• Pour certains espaces de travail activés automatiquement pour le catalogue Unity, le catalogue d’espaces de travail a été défini comme catalogue par défaut. Consultez Activation automatique de Unity Catalog.
• Pour tous les autres espaces de travail, le catalogue hive_metastore a été défini comme catalogue par défaut.

Lorsque vous migrez du metastore Hive vers le catalogue Unity, vous pouvez définir le catalogue par défaut sur hive_metastore pour éviter d’affecter le code existant qui fait référence au metastore Hive.

Modifier le catalogue par défaut

Un administrateur d’espace de travail peut modifier le catalogue par défaut pour l’espace de travail. Toute personne disposant de l’autorisation de créer ou de modifier une ressource de calcul peut définir un catalogue par défaut différent pour la ressource de calcul.

Avertissement

La modification du catalogue par défaut peut interrompre les opérations de données existantes qui en dépendent.

Pour configurer un autre catalogue par défaut pour un espace de travail :

1. Connectez-vous à votre espace de travail en tant qu’administrateur d’espace de travail.
2. Cliquez sur votre nom d'utilisateur dans la barre supérieure de l'espace de travail et sélectionnez Paramètres d'administration dans la liste déroulante.
3. Cliquez sur l’onglet Avancé.
4. Dans la ligne Catalogue par défaut de l’espace de travail, entrez le nom du catalogue, puis cliquez sur Enregistrer.

Redémarrez vos entrepôts et clusters SQL pour que la modification apportée prenne effet. Tous les entrepôts et clusters SQL, après création ou redémarrage, utilisent ce catalogue comme espace de travail par défaut.

Vous pouvez également remplacer le catalogue par défaut d’un cluster spécifique en définissant la configuration Spark suivante sur le cluster. Cette approche n’est pas disponible pour les entrepôts SQL :

spark.databricks.sql.initial.catalog.name

Pour obtenir des instructions, consultez Configuration de Spark.

Consulter le catalogue par défaut actuel

Pour obtenir le catalogue par défaut actuel pour votre espace de travail, vous pouvez utiliser une instruction SQL dans un notebook ou une requête de l’éditeur SQL. Un administrateur d’espace de travail peut obtenir le catalogue par défaut à l’aide de l’interface utilisateur des paramètres d’administration.

Paramètres d'administration

1. Connectez-vous à votre espace de travail en tant qu’administrateur d’espace de travail.
2. Cliquez sur votre nom d'utilisateur dans la barre supérieure de l'espace de travail et sélectionnez Paramètres d'administration dans la liste déroulante.
3. Cliquez sur l’onglet Avancé.
4. Dans la ligne Catalogue par défaut de l’espace de travail, consultez le nom du catalogue.

SQL

Exécutez la commande suivante dans un notebook ou une requête de l’éditeur SQL qui s’exécute sur un entrepôt SQL ou un cluster conforme à Unity Catalog. Le catalogue par défaut de l’espace de travail est retourné si aucune instruction USE CATALOG ou aucun paramètre JDBC n’a été défini sur la session, et si aucune configuration spark.databricks.sql.initial.catalog.namespace n’est définie pour le cluster.

SELECT current_catalog();