Node.js で Factorial のデータを MySQL データベースとしてクエリ

Factorial 用の ODBC Driver の SQL Gateway を使用すると、MySQL インターフェース経由でFactorial のデータをクエリできます。以下の手順に従って、SQL Gateway の MySQL リモーティングサービスを起動し、Node.js からクエリを開始してください。

Factorial のデータに接続

まだ行っていない場合は、データソース名（DSN）で必要な接続プロパティの値を指定してください。組み込みの Microsoft ODBC データソースアドミニストレーターを使用して DSN を設定できます。これはドライバーインストールの最後のステップでもあります。Microsoft ODBC データソースアドミニストレーターを使用して DSN を作成・設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。

認証

Factorial は認証に OAuth 2.0 を使用し、自分の HR データに接続する場合も、他のユーザーが各自のデータに接続できるようにする場合も、OAuth 2.0 認証を利用できます。

OAuth 認証の設定

OAuth を使って接続するには、以下のステップで進めます：

1. Factorial の管理パネルに移動して、新しい OAuth アプリケーションを作成します。
2. アプリケーション設定から Client ID と Client Secret をコピーします。
3. 以下の接続プロパティを設定します。

• AuthScheme：OAuth に設定します。
• OAuthClientId：OAuth Client ID に設定します。
• OAuthClientSecret：OAuth Client Secret に設定します。
• Scope：データへのアクセス権限を指定します（デフォルト："read write"）。

SQL Gateway を設定

SQL Gateway 概要を参照して、Factorial のデータ を仮想 MySQL データベースとして接続を設定してください。クライアントからの MySQL リクエストをリッスンする MySQL リモーティングサービスを設定します。サービスは SQL Gateway UI で設定できます。

Node.js から Factorial をクエリ

以下の例では、mysql モジュールを使用して Factorial への接続を定義し、クエリを実行する方法を示しています。以下の情報が必要です。

• ホスト名またはアドレス、およびポート：MySQL リモーティングサービスが MySQL 接続をリッスンしているマシンとポート
• ユーザー名とパスワード：SQL Gateway の Users タブで認証したユーザーのユーザー名とパスワード
• データベース名：MySQL リモーティングサービス用に設定した DSN

以下のコードでFactorial のデータに接続し、クエリの実行を開始できます。

var mysql      = require('mysql');
var connection = mysql.createConnection({
  host     : 'localhost',
  database : 'CData API Sys',
  port	   : '3306',
  user     : 'mysql_user',
  password : 'test'
});
connection.connect();
connection.query('SELECT * FROM Agreements', function(err, rows, fields) {
  if (err) throw err;
  console.log(rows);
});

connection.end();