Dela via

CREATE EXTERNAL LOCATION

  • Artikel

gäller för:markerad som ja Databricks SQL markerad som ja Databricks Runtime 10.4 LTS och senare markerad som ja Unity Catalog

Skapar en extern plats med det angivna namnet. Om det redan finns en plats med samma namn genereras ett undantag.

Anvisningar finns i Skapa en extern plats för att ansluta molnlagring till Azure Databricks.

Syntax

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

Alla objektnamn som innehåller specialtecken, till exempel bindestreck (-), måste omges av backticks (` `). Objektnamn med understreck (_) kräver inte backticks. Se Namn och exempel.

Parameters

  • location_name

    Namnet på den plats som ska skapas.

  • OM INTE FINNS

    Skapar en plats med det angivna namnet om den inte finns. Om det redan finns en plats med samma namn händer ingenting.

  • url_str

    En STRING literal med platsen för molnlagringen som beskrivs som en absolut URL. Måste vara omgiven av enkla citattecken.

  • credential_name

    Den namngivna autentiseringsuppgiften som används för att ansluta till den här platsen.

  • kommentar

    En valfri beskrivning av platsen, eller NULL. Standardvärdet är NULL.

Exempel

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

Observera backticks (` `) runt den externa platsen och lagringsautentiseringsuppgifternas namn i följande exempel. Backticks krävs för objektnamn som innehåller specialtecken, till exempel bindestreck (-). Objektnamn med understreck (_), till exempel de i föregående exempel, kräver inte backticks. Se Namn.

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