DataGrip で Zendesk のデータ をクエリ

DataGrip は、SQL 開発者がデータベースへのクエリ、作成、管理を行えるデータベース IDE です。CData JDBC Driver for Zendesk と組み合わせることで、DataGrip からリアルタイムZendesk のデータを操作できます。この記事では、DataGrip で Zendesk のデータ への接続を確立し、テーブルエディタを使用して Zendesk のデータ を読み込む方法を説明します。

Zendesk 用の新しいドライバー定義を作成

以下のステップでは、DataGrip で Zendesk 用の新しいデータソースを作成する方法を説明します。

1. DataGrip で、File -> New -> Project をクリックしてプロジェクト名を入力します。
2. Database Explorer で、プラスアイコン（）をクリックして Driver を選択します。
3. Driver タブで以下を設定します。
   • Name をわかりやすい名前に設定します（例："CData Zendesk Driver"）。
   • Driver Files を適切な JAR ファイルに設定します。ファイルを追加するには、プラス（）をクリックし、「Add Files」を選択して、ドライバーのインストールディレクトリ内の「lib」フォルダに移動し、JAR ファイル（例：cdata.jdbc.zendesk.jar）を選択します。
   • Class を cdata.jdbc.zendesk.Zendesk.jar に設定します。
   また、詳細タブでは、ドライバーのプロパティや、VM Options、VM environment、VM home path、DBMS などの設定を変更できます。
   • ほとんどの場合、Expert options で DBMS type を「Unknown」に変更して、ネイティブの SQL Server クエリ（Transact-SQL）を回避してください。これを行わないと、無効な関数エラーが発生する可能性があります。
4. 「Apply」をクリックし、「OK」をクリックして接続を保存します。

Zendesk への接続を設定

1. 接続を保存したら、プラス（）をクリックし、「Data Source」→「CData Zendesk Driver」を選択して、新しい Zendesk データソースを作成します。
2. 新しいウィンドウで、JDBC URL を使用して Zendesk への接続を設定します。

   組み込みの接続文字列デザイナー

   JDBC URL の構築には、Zendesk JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

         java -jar cdata.jdbc.zendesk.jar
       

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   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 の管理画面で以下の設定を行います。

   1. Token アクセスを有効にします。
   2. Admin -> Channels-> API で、API トークンを管理します。一度にアクティブにできるトークンは1つだけです。トークンを削除すると、そのトークンは永久に無効化されます。
   最後に、APIToken をアクティブなAPI トークンに設定します。

   その他の認証方法についてはヘルプドキュメントを参照してください。

   
3. URL を接続文字列に設定します。例：

   jdbc:zendesk:URL=https://subdomain.zendesk.com;User=my@email.com;Password=test123;

4. 「Apply」と「OK」をクリックして接続文字列を保存します。

これで、Data Explorer にデータソースが表示されます。

Zendesk に対して SQL クエリを実行

JDBC Driver を介してアクセス可能な Zendesk のエンティティ（テーブルとして利用可能）を参照するには、データソースを展開します。

クエリを実行するには、任意のテーブルを右クリックして「New」→「Query Console」を選択します。

Console で、実行したい SQL クエリを記述します。例：

SELECT Id, Subject FROM Tickets

CData JDBC Driver for Zendesk の30日間の無料トライアルをダウンロードして、DataGrip でリアルタイムZendesk のデータを操作してみてください。ご不明な点があれば、サポートチームにお問い合わせください。