PolyBase で外部データソースとしてPonparemall を連携利用

SQL Server のPolyBase は、データベーステーブルをクエリするTransact-SQL 構文を使って、外部データにクエリする仕組みです。 CData ODBC Driver for Ponparemall を組み合わせて使うことで、SQL Server データと同じようにPonparemall へのアクセスが可能です。 本記事では、外部データソースと外部テーブルの作成から、T-SQL クエリを使ってライブPonparemall データへ接続を認可するところまで説明します。

CData ODBC ドライバーは、ドライバーに組み込まれた最適化されたデータ処理により、PolyBase でライブPonparemall データを送受信するための圧倒的なパフォーマンスを提供します。SQL Server からPonparemall に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をPonparemall に直接プッシュダウンし、組み込みSQL エンジンを利用して、サポートされていない操作（一般的にはSQL 関数とJOIN 操作） をクライアント側で処理します。また、PolyBase を使用することで、単一のクエリを使用して分散ソースからデータをプルし、SQL Server データをPonparemall と結合することもできます。

Ponparemall への接続

未指定の場合は、初めにODBC DSN（data source name）で接続プロパティを指定します。ドライバーのインストールの最後にアドミニストレーターが開きます。Microsoft ODBC Data Source Administrator を使用して、ODBC DSN を作成および構成できます。PolyBase を使用してSQL Server に外部データソースを作成するには、System DSN を構成します。（CData Ponparemall Sys は自動的に作成されます。）

Ponparemall に接続するには、ShopUrl、InventoryUserId、InventoryPassword、OrderUserId、OrderPassword、PaymentUserId、およびPaymentPassword が必要です。

Ponparemall へのアクセスの設定

Ponparemall には各API のId とPassword が必要です。取得するには、以下の手順に従ってください。

• Ponparemall Manager にログインし、メニューの「各種申請」の「WebAPI利用申請」をクリックします。
• Web API メニューの「WebAPIサービス利用申請」をクリックし、利用申請を行います。
• 後日、Ponparemall から必要なId とPassword が送られてきます。

Ponparemall アカウントの認証

次の接続プロパティを設定して接続します。

• ShopUrl：接続先のPonparemall Shop URL を設定。「http://storetst4.ponparemall.com/sample/」に含まれる「sample」の部分を入力します。
• InventoryUserId：「在庫API」のユーザID を設定。このプロパティは、Inventory テーブルにアクセスする場合に必要です。
• InventoryPassword：「在庫API」のパスワードを設定。このプロパティは、Inventory テーブルにアクセスする場合に必要です。
• OrderUserId：「受注API」のユーザID を設定。このプロパティは、Orders テーブルにアクセスする場合に必要です。
• OrderPassword：「受注API」のパスワードを設定。このプロパティは、Orders テーブルにアクセスする場合に必要です。
• PaymentUserId：「決済API」のユーザID を設定。このプロパティは、Payments テーブルにアクセスする場合に必要です。
• PaymentPassword：「決済API」のパスワードを設定。このプロパティは、Payments テーブルにアクセスする場合に必要です。

［接続のテスト］をクリックして、DSN がPonparemall に正しく接続できているかを確認します。［テーブル］タブに移動し、Ponparemall のテーブル定義を確認します。

Ponparemall データの外部データソースを作成

接続を構成したのち、外部データソースのマスター暗号化キーと資格情報データベースを作成する必要があります。

マスター暗号化キーの作成

以下のSQL コマンドを実行して新しいマスターキー［ENCRYPTION］を作成し、外部データソースの資格情報を暗号化します。

CREATE MASTER KEY ENCRYPTION BY PASSWORD = 'password';

資格情報データベースの作成

以下のSQL コマンドを実行してPonparemall に接続されている外部データソースの資格情報を作成します。

Note：IDENTITY とSECRET はPonparemall のUser プロパティとPassword プロパティに対応しています。

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

Ponparemall の外部データソースを作成

以下のSQL コマンドを実行し、以前作成したDSN と資格情報を使用して、PolyBase でPonparemall の外部データソースを作成します。

Ponparemall の場合、SERVERNAME を［localhost］または［127.0.0.1］に設定し、PORT を空のままにします。PUSHDOWN は、デフォルトでON に設定されているため、ODBC Driver は、サーバー側の処理を利用して複雑なクエリを実行できます。

CREATE EXTERNAL DATA SOURCE cdata_ponparemall_source
WITH ( 
  LOCATION = 'odbc://SERVERNAME[:PORT]',
  CONNECTION_OPTIONS = 'DSN=CData Ponparemall Sys',
  -- PUSHDOWN = ON | OFF,
  CREDENTIAL = ponparemall_creds
);

Ponparemall の外部テーブルを作成

外部データソースを作成したら、CREATE EXTERNAL TABLE ステートメントを使用してSQL Server インスタンスからPonparemall にリンクします。テーブルカラムの定義は、CData ODBC Driver for Ponparemall によって公開されているものと一致しなければなりません。DSN Configuration Wizard の［テーブル］タブを参照し、テーブルの定義を確認できます。

CREATE TABLE ステートメントのサンプル

以下は、Ponparemall Orders に基づいて外部テーブルを作成するステートメントの一例です。

CREATE EXTERNAL TABLE Orders(
  OrderNumber [nvarchar](255) NULL,
  OrderStatus [nvarchar](255) NULL,
  ...
) WITH ( 
  LOCATION='Orders',
  DATA_SOURCE=cdata_ponparemall_source
);

SQL Server インスタンスでPonparemall の外部テーブルを作成すると、ローカルデータとリモートデータを同時にクエリできるようになります。CData ODBC Driver に組み込まれているクエリ処理により、可能な限り多くのクエリ処理がPonparemall にプッシュされることで、ローカルのリソースと計算リソースが解放されます。ODBC Driver for Ponparemall の30日間無料トライアルをダウンロードし、SQL Server データでライブPonparemall データを使い始めましょう。