Delen via

CREATE EXTERNAL LOCATION

Van toepassing op:aangevinkt als ja Databricks SQL aangevinkt als ja Databricks Runtime 10.4 LTS en hoger aangevinkt als ja Unity Catalog alleen

Hiermee maakt u een externe locatie met de opgegeven naam. Als er al een locatie met dezelfde naam bestaat, wordt er een uitzondering gegenereerd.

Zie optie 2 voor instructies: Een externe locatie maken met behulp van SQL.

Syntaxis

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

Elke objectnaam die speciale tekens bevat, zoals afbreekstreepjes (-), moet worden omgeven door backticks (` `). Objectnamen met onderstrepingstekens (_) hebben geen backticks nodig. Zie Namen en voorbeelden.

Parameterwaarden

  • location_name

    De naam van de locatie die moet worden gemaakt.

  • ALS DEZE NIET BESTAAT

    Hiermee maakt u een locatie met de opgegeven naam als deze niet bestaat. Als er al een locatie met dezelfde naam bestaat, gebeurt er niets.

  • url_str

    Een STRING letterlijke naam met de locatie van de cloudopslag die wordt beschreven als een absolute URL. Moet tussen enkele aanhalingstekens staan.

  • credential_name

    De benoemde referentie die wordt gebruikt om verbinding te maken met deze locatie.

  • commentaar

    Een optionele beschrijving voor de locatie of NULL. De standaardwaarde is NULL.

Voorbeelden

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

Noteer de backticks (` `) rond de namen van de externe locatie en opslagreferenties in het volgende voorbeeld. Backticks zijn vereist voor objectnamen die speciale tekens bevatten, zoals afbreekstreepjes (-). Objectnamen met onderstrepingstekens (_), zoals die in het vorige voorbeeld, vereisen geen backticks. Zie Namen.

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