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. Har katalogen angetts 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?

Viktig

Pipelinekonfigurationen för Delta Live Tables anger en standardkatalog som åsidosätter standardinställningen för arbetsytan.

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 den arbetsytekatalogen som standardkatalog. Se Automatisk aktivering av Unity Catalog.
• För alla andra arbetsytor angavs den hive_metastore katalogen som standardkatalog.

När du migrerar från Hive-metaarkivet till Unity Catalog kan du ställa in standardkatalogen på hive_metastore 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. I standardkatalogen för arbetsytan rad 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.namespace

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 i Standardkatalog för arbetsytan rad.

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();