CREATE CATALOG

  • Articolo

Si applica a:check marked yes Solo databricks SQL check marked yes Databricks Runtime 10.3 e versioni successive check marked yes a 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 ]

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

Parametri

  • FOREIGN

    Si applica a:check marked yes Databricks SQL check marked yes Databricks Runtime 13.1 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 del percorso esterno ed è necessario avere il CREATE MANAGED STORAGE privilegio per la configurazione della posizione esterna. È possibile usare il percorso definito nella configurazione del percorso esterno 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 e Creare un metastore del catalogo Unity.

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

    • opzione

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

      Le chiavi di opzione devono essere univoche e fanno distinzione tra maiuscole e minuscole.

    • value

      Valore per l'opzione. Il valore deve essere un'espressione BOOLEANcostante , STRINGINTEGER, o DECIMAL . Il valore può anche essere una chiamata alla SECRET funzione SQL. 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');