Openflow Connector for Jira Cloud について¶
注釈
This connector is subject to the Snowflake Connector Terms.
このトピックでは、 Openflow Connector for Jira Cloud の基本概念、ワークフロー、および制限事項について説明します。
Openflow Connector for Jira Cloud は、Atlassian Jiraの問題データをSnowflakeに取り込みます。Jira Cloud REST API と `Jiraクエリ言語（JQL）<https://support.atlassian.com/jira-service-management-cloud/docs/use-advanced-search-with-jira-query-language-jql/>`_ を使用してデータを取得し、取得したデータはSnowflakeテーブルに保存され、ビュー経由でアクセスできるようになります。データの取り込みは2つのフェーズで行われます。
初期ロードでは、最初の API 呼び出しですべてのデータが取得されます。
増分ロードでは、更新と新しいデータを宛先テーブルにマージし、前回の呼び出しのタイムスタンプを使用して、前回のロード以降に更新された課題に結果を限定します。
このコネクタは、以下を実行する場合に使用します。
チーム間の可視化とより掘り下げたインサイトのため、Jiraの課題とプロジェクトの詳細を抽出する
ワークフロー¶
Jira Cloud管理者 は以下のタスクを実行します。
Jiraインスタンス内で API トークンを生成します。このトークンは、コネクタによって認証に使用されます。スコープ付きトークン（
read:jira-workおよびread:jira-userスコープ）とスコープなしトークンがサポートされていますが、よりきめ細やかなアクセス制御を行うには、スコープ付きトークンの使用が推奨されます。プロジェクト名、作成フィールド、更新フィールドなど、課題を検索する条件を定義します。
Snowflakeアカウント管理者 は以下のタスクを実行します。
コネクタをインストールします。
コネクタを構成します。
Jira API トークンを提供します。
Jiraインスタンス URL を指定します。
JQL クエリ、またはより単純なケースではプロジェクト名のみを提供して、取り込まれる課題の条件を定義します。
Snowflakeアカウントのデータベース名とスキーマ名を設定します。
Openflowキャンバスでコネクタフローを実行します。実行時、コネクタは以下のアクションを実行します。
構成されたJiraインスタンスから課題をフェッチする API 呼び出しを作成します。
課題の作成日、ステータス、担当者などの関連データを抽出します。
API 呼び出しが少なくとも1つの結果を返した場合、構成された宛先テーブルをSnowflakeデータベースに作成します。
処理したデータを指定したSnowflakeテーブルにロードします。
Snowflake Businessユーザー はビューにアクセスし、Jira Cloudから宛先テーブルにダウンロードされたデータに対して操作を実行することができます。
制限事項¶
各コネクタインスタンスは、 JQL 検索クエリ1つのみに関連付けることができます。
コネクタプロパティのタイムスタンプはJira Cloudのタイムゾーンを反映するため、ユーザーのローカルタイムゾーンと不一致が生じる可能性があります。Jira Cloudのタイムゾーンは一度フェッチされ、 FetchJiraIssues プロセッサーの状態に保持されます。コネクタのタイムゾーンを更新するには、このプロセッサーの状態をクリアする必要があります。
Jira Cloud REST API がデータ削除に関する情報を返さないため、コネクタはターゲットSnowflakeテーブルの削除を反映できません。
メールと API トークンを使用した基本認証のみがサポートされている認証方法です。その結果、コネクタは API トークンの所有者がアクセスできるデータのみを取り込むことができます。
FetchJiraIssues プロセッサーはシングルスレッドであり、プライマリノードで動作するように設計されています。