CREATE EXTERNAL DATA SOURCE (Transact-SQL)

SQL Server、Azure SQL Database、Azure SQL Managed Instance、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 Storage アカウント (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) 以降 階層型名前空間がサポートされています。	Shared Access Signature (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) 以降	Shared Access Signature (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 または MongoDB 用 Cosmos DB API	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) 以降	Shared Access Signature (SAS)
S3 互換オブジェクト ストレージ	s3	- S3 互換: s3://<server_name>:<port>/ - AWS S3: s3://<bucket_name>.S3.amazonaws.com[:port]/<folder> or s3://s3.amazonaws.com[:port]/<bucket_name>/<folder>	SQL Server 2022 (16.x) 以降	Basic またはパススルー (STS) *

* データベース スコープの資格情報である必要があります IDENTITY は IDENTITY = 'S3 Access Key' にハードコーディングされ、SECRET 引数は = '<AccessKeyID>:<SecretKeyID>' 形式であるか、パススルー (STS) 承認を使用します。 詳しくは、「S3 互換オブジェクト ストレージの外部データにアクセスするように PolyBase を構成する」をご覧ください。

場所のパス:

• 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 に接続できます。
• Driver={<Name of Driver>} 経由で接続する際に ODBC を指定します。
• プレフィックス adls を使用する Azure ストレージ アカウント (V2) の階層型名前空間オプションは、SQL Server 2022 (16.x) の Azure Data Lake Storage Gen2 でサポートされています。

• 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 の詳細については、「S3 互換オブジェクト ストレージ内の外部データにアクセスするように PolyBase を構成する」を参照してください。 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 Storage の CSV ファイルを仮想化する例については、「PolyBase を使って CSV ファイルを仮想化する」を参照してください。
• PolyBase を使って ADLS Gen2 のデルタ テーブルを仮想化する例については、「PolyBase を使ってデルタ ファイルを仮想化する」を参照してください。
• SQL Server 2022 (16.x) では、Azure Storage Account v2 (abs) と Azure Data Lake Gen2 (adls) の両方に対して 2 つの URL 形式が完全にサポートされています。
  • LOCATION パスには、形式 <container>@<storage_account_name>.. (推奨) または <storage_account_name>../<container> を使用できます。 例:
    • Azure Storage Account 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、Cosmos DB、MongoDB 用 Azure Cosmos DB API の組み込み 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) 以降 外部データ ソースに計算をプッシュ ダウンできるかどうかを示します。 既定でオンです。

PUSHDOWN は、外部データ ソース レベルで SQL Server、Oracle、Teradata、MongoDB、MongoDB 用 Azure Cosmos DB API、または ODBC に接続するときにサポートされます。

クエリ レベルでプッシュ ダウンを有効にするか、無効にするかは、ヒントによって実現します。

CREDENTIAL = credential_name

外部データ ソースへの認証の資格情報のデータベース スコープを指定します。

資格情報の作成時の追加の注意事項とガイダンス:

• CREDENTIAL は、データがセキュリティ保護されている場合にのみ必須です。 匿名アクセスを許可するデータ セットには、CREDENTIAL は必要ありません。
• Azure Storage アカウント (V2) または Azure Data Lake Storage Gen2 にアクセスする場合、IDENTITY は SHARED ACCESS SIGNATURE である必要があります。
  • 例については、一括操作を実行し、Azure Storage から SQL Database にデータを取得するための外部データ ソースの作成に関するセクションを参照してください。

Shared Access Signature を作成する方法は複数あります。

• SAS トークンを作成するには、Azure portal -><ご利用のストレージ アカウント> -> [Shared Access Signature] -> [アクセス許可の構成] -> [SAS と接続文字列を生成する] の順に移動します。 詳細については、Shared Access Signature の作成に関するページを参照してください。

• Azure Storage Explorer を使用して SAS を作成および構成できます。

• PowerShell、Azure CLI、.NET、REST API を使用すれば、SAS をプログラムで作成できます。 詳細については、「Shared Access Signatures (SAS) を使用して Azure Storage リソースへの制限付きアクセスを許可する」を参照してください。

• SAS トークンは、次のように構成する必要があります。

  • SAS トークンが生成されると、トークンの先頭に疑問符 ("?") が含まれます。 SECRET として構成されている場合、先頭の ? を除外します。
  • 有効な有効期限を使用する (すべての日付が UTC 時間)。
  • 読み込む必要のあるファイル (たとえば srt=o&sp=r) に対して少なくとも読み取りアクセス許可を付与します。 さまざまなユース ケースに合わせて複数の Shared Access Signature を作成できます。 アクセス許可は次のように付与する必要があります。

  アクション	権限
  データをファイルから読み取る	Read
  複数のファイルとサブフォルダーからデータを読み取る	Read と List
  Create External Table as Select (CETAS) を使う	読み取り、作成、一覧表示、書き込み

• Azure Blob Storage と Azure Data Lake Gen 2 の場合:

  • 許可されるサービス: SAS トークンを生成するには、Blob を選択する必要があります
  • 許可されるリソースの種類: SAS トークンを生成するには、Container と Object を選択する必要があります

CREDENTIAL を S3 互換オブジェクト ストレージと PolyBase と共に使用する例については、「S3 互換オブジェクト ストレージの外部データにアクセスするように PolyBase を構成する」を参照してください。

データベース スコープ資格情報を作成するには、「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 Storage に接続するときに新しいコネクタを使用するように外部データ ソースを構成する必要があります。

外部データ ソース	ソース	終了
Azure Blob Storage	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 を使用して認証することもできます。

Applies to: SQL Server 2022 (16.x) 累積的な更新プログラム 2 以降、CREATE EXTERNAL DATA SOURCEは Oracle に接続するときに TNS ファイルの使用をサポートするようになりました。 CONNECTION_OPTIONS パラメーターが展開されるともに、このパラメーターによって、TNSNamesFile と ServerName を変数として使用して tnsnames.ora ファイルを参照することでサーバーとの接続が確立されるようになりました。

次の例では、TNSNamesFile によって指定された tnsnames.ora ファイルの場所と ServerName によって指定されたホストとネットワーク ポートの検索が、実行中に SQL Server によって行われます。

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 を指定します。 さらに、可用性データベースをCONNECTION_OPTIONSでDatabase={dbname}として設定するか、可用性データベースをデータベース スコープ資格情報に使用されるログインの既定のデータベースとして設定する必要があります。 これは、可用性グループのすべての可用性レプリカで行う必要があります。

まず、データベース スコープの資格情報を作成して、SQL 認証ログインのための資格情報を保存します。 PolyBase 用の SQL ODBC コネクタでサポートされるのは基本認証のみです。 データベース スコープ資格情報を作成する前に、データベースに資格情報を保護するためのマスター キーが必要です。 詳細については、「CREATE MASTER KEY」を参照してください。 次の例では、データベース スコープの資格情報を作成し、自分のログインとパスワードを指定します。

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

次に、新しい外部データ ソースを作成します。

CONNECTION_OPTIONSにDatabase=dbnameを含める場合も、可用性データベースをデータベース スコープ資格情報のログインの既定のデータベースとして設定する場合でも、LOCATION パラメーター内の CREATE EXTERNAL TABLE ステートメントで 3 部構成の名前を使用してデータベース名を指定する必要があります。 例については、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
);

ApplicationIntent を指定して、システム ビュー sys.servers で外部テーブルを作成することにより、可用性グループのリダイレクト動作を実演できます。 次のサンプル スクリプトでは、2 つの外部データ ソースが作成され、それぞれに対して 1 つの外部テーブルが作成されます。 ビューを使用して、どのサーバーが接続に応答しているかをテストします。 読み取り専用ルーティング機能を使用しても同様の結果を得ることができます。 詳細については、「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 to 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 Storage

Shared Access Signature を作成する

Azure Blob Storage と Azure Data Lake Gen2 の両方でサポートされる認証方法は Shared Access Signature (SAS) です。 Shared Access Signature トークンを生成する簡単な方法の 1 つは、次の手順を実行することです。 詳細については、資格情報に関するページを参照してください。

1. Azure portal で目的のストレージ アカウントに移動します。
2. [データ ストレージ] メニューから目的のコンテナーに移動します。
3. [共有アクセス トークン] を選びます。
4. 次の表を参照して、目的のアクションに応じて適切なアクセス許可を選びます。

アクション	権限
データをファイルから読み取る	Read
複数のファイルとサブフォルダーからデータを読み取る	Read と List
Create External Table as Select (CETAS) を使う	Read、Create、Write

5. トークンの有効期限を選びます。
6. SAS トークンと URL を生成します。
7. SAS トークンをコピーします。

F. abs:// インターフェイスを使用して Azure Blob Storage のデータにアクセスするための外部データ ソースを作成する

適用対象: 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 Token を使用します。

-- 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 Storage に格納された 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 の末尾に、 / 、ファイル名、Shared Access Signature パラメーターを追加しないでください。

H. Azure Storage からデータを取得する一括操作用の外部データ ソースを作成する

適用対象: SQL Server 2022 (16.x) 以降。

BULK INSERT または OPENROWSET を使用する一括操作に対し、次のデータ ソースを使用します。 資格情報は、SHARED ACCESS SIGNATURE を ID として設定する必要があり、SAS トークンの先頭に ? があってはなりません。また、読み込む必要のあるファイル (たとえば srt=o&sp=r) に対して少なくとも読み取りアクセス許可が必要で、有効期限が有効である必要があります (すべての日付は UTC 時間です)。 Shared Access Signature に関する詳細については、「Shared Access Signature (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)
• Shared Access Signatures (SAS) の使用
• PolyBase 接続構成