CREATE CATALOG

gäller för:kontrollera markerat ja Databricks SQL kontrollera markerat ja Databricks Runtime 10.4 LTS och senare kontrollera markerat ja Endast Unity Catalog

Skapar en katalog med det angivna namnet. Om det redan finns en katalog med samma namn genereras ett undantag.

När du skapar en FOREIGN katalog fylls den i med alla scheman och deras tabeller som är synliga för den autentiserande användaren.

Syntax

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name |
      MANAGED LOCATION location_path |
      RETAIN DROPPED FOR number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
      COMMENT comment |
      DEFAULT COLLATION default_collation_name |
      OPTIONS ( { option_name = option_value } [ , ... ] ) ] [...]

CREATE FOREIGN CATALOG [ IF NOT EXISTS ] catalog_name
    USING CONNECTION connection_name
    [ COMMENT comment ]
    OPTIONS ( { option_name = option_value } [ , ... ] )

Parametrar

  • FRÄMMANDE

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 13.3 LTS och senare

    Anger att katalogen importeras via en anslutning.

  • OM INTE FINNS

    Skapar en katalog med det angivna namnet om den inte finns. Om det redan finns en katalog med samma namn händer ingenting.

  • catalog_name

    Namnet på katalogen som ska skapas.

  • ANVÄNDA DELNING provider_name.share_name

    Du kan också ange att katalogen baseras på en OpenSharing-resurs.

  • HANTERAD PLACERING location_path

    Du kan också ange sökvägen till en hanterad lagringsplats för katalogen som skiljer sig från metaarkivets rotlagringsplats. Den här sökvägen måste definieras i en extern platskonfiguration och du måste ha behörighet för konfigurationen CREATE MANAGED STORAGE av den externa platsen. Du kan använda sökvägen som definieras i den externa platsens konfiguration eller en undersökväg (med andra ord, 'abfss://container@storageaccount.dfs.core.windows.net/finance' eller 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Stöds i Databricks SQL eller i kluster som kör Databricks Runtime 11.3 LTS och senare.

    Se även Hanterade tabeller i Unity Catalog för Delta Lake och Apache Iceberg och Skapa ett Unity Catalog-metaarkiv.

  • BEHÅLL BORTTAGET FÖR nummer { TIMME | TIMMAR | DAG | DAYS | VECKA | VECKOR }

    Gäller för:check markerad ja Databricks Runtime 17.3 och senare markerad som ja Endast Unity-katalog

    Important

    Den här funktionen finns som allmänt tillgänglig förhandsversion.

    Du kan också ange återställningsperioden för borttagna hanterade tabeller i katalogen, den period under vilken borttagna UNDROP TABLE tabeller kan återställas med kommandot . Om det inte anges är standardvärdet 7 dagar. Värdet måste vara 0 timmar (för att inaktivera återställning) eller mellan 7–30 dagar, inklusive.

    Om återställningsperioden anges till 0 innebär det att borttagna tabeller inte kan återställas med hjälp av UNDROP och att datafiler tas bort från molnlagringen inom 48 timmar.

    Om en återställningsperiod också anges i ett underordnat schema har inställningen på schemanivå företräde för tabeller i det schemat. Den här inställningen gäller endast för tabeller som släppts efter att återställningsperioden har konfigurerats. När återställningsperioden är slut tas datafiler för hanterade tabeller bort från molnlagringen inom 48 timmar.

    Stöds inte för utländska eller delade kataloger. Se även Släpp en hanterad tabell.

  • ANVÄNDER ANSLUTNING connection_name

    Anger den anslutning där källkatalogen finns.

  • kommentar

    En valfri STRING literal. Beskrivningen för katalogen.

  • STANDARDSORTERING default_collation_name

    Gäller för: : markerad ja Databricks SQL markerad ja Databricks Runtime 17.1 och senare

    Du kan också definiera standardsortering för objekt som definierats i katalogen. Om det inte anges är UTF8_BINARY standardsorteringen.

  • ALTERNATIV

    Anger specifika parametrar av anslutningstyp som behövs för att identifiera katalogen vid anslutningen.

    • option_name

      Alternativnyckeln. Nyckeln kan bestå av en eller flera identifierare avgränsade med en punkt eller en STRING literal.

      Alternativnycklar måste vara unika och skiftlägeskänsliga.

    • option_value

      Värdet för alternativet. Värdet måste vara ett BOOLEAN, STRING, INTEGEReller DECIMALkonstant uttryck. Värdet kan också vara ett anrop till SECRET SQL-funktionen. Till exempel kan value för password bestå av secret('secrets.r.us', 'postgresPassword') i stället för att ange det bokstavliga lösenordet.

Exempel

-- Create catalog `customer_cat`. This throws exception if catalog with name customer_cat
-- already exists.
> CREATE CATALOG customer_cat;

-- Create catalog `customer_cat` only if catalog with same name doesn't exist.
> CREATE CATALOG IF NOT EXISTS customer_cat;

-- Create catalog `customer_cat` only if catalog with same name doesn't exist, with a comment.
> CREATE CATALOG IF NOT EXISTS customer_cat COMMENT 'This is customer catalog';

-- Create a catalog from a Delta Sharing share.
> CREATE CATALOG customer_cat USING SHARE cdc.vaccinedata;

-- Create a catalog with a different managed storage location than the metastore's.
> CREATE CATALOG customer_cat MANAGED LOCATION 'abfss://container@storageaccount.dfs.core.windows.net/finance';

-- Create a catalog with a case insesnitive and accent insensitive default collation.
> CREATE CATALOG customer_cat DEFAULT COLLATION UNICODE_CI_AI;

-- Create a catalog with a 30-day recovery period for dropped managed tables.
> CREATE CATALOG customer_cat RETAIN DROPPED FOR 30 DAYS;

-- Create a foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');
  • Last updated on