Condividi tramite

CREATE CATALOG:

  • Articolo

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

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 ]

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

Parametri

  • FOREIGN

    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.

  • USING SHARE provider_name share_name.

    Facoltativamente, specifica che il catalogo è basato su una condivisione di condivisione Delta.

  • POSIZIONE GESTITA 'location_path'

    Facoltativamente, specifica il percorso di 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 Usare tabelle gestite e Creare un metastore di Unity Catalog.

  • USING CONNECTION connection_name

    Specifica la connessione in cui risiede il catalogo di origine.

  • comment

    Valore letterale facoltativo STRING . Descrizione del catalogo.

  • OPTIONS

    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 fanno distinzione tra maiuscole e minuscole.

    • option_value

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