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

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

Backlog 接続の構成

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

Windows

<?xml version="1.0" encoding="UTF-8" ?>
<CDataSync>
  <DatabaseType>SQLite</DatabaseType>
  <DatabaseProvider>System.Data.SQLite</DatabaseProvider>
  <ConnectionString>ApiKey=YOUR_API_KEY;Url=https://yourURL.backlog.com;</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>ApiKey=YOUR_API_KEY;Url=https://yourURL.backlog.com;</ConnectionString>
  <ReplicateAll>False</ReplicateAll>
  <NotificationUserName></NotificationUserName>
  <DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString>
</CDataSync>

Backlog への接続に使用できる認証方法は、API キーおよびOAuth の2つです。

API キー認証

ApiKey およびURL をログインクレデンシャルに設定します。 ApiKey を取得するには：

1. Backlog の個人設定ページを開きます。
2. 「API」セクションをクリックして、「メモ」にAPI キーについての説明を追加し、「登録」ボタンをクリックします。トークンが生成されます。
3. ApiKey にAPI キーを指定します。
4. URL はBacklog のテナントURL から取得できます。

OAuth 認証

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

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

REPLICATE Issues;

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

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

REPLICATE PROD_Issues SELECT * FROM Issues

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

REPLICATE PROD.Issues SELECT * FROM Issues

Sync の実行

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

Windows

BacklogSync.exe -g MyProductionBacklogConfig.xml -f MyProductionBacklogSync.sql

Java

java -Xbootclasspath/p:c:\sqlitejdbc.jar -jar BacklogSync.jar -g MyProductionBacklogConfig.xml -f MyProductionBacklogSync.sql