ODBC ジェネリック型の外部データにアクセスするための PolyBase の構成

[アーティクル]
05/30/2023

適用対象: SQL Server

SQL Server 2019 以降の PolyBase では、ODBC コネクタを使用して ODBC と互換性のあるデータソースに接続できます。

この記事では、ODBC データソースを使用して接続構成を作成する方法について説明します。提供されるガイダンスでは、例として 1 つの特定の ODBC ドライバーを使用します。特定の例については、ODBC プロバイダーにお問い合わせください。適切な接続文字列のオプションを決定するには、データソースの ODBC ドライバーに関するドキュメントを参照してください。この記事の例は、特定の ODBC ドライバーには適用されない場合があります。

前提条件

Note

この機能を使用するには、SQL Server on Windows が必要です。

PolyBase をインストールし、SQL Server インスタンス用に有効にする必要があります (PolyBase のインストール)。
データベーススコープ資格情報より前に、マスターキーを作成しておく必要があります。

ODBC ドライバーをインストールする

各 PolyBase ノードで、接続するデータソースの ODBC ドライバーをダウンロードしてインストールします。ドライバーが適切にインストールされたら、[ODBC データソースの管理者] からドライバーを表示してテストできます。

PolyBase スケールアウトグループ

上の例で、赤色の円で囲んでいるのがドライバーの名前です。外部データソースを作成するときに、この名前を使用します。

重要

クエリのパフォーマンスを向上させるために、接続プールを有効にします。この操作は、[ODBC データソースの管理者] から実行できます。

SQL Server に依存オブジェクトを作成する

ODBC データソースを使用するには、最初にいくつかのオブジェクトを作成して構成を完了する必要があります。

このセクションでは以下の Transact-SQL コマンドが使用されます。

ODBC ソースにアクセスするために、データベーススコープ資格情報を作成します。
```
CREATE DATABASE SCOPED CREDENTIAL [<credential_name>] WITH IDENTITY = '<username>', Secret = '<password>';
```
たとえば、次の例では、username という ID と複雑なパスワードを使用して、credential_name という名前の資格情報を作成します。
```
CREATE DATABASE SCOPED CREDENTIAL credential_name WITH IDENTITY = 'username', Secret = 'BycA4ZjrE#*2W%!';
```
CREATE EXTERNAL DATA SOURCE を使用して外部データソースを作成します。
```
CREATE EXTERNAL DATA SOURCE [<external_data_source_name>]
WITH ( LOCATION = 'odbc://<ODBC server address>[:<port>]',
CONNECTION_OPTIONS = 'Driver={<Name of Installed Driver>};
ServerNode = <name of server  address>:<Port>',
-- PUSHDOWN = [ON] | OFF,
CREDENTIAL = [<credential_name>] );
```
次の例では、以下の条件で外部データソースを作成します。
- 名前 external_data_source_name
- ODBC SERVERNAME およびポート 4444に配置する
- CData ODBC Driver For SAP 2015 に接続する - これは、「ODBC ドライバーをインストールする」で作成したドライバーです。
- ServerNodesap_server_node のポート 5555
- サーバーへのプッシュダウンを処理できるように構成する (PUSHDOWN = ON)
- 資格情報 credential_name を使用する
```
CREATE EXTERNAL DATA SOURCE external_data_source_name
WITH ( LOCATION = 'odbc://SERVERNAME:4444',
CONNECTION_OPTIONS = 'Driver={CData ODBC Driver For SAP 2015};
ServerNode = sap_server_node:5555',
PUSHDOWN = ON,
CREDENTIAL = credential_name );
```

外部テーブルを作成する

依存オブジェクトを作成したら、T-SQL を使用して外部テーブルを作成できます。

このセクションでは以下の Transact-SQL コマンドが使用されます。

1 つ以上の外部テーブルを作成します。

外部テーブルを作成します。 DATA_SOURCE 引数を使用して上で作成した外部データソースを参照し、ソーステーブルを LOCATION として指定する必要があります。すべての列を参照する必要はありませんが、型が正しくマップされていることを確認する必要があります。
```
  CREATE EXTERNAL TABLE [<your_table_name>]
  (
  [<col1_name>]     DECIMAL(38) NOT NULL,
  [<col2_name>]     DECIMAL(38) NOT NULL,
  [<col3_name>]     CHAR COLLATE Latin1_General_BIN NOT NULL
  )
  WITH (
  LOCATION='<sap_table_name>',
  DATA_SOURCE= [<external_data_source_name>]
  )
  ;
```
Note

この外部データソースを使用するすべての外部テーブルで依存オブジェクトを再利用できることに注意してください。
省略可能: 外部テーブルの統計を作成します。

クエリのパフォーマンスを最適化するには、外部テーブルの列、特に結合、フィルター、集計に使用される列に統計を作成することをお勧めします。
```
CREATE STATISTICS statistics_name ON contact (FirstName) WITH FULLSCAN; 
```

次のステップ

PolyBase の詳細については、SQL Server PolyBase の概要に関する記事をご覧ください。

さまざまなデータソースへの外部データソースと外部テーブルの作成に関するその他のチュートリアルについては、「PolyBase Transact-SQL リファレンス」を参照してください。

次の方法で共有