CREATE EXTERNAL LOCATION

项目
04/12/2024

适用于：勾选“是” Databricks SQL Databricks Runtime 10.3 及更高版本仅 Unity Catalog

创建具有指定名称的外部位置。如果已存在同名位置，则会引发异常。

有关操作说明，请参阅创建外部位置以将云存储连接到 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

将云存储的位置描述为绝对 URL 的 STRING 文本。必须用单引号括起来。
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.chinacloudapi.cn/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.chinacloudapi.cn/location'
    WITH (STORAGE CREDENTIAL `abfss-remote-cred`)
    COMMENT 'Default source for Azure exernal data';