Delen via

CATALOGUS MAKEN

  • Artikel

Van toepassing op:vinkje als ja aan Alleen Databricks SQL vinkje als ja aan Databricks Runtime 10.4 LTS en hoger vinkje als ja aan dan 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 verificatiegebruiker.

Syntaxis

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 } [ , ... ] )

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 vanuit een VERBINDING.

  • 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 provider_name share_name.gebruiken

    Hiermee geeft u optioneel aan dat de catalogus is gebaseerd op een Delta Sharing-share.

  • 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 externe locatie en u moet de CREATE MANAGED STORAGE bevoegdheid hebben voor de configuratie van de externe 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-metastore maken.

  • 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.

    • optie

      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.

    • 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 password kan bijvoorbeeld value 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');