CREATE EXTERNAL DATA SOURCE (Transact-SQL)

使用 SQL Server、Azure SQL 数据库、Azure SQL 托管实例、Azure Synapse Analytics、Analytics Platform System (PDW) 或 Azure SQL Edge 创建外部数据源，以用于查询。

本文提供所选任何 SQL 产品的语法、参数、注解、权限和示例。

选择一个产品

在下面的行中，选择你感兴趣的产品名称，系统将只显示该产品的信息。

* SQL Server *  

SQL 数据库

SQL 托管
实例

Azure Synapse
分析

Analytics Platform
System (PDW)

 

概述：SQL Server 2022

适用于： SQL Server 2022 （16.x） 及更高版本

为 PolyBase 查询创建外部数据源。 外部数据源用于建立连接以及支持以下这些用例：

• 使用 PolyBase 执行数据虚拟化和数据加载
• 使用 BULK INSERT 或 OPENROWSET 大容量加载操作

注意

此语法在不同版本的 SQL Server 之间有所不同。 使用版本选择器下拉列表选择适当版本。 此内容适用于 SQL Server 2022 (16.x) 及更高版本。

SQL Server 2022 及更高版本的语法

有关语法约定的详细信息，请参阅 Transact-SQL 语法约定。

CREATE EXTERNAL DATA SOURCE <data_source_name>
WITH
  ( [ LOCATION = '<prefix>://<path>[:<port>]' ]
    [ [ , ] CONNECTION_OPTIONS = '<key_value_pairs>'[,...]]
    [ [ , ] CREDENTIAL = <credential_name> ]
    [ [ , ] PUSHDOWN = { ON | OFF } ]
  )
[ ; ]

参数

data_source_name

指定数据源的用户定义名称。 该名称在 SQL Server 数据库中必须唯一。

LOCATION = '<prefix>://<path[:port]>'

提供连接协议和外部数据源的路径。

外部数据源	连接器位置前缀	位置路径	产品/服务支持的位置	身份验证
Azure 存储帐户 (V2)	abs	abs://<container_name>@<storage_account_name>.blob.core.windows.net/ 或 abs://<storage_account_name>.blob.core.windows.net/<container_name>	自 SQL Server 2022 (16.x) 起 支持分层命名空间。	共享访问签名 (SAS)
Azure Data Lake Storage Gen2	adls	adls://<container_name>@<storage_account_name>.dfs.core.windows.net/ 或 adls://<storage_account_name>.dfs.core.windows.net/<container_name>	自 SQL Server 2022 (16.x) 起	共享访问签名 (SAS)
SQL Server	sqlserver	<server_name>[\<instance_name>][:port]	自 SQL Server 2019 (15.x) 起	仅 SQL 身份验证
Oracle	oracle	<server_name>[:port]	自 SQL Server 2019 (15.x) 起	仅基本身份验证
Teradata	teradata	<server_name>[:port]	自 SQL Server 2019 (15.x) 起	仅基本身份验证
MongoDB 或 Cosmos DB API for MongoDB	mongodb	<server_name>[:port]	自 SQL Server 2019 (15.x) 起	仅基本身份验证
泛型 ODBC	odbc	<server_name>[:port]	自 SQL Server 2019 (15.x) 起 - 仅限 Windows	仅基本身份验证
批量操作	https	<storage_account>.blob.core.windows.net/<container>	自 SQL Server 2017 (14.x) 起	共享访问签名 (SAS)
S3 兼容的对象存储	s3	- S3 兼容： s3://<server_name>:<port>/ - AWS S3： s3://<bucket_name>.S3.amazonaws.com[:port]/<folder> 或 s3://s3.amazonaws.com[:port]/<bucket_name>/<folder>	自 SQL Server 2022 (16.x) 起	基本或直通 （STS） *

* 必须是 数据库范围的凭据，其中 IDENTITY 硬编码， IDENTITY = 'S3 Access Key' SECRET 参数采用格式 = '<AccessKeyID>:<SecretKeyID>' 或使用直通 （STS） 授权。 有关详细信息，请参阅配置 PolyBase 以访问 S3 兼容的对象存储中的外部数据。

位置路径：

• port = 外部数据源侦听的端口。 在许多情况下（具体取决于网络配置）是可选的。
• <container_name> = 保存数据的存储帐户的容器。 根容器是只读的，数据无法写回容器。
• <storage_account> = Azure 资源的存储帐户名称。
• <server_name> = 主机名。
• <instance_name> = SQL Server 命名实例的名称。 如果在目标实例上运行 SQL Server Browser 服务，则使用此路径。
• <ip_address>:<port> = 仅适用于与 S3 兼容的对象存储（从 SQL Server 2022 (16.x) 开始），用于连接到与 S3 兼容的存储的终结点和端口。
• <bucket_name> = 仅适用于 S3 兼容的对象存储（从 SQL Server 2022 （16.x）开始），特定于存储平台。
• <region> = 仅适用于 S3 兼容的对象存储（从 SQL Server 2022 （16.x）开始），特定于存储平台。
• <folder> = 存储 URL 中的存储路径的一部分。

设置位置时的其他说明和指南：

• 创建对象时，SQL Server 数据库引擎不会验证外部数据源是否存在。 要进行验证，请使用外部数据源创建外部表。
• 可使用 sqlserver 连接器将 SQL Server 2019 (15.x) 连接到另一个 SQL Server 或 Azure SQL 数据库。
• 通过 ODBC 连接时，请指定 Driver={<Name of Driver>}。
• 在 SQL Server 2022 (16.x) 中，支持在 Azure Data Lake Storage Gen2 中通过前缀 adls 对 Azure 存储帐户 (V2) 使用分层命名空间选项。

• SQL Server 对 HDFS Cloudera (CDP) 和 Hortonworks (HDP) 外部数据源的支持将停用，不会包含在 SQL Server 2022 (16.x) 中。 SQL Server 2022 (16.x) 中无需使用 TYPE 参数。
• 有关从 SQL Server 2022 (16.x) 开始的 S3 兼容对象存储和 PolyBase 的详细信息，请参阅配置 PolyBase 以访问 S3 兼容对象存储中的外部数据。 有关在 S3 兼容对象存储中查询 parquet 文件的示例，请参阅使用 PolyBase 虚拟化 S3 兼容对象存储中的 parquet 文件。
• 与以前的版本不同，在 SQL Server 2022 (16.x) 中，用于 Azure 存储帐户 (v2) 的前缀已从 wasb[s] 更改为 abs。
• 与以前的版本不同，在 SQL Server 2022 (16.x) 中，用于 Azure Data Lake Storage Gen2 的前缀已从 abfs[s] 更改为 adls。
• 有关使用 PolyBase 在 Azure 存储中直观呈现 CSV 文件的示例，请参阅使用 PolyBase 虚拟化 CSV 文件。
• 有关使用 PolyBase 在 ADLS Gen2 中虚拟化 Delta 表的示例，请参阅使用 PolyBase 虚拟化 Delta 表。
• SQL Server 2022 (16.x) 完全支持 Azure 存储帐户 v2 (abs) 和 Azure Data Lake Gen2 (adls) 的两种 URL 格式。
  • LOCATION 路径可以使用格式：<container>@<storage_account_name>..（建议）或 <storage_account_name>../<container>。 例如：
    • Azure 存储帐户 v2：abs://<container>@<storage_account_name>.blob.core.windows.net（建议）或 abs://<storage_account_name>.blob.core.windows.net/<container>。
    • Azure Data Lake Gen2 支持：adls://<container>@<storage_account_name>.blob.core.windows.net（建议）或 adls://<storage_account_name>.dfs.core.windows.net/<container>。

CONNECTION_OPTIONS = key_value_pair

针对 SQL Server 2019 (15.x) 及更高版本指定。 通过 ODBC 连接到外部数据源时指定其他选项。 若要使用多个连接选项，请用分号分隔它们。

适用于通用 ODBC 连接，还适用于 SQL Server、Oracle、Teradata、MongoDB 和 Azure Cosmos DB API for MongoDB 的内置 ODBC 连接器。

key_value_pair 是特定连接选项的关键字和值。 哪些关键字和值可用由外部数据源类型决定。 驱动程序的名称是必需的（最基本的要求），但设置其他选项（例如 APP='<your_application_name>' 或 ApplicationIntent= ReadOnly|ReadWrite）也很有用，可以帮助进行故障排除。

可能的键值对特定于驱动程序。 有关每个提供程序的详细信息，请参阅 CREATE EXTERNAL DATA SOURCE (Transact-SQL) CONNECTION_OPTIONS。

从 适用范围开始： SQL Server 2022 （16.x） 累积更新 2，引入了其他关键字以支持 Oracle TNS 文件：

• 关键字 TNSNamesFile 指定位于 Oracle 服务器上的 tnsnames.ora 文件的文件路径。
• 关键字 ServerName 指定 tnsnames.ora 内使用的别名，该别名将用于替换主机名和端口。

PUSHDOWN = 打开 | 关闭

适用于：SQL Server 2019 (15.x) 及更高版本。 说明是否可以将计算下推到外部数据源。 它默认处于打开状态。

在外部数据源级别连接到 SQL Server、Oracle、Teradata、MongoDB、Azure Cosmos DB API for MongoDB 或 ODBC 时，支持使用 PUSHDOWN。

通过提示实现在查询级别启用或禁用下推。

CREDENTIAL = credential_name

指定用于对外部数据源进行身份验证的数据库范围凭据。

创建凭证时的其他说明和指导：

• 只有在数据得到保护的情况下才需要 CREDENTIAL。 允许匿名访问的数据集不需要 CREDENTIAL。
• 访问 Azure 存储帐户 (V2) 或 Azure Data Lake Storage Gen2 时，IDENTITY 必须为 SHARED ACCESS SIGNATURE。
  • 有关示例，请参阅创建外部数据源以执行批量操作并将数据从 Azure 存储检索到 SQL 数据库。

创建共享访问签名的方式有很多种：

• 可以导航到“Azure 门户”->“<Your_Storage_Account>”->“共享访问签名”->“配置权限”->“生成 SAS 和连接字符串”来创建 SAS 令牌。 有关详细信息，请参阅生成共享访问签名。

• 可使用 Azure 存储资源管理器创建和配置 SAS。

• 可以通过 PowerShell、Azure CLI、.NET 和 REST API 以编程方式创建 SAS。 有关详细信息，请参阅使用共享访问签名 (SAS) 授予对 Azure 存储资源的有限访问权限。

• 应按如下所示配置 SAS 令牌：

  • 生成某个 SAS 令牌时，其开头会包含问号（“?”）。 配置为密码时排除前导 ?。
  • 使用有效的有效期（所有日期均采用 UTC 时间）。
  • 至少授予对应加载的文件的读取权限（例如 srt=o&sp=r）。 可以为不同的用例创建多个共享访问签名。 应按如下所示授予权限：

  操作	权限
  从文件中读取数据	读取
  从多个文件和子文件夹读取数据	读取和列出
  使用 Create External Table as Select (CETAS)	读取、创建、列出和写入

• 对于 Azure Blob 存储和 Azure Data Lake Gen 2：

  • 允许的服务：必须选择 Blob 才能生成 SAS 令牌
  • 允许的资源类型：必须选择 Container 和 Object 才能生成 SAS 令牌

有关将 CREDENTIAL 与 S3 兼容对象存储和 PolyBase 结合使用的示例，请参阅配置 PolyBase 以访问 S3 兼容对象存储中的外部数据。

要创建数据库范围凭据，请参阅 CREATE DATABASE SCOPED CREDENTIAL (Transact-SQL)。

权限

需要对 SQL Server 中数据库的 CONTROL 权限。

锁定

对 EXTERNAL DATA SOURCE 对象采用共享锁。

安全性

PolyBase 支持大多数外部数据源的基于代理的身份验证。 创建数据库范围凭据以创建代理帐户。

升级到 SQL Server 2022

从 SQL Server 2022 (16.x) 开始，不再支持 Hadoop 外部数据源。 需要手动重新创建以前使用 TYPE = HADOOP 创建的外部数据源，以及使用此外部数据源的任何外部表。

用户还需要将其外部数据源配置为在连接到 Azure 存储时使用新连接器。

外部数据源	源	功能
Azure Blob 存储	wasb[s]	abs
ADLS Gen2	abfs[s]	adls

示例

重要

有关如何安装和启用 PolyBase 的信息，请参阅在 Windows 上安装 PolyBase

A. 在 SQL Server 中创建外部数据源以引用 Oracle

要创建引用 Oracle 的外部数据源，请确保具有数据库范围凭据。 也可以选择针对此数据源启用或禁用计算下推。

-- Create a database master key if one does not already exist, using your own password.
-- This key is used to encrypt the credential secret in next step.
CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<password>';

-- Create a database scoped credential with Azure storage account key as the secret.
CREATE DATABASE SCOPED CREDENTIAL OracleProxyAccount
    WITH IDENTITY = 'oracle_username',
    SECRET = 'oracle_password';

CREATE EXTERNAL DATA SOURCE MyOracleServer
WITH (
    LOCATION = 'oracle://145.145.145.145:1521',
    CREDENTIAL = OracleProxyAccount,
    PUSHDOWN = ON
);

（可选）Oracle 的外部数据源可以使用代理身份验证提供精细的访问控制。 可以将代理用户配置为，与被模拟的用户相比，具有有限的访问权限。

CREATE DATABASE SCOPED CREDENTIAL [OracleProxyCredential]
    WITH IDENTITY = 'oracle_username',
    SECRET = 'oracle_password';

CREATE EXTERNAL DATA SOURCE [OracleSalesSrvr]
WITH (
    LOCATION = 'oracle://145.145.145.145:1521',
    CONNECTION_OPTIONS = 'ImpersonateUser=%CURRENT_USER',
    CREDENTIAL = [OracleProxyCredential]
);

或者，可以使用 TNS 进行身份验证。

从适用范围开始：SQL Server 2022 （16.x） 累积更新 2，CREATE EXTERNAL DATA SOURCE现在支持在连接到 Oracle 时使用 TNS 文件。 CONNECTION_OPTIONS 参数已扩展，现在使用 TNSNamesFile 和 ServerName 作为变量来浏览 tnsnames.ora 文件并与服务器建立连接。

在下面的示例中，在运行时，SQL Server 将搜索由 TNSNamesFile 指定的 tnsnames.ora 文件位置，并搜索由 ServerName 指定的主机和网络端口。

CREATE EXTERNAL DATA SOURCE [external_data_source_name]
WITH (
    LOCATION = N'oracle://XE',
    CREDENTIAL = [OracleCredentialTest],
    CONNECTION_OPTIONS = N'TNSNamesFile=C:\Temp\tnsnames.ora;ServerName=XE'
);

B. 创建外部数据源以通过 PolyBase 连接引用 SQL Server 命名实例

适用于：SQL Server 2019 (15.x) 及更高版本

要创建引用 SQL Server 命名实例的外部数据源，请使用 CONNECTION_OPTIONS 指定实例名称。

首先，创建数据库限定范围的凭据，为经过身份验证的 SQL 登录名存储凭据。 用于 PolyBase 的 SQL ODBC 连接器仅支持基本身份验证。 创建数据库范围凭据之前，数据库必须具有主密钥用于保护凭据。 有关详细信息，请参阅 CREATE MASTER KEY。 以下示例创建数据库限定范围的凭据，提供自己的登录名和密码。

CREATE DATABASE SCOPED CREDENTIAL SQLServerCredentials
    WITH IDENTITY = 'username',
    SECRET = 'password';

在下面的示例中，WINSQL2019 是主机名，而 SQL2019 是实例名。 'Server=%s\SQL2019' 是键值对。

CREATE EXTERNAL DATA SOURCE SQLServerInstance2
WITH (
    LOCATION = 'sqlserver://WINSQL2019',
    CONNECTION_OPTIONS = 'Server=%s\SQL2019',
    CREDENTIAL = SQLServerCredentials
);

或者，可以使用端口连接到 SQL Server 默认实例。

CREATE EXTERNAL DATA SOURCE SQLServerInstance2
WITH (
    LOCATION = 'sqlserver://WINSQL2019:58137',
    CREDENTIAL = SQLServerCredentials
);

C. 创建外部数据源以引用 Always On 可用性组的可读次要副本

适用于：SQL Server 2019 (15.x) 及更高版本

要创建引用 SQL Server 的可读次要副本的外部数据源，请使用 CONNECTION_OPTIONS 指定 ApplicationIntent=ReadOnly。 此外，需要将可用性数据库 Database={dbname} 设置为 in CONNECTION_OPTIONS，或将可用性数据库设置为用于数据库作用域凭据的登录名的默认数据库。 需要在可用性组的所有可用性副本上执行此操作。

首先，创建数据库限定范围的凭据，为经过身份验证的 SQL 登录名存储凭据。 用于 PolyBase 的 SQL ODBC 连接器仅支持基本身份验证。 创建数据库范围凭据之前，数据库必须具有主密钥用于保护凭据。 有关详细信息，请参阅 CREATE MASTER KEY。 以下示例创建数据库限定范围的凭据，提供自己的登录名和密码。

CREATE DATABASE SCOPED CREDENTIAL SQLServerCredentials
    WITH IDENTITY = 'username',
    SECRET = 'password';

接下来，创建新的外部数据源。

无论是在Database=dbnameCONNECTION_OPTIONS数据库范围内凭据中包括可用性数据库还是将可用性数据库设置为登录名的默认数据库，仍必须在 LOCATION 参数中通过 CREATE EXTERNAL TABLE 语句中的三部分名称提供数据库名称。 有关示例，请参阅 CREATE EXTERNAL TABLE。

在下面的示例中，WINSQL2019AGL 是可用性组侦听程序名称，dbname 是要成为 CREATE EXTERNAL TABLE 语句目标的数据库的名称。

CREATE EXTERNAL DATA SOURCE SQLServerInstance2
WITH (
    LOCATION = 'sqlserver://WINSQL2019AGL',
    CONNECTION_OPTIONS = 'ApplicationIntent=ReadOnly; Database=dbname',
    CREDENTIAL = SQLServerCredentials
);

可以通过在系统视图 sys.servers 上指定 ApplicationIntent 并创建外部表来演示可用性组的重定向行为。 在以下示例脚本中，会创建两个外部数据源，并为每个外部数据源创建一个外部表。 使用视图测试哪个服务器在响应连接。 还可以通过只读路由功能实现类似结果。 有关详细信息，请参阅为 Always On 可用性组配置只读路由。

CREATE EXTERNAL DATA SOURCE [DataSource_SQLInstanceListener_ReadOnlyIntent]
WITH (
    LOCATION = 'sqlserver://WINSQL2019AGL',
    CONNECTION_OPTIONS = 'ApplicationIntent=ReadOnly; Database=dbname',
    CREDENTIAL = [SQLServerCredentials]
);
GO

CREATE EXTERNAL DATA SOURCE [DataSource_SQLInstanceListener_ReadWriteIntent]
WITH (
    LOCATION = 'sqlserver://WINSQL2019AGL',
    CONNECTION_OPTIONS = 'ApplicationIntent=ReadWrite',
    CREDENTIAL = [SQLServerCredentials]
);
GO

在可用性组的数据库内，创建视图以返回 sys.servers 和本地实例的名称，这可帮助确定哪个副本在响应查询。 有关详细信息，请参阅 sys.servers。

CREATE VIEW vw_sys_servers
AS
SELECT [name]
FROM sys.servers
WHERE server_id = 0;
GO

然后，在源实例上创建外部表：

CREATE EXTERNAL TABLE vw_sys_servers_ro (name SYSNAME NOT NULL)
WITH (
    DATA_SOURCE = [DataSource_SQLInstanceListener_ReadOnlyIntent],
    LOCATION = N'dbname.dbo.vw_sys_servers'
);
GO

CREATE EXTERNAL TABLE vw_sys_servers_rw (name SYSNAME NOT NULL)
WITH (
    DATA_SOURCE = [DataSource_SQLInstanceListener_ReadWriteIntent],
    LOCATION = N'dbname.dbo.vw_sys_servers'
);
GO

SELECT [name]
FROM dbo.vw_sys_servers_ro;--should return secondary replica instance

SELECT [name]
FROM dbo.vw_sys_servers_rw;--should return primary replica instance
GO

D. 通过 PolyBase 创建外部数据源以查询 S3 兼容对象存储中的 parquet 文件

适用于：SQL Server 2022 (16.x) 及更高版本

以下示例脚本在 SQL Server 的源用户数据库中创建外部数据源 s3_ds。 外部数据源引用 s3_dc 数据库范围的凭据。

CREATE DATABASE SCOPED CREDENTIAL s3_dc
    WITH IDENTITY = 'S3 Access Key', -- for S3-compatible object storage the identity must always be S3 Access Key
    SECRET = '<access_key_id>:<secret_key_id>' -- provided by the S3-compatible object storage
GO

CREATE EXTERNAL DATA SOURCE s3_ds
WITH (
    LOCATION = 's3://<ip_address>:<port>/',
    CREDENTIAL = s3_dc
);
GO

使用 sys.external_data_sources 验证新的外部数据源。

SELECT * FROM sys.external_data_sources;

然后，以下示例演示如何使用 T-SQL 通过 OPENROWSET 查询来查询存储在 S3 兼容的对象存储中的 parquet 文件。 有关详细信息，请参阅使用 PolyBase 虚拟化 S3 兼容对象存储中的 parquet 文件。

SELECT *
FROM OPENROWSET (
    BULK '/<bucket>/<parquet_folder>',
    FORMAT = 'PARQUET',
    DATA_SOURCE = 's3_ds'
) AS [cc];

E. 使用泛型 ODBC 创建到 PostgreSQL 的外部数据源

与前面示例一样，先创建数据库主密钥和数据库范围凭据。 数据库范围的凭据将用于外部数据源。 此示例还假定服务器上安装了适用于 PostgreSQL 的泛型 ODBC 数据提供程序。

在本例中，泛型 ODBC 数据提供程序用于连接到同一网络中的 PostgreSQL 数据库服务器，其中 PostgreSQL 服务器的完全限定域名为 POSTGRES1，使用的默认端口是 TCP 5432。

CREATE EXTERNAL DATA SOURCE POSTGRES1
WITH (
    LOCATION = 'odbc://POSTGRES1.domain:5432',
    CONNECTION_OPTIONS = 'Driver={PostgreSQL Unicode(x64)};',
    CREDENTIAL = postgres_credential
);

Azure 存储

创建共享访问签名

对于 Azure Blob 存储和 Azure Data Lake Gen2，支持的身份验证方法是共享访问签名 (SAS)。 生成共享访问签名令牌的一种简单方法，请执行以下步骤。 有关详细信息，请参阅凭据。

1. 导航到 Azure 门户中的所需存储帐户。
2. 导航到“数据存储”菜单下的所需容器。
3. 选择“共享访问令牌”。
4. 根据所需操作选择适当的权限，如需参考，请使用下表：

操作	权限
从文件中读取数据	读取
从多个文件和子文件夹读取数据	读取和列出
使用 Create External Table as Select (CETAS)	读取、创建和写入

5. 选择令牌的过期日期。
6. 生成 SAS 令牌和 URL。
7. 复制 SAS 令牌。

F. 创建外部数据源来使用 abs:// 接口访问 Azure Blob 存储中的数据

适用于：SQL Server 2022 (16.x) 及更高版本

从 SQL Server 2022 (16.x) 开始，为 Azure 存储帐户 v2 使用新前缀 abs。 abs 前缀支持使用 SHARED ACCESS SIGNATURE 进行身份验证。 abs 前缀替换了以前版本中使用的 wasb。 HADOOP 不再受支持，因此不再需要使用 TYPE = BLOB_STORAGE。

不再需要 Azure 存储帐户密钥，而是使用 SAS 令牌，如以下示例所示：

-- Create a database master key if one does not already exist, using your own password.
-- This key is used to encrypt the credential secret in next step.
CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<password>';
GO

CREATE DATABASE SCOPED CREDENTIAL AzureStorageCredentialv2
    WITH IDENTITY = 'SHARED ACCESS SIGNATURE', -- to use SAS the identity must be fixed as-is
    SECRET = '<Blob_SAS_Token>';
GO

-- Create an external data source with CREDENTIAL option.
CREATE EXTERNAL DATA SOURCE MyAzureStorage
WITH (
    LOCATION = 'abs://<container>@<storage_account_name>.blob.core.windows.net/',
    CREDENTIAL = AzureStorageCredentialv2,
);

有关如何访问存储在 Azure Blob 存储中的 CSV 文件的更详细示例，请参阅使用 PolyBase 虚拟化 CSV 文件。

G. 创建外部数据源以访问 Azure Data Lake Gen2 中的数据

适用于：SQL Server 2022 (16.x) 及更高版本

从 SQL Server 2022 (16.x) 开始，为 Azure Data Lake Gen2 使用新前缀 adls，替换以前版本中使用的 abfs。 前缀 adls 还支持将 SAS 令牌作为身份验证方法，如此示例所示：

--Create a database scoped credential using SAS Token
CREATE DATABASE SCOPED CREDENTIAL datalakegen2
    WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
    SECRET = '<DataLakeGen2_SAS_Token>';
GO

CREATE EXTERNAL DATA SOURCE data_lake_gen2_dfs
WITH (
    LOCATION = 'adls://<container>@<storage_account>.dfs.core.windows.net',
    CREDENTIAL = datalakegen2
);

有关如何访问存储在 Azure Data Lake Gen2 上的差异文件的更详细示例，请参阅使用 PolyBase 虚拟化差异文件。

示例：批量操作

重要

为批量操作配置外部数据源时，请勿在 LOCATION URL 的末尾放置尾随 /、文件名或共享访问签名参数。

H. 创建外部数据源以用于从 Azure 存储检索数据的批量操作

适用于：SQL Server 2022 (16.x) 及更高版本。

对使用 BULK INSERT 或 OPENROWSET 的批量操作使用以下数据源。 凭据必须设置 SHARED ACCESS SIGNATURE 作为标识、不应在 SAS 令牌中具有前导 ?、必须对应加载的文件（例如 srt=o&sp=r）至少具有读取权限，并且有效期应有效（所有日期均采用 UTC 时间）。 有关共享访问签名的详细信息，请参阅使用共享访问签名 (SAS)。

CREATE DATABASE SCOPED CREDENTIAL AccessAzureInvoices
WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
    -- Remove ? from the beginning of the SAS token
    SECRET = '<azure_shared_access_signature>';

CREATE EXTERNAL DATA SOURCE MyAzureInvoices
WITH (
    LOCATION = 'abs://<container>@<storage_account_name>.blob.core.windows.net/',
    CREDENTIAL = AccessAzureInvoices,
);

后续步骤

• ALTER EXTERNAL DATA SOURCE (Transact-SQL)
• CREATE DATABASE SCOPED CREDENTIAL (Transact-SQL)
• CREATE EXTERNAL FILE FORMAT (Transact-SQL)
• CREATE EXTERNAL TABLE (Transact-SQL)
• sys.external_data_sources (Transact-SQL)
• 使用共享访问签名 (SAS)
• PolyBase 连接配置