DataGrip で Backlog のデータ をクエリ

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

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

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

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

Backlog への接続を設定

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

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

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

         java -jar cdata.jdbc.backlog.jar
       

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

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

   API キー認証

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

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

   OAuth 認証

   ユーザー名やパスワードへのアクセスを保有していない場合や、それらを使いたくない場合にはOAuth ユーザー同意フローを使用します。認証方法については、ヘルプドキュメントを参照してください。
3. URL を接続文字列に設定します。例：

   jdbc:backlog:ApiKey=YOUR_API_KEY;Url=https://yourURL.backlog.com;

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

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

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

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

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

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

SELECT Id, ProjectID FROM Issues

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