Dela via


Hantera kataloger

Den här artikeln visar hur du visar, uppdaterar och tar bort kataloger i Unity Catalog. En katalog innehåller scheman (databaser) och ett schema innehåller tabeller, vyer, volymer, modeller och funktioner.

Mer information om kataloger finns i Vad finns kataloger i Azure Databricks? och Skapa kataloger. Mer information om hur du beviljar och återkallar åtkomst till en katalog finns i Referens för Behörigheter för Unity Catalog.

Information om hur du hanterar en utländsk katalog, ett Unity Catalog-objekt som speglar en databas i ett externt datasystem finns i Hantera och arbeta med utländska kataloger.

Kravspecifikation

Så här visar, uppdaterar eller tar du bort en katalog:

  • Du måste ha ett Unity Catalog-metaarkiv länkat till arbetsytan där du utför uppgiften.

  • Klustret som du använder för att köra en notebook för att hantera en katalog måste använda ett åtkomstläge som uppfyller Unity Catalogs krav. Se Åtkomstlägen.

    SQL-lager stöder alltid Unity Catalog.

De behörigheter som krävs skiljer sig åt efter uppgift och tillhandahålls i varje avsnitt som följer.

Visa kataloginformation

Behörighet krävs: Användarna kan se metadata för alla kataloger som de äger eller som de har tilldelats behörigheten USE CATALOG eller BROWSE på.

Anmärkning

Användare med behörighet i BROWSE en extern katalog kan se inaktuella metadata i Katalogutforskaren eller vid åtkomst till metadata via Unity Catalog-API:et. Synlighet av metadata beror på när REFRESH senast kördes för den externa katalogen.

Om du vill visa information om en katalog kan du använda Catalog Explorer eller ett SQL-kommando.

Katalogutforskaren

  1. Logga in på en arbetsyta som är länkad till metaarkivet.

  2. Klicka på dataikonen.Katalog.

  3. Leta reda på katalogen i fönstret Katalog och klicka på dess namn.

    En del information visas överst på sidan. Andra kan visas på flikarna Scheman, Information, Behörigheter och Arbetsytor .

SQL

Kör SHOW CATALOGS i en notebook-fil eller SQL-frågeredigeraren för att visa alla kataloger i ett metaarkiv eller de som matchar ett reguljärt uttryck.

Kör följande SQL-kommando för att få information om en katalog. Objekt inom hakparenteser är valfria. Ersätt platshållaren <catalog-name>.

DESCRIBE CATALOG <catalog-name>;

Använd CATALOG EXTENDED för att hämta fullständig information.

Mer information finns i DESCRIBE CATALOG.

Uppdatera en katalog

Om du vill uppdatera (eller ändra) en katalog kan du använda Catalog Explorer eller ett SQL-kommando.

Behörigheter som krävs: Behörigheter som krävs för att uppdatera en katalog beror på uppdateringen:

  • Om du vill ändra ägaren måste du vara ägare eller ha MANAGE och USE CATALOG i katalogen.
  • Om du vill byta namn på katalogen måste du vara ägare eller ha MANAGE och USE CATALOG i katalogen och CREATE CATALOG i det överordnade metaarkivet.
  • Om du vill lägga till eller uppdatera en kommentar eller taggar måste du vara ägare eller ha MANAGE eller MODIFY och USE CATALOG i katalogen.
  • Om du vill bevilja och återkalla behörigheter för katalogen måste du vara katalogägare, metaarkivadministratör eller ha MANAGE och USE CATALOG i katalogen.

Katalogutforskaren

  1. Logga in på en arbetsyta som är länkad till Unity Catalog-metaarkivet.
  2. Klicka på dataikonen.Katalog.
  3. I fönstret Katalog till vänster klickar du på den katalog som du vill uppdatera.
  4. Använd följande sidelement på sidan med kataloginformation för att uppdatera katalogen:

SQL

  • Om du vill ändra ägare, lägga till eller uppdatera taggar och hantera förutsägelseoptimering på tabellerna i en katalog kör ALTER CATALOG du kommandot i en notebook-fil eller SQL-frågeredigeraren. Se även ALTER CATALOG.
  • Om du vill bevilja eller återkalla behörigheter använder du GRANT kommandot eller REVOKE . Se GRANT och REVOKE.
  • Information om hur du lägger till scheman i katalogen finns i Vad är scheman i Azure Databricks?.
  • Om du vill byta namn på en katalog med SQL måste du skapa en ny katalog och flytta alla tillgångar till den nya katalogen.

Ta bort en katalog

Om du vill ta bort (eller ta bort) en katalog kan du använda Catalog Explorer eller ett SQL-kommando.

Om katalogen eller något av dess underordnade objekt ingår i en Delta Sharing-resurs, ska du ta bort dem från resursen innan du raderar katalogen. Mer information finns i Kaskadborttagningar kringgår andelsskydd.

Varning

Ta inte bort main katalogen, även om den verkar vara oanvänd. Om du tar bort den kan du bryta befintliga dataåtgärder som är beroende av den.

Behörighet krävs: Katalogägare eller MANAGE och USE CATALOG i katalogen.

Katalogutforskaren

Du måste ta bort alla scheman i katalogen förutom information_schema innan du kan ta bort en katalog. Detta inkluderar det automatiskt skapade default schemat.

  1. Logga in på en arbetsyta som är länkad till metaarkivet.
  2. Klicka på dataikonen.Katalog.
  3. I fönstret Katalog till vänster klickar du på den katalog som du vill ta bort.
  4. I detaljfönstret klickar du på menyikonen för kebabmenyn. Till vänster om knappen Skapa databas väljer du Ta bort.
  5. I dialogrutan Ta bort katalog klickar du på Ta bort.

SQL

Kör följande SQL-kommando i en notebook- eller Databricks SQL-redigerare. Objekt inom hakparenteser är valfria. Ersätt platshållaren <catalog-name>.

Parameterbeskrivningar finns i DROP CATALOG.

Om du använder DROP CATALOG utan CASCADE alternativet måste du ta bort alla scheman i katalogen förutom information_schema innan du kan ta bort katalogen. Detta inkluderar det automatiskt skapade default schemat.

DROP CATALOG [ IF EXISTS ] <catalog-name> [ RESTRICT | CASCADE ]

Om du till exempel vill ta bort en katalog med namnet vaccine och dess scheman:

DROP CATALOG vaccine CASCADE