CREATE EXTERNAL LOCATION

適用於：Databricks SQL Databricks Runtime 10.4 LTS 和更新版本僅限 Unity 目錄

建立具有指定名稱的外部位置。 如果已有相同名稱的位置存在，則會擲回例外狀況。

如需操作說明，請參閱 建立外部位置以將雲端記憶體連線到 Azure Databricks。

語法

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

任何包含特殊字元的物件名稱，例如連字元 （-），都必須以反引號 （` `） 括住。 有底線的物件名稱 (_) 不需要反引號。 請參閱名稱和範例。

參數

• location_name

  要建立的位置名稱。

• IF NOT EXISTS

  如果指定名稱不存在，請建立具有指定名稱的位置。 如果具有相同名稱的位置已經存在，則不會發生任何動作。

• url_str

  具有 STRING 描述為絕對 URL 之雲端記憶體位置的常值。 必須以單引弧括住。

• credential_name

  用來連線至此位置的具名認證。

• comment

  位置或 NULL的選擇性描述。 預設值為 NULL。

例子

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

請注意下列範例中外部位置和記憶體認證名稱周圍的反引號 （` `）。 物件名稱需要反引號，包括特殊字元，例如連字元 （-）。 具有底線的物件名稱 （_），例如上一個範例中的名稱，不需要反引號。 請參閱名稱。

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

相關文章

• ALTER EXTERNAL LOCATION
• 描述外部位置
• DROP EXTERNAL LOCATION
• 外部位置和記憶體認證
• 顯示外部位置