Condividi tramite

CREATE CATALOG

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 10.4 LTS e versioni successive segno di spunta sì Solo Unity Catalog

Crea un catalogo con il nome specificato. Se esiste già un catalogo con lo stesso nome, viene generata un'eccezione.

Quando si crea un FOREIGN catalogo, questo verrà popolato con tutti gli schemi e le relative tabelle visibili all'utente che esegue l'autenticazione.

Sintassi

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

Parametri

  • STRANIERO

    Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 13.3 LTS e versioni successive

    Specifica che il catalogo viene importato da una connessione.

  • SE NON ESISTE

    Crea un catalogo con il nome specificato, se non esiste. Se esiste già un catalogo con lo stesso nome, non verrà eseguita alcuna operazione.

  • catalog_name

    Nome del catalogo da creare.

  • UTILIZZANDO LA CONDIVISIONE provider_name.share_name

    Opzionalmente, specifica che il catalogo è basato su una condivisione Delta Sharing.

  • LOCALITÀ GESTITA location_path

    Facoltativamente specifica un percorso di archiviazione gestito per il catalogo, diverso dal percorso di archiviazione radice del metastore. Questo percorso deve essere definito in una configurazione della posizione esterna ed è necessario avere il privilegio CREATE MANAGED STORAGE per la configurazione della posizione esterna. È possibile usare il percorso definito nella configurazione della posizione esterna o un sottopercorso (in altre parole, 'abfss://container@storageaccount.dfs.core.windows.net/finance' o 'abfss://container@storageaccount.dfs.core.windows.net/finance/product'). Supportato in Databricks SQL o nei cluster che eseguono Databricks Runtime 11.3 LTS e versioni successive.

    Vedere anche Tabelle gestite di Unity Catalog in Azure Databricks per Delta Lake e Apache Iceberg e Creare un metastore del Unity Catalog.

  • UTILIZZANDO LA CONNESSIONE connection_name

    Specifica la connessione in cui risiede il catalogo di origine.

  • commento

    Valore letterale facoltativo STRING . Descrizione del catalogo.

  • OPZIONI

    Imposta i parametri specifici del tipo di connessione necessari per identificare il catalogo nella connessione.

    • option_name

      La chiave dell'opzione. La chiave può essere costituita da uno o più identificatori separati da un punto o da un valore letterale STRING.

      Le chiavi di opzione devono essere univoche e sensibili alle maiuscole e minuscole.

    • valore_opzione

      Valore per l'opzione. Il valore deve essere un'espressione costante BOOLEAN, STRING, INTEGER o DECIMAL. Il valore può anche essere una chiamata alla funzione SQL SECRET. Ad esempio, l'oggetto value for password può includere secret('secrets.r.us', 'postgresPassword') anziché immettere la password letterale.

Esempi

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