CREATE EXTERNAL LOCATION

  • 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 percorso esterno con il nome specificato. Se esiste già una posizione con lo stesso nome, viene generata un'eccezione.

Per istruzioni dettagliate, vedere Creare una posizione esterna per connettere l'archiviazione cloud ad Azure Databricks.

Sintassi

CREATE EXTERNAL LOCATION [IF NOT EXISTS] location_name
    URL url_str
    WITH (STORAGE CREDENTIAL credential_name)
    [COMMENT comment]

Qualsiasi nome di oggetto che include caratteri speciali, ad esempio trattini (-), deve essere racchiuso da backtick (` `). I nomi degli oggetti con caratteri di sottolineatura (_) non richiedono backtick. Vedere Nomi ed esempi.

Parametri

  • location_name

    Nome del percorso da creare.

  • SE NON ESISTE

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

  • url_str

    Valore STRING letterale con la posizione dell'archiviazione cloud descritta come URL assoluto. Deve essere racchiuso tra virgolette singole.

  • credential_name

    Credenziali denominate usate per connettersi a questo percorso.

  • comment

    Descrizione facoltativa per il percorso o NULL. Il valore predefinito è NULL.

Esempi:

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION abfss_remote URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL abfss_remote_cred)
    COMMENT 'Default source for Azure exernal data';

Si notino i backticks (` `) intorno alla posizione esterna e ai nomi delle credenziali di archiviazione nell'esempio seguente. I backtick sono necessari per i nomi degli oggetti che includono caratteri speciali, ad esempio trattini (-). I nomi degli oggetti con caratteri di sottolineatura (_), ad esempio quelli dell'esempio precedente, non richiedono backtick. Vedere Nomi.

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION `abfss-remote` URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL `abfss-remote-cred`)
    COMMENT 'Default source for Azure exernal data';