CREATE EXTERNAL LOCATION

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime 10.4 LTS 及更高版本 勾选“是” 仅 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';