CREATE EXTERNAL DATA SOURCE (Transact-SQL)

使用 SQL Server、Azure SQL Database、Azure SQL 受控執行個體、Azure Synapse Analytics、Analytics Platform System (PDW) 或 Azure SQL Edge 來建立一個用於查詢的外部資料來源。

本文提供適用於您所選擇之 SQL 產品的語法、引數、備註、權限和範例。

選取產品

在以下資料列中，選取您感興趣的產品名稱，隨即只會顯示該產品的資訊。

* SQL Server *  

SQL Database

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 Database。
• 透過 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 引數。
• 如需從 2022 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 中虛擬化差異資料表的範例，請參閱使用 PolyBase 將差異資料表虛擬化。
• 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 = ON | OFF

適用於：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 Database。

有多種方式可以建立共用存取簽章：

• 您可以透過瀏覽到 [Azure 入口網站 -><Your_Storage_Account> -> 共用存取簽章 -> 設定權限 -> 產生 SAS 和連接字串] 來建立 SAS 權杖。 如需詳細資訊，請參閱產生共用存取簽章。

• 您可以使用 Azure 儲存體總管來建立和設定 SAS。

• 您可以透過 PowerShell、Azure CLI、.NET 和 REST API，以程式設計方式來建立 SAS。 如需詳細資訊，請參閱使用共用存取簽章 (SAS) 對 Azure 儲存體資源授與有限存取權。

• SAS 權杖應設定如下：

  • 產生 SAS 權杖時，權杖的開頭會包含問號 ('?')。 設定為 SECRET 時，請排除前置 ?。
  • 使用有效的到期時間 (所有日期都是 UTC 時間)。
  • 至少授與應載入檔案的讀取權限 (例如 srt=o&sp=r)。 可以針對不同的使用案例建立多個共用存取簽章。 應如下來授與權限：

  動作	權限
  從檔案讀取資料	Read
  從多個檔案和子資料夾讀取資料	讀取和列示
  使用 Create External Table as Select (CETAS)	讀取、建立、列示和寫入

• 針對 Azure Blob 儲存體 和 Azure Data Lake Gen 2：

  • 允許的服務： Blob 必須選取才能產生 SAS 令牌
  • 允許的資源類型： Container 必須選取 ， Object 才能產生 SAS 令牌

如需搭配與 S3 相容物件儲存體和 PolyBase 使用 CREDENTIAL 的範例，請參閱設定 PolyBase 以存取與 S3 相容物件儲存體中的外部資料。

若要建立資料庫範圍認證，請參閱 CREATE DATABASE SCOPED CREDENTIAL (Transact-SQL)。

權限

需要有對 SQL Server 中資料庫的 CONTROL 權限。

鎖定

對 EXTERNAL DATA SOURCE 物件採取共用鎖定。

安全性

PolyBase 支援大多數外部資料來源的 Proxy 驗證。 建立資料庫範圍認證以建立 Proxy 帳戶。

升級到 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 的外部資料源可以選擇性使用 Proxy 驗證來提供精細的存取控制項。 相較於模擬的使用者，Proxy 使用者可以設定為具有有限的存取權。

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} 中的 CONNECTION_OPTIONS，或將可用性資料庫設定為資料庫範圍認證所用登入的預設資料庫。 您必須在可用性群組的所有可用性複本上執行此動作。

首先，建立資料庫有限範圍認證，以儲存 SQL 驗證登入的認證。 適用於 PolyBase 的 SQL ODBC 連接器僅支援基本驗證。 在您建立資料庫有限範圍認證之前，資料庫必須具有保護認證的主要金鑰。 如需詳細資訊，請參閱 CREATE MASTER KEY。 下列範例會建立一個資料庫有限範圍認證，提供您自己的登入和密碼。

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

接下來，建立新的外部資料來源。

無論您是包含在 Database=dbname 中 CONNECTION_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)。 產生共用存取簽章權杖的一個簡單方法，即是遵循下列步驟。 如需詳細資訊，請參閱 CREDENTIAL。

1. 瀏覽至 Azure 入口網站和想要的儲存體帳戶。
2. 瀏覽至您想要的 [資料儲存體] 功能表下的 [容器]。
3. 選取 [共用存取權杖]。
4. 根據所需的動作來選擇適當的權限 (參考使用下表)：

動作	權限
從檔案讀取資料	Read
從多個檔案和子資料夾讀取資料	讀取和列示
使用 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 連線能力設定