各製品の資料を入手。
詳細はこちら →複数Zendesk アカウントをレプリケーション
複数のZendesk アカウントを、1つあるいは多数のデータベースにレプリケーション。
最終更新日:2022-06-05
こんにちは!プロダクトスペシャリストの宮本です。
CData Sync for Zendesk は、データベースにサンドボックスや製品インスタンスをレプリケートするなどの、レプリケーションの多様なシナリオに対する解決策を提供するスタンドアロンアプリケーションです。Sync for Windows およびSync for Java はどちらもコマンドラインインターフェース(CLI)を含んでおり、複数のZendesk 接続を簡単に管理できます。この記事では、CLI を使って複数のZendesk アカウントをレプリケートする方法について説明します。
Zendesk 接続の構成
接続およびE メール通知設定をXML 設定ファイルに保存できます。複数のZendesk アカウントをレプリケートするには、複数の設定ファイルを使います。以下にZendesk をSQLite にレプリケートする設定例を示します。
Windows
<?xml version="1.0" encoding="UTF-8" ?>
<CDataSync>
<DatabaseType>SQLite</DatabaseType>
<DatabaseProvider>System.Data.SQLite</DatabaseProvider>
<ConnectionString>URL=https://subdomain.zendesk.com;User=my@email.com;Password=test123;</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>URL=https://subdomain.zendesk.com;User=my@email.com;Password=test123;</ConnectionString>
<ReplicateAll>False</ReplicateAll>
<NotificationUserName></NotificationUserName>
<DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString>
</CDataSync>
Zendesk 接続プロパティの取得・設定方法
Zendesk に接続するには、https://{subdomain}.zendesk.com の形式でURL(Zendesk Support URL)を設定します。接続後、次のセクションの説明に従ってユーザー認証を行います。
また、TicketMetrics テーブルのアーカイブデータを扱うユーザーは、UseIncrementalAPI プロパティをTrue に設定する必要があります。
Zendesk への認証
Zendesk は、Zendesk インスタンスの設定に応じて、3種類の認証をサポートします。API トークン認証、OAuth 認証、Basic 認証(レガシー)です。
API トークン認証
API トークン認証を使用する場合は、E メールアドレスとApiToken を指定します。 AuthScheme をAPIToken に、User をE メールアドレスに設定し、Zendesk Support の管理画面で以下の設定を行います。
- Token アクセスを有効にします。
- Admin -> Channels-> API で、API トークンを管理します。一度にアクティブにできるトークンは1つだけです。トークンを削除すると、そのトークンは永久に無効化されます。
その他の認証方法についてはヘルプドキュメントを参照してください。
各Zendesk インスタンスにクエリを設定
Sync を使うと標準SQL でレプリケーションを制御できます。REPLICATE ステートメントはハイレベルなコマンドで、データベースにテーブルをキャッシュして維持します。Zendesk API がサポートするあらゆるSELECT クエリを定義できます。下記のステートメントは、Zendesk のデータ のテーブルをキャッシュしてインクリメンタルに更新します。
REPLICATE Tickets;
特定のデータベースを更新するために使用するレプリケーションクエリを含むファイルを指定することができます。レプリケーションステートメントはセミコロンで区切ります。次のオプションは、複数のZendesk アカウントを同じデータベースにレプリケートする場合に便利です。
REPLICATE SELECT ステートメントでは、異なるテーブルのプレフィックスを使用できます。
REPLICATE PROD_Tickets SELECT * FROM Tickets
異なるスキーマを使用することもできます。
REPLICATE PROD.Tickets SELECT * FROM Tickets
Sync の実行
接続文字列およびレプリケーションクエリの設定が完了したら、次のコマンドラインオプションを使ってSync を実行できます。
Windows
ZendeskSync.exe -g MyProductionZendeskConfig.xml -f MyProductionZendeskSync.sql
Java
java -Xbootclasspath/p:c:\sqlitejdbc.jar -jar ZendeskSync.jar -g MyProductionZendeskConfig.xml -f MyProductionZendeskSync.sql