複数Freshservice アカウントをレプリケーション
CData Sync for API は、データベースにサンドボックスや製品インスタンスをレプリケートするなどの、レプリケーションの多様なシナリオに対する解決策を提供するスタンドアロンアプリケーションです。Sync for Windows およびSync for Java はどちらもコマンドラインインターフェース(CLI)を含んでおり、複数のFreshservice 接続を簡単に管理できます。この記事では、CLI を使って複数のFreshservice アカウントをレプリケートする方法について説明します。
Freshservice 接続の構成
接続およびE メール通知設定をXML 設定ファイルに保存できます。複数のFreshservice アカウントをレプリケートするには、複数の設定ファイルを使います。以下にFreshservice をSQLite にレプリケートする設定例を示します。
Windows
<?xml version="1.0" encoding="UTF-8" ?> <CDataSync> <DatabaseType>SQLite</DatabaseType> <DatabaseProvider>System.Data.SQLite</DatabaseProvider> <ConnectionString>Profile=C:\profiles\Freshservice.apip;ProfileSettings='APIKey=your_api_key;Domain=your_subdomain';</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\Freshservice.apip;ProfileSettings='APIKey=your_api_key;Domain=your_subdomain';</ConnectionString> <ReplicateAll>False</ReplicateAll> <NotificationUserName></NotificationUserName> <DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString> </CDataSync>
Freshservice に接続するには、Freshservice ポータル右上のProfile Settings からAPI キーを取得します(管理者アクセスが必要です)。次に、以下を設定します。
- Domain:Freshservice アカウントURL のサブドメインです。例えば、URL がyourcompany.freshservice.com の場合、この値をyourcompany に設定します。
- API Key:Freshservice のProfile Settings で取得したAPI キーです。
各Freshservice インスタンスにクエリを設定
Sync を使うと標準SQL でレプリケーションを制御できます。REPLICATE ステートメントはハイレベルなコマンドで、データベースにテーブルをキャッシュして維持します。Freshservice API がサポートするあらゆるSELECT クエリを定義できます。下記のステートメントは、Freshservice のデータ のテーブルをキャッシュしてインクリメンタルに更新します。
REPLICATE AgentGroups;
特定のデータベースを更新するために使用するレプリケーションクエリを含むファイルを指定することができます。レプリケーションステートメントはセミコロンで区切ります。次のオプションは、複数のFreshservice アカウントを同じデータベースにレプリケートする場合に便利です。
REPLICATE SELECT ステートメントでは、異なるテーブルのプレフィックスを使用できます。
REPLICATE PROD_AgentGroups SELECT * FROM AgentGroups
異なるスキーマを使用することもできます。
REPLICATE PROD.AgentGroups SELECT * FROM AgentGroups
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