CREATE EXTERNAL LOCATION

  • Artikel

Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 10.4 LTS und höher Häkchen gesetzt ja nur für Unity Catalog

Erstellt einen externen Speicherort mit dem angegebenen Namen. Wenn bereits ein Speicherort mit demselben Namen vorhanden ist, wird eine Ausnahme ausgelöst.

Anleitungen dazu finden Sie unter Erstellen eines externen Speicherorts zum Verbinden des Cloudspeichers mit Azure Databricks.

Syntax

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

Jeder Objektname, der Sonderzeichen enthält, z. B. Bindestriche (-), muss von Backticks (` `) umgeben sein. Objektnamen mit Unterstrichen (_) erfordern keine Backticks. Siehe Namen und Beispiele.

Parameter

  • location_name

    Der Name des zu erstellenden Speicherorts.

  • IF NOT EXISTS

    Erstellt einen Speicherort mit dem angegebenen Namen, wenn er nicht vorhanden ist. Wenn bereits ein Standort mit dem gleichen Namen vorhanden ist, geschieht nichts.

  • url_str

    Ein STRING-Literal mit dem Speicherort des Cloudspeichers, beschrieben als absolute URL. Muss von einzelnen Anführungszeichen umgeben sein.

  • credential_name

    Die benannten Anmeldeinformationen, die für die Verbindung mit diesem Speicherort verwendet werden.

  • Kommentar

    Eine optionale Beschreibung für den Speicherort oder NULL. Der Standardwert ist NULL.

Beispiele

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

Beachten Sie die Backticks (` `) um den externen Speicherort und die Namen der Speicheranmeldeinformationen im folgenden Beispiel. Backticks sind für Objektnamen erforderlich, die Sonderzeichen enthalten, z. B. Bindestriche (-). Objektnamen mit Unterstrichen (_), z. B. die im vorherigen Beispiel, erfordern keine Backticks. Siehe 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';