Pentaho Data Integration でZendesk のデータを連携
CData JDBC Driver for Zendesk を使用すると、データパイプラインからリアルタイムデータにアクセスできます。Pentaho Data Integration は、ETL(Extraction, Transformation, and Loading)エンジンであり、データをクレンジングし、アクセス可能な統一フォーマットでデータを格納します。この記事では、Zendesk のデータ に JDBC データソースとして接続し、Pentaho Data Integration で Zendesk のデータ をベースにしたジョブやトランスフォーメーションを構築する方法を説明します。
Zendesk への接続を設定
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つだけです。トークンを削除すると、そのトークンは永久に無効化されます。
その他の認証方法についてはヘルプドキュメントを参照してください。
組み込みの接続文字列デザイナー
JDBC URL の構築を支援するには、Zendesk JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.zendesk.jar
接続プロパティを設定し、接続文字列をクリップボードにコピーします。
JDBC URL を設定する際には、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時にパフォーマンスを向上させることができます。
一般的な JDBC URL は次のようになります:
jdbc:zendesk:URL=https://subdomain.zendesk.com;User=my@email.com;Password=test123;
接続文字列を保存して、Pentaho Data Integration で使用します。
Pentaho DI から Zendesk に接続
Pentaho Data Integration を開き、「Database Connection」を選択して CData JDBC Driver for Zendesk への接続を設定します。
- 「General」をクリックします。
- Connection name を設定します(例:Zendesk Connection)。
- Connection type を「Generic database」に設定します。
- Access を「Native (JDBC)」に設定します。
- Custom connection URL に Zendesk の接続文字列を設定します(例:
jdbc:zendesk:URL=https://subdomain.zendesk.com;User=my@email.com;Password=test123;
)。 - Custom driver class name を「cdata.jdbc.zendesk.ZendeskDriver」に設定します。
- 接続をテストし、「OK」をクリックして保存します。
Zendesk のデータパイプラインを作成
CData JDBC Driver を使用して Zendesk への接続が設定されたら、新しいトランスフォーメーションまたはジョブを作成する準備が整いました。
- 「File」>>「New」>>「Transformation/job」をクリックします。
- 「Table input」オブジェクトをワークフローパネルにドラッグし、Zendesk 接続を選択します。
- 「Get SQL select statement」をクリックし、Database Explorer を使用して利用可能なテーブルとビューを表示します。
- テーブルを選択し、必要に応じてデータをプレビューして確認します。
ここから、適切な同期先を選択し、レプリケーション中にデータを変更、フィルタリング、その他の処理を行うトランスフォーメーションを追加することで、トランスフォーメーションまたはジョブを続行できます。
無料トライアルと詳細情報
CData JDBC Driver for Zendesk の 30日間無料トライアルをダウンロードして、Pentaho Data Integration で Zendesk のデータ のリアルタイムデータを今すぐ活用しましょう。