Dela via


CREATE CATALOG

gäller för:markerad som ja Databricks SQL markerad som ja Databricks Runtime 10.4 LTS och senare markerad som ja Unity Catalog

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

När du skapar en FOREIGNcatalog kommer den att fyllas med alla scheman och deras tables som är synliga för den användare som autentiserar.

Syntax

CREATE CATALOG [ IF NOT EXISTS ] catalog_name
    [ USING SHARE provider_name . share_name |
      MANAGED LOCATION location_path |
      COMMENT comment |
      OPTIONS ( { option_name = option_value } [ , ... ] ) ] [...]

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

Parameters

  • FRÄMMANDE

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

    Anger att catalog importeras från en -anslutning.

  • OM INTE FINNS

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

  • catalog_name

    Namnet på den catalog som ska skapas.

  • ANVÄNDA SHARE provider_name.share_name

    Du kan också ange att catalog baseras på en Delta-delningsresurs.

  • HANTERAD PLACERING location_path

    Du kan också ange sökvägen till en hanterad lagringsplats för catalog 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 Arbeta med hanterade tables och Skapa ett Unity Catalog-metaarkiv.

  • ANVÄNDA CONNECTION_NAME

    Anger anslutningen where källan catalog finns.

  • kommentar

    En valfri STRING literal. Beskrivningen för catalog.

  • ALTERNATIV

    Anger anslutningstypsspecifik parameters som behövs för att identifiera catalog 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 DECIMAL konstant uttryck. Värdet kan också vara ett anrop till SECRET SQL-funktionen. Till exempel value kan för bestå password av i stället för secret('secrets.r.us', 'postgresPassword') 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');