IntelliJ で Linear のデータ に接続

CData JDBC Driver for Linear を使用すると、Linear を JDBC データソースとしてアクセスでき、IDE の迅速な開発ツールとの連携が可能になります。この記事では、データソース設定ウィザードを使用して IntelliJ で Linear のデータ に接続する方法を説明します。

Linear 用の JDBC データソースを作成

以下の手順で、ドライバー JAR を追加し、Linear のデータ への接続に必要な接続プロパティを定義します。

1. Data Sources ウィンドウで右クリックし、Add Data Source -> DB Data Source をクリックします。

2. 表示される Data Source Properties ダイアログで、以下のプロパティを設定します。

   • JDBC Driver Files: このメニューの横にあるボタンをクリックし、インストールディレクトリにある JDBC Driver ファイル cdata.jdbc.linear.jar を追加します。
   • JDBC Driver Class: このメニューで、リストから cdata.jdbc.linear.LinearDriver を選択します。

   • Database URL: JDBC URL プロパティに接続 URL を入力します。URL は jdbc:linear: で始まり、セミコロンで区切られた接続プロパティを含みます。

     Linear への認証には、個人用 API キーまたは OAuth 2.0 を使用できます。ご自身の Linear アカウントで接続する場合は、API キーを使うのが最も手軽です。

     API キーによる認証

     以下の接続プロパティを設定します。

     • AuthScheme：APIKey に設定します。
     • APIKey：Linear の個人用 API キー。

     個人用 API キーを作成するには、Linear にログインして Settings > Security & access > Personal API keys を開き、New API key を選択して作成します。キーは一度しか表示されないため、すぐにコピーしておきましょう。

     OAuth による認証

     OAuth を使用するには、Linear にカスタム OAuth アプリケーションを登録する必要があります（Settings > API > OAuth applications）。登録すると OAuthClientId と OAuthClientSecret が発行されます。対応しているフローは以下の 2 つです。

     • Authorization code：AuthScheme を OAuth、InitiateOAuth を GETANDREFRESH に設定し、OAuthClientId、OAuthClientSecret、およびアプリケーションで定義した CallbackURL（例：http://localhost:33333）を指定します。ドライバーがブラウザで Linear を開くので、アクセスを許可してください。
     • Client credentials：AuthScheme を OAuthClient に設定し、OAuthClientId と OAuthClientSecret を指定します。アプリケーション自体を認証するためブラウザ操作は不要で、マシン間（M2M）連携に適しています。

     デフォルトでは、ドライバーは read,write スコープをリクエストします。アクセストークンは有効期限が切れると自動で更新されます。

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

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

     
     java -jar cdata.jdbc.linear.jar
     

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

     

     一般的な JDBC URL は以下のとおりです。

     jdbc:linear:AuthScheme=APIKey;APIKey=myAPIKey;

Linear のデータ の編集と保存

スキーマ情報を取得するには、作成したデータソースを右クリックして Refresh Tables をクリックします。テーブルをクエリするには、テーブルを右クリックして Open Tables Editor をクリックします。