各製品の資料を入手。
詳細はこちら →
製品をチェック
ODBC を介してNode.js からUM SaaS Cloud のデータをクエリ
node-odbc を使用して、Node.js からUM SaaS Cloud のデータへのSQL クエリを実行します。
最終更新日：2022-01-09
この記事で実現できるUM SaaS Cloud 連携のシナリオ
こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。
Node.js はブラウザ上以外でJavaScript コードを使用できるJavaScript ランタイム環境です。CData ODBC Driver for UMSaaSCloud を使用すれば、Node.js アプリとスクリプトから、リアルタイムUM SaaS Cloud のデータにアクセスできます。この記事ではnode-odbc のインストールと、リアルタイムUM SaaS Cloud のデータへのアクセスが可能な、シンプルなNode.js アプリケーションを作成するために必要なツールについて説明します。
ビルトインの最適化されたデータ処理により、CData ODBC Driver は比類のないパフォーマンスで、Node.js のリアルタイムUM SaaS Cloud のデータとやりとりできます。Node.js からUM SaaS Cloud に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をUM SaaS Cloud に直接プッシュし、組み込まれたSQL エンジンを利用してサポートされていない操作（主にSQL 関数とJOIN 操作）をクライアント側で処理します。
CData ODBC ドライバとは？
CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。
- UM SaaS Cloud をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
- 多様なアプリケーション、ツールにUM SaaS Cloud のデータを連携
- ノーコードでの手軽な接続設定
- 標準 SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてUM SaaS Cloud の接続を設定、2.Node.js 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとUM SaaS Cloud への接続設定
まずは、本記事右側のサイドバーからUMSaaSCloud ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
必要な接続プロパティの値が未入力の場合には、データソース名（DSN）で入力します。組み込みのMicrosoft ODBC Data Source Administrator を使用し、DSN を構成できます。ドライバーのインストールの最後にアドミニストレーターが開きます。Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定する方法は、ヘルプドキュメントの「はじめに」を参照してください。
UM SaaS Cloud 接続プロパティの取得・設定方法
デフォルトでは、本製品は本番環境に接続します。UMSaaSCloud sandbox アカウントを使用するには、UseSandbox をtrue に設定します。ユーザー / パスワード認証を使用している場合は、User にsandbox のユーザー名を設定してください。
UM SaaS Cloud への認証
UM SaaS Cloud は、Basic、OAuth、OAuthJWT（コンシューマーキー）など、複数の認証方式をサポートしています。ここではBasic 認証について説明します。認証情報の詳しい取得方法や他の認証方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。
Basic 認証
Basic 認証は、セキュリティトークンとユーザー資格情報の使用に基づきます。Basic 認証を使用するには、AuthScheme をBasic に、User とPassword をログイン資格情報に設定し、SecurityToken を設定します。
デフォルトではSecurityToken が必要ですが、UM SaaS Cloud で信頼できるIP アドレスの範囲を設定することで、オプションにすることができます。
node-odbc を構築する
CData ODBC Driver を介してUM SaaS Cloud に接続するには、必要なツールをインストールした後に、node-odbc を手動で構築する必要があります。
必要なツールをインストールする
以下のコマンドでは、node-odbc の構築に必要なツールをインストールします。（ツールをグローバルにインストールする-g パラメータに注意してください。）
npm i -g windows-build-tools npm i -g node-gyp
node-odbc を構築する
必要なツールをインストールしたらNode.js アプリケーションのディレクトリを作成し、Node.js スクリプトで使用するバイナリを構築するodbc をインストールします。
mkdir nodeodbc cd nodeodbc npm i -g node
Node.js からUM SaaS Cloud をクエリ
ODBC Driver がインストールされ、DSN が構成されて、node-odbc が構築されたら、Node.js アプリケーションからリアルタイムUM SaaS Cloud のデータをクエリすることができるようになります。以下のサンプルコードは、特定のDSN に接続してAccount テーブルをクエリします。
myscript.js
const odbc = require('odbc');
async function queryUMSaaSCloud() {
const connection = await odbc.connect(`DSN=CData UMSaaSCloud Source`);
const data = await connection.query('SELECT BillingState, Name FROM Account');
console.log(data);
}
queryUMSaaSCloud();
アプリケーションを作成したら、node を使用してスクリプトを実行します。
node myscript.js
おわりに
CData ODBC Driver for UMSaaSCloud の30日の無償評価版 をダウンロードすればNode.js でリアルタイムUM SaaS Cloud のデータを使用できます。ご不明な点があれば、サポートチームにお問い合わせください。
関連コンテンツ
