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]
任何包含特殊字符的对象名称(如连字符 (-
))都必须用反引号 (` `
) 引起来。 带下划线 (_
) 的对象名称不需要反撇号。 请参阅名称和示例。
参数
-
要创建的位置的名称。
IF NOT EXISTS
创建具有给定名称的位置(如果不存在)。 如果已存在同名位置,则不会执行任何操作。
url_str
将云存储的位置描述为绝对 URL 的
STRING
文本。 必须用单引号括起来。-
用于连接到此位置的命名凭据。
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';