Delen via

CREATE EXTERNAL LOCATION

  • Artikel

nl-NL: Van toepassing op:vinkje met ja Databricks SQL vinkje met ja Databricks Runtime 10.4 LTS en hoger vinkje met 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 Een externe locatie maken om cloudopslag te verbinden met Azure Databricks voor instructies.

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 (_) vereisen geen backticks. Zie Namen en voorbeelden.

Parameters

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