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.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
• DESCRIBE EXTERNAL LOCATION
• DROP EXTERNAL LOCATION
• 外部位置和存储凭据
• SHOW EXTERNAL LOCATIONS