HULFT Integrate で Jira Assets のデータに接続

Jerod Johnson
Senior Technology Evangelist

HULFT Integrate で Jira Assets に JDBC データソースとして接続

HULFT Integrate は、ドラッグ＆ドロップのユーザーインターフェースでコーポレーションフロー、データ変換、処理を簡単に作成できる最新のデータ連携プラットフォームです。CData JDBC Driver for Jira Assets と組み合わせることで、HULFT Integrate からリアルタイムの Jira Assets のデータを扱うことができます。この記事では、Jira Assets への接続方法と、データを CSV ファイルに出力する手順をご紹介します。

CData JDBC ドライバーは、最適化されたデータ処理機能を備えており、リアルタイムの Jira Assets のデータとの連携において比類のないパフォーマンスを発揮します。Jira Assets に対して複雑な SQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を直接 Jira Assets にプッシュし、サポートされていない操作（主に SQL 関数や JOIN 操作）は内蔵の SQL エンジンでクライアント側で処理します。また、動的なメタデータクエリ機能により、ネイティブなデータ型を使用して Jira Assets のデータを操作・分析できます。

Jira Assets へのアクセスを有効化

HULFT Integrate プロジェクトから Jira Assets のデータへのアクセスを有効にするには、以下の手順で設定します：

CData JDBC Driver の JAR ファイル（およびライセンスファイルがある場合はそれも）、cdata.jdbc.jiraassets.jar（および cdata.jdbc.jiraassets.lic）を、Integrate Server の jdbc_adapter サブフォルダにコピーします
HULFT Integrate Server を再起動し、HULFT Integrate Studio を起動します

Jira Assets のデータにアクセスするプロジェクトの作成

JAR ファイルをコピーしたら、Jira Assets のデータにアクセスするプロジェクトを作成できます。まず、Integrate Studio を開いて新しいプロジェクトを作成しましょう。

プロジェクト名を入力します
「スクリプトを作成」チェックボックスがオンになっていることを確認します
「次へ」をクリックします
スクリプト名を入力します（例：JiraAssetstoCSV）

プロジェクトを作成したら、Jira Assets のデータを CSV ファイルにコピーするためのコンポーネントをスクリプトに追加します。

Execute Select SQL コンポーネントの設定

ツールパレット（Database -> JDBC）から「Execute Select SQL」コンポーネントをスクリプトワークスペースにドラッグします。

「必須設定」タブの接続先で、「追加」をクリックして Jira Assets 用の新しい接続を作成します。以下のプロパティを設定します：
- 名前：Jira Assets Connection Settings
- ドライバークラス名：cdata.jdbc.jiraassets.JiraAssetsDriver
- URL：jdbc:jiraassets:User=MyUser;APIToken=myApiToken;Url=https://yoursitename.atlassian.net
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の構築には、Jira Assets JDBC Driver に組み込まれている接続文字列デザイナーをご利用ください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
		java -jar cdata.jdbc.jiraassets.jar
		
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  Jira Assets は、APIToken 経由での接続と認証をサポートしています。
  
  API トークンを生成するには：
  1. Atlassian アカウントにログインします。
  2. セキュリティ設定 > API トークン > API トークンを作成するをクリックします。
  Atlassian がAPI トークンを生成して表示します。
  
  API トークンを生成したら、以下のパラメータをセットします。
  - AuthScheme：APIToken。
  - User：認証するユーザーのログイン名。
  - APIToken：生成したAPI トークン。
  これでJira Assets に接続して認証する準備が整いました。
SQL ステートメントを記述します。例：
```
SELECT ID, Name FROM Objects
```
「抽出テスト」をクリックして、接続とクエリが正しく設定されていることを確認します
「SQL を実行して出力スキーマを設定」をクリックします
「完了」をクリックします