CREATE EXTERNAL LOCATION (Databricks SQL)

  • 项目

重要

Unity Catalog 目前为公共预览版。 要使用该预览版，请联系 Azure Databricks 代表。

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

语法

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

参数

  • location_name

    要创建的位置的名称。

  • IF NOT EXISTS

    创建具有给定名称的位置（如果不存在）。 如果已存在同名位置，则不会执行任何操作。

  • url

    将云存储的位置描述为绝对 URL 的 STRING 文本。

  • credential_name

    用于连接到此位置的命名凭据。

  • comment

    位置的可选说明，或 NULL。 默认值为 NULL。

示例

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION abfss_remote URL 'abfss://us-east-1/location'
    WITH (STORAGE CREDENTIAL abfss_remote_cred)
    COMMENT 'Default source for Azure exernal data';