Delen via

CREATE CATALOG

  • Artikel

nl-NL: Van toepassing op:gemarkeerd met ja Databricks SQL gemarkeerd met ja Databricks Runtime 10.4 LTS en hoger gemarkeerd met ja Alleen Unity Catalog

Hiermee maakt u een catalogus met de opgegeven naam. Als er al een catalogus met dezelfde naam bestaat, wordt er een uitzondering gegenereerd.

Wanneer u een FOREIGN catalogus maakt, wordt deze gevuld met alle schema's en de bijbehorende tabellen die zichtbaar zijn voor de geverifieerde gebruiker.

Syntaxis

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

  • BUITENLANDS

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

    Hiermee geeft u op dat de catalogus wordt geïmporteerd uit een CONNECTION.

  • ALS DEZE NIET BESTAAT

    Hiermee maakt u een catalogus met de opgegeven naam als deze niet bestaat. Als er al een catalogus met dezelfde naam bestaat, gebeurt er niets.

  • catalog_name

    De naam van de catalogus die moet worden gemaakt.

  • SHARE .

    Geeft desgewenst aan dat de catalogus is gebaseerd op een Delta Sharing-deel.

  • BEHEERDE LOCATIE location_path

    Geef desgewenst het pad op naar een beheerde opslaglocatie voor de catalogus die verschilt van de hoofdopslaglocatie van de metastore. Dit pad moet worden gedefinieerd in een configuratie van een locatie. U kunt het pad gebruiken dat is gedefinieerd in de configuratie van de externe locatie of een subpad (met andere woorden, 'abfss://container@storageaccount.dfs.core.windows.net/finance' of 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Ondersteund in Databricks SQL of in clusters met Databricks Runtime 11.3 LTS en hoger.

    Zie ook Werken met beheerde tabellen en Een Unity Catalog-metastoremaken.

  • VERBINDING CONNECTION_NAME GEBRUIKEN

    Hiermee geeft u de verbinding op waar de broncatalogus zich bevindt.

  • commentaar

    Een optionele STRING letterlijke. De beschrijving voor de catalogus.

  • OPTIES

    Hiermee stelt u specifieke parameters voor het verbindingstype in die nodig zijn om de catalogus bij de verbinding te identificeren.

    • option_name

      De optietoets. De sleutel kan bestaan uit een of meer id's , gescheiden door een punt of een STRING letterlijke aanduiding.

      Optietoetsen moeten uniek zijn en hoofdlettergevoelig zijn.

    • option_value

      De waarde voor de optie. De waarde moet een BOOLEAN, STRINGof INTEGERDECIMAL constante expressie zijn. De waarde kan ook een aanroep van de SECRET SQL-functie zijn. De for value kan bijvoorbeeld password bestaan uit secret('secrets.r.us', 'postgresPassword') in plaats van het letterlijke wachtwoord in te voeren.

Voorbeelden

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