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

2025-06-17

適用対象:SQL Server

SQL Server 2019 以降の PolyBase では、ODBC コネクタを使用して ODBC と互換性のあるデータソースに接続できます。 SQL Server 2025 (17.x) プレビュー以降、この機能は Linux で使用できます。

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

前提条件

注

SQL Server 2022 (16.x) 以前のバージョンでは、この機能には Windows 上の SQL Server が必要です。

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

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

使用しているオペレーティングシステムのインストール手順に従ってください。

SQL Server 2025 (17.x) プレビューでは、PolyBase sqlserver データソースの場合、既定で Microsoft ODBC Driver version 18 for SQL Server が使用されます。このドライバーは TDS 8.0 をサポートしており、さまざまな更新プログラム、機能、いくつかの破壊的変更が含まれています。 TDS 8.0 を使用するには、新しい暗号化オプションを使用し、信頼された証明書をサーバーにインストールする必要があります。

MICROSOFT ODBC Driver version 18 for SQL Server の詳細については、以下を参照してください。

SQL Server TDS 8.0 のサポートの詳細については、 TDS 8.0 を参照してください。

ウィンドウズ
リナックス

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

PolyBase スケールアウトグループのスクリーンショット。

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

重要

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

Ubuntu 上の SQL ODBC ドライバーの例を次に示します。

ヒント

PolyBase を Linux にまだインストールしていない場合は、インストールします。

Microsoft リポジトリを追加します。

Microsoft GPG キーをインポートします。

curl https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg

Microsoft リポジトリをシステムに追加します。

curl https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list

パッケージの一覧を更新します。
```
sudo apt update
```
ODBC ドライバーをインストールします。

最新バージョンの ODBC ドライバーをインストールします。次の例では、バージョン 18 をインストールします。
```
sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18
```

インストールでは、次のファイルが作成されます。

ファイル	説明
`/etc/odbcinst.ini`	ドライバー名、説明、バージョン情報。
`/etc/odbc.ini`	DSN 名、暗号化、およびその他の仕様。

ドライバーのプロパティと仕様に基づいて odbc.ini ファイルを作成する必要があります。複数のドライバーが同じ odbc.ini と odbcinst.ini ファイルを共有し、複数のエントリを持つ。

ファイルの例

odbc.ini の例

この例では、 driver_name は odbcinst.iniの名前と一致する必要があります。

[MyDSN]
Driver = driver_name
Server = your_server_name
Database = your_database_name
Trusted_Connection = yes

Sybase の odbcinst.ini の例

[ODBC Drivers]
Devart ODBC Driver for ASE=installed
[Devart ODBC Driver for ASE]
Driver=/usr/share/devart/odbcase/libdevartodbcase.3.5.0.so

Sybase の odbc.ini の例

[ODBC Data Sources]
DEVART_ASE=Devart ODBC Driver for ASE
[DEVART_ASE]
Driver=Devart ODBC Driver for ASE
Data Source=database_server_ip
Port=5000
Database=master
QuotedIdentifier=1

サポートされているパラメーターの完全な一覧については、ドライバープロバイダーのドキュメントを参照してください。

制限事項

PolyBase for SQL Server on Linux では、外部サービスを使用してドライバーを安全に分離して読み込みます。このサービスは、PolyBase パッケージ (mssql-server-polybase) のインストール時に既定で開始されます。

サービスでは、既定のポート番号 25100が使用されます。このポートが使用中の場合は、次のメッセージで失敗します。

Failed to bind port "127.0.0.1:25100"

このメッセージは、PolyBase のログファイルの /var/opt/mssql-polybase-ees/log/ にあります。 SQL Server 2025 (17.x) プレビュー以降のバージョンでは、場所は /var/opt/mssql/log/polybase-ees-logに移動しました。

修正するには、使用可能なポートを使用するようにサービスをカスタマイズし、再起動します。

/var/opt/mssql/binn/PolyBase/DMs.exe.config ファイルを検索して編集します。 EESPortキーエントリを見つけて、新しいポートを割り当てます。
/var/opt/mssql/binn/PolyBase/DWEngineService.exe.config ファイルを検索して編集します。 EESPortキーエントリを見つけて、新しいポートを割り当てます。
次のコマンドを実行して、新しいポートを通知するサービスを再起動します。
```
sudo /opt/mssql/lib/dotnet6/dotnet/opt/mssql/lib/ExternalExecutionService.dll -port <newportnumber>
```
SQL Server 2025 (17.x) Preview 以降のバージョンでは、代わりに次のコマンドを使用します。
```
sudo /opt/mssql/bin/mssql-conf set polybaseEES eesport <newportnumber>
```
PolyBase サービスを再起動するように求められます。
```
systemctl restart mssql-ees.service
```

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

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

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

ODBC ソースにアクセスするために、データベーススコープ資格情報を作成します。
```
CREATE DATABASE SCOPED CREDENTIAL [<credential_name>]
    WITH IDENTITY = '<username>', SECRET = '<password>';
```
たとえば、次の例では、credential_nameの ID を使用して、usernameという名前の資格情報を作成します。 <password> は複雑なパスワードに置き換えます。
```
CREATE DATABASE SCOPED CREDENTIAL credential_name
    WITH IDENTITY = 'username', SECRET = '<password>';
```
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 ドライバーをインストールする」で作成したドライバーです。
- ServerNode sap_server_node のポート 5555
- サーバーへのプッシュダウンを処理できるように構成する (PUSHDOWN = ON)
- 資格情報 credential_name を使用する
```
CREATE EXTERNAL DATA SOURCE external_data_source_name
WITH (
    LOCATION = 'odbc://SERVERNAME:4444',
    PUSHDOWN = ON,
    CONNECTION_OPTIONS = 'Driver={CData ODBC Driver For SAP 2015};
        ServerNode = sap_server_node:5555',
    CREDENTIAL = credential_name
);
```

外部テーブルを作成する

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

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

CREATE EXTERNAL TABLE（外部テーブルを作成）
CREATE STATISTICS

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 (
    DATA_SOURCE = [<external_data_source_name>],
    LOCATION = '<sap_table_name>'
);
```
注

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

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

次の方法で共有

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

前提条件

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

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

外部テーブルを作成する

関連コンテンツ

フィードバック

その他のリソース