Aqua Data Studio で Linear のデータ に接続
CData JDBC Driver for Linear は、Aqua Data Studio などの IDE のウィザードや分析機能と Linear のデータ を連携できます。本記事では、接続マネージャーを使って Linear のデータ に接続し、クエリを実行する方法を説明します。
JDBC データソースの作成
接続マネージャーを使用して接続プロパティを定義し、新しい JDBC データソースとして保存できます。作成した Linear データソースは、Aqua Data Studio の各ツールからアクセスできるようになります。
- Aqua Data Studio で、Servers メニューから Register Server を選択します。
- Register Server フォームで、「Generic - JDBC」接続を選択します。
- 以下の JDBC 接続プロパティを入力します：
- Name: データソースの名前を入力します（例：Linear）。
- Driver Location: Browse ボタンをクリックし、インストールディレクトリの lib サブフォルダにある cdata.jdbc.linear.jar ファイルを選択します。
- Driver: ドライバーのクラス名 cdata.jdbc.linear.LinearDriver を入力します。
URL: JDBC 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 のデータ へのクエリ
これで、公開されているテーブルにクエリを実行できます。
はじめる準備はできましたか？
Linear Driver の無料トライアルをダウンロードしてお試しください：
ダウンロード