Hantera standardkatalogen

Den här artikeln introducerar standardkatalogen för Unity Catalog, förklarar hur du bestämmer vilken katalog som ska användas som standard och visar hur du ändrar den.

Vilken är standardkatalogen i Unity Catalog?

En standardkatalog konfigureras för varje arbetsyta som är aktiverad för Unity Catalog. Med standardkatalogen kan du utföra dataåtgärder utan att ange en katalog. Om du utelämnar katalognamnet på den översta nivån när du utför dataåtgärder antas standardkatalogen.

En arbetsyteadministratör kan visa eller växla standardkatalogen med hjälp av användargränssnittet för administratörsinställningar. Du kan också ange standardkatalogen för ett kluster med hjälp av en Spark-konfiguration.

Kommandon som inte anger katalogen (till exempel GRANT CREATE TABLE ON SCHEMA myschema TO mygroup) utvärderas för katalogen i följande ordning:

1. Är katalogen inställd för sessionen med hjälp av en USE CATALOG instruktion eller en JDBC-inställning?
2. Är Spark-konfigurationen spark.databricks.sql.initial.catalog.namespace inställd på klustret?
3. Finns det en standardkatalog för arbetsytan för klustret?

Standardkatalogkonfigurationen när Unity Catalog är aktiverat

Standardkatalogen som ursprungligen konfigurerades för din arbetsyta beror på hur din arbetsyta har aktiverats för Unity Catalog:

• För vissa arbetsytor som aktiverades automatiskt för Unity Catalog angavs arbetsytekatalogen som standardkatalog. Se Automatisk aktivering av Unity Catalog.
• För alla andra arbetsytor angavs hive_metastore katalogen som standardkatalog.

Om du övergår från Hive-metaarkivet till Unity Catalog på en befintlig arbetsyta är det vanligtvis klokt att använda hive_metastore som standardkatalog för att undvika att påverka befintlig kod som refererar till Hive-metaarkivet.

Ändra standardkatalogen

En arbetsyteadministratör kan ändra standardkatalogen för arbetsytan. Alla som har behörighet att skapa eller redigera en beräkningsresurs kan ange en annan standardkatalog för beräkningsresursen.

Varning

Om du ändrar standardkatalogen kan du bryta befintliga dataåtgärder som är beroende av den.

Så här konfigurerar du en annan standardkatalog för en arbetsyta:

1. Logga in på din arbetsyta som administratör för arbetsytan.
2. Klicka på ditt användarnamn i arbetsytans övre stapel och välj Administratörsinställningar i listrutan.
3. Klicka på fliken Avancerat.
4. På raden Standardkatalog för arbetsytan anger du katalognamnet och klickar på Spara.

Starta om dina SQL-lager och -kluster för att ändringen ska börja gälla. Alla nya och omstartade SQL-lager och -kluster använder den här katalogen som standard för arbetsytan.

Du kan också åsidosätta standardkatalogen för ett visst kluster genom att ange följande Spark-konfiguration i klustret. Den här metoden är inte tillgänglig för SQL-lager:

spark.databricks.sql.initial.catalog.name

Anvisningar finns i Spark-konfiguration.

Visa den aktuella standardkatalogen

Om du vill hämta den aktuella standardkatalogen för din arbetsyta kan du använda en SQL-instruktion i en notebook- eller SQL-redigerarfråga. En arbetsyteadministratör kan hämta standardkatalogen med hjälp av användargränssnittet för administratörsinställningar.

Administratörsinställningar

1. Logga in på din arbetsyta som administratör för arbetsytan.
2. Klicka på ditt användarnamn i arbetsytans övre stapel och välj Administratörsinställningar i listrutan.
3. Klicka på fliken Avancerat.
4. Visa katalognamnet på raden Standardkatalog för arbetsytan.

SQL

Kör följande kommando i en notebook- eller SQL-redigerarfråga som körs på ett SQL-lager eller ett Unity Catalog-kompatibelt kluster. Standardkatalogen för arbetsytan returneras så länge ingen USE CATALOG instruktion eller JDBC-inställning har angetts för sessionen och så länge ingen spark.databricks.sql.initial.catalog.namespace konfiguration har angetts för klustret.

SELECT current_catalog();