Administración del catálogo predeterminado

En este artículo se presenta el catálogo de catálogos de Unity predeterminado, se explica cómo decidir qué catálogo se va a usar como valor predeterminado y se muestra cómo cambiarlo.

¿Cuál es el catálogo predeterminado en El catálogo de Unity?

Se configura un catálogo predeterminado para cada área de trabajo habilitada para Unity Catalog. El catálogo predeterminado permite realizar operaciones de datos sin especificar un catálogo. Si omite el nombre del catálogo de nivel superior cuando lleva a cabo operaciones de datos, se asume el uso del catálogo predeterminado.

Un administrador del área de trabajo puede ver o cambiar el catálogo predeterminado mediante la interfaz de usuario de configuración de administración. También puede establecer el catálogo predeterminado para un clúster mediante una configuración de Spark.

Los comandos que no especifican el catálogo (por ejemplo, GRANT CREATE TABLE ON SCHEMA myschema TO mygroup) se evalúan para el catálogo en el orden siguiente:

1. ¿El catálogo está establecido para la sesión mediante una instrucción USE CATALOG o una configuración de JDBC?
2. ¿Está establecida la configuración de Spark spark.databricks.sql.initial.catalog.namespace en el clúster?
3. ¿Hay un catálogo predeterminado del área de trabajo establecido para el clúster?

Configuración predeterminada del catálogo cuando Unity Catalog está habilitado

El catálogo predeterminado que se configuró inicialmente para el área de trabajo depende de cómo se haya habilitado el área de trabajo para Unity Catalog:

• Para algunas áreas de trabajo que se habilitaron automáticamente para el Catálogo de Unity, el catálogo de área de trabajo se estableció como catálogo predeterminado. Consulte Habilitación automática de Unity Catalog.
• Para todas las demás áreas de trabajo, el catálogo de hive_metastore se estableció como catálogo predeterminado.

Si va a realizar la transición desde el metastore de Hive al catálogo de Unity dentro de un área de trabajo existente, normalmente tiene sentido usarlo hive_metastore como catálogo predeterminado para evitar que afecte al código existente que haga referencia al metastore de Hive.

Cambiar el catálogo predeterminado

Un administrador del área de trabajo puede cambiar el catálogo predeterminado del área de trabajo. Cualquier persona con permiso para crear o editar un recurso de proceso puede establecer un catálogo predeterminado diferente para el recurso de proceso.

Advertencia

Cambiar el catálogo predeterminado puede interrumpir las operaciones de datos existentes que dependen de él.

Para configurar un catálogo predeterminado diferente para un área de trabajo:

1. Inicie sesión en el área de trabajo como administrador del área de trabajo.
2. Haga clic en el nombre de usuario situado en la parte superior del área de trabajo y seleccione Configuración de administrador en la lista desplegable.
3. Haga clic en la pestaña Opciones avanzadas.
4. En la fila Catálogo predeterminado para el área de trabajo, escriba el nombre del catálogo y haga clic en Guardar.

Reinicie los almacenes y clústeres de SQL para que el cambio surta efecto. Todos los almacenamientos y clústeres de SQL nuevos y reiniciados usarán este catálogo como valor predeterminado del área de trabajo.

También se puede invalidar el catálogo predeterminado de un clúster específico estableciendo la siguiente configuración de Spark en el clúster. Este método no está disponible para los almacenes de SQL:

spark.databricks.sql.initial.catalog.name

Para obtener instrucciones, consulte Configuración de Spark.

Ver el catálogo predeterminado actual

Para obtener el catálogo predeterminado actual para el área de trabajo, puede usar una instrucción SQL en un cuaderno o una consulta del Editor de SQL. Un administrador del área de trabajo puede obtener el catálogo predeterminado mediante la interfaz de usuario de configuración de administrador.

Configuración de administración

1. Inicie sesión en el área de trabajo como administrador del área de trabajo.
2. Haga clic en el nombre de usuario situado en la parte superior del área de trabajo y seleccione Configuración de administrador en la lista desplegable.
3. Haga clic en la pestaña Opciones avanzadas.
4. En la fila catálogo predeterminado del área de trabajo, verá el nombre del catálogo.

SQL

Ejecute el comando siguiente en un cuaderno o una consulta del Editor de SQL que se ejecuta en un clúster compatible con Unity Catalog o un almacén de SQL. El catálogo predeterminado del área de trabajo se devuelve siempre que no se haya establecido ninguna instrucción USE CATALOG o configuración de JDBC en la sesión y siempre que no se establezca ninguna configuración spark.databricks.sql.initial.catalog.namespace para el clúster.

SELECT current_catalog();