複数Factorial アカウントをレプリケーション

CData Sync for API は、データベースにサンドボックスや製品インスタンスをレプリケートするなどの、レプリケーションの多様なシナリオに対する解決策を提供するスタンドアロンアプリケーションです。Sync for Windows およびSync for Java はどちらもコマンドラインインターフェース（CLI）を含んでおり、複数のFactorial 接続を簡単に管理できます。この記事では、CLI を使って複数のFactorial アカウントをレプリケートする方法について説明します。

Factorial 接続の構成

接続およびE メール通知設定をXML 設定ファイルに保存できます。複数のFactorial アカウントをレプリケートするには、複数の設定ファイルを使います。以下にFactorial をSQLite にレプリケートする設定例を示します。

Windows

<?xml version="1.0" encoding="UTF-8" ?>
<CDataSync>
  <DatabaseType>SQLite</DatabaseType>
  <DatabaseProvider>System.Data.SQLite</DatabaseProvider>
  <ConnectionString>Profile=C:\profiles\Factorial.apip;AuthScheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;</ConnectionString>
  <ReplicateAll>False</ReplicateAll>
  <NotificationUserName></NotificationUserName>
  <DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString>
  <TaskSchedulerStartTime>09:51</TaskSchedulerStartTime>
  <TaskSchedulerInterval>Never</TaskSchedulerInterval>
</CDataSync>

Java

<?xml version="1.0" encoding="UTF-8" ?>
<CDataSync>
<DatabaseType>SQLite</DatabaseType>
  <DatabaseProvider>org.sqlite.JDBC</DatabaseProvider>
  <ConnectionString>Profile=C:\profiles\Factorial.apip;AuthScheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;</ConnectionString>
  <ReplicateAll>False</ReplicateAll>
  <NotificationUserName></NotificationUserName>
  <DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString>
</CDataSync>

認証

Factorial は、自身の 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"）。

各Factorial インスタンスにクエリを設定

Sync を使うと標準SQL でレプリケーションを制御できます。REPLICATE ステートメントはハイレベルなコマンドで、データベースにテーブルをキャッシュして維持します。Factorial API がサポートするあらゆるSELECT クエリを定義できます。下記のステートメントは、Factorial のデータ のテーブルをキャッシュしてインクリメンタルに更新します。

REPLICATE Agreements;

特定のデータベースを更新するために使用するレプリケーションクエリを含むファイルを指定することができます。レプリケーションステートメントはセミコロンで区切ります。次のオプションは、複数のFactorial アカウントを同じデータベースにレプリケートする場合に便利です。

REPLICATE SELECT ステートメントでは、異なるテーブルのプレフィックスを使用できます。

REPLICATE PROD_Agreements SELECT * FROM Agreements

異なるスキーマを使用することもできます。

REPLICATE PROD.Agreements SELECT * FROM Agreements

Sync の実行

接続文字列およびレプリケーションクエリの設定が完了したら、次のコマンドラインオプションを使ってSync を実行できます。

Windows

APISync.exe -g MyProductionAPIConfig.xml -f MyProductionAPISync.sql

Java

java -Xbootclasspath/p:c:\sqlitejdbc.jar -jar APISync.jar -g MyProductionAPIConfig.xml -f MyProductionAPISync.sql