SKAPA KATALOG

  • Artikel

Gäller endast för:markerad ja Databricks SQL markerad ja Databricks Runtime 10.4 LTS och senare markerad ja i 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' ]
    [ COMMENT comment ]

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

Parametrar

  • UTLÄNDSKA

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

    Anger att katalogen importeras från 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 SHARE provider_name.share_name

    Du kan också ange att katalogen baseras på en deltadelningsresurs.

  • HANTERAD PLATS '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 konfigurationen av den externa platsen eller en undersökväg (med andra ord eller 'abfss://container@storageaccount.dfs.core.windows.net/finance''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 och Skapa ett Unity Catalog-metaarkiv.

  • ANVÄNDA CONNECTION_NAME

    Anger den anslutning där källkatalogen finns.

  • Kommentar

    En valfri STRING literal. Beskrivningen för katalogen.

  • ALTERNATIV

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

    • alternativ

      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.

    • värde

      Värdet för alternativet. Värdet måste vara ett BOOLEAN, STRING, INTEGEReller DECIMAL konstant uttryck. Värdet kan också vara ett anrop till SECRET SQL-funktionen. Till exempel value kan för bestå secret('secrets.r.us', 'postgresPassword') av i stället för password att ange literallö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 foreign catalog linked to postgresdb at postgresql_connection
> CREATE FOREIGN CATALOG postgresql_catalog
     USING CONNECTION postgresql_connection
     OPTIONS (database 'postgresdb');