Magic xpi からCData ODBC Driver を使ってParallel につないでみた
ノーコードでデータを連携・同期・統合するデータ連携（EAI）ツール「Magic xpi」には、ODBC でデータベースへ接続する機能が備わっているので、これを使ってParallel のデータ連携を行うことが可能です。 通常、Parallel などのSaaS として提供されるアプリケーションにはWeb API でアクセスしますが、CData Parallel ODBC Driver によって、RDB にアクセスするのと同感覚で、Parallel のデータを扱うことができます。
CData ODBC ドライバとは？
CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。
- Parallel をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
- 多様なアプリケーション、ツールにParallel のデータを連携
- ノーコードでの手軽な接続設定
- 標準 SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてParallel の接続を設定、2.Magic xpi 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとParallel への接続設定
まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
Magic xpi スタジオにてプロジェクトを作成して、ODBC接続設定を行います。
-
Magic xpi スタジオを起動してメニューバーからファイル > 新規 を選択します。新規プロジェクトウィンドウが起動したらプロジェクト名を指定して新規プロジェクトを作成します。
-
メニューバーからプロジェクト > リソース を選択します。リソース設定ウィンドウが起動したら左下の「新規」ボタンをクリックします。
-
新規リソースウィンドウにて、リソースタイプを「Database」を選択、リソース名にCDataParallelを指定して「OK」ボタンをクリックします。
-
リソース設定ウィンドウにて、DBMSには「ODBC」、データソース名には、Microsoft ODBC データソースアドミニストレーターのシステムDSNで定義されたデータソース名（DSN）、例えば「CData Parallel Source」などを設定します。
Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定する方法は、CData Parallelのヘルプドキュメントの「はじめに」をご参照ください。Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。
Parallel API は、x-api-key リクエストヘッダーを介した API キー認証を使用します。
API キー認証の設定
接続を作成するには、Parallel の API キーが必要です。API キーを取得するには、以下のステップで進めます：
- app.parallel.ai で Parallel アカウントにログインします。
- アカウントダッシュボードの Settings または API Keys に移動します。
- API キーを生成するか、コピーします。
API キーを取得したら、以下の接続プロパティを設定します：
- AuthScheme：APIKey に設定します。
- APIKey：Parallel の API キーに設定します。
接続文字列の例：
Profile=C:\profiles\Parallel.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key';
「検証」ボタンをクリックしてデータベースとの接続が成功することを確認して、リソース設定ウィンドウを「OK」ボタンをクリックして終了します。
Parallel のデータをCSV ファイルへ出力するフローの作成
Magic xpi スタジオにて、データマッパーコンポーネントを使用してParallel のデータをCSV ファイルへ出力するフローを作成します。
-
プロジェクト内に作成されたフローを右クリックして、特性を選択します。フロー特性ウィンドウが起動したら自動起動をYesに変更して「OK」ボタンをクリックします。
-
トリガコンポーネントが「自動起動」に設定されたことを確認します。コンポーネント内のデータマッパーを右側のペインにドラッグ＆ドロップします。
-
データマッパーウィンドウが起動するので「構成」ボタンをクリックします。
-
送り元/送り先管理ウィンドウが開くので、送り元のタイプをDatabase、送り先のタイプをフラットファイルに設定します。
-
送り元の「特性」ボタンをクリックして、データベーススキーマ特性ウィンドウにてDB オペレーションで「Select」を選択、データベース定義で「CDataParallel」を選択して「ウィザード」ボタンをクリックします。
-
使用可能テーブルからテーブルを選択して「追加」ボタンをクリックして選択済テーブルに追加されたことを確認して「次へ」ボタンをクリックします。
-
データベースウィザードにて出力したいカラムを使用可能カラムから「追加」ボタンをクリックして選択済カラムに追加されたことを確認して「次へ」ボタンをクリックします。
Where 句とOrder By 句の定義ウィンドウが表示されるので必要であれば設定して「次へ」ボタンをクリックします。
-
ウィザードの結果にてSQL が表示されます。誤りがなければ「終了」ボタンをクリックします。
-
次に、送り先の「特性」ボタンをクリックして、フラットファイルウィンドウにてデータの送り先で「ファイル」を選択、右横のウィンドウにパス付の出力ファイル名を入力します。
下段の「新規」ボタンを、出力するカラム数分クリックして出力項目を定義します。出力項目に併せて必要に応じて型や桁数を定義してください。
- 送り元/送り先管理ウィンドウに戻り「マップ」ボタンをクリックします。
-
「マップ」ウィンドウが起動するので、送り元から送り先の項目へのドラッグ＆ドロップ操作で線でつなぎます。「OK」ボタンをクリックします。
送り元/送り先管理ウィンドウに戻り「OK」ボタンをクリックします。
Magic xpi スタジオからのテスト実行
Magic xpi スタジオから作成したフローを実行します。
-
メニューバーからデバッガ > 開く を選択します。チェック処理が実行され正常に終了すると、メニューバーからデバッガ > 実行 が活性化されるので選択します。
-
フローが実行されて正常に終了すると送り先のフラットファイルウィンドウで指定したファイルが作成されてParallel 内の指定したカラムのデータが出力されていることを確認できます。
おわりに
このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。
CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。