Jira 製品ファミリーのスキーマ

Jira 製品ファミリーでは、多くの同じテーブルが共有されています。つまり、Atlassian Data Lake で使用可能な Jira 製品のデータは、同じテーブル セットに集約されます。

If you need to filter for specific Jira product data, use the Project type column from the Jira project table in the “Filters” section of your visual mode queries or the WHERE clause of your SQL mode queries.

上の図は、Jira 製品ファミリーのスキーマと Jira Service Management のスキーマの間の関係を示しています。太字の列は、それらが含まれているテーブルの主キーです。

プロジェクト データのテーブル

Jira プロジェクト データ用のテーブルは次のとおり複数あります。

• Project

• ProjectComponent

• プロジェクトの修正バージョン

Project

jira_project テーブルには Jira プロジェクトがリストされています。

使用されている列は次のとおりです。

担当者タイプ*

プロジェクトの既定の課題割当先の設定。

説明*

プロジェクトの説明。

リード アカウント ID

プロジェクト リードとして定義された人物の一意の識別子。

名前*

プロジェクトの名前。

プロジェクト カテゴリ*

このプロジェクトが割り当てられているプロジェクト カテゴリ。

プロジェクト ID

プロジェクトの一意の識別子。これをプロジェクト データの主キーとして使用します。

プロジェクト キー*

プロジェクトの一意のキー。

プロジェクト参照*

Jira サイト内のプロジェクトの識別子。

これは、Jira の REST API と URL で該当するレコードをプロジェクト識別子に関連付けるために使用できますが、複数のワークスペースでの一意性を保証するものではありません。

プロジェクト タイプ*

プロジェクトのタイプ。プロジェクト タイプの詳細を確認してください。

行の更新時刻

ワークスペース ID

ProjectComponent

jira_project_component テーブルには、各プロジェクトに定義されたコンポーネントがリストされます。

使用されている列は次のとおりです。

担当者タイプ*

プロジェクトの既定の課題割当先の設定。

コンポーネント ID

プロジェクト コンポーネントの一意の識別子。これをコンポーネント データの主キーとして使用します。

コンポーネント参照*

Jira サイト内のコンポーネントの識別子

これは、Jira の REST API と URL で該当するレコードをコンポーネント識別子に関連付けるために使用できますが、複数のワークスペースでの一意性を保証するものではありません。

説明*

プロジェクト コンポーネントの説明。

リード アカウント ID

コンポーネント リードとして定義された人物の一意の識別子。

名前*

プロジェクト コンポーネントの名前。

プロジェクト ID

プロジェクトの一意の識別子。

行の更新時刻

ワークスペース ID

プロジェクトの修正バージョン

jira_project_fix_version テーブルには、各プロジェクトに定義されたバージョンがリストされます。

使用されている列は次のとおりです。

説明*

プロジェクト バージョンの説明。

名前*

プロジェクト バージョンの名前。

プロジェクト ID

プロジェクトの一意の識別子。

リリース日

プロジェクト バージョンのリリース日。

行の更新時刻

並べ替え順序*

バージョンの順序 (Jira 製品での表示順序に対応)。

開始日

プロジェクト バージョンの開始日。

ステータス*

プロジェクト バージョンの現在のステータス。

バージョン ID

プロジェクト バージョンの一意の識別子。これをバージョン データの主キーとして使用します。

バージョン参照*

Jira サイト内のプロジェクト バージョンの識別子。

これは、Jira の REST API と URL で該当するレコードをバージョン識別子に関連付けるために使用できますが、複数のワークスペースでの一意性を保証するものではありません。

ワークスペース ID

課題データのテーブル

Jira 課題データのテーブルは次のとおり複数あります。

• Issue

• 課題の影響を受けるバージョン マッピング

• 課題のサイクル期間

• 課題のカスタム フィールド

• 課題グループのマッピング

• 課題フィールド

• 課題の修正バージョン マッピング

• 課題履歴

• 課題リンク

• 課題ステータスの履歴

• 課題の作業ログ

Issue

jira_issue には Jira 課題がリストされます。

使用されている列は次のとおりです。

担当者アカウント ID*

課題担当者の一意の識別子。

作成時刻

課題が作成された日時 (UTC タイム ゾーン)。

作成者アカウント ID*

課題の作成者の一意の識別子。

説明*

課題の説明。

期限

課題の期限 (UTC タイム ゾーン)。

環境*

課題が発生した環境の短い説明。

アーカイブ済み

課題が現在アーカイブされているかどうかを示します。

課題 ID

課題の一意の識別子。これを課題データの主キーとして使用します。

課題キー*

プロジェクト内の課題の番号。

課題参照*

Jira サイト内の課題の識別子。

これは、Jira の REST API と URL で該当するレコードを課題識別子に関連付けるために使用できますが、複数のワークスペースでの一意性を保証するものではありません。

課題タイプ*

課題のタイプ。

ラベル*

課題に追加されたラベル名の配列。

初期見積もり時間 (秒)*

設定された初期見積もり時間 (秒単位)。

親課題 ID

課題の直接の親の一意の識別子 (課題で「親」フィールドを使用している場合)。

優先度*

現在の課題の優先度。

優先度の並べ替え順序

優先度の順序 (Jira 製品での表示順序に対応)。

プロジェクト ID

プロジェクトの一意の識別子。

報告者アカウント ID*

課題の報告者の一意の識別子。

解決状況*

現在の課題解決状況。

解決日

課題が解決された日時 (UTC タイム ゾーン)。

解決状況の並べ替え順序

解決状況の順序 (Jira 製品での表示順序に対応)。

行の更新時刻

ステータス*

現在の課題のステータス。

ステータス カテゴリ*

現在の課題ステータスのステータス カテゴリ。

ステータスの並べ替え順序

ステータスの順序 (Jira 製品での表示順序に対応)。

ストーリー ポイント*

課題に割り当てられたストーリー ポイントの数。

このフィールドには、[ストーリー ポイントの見積もり] フィールドまたは [ストーリー ポイント] フィールドのいずれかの値が入力されます (既定の設定が変更されていない場合) が、両方のフィールドが同じ課題で使用されている場合は、[ストーリー ポイントの見積もり] フィールドの値が優先されます。

要約*

課題の要約。

チーム ID

課題に関連付けられたチームの一意の識別子。

時間の見積もり (秒)*

元の推定からの残存推定時間 (秒単位)。

消費時間 (秒)*

ログに記録された作業量 (秒単位)。消費時間がない場合、フィールドは NULL になります。

作成日時

課題が最後に更新された日時 (UTC タイム ゾーン)。

URL*

課題の URL。

ワークスペース ID

課題の影響を受けるバージョン マッピング

jira_issue_affected_version_mapping テーブルには、バグまたは問題が見つかった課題とプロジェクト バージョンとの間の関連付けが保持されます。

使用されている列は次のとおりです。

課題 ID

課題の一意の識別子。

行の更新時刻

バージョン ID

課題の修正バージョンであるプロジェクト バージョンの一意の識別子。

ワークスペース ID

課題のサイクル期間

jira_issue_cycle_time テーブルには、「課題ステータスの履歴」テーブルから取得したデータが含まれます。

これを使用し、課題ステータスのトランジションに基づいてフロー メトリックを計算できます。作業の開始は「進行中」ステータス カテゴリに割り当てられたステータスへの最初のトランジションとして定義され、作業の終了は「完了」ステータス カテゴリに割り当てられたステータスへの最後のトランジションとして定義されます。

課題のステータスが現在「完了」ステータス カテゴリにある場合は、cycle_time_secs 列に経過時間が表示されます。作業の終了が作業の開始よりも前にある場合、その値は NULL になります。マイナスのサイクル期間を取得しないようにするためです。

使用されている列は次のとおりです。

サイクル期間 (秒)

作業の開始から作業の終了までの全体経過時間 (秒単位) で、課題サイクル期間全体を示しています。

記録された work_ended_at が work_started_at より前の場合、値は NULL になります。

課題 ID

課題の一意の識別子

作業完了日時

課題が「完了」ステータス カテゴリのステータスにトランジションした最も遅い日時 (UTC タイム ゾーン) (課題の作業が完了した時刻を示す)。

作業開始時間

課題が「進行中」ステータス カテゴリのステータスにトランジションした最も早い日時 (UTC タイム ゾーン) (課題の作業が開始された時刻を示す)。

ワークスペース ID

課題のカスタム フィールド

この表は「Jira 課題フィールド」表から派生したもので、すべてのカスタム フィールドをクエリに追加できる通常の列として表示します。

カスタム フィールドに他の属性が必要な場合は、[Issue field (課題フィールド)] 表を使用する必要があります。

課題グループのマッピング

jira_issue_group_mapping テーブルには、課題とグループ間の関連が格納されます。

使用されている列は次のとおりです。

フィールド ID

グループが選択された課題フィールドの一意の識別子。

groupid

課題に関連付けられたグループの一意の識別子。

課題 ID

課題の一意の識別子

行の更新時刻

ワークスペース ID

課題フィールド

jira_issue_field には、Jira フィールドの内容がリストされます。

使用されている列は次のとおりです。

フィールド ID

Jira フィールドの一意の識別子。このテーブルの issue_id 列とともに、課題フィールド データの主キーとして使用します。

フィールド キー*

Jira フィールドのキー。

キーには、アプリで定義されている ID とは異なる値を保持できます。

フィールド参照

Jira サイト内のフィールドの識別子。

これは、Jira の REST API と URL で該当するレコードをフィールド識別子に関連付けるために使用できますが、複数のワークスペースでの一意性を保証するものではありません。

フィールド タイプ*

フィールドに格納されるデータ タイプ。

課題 ID

課題の一意の識別子。このテーブルの field_id 列とともに、課題フィールド データの主キーとして使用します。

名前*

フィールドの名前。

フィールドに複数の値が含まれている場合は、フィールドにそれぞれの値のレコードが存在します。

フィールドにカスケード値が含まれている場合は、親の値のレコードと、それぞれの子の値のレコードが存在します。親の値を取得するには、フィールド名に (parent) を追加します。子の値を取得するには、フィールド名に (child) を追加します。

たとえば、"ロケーション" という名前の Jira フィールドがあるとします。フィールドの値には、まず国を選択してから、次に地域を選択する必要があります。国は親の値に保存され、地域は子の値に保存されます。データ レイクから両方をクエリするには、Location (parent) と Location (child) というフィールド名をフィルタリングして、国と地域の値をそれぞれ取得します。

値*

該当する課題に関する Jira フィールドの内容。この文字列で表されるデータのタイプは、フィールドによって異なります。

ワークスペース ID

課題の修正バージョン マッピング

jira_issue_fix_version_mapping テーブルには、課題と、その修正バージョンであるプロジェクト バージョンとの間の関連付けが保持されます。

使用されている列は次のとおりです。

課題 ID

課題の一意の識別子。

行の更新時刻

バージョン ID

課題の修正バージョンであるプロジェクト バージョンの一意の識別子。

ワークスペース ID

課題履歴

jira_issue_history テーブルでは、課題データの経時的な変更が追跡されます。課題詳細の [History] タブとは異なり、このテーブルには、課題作成時にフィールドに割り当てられる初期値が含まれています。

場合によっては、課題に複数の更新が同時に適用されることがあります。これらの更新では、同じ changelog_id 値が共有されます。これらの変更グループごとに、更新された各フィールドの行が表示されます。

使用されている列は次のとおりです。

作成者アカウント ID*

課題に対する変更適用者の一意の識別子。

変更ログ ID

課題に対する更新のグループの一意の識別子。

終了日時

新しいフィールド値が別の値に置き換えられた日時 (UTC タイム ゾーン)。

この記録が取り込んだ変更がその後の変更によって置き換えられた時刻です。その後に変更がなかった場合は NULL です。

フィールド*

更新されたフィールドの名前。

フィールド ID

更新されたフィールドの一意の識別子。

フィールド キー*

フィールドのキー。

フィールド名*

更新されたフィールドの現在の名前。

履歴レコードが作成されてからフィールドが削除された場合は、NULL になることがあります。

フィールド タイプ*

更新されたフィールドのタイプ。

履歴レコードが作成されてからフィールドが削除された場合は、NULL になることがあります。

課題 ID

更新された課題の一意の識別子。

前の値*

変更前のフィールドの値。

前の値 (文字列)*

変更前のフィールドの値を表す文字列。

開始日時*

新しいフィールド値が有効になった日時 (UTC タイム ゾーン)。

この記録が取り込んだ変更の時刻です。

値の時間 (秒)

このフィールド値の開始時刻と終了時刻の時間間隔 (秒単位)。

フィールドでその後に変更がなかった場合 (つまり、新しいフィールド値が現在の値)、NULL になります。

値*

変更後のフィールドの値。

値 (文字列)*

変更後のフィールドの値を表す文字列。

ワークスペース ID

課題リンク

jira_issue_link テーブルは、2 つの Jira 課題間のリンクを表しています。すべての課題は 1 組の行で表示されます。1 つは内向きの関係を表し、もう 1 つは外向きの関係を表します。

例：

• 外向きの関係: ABC-1 は ABC-2 をブロックする

• 内向きの関係: ABC-2 は ABC-1 によってブロックされる

使用されている列は次のとおりです。

課題 ID

リンク関係の始点となる課題を示す一意の識別子。

課題リンク タイプ ID

関係を表す課題リンクのタイプを示す一意の識別子。

リンクの方向

関係が流れる方向。

リンク ID

課題リンクを示す一意の識別子。これを課題リンク データの主キーとして使用します。

リンク名

関係を表す課題リンクのタイプの名前。

リンク関係

関係の説明。

リンクされた課題 ID

リンク関係の終点となる課題を示す一意の識別子。

行の更新時刻

ワークスペース ID

課題ステータスの履歴

jira_issue_status_history テーブルでは、課題ステータスの経時的な変更が追跡されます。課題詳細の [History] タブとは異なり、このテーブルには課題作成の初期ステータスも含まれます。課題の各トランジションに対して行があります。

使用されている列は次のとおりです。

作成者アカウント ID*

課題ステータスを設定または変更したユーザーの一意の識別子。

終了日時

新しい課題ステータスが別のステータスに置き換えられた日時 (UTC タイム ゾーン)。

その後に課題のトランジションがなかった場合は NULL です。

課題 ID

更新された課題の一意の識別子。

前のステータス*

前の課題ステータス。

前のステータスカテゴリ*

前の課題ステータスのステータス カテゴリ。

前のステータス ID

前の課題ステータスの一意の識別子。

開始日時*

新しい課題ステータスが設定された日時 (UTC タイム ゾーン)。

ステータス*

新しい課題ステータス。

ステータス カテゴリ*

新しい課題ステータスのステータス カテゴリ。

ステータス ID

新しい課題ステータスの一意の識別子。

ステータスの時間 (秒)

ステータスの開始時刻と終了時刻の時間間隔 (秒単位)。

その後に課題トランジションがなかった場合は (つまり、新しい課題ステータスが現在のステータス)、NULL になります。

ワークスペース ID

課題の作業ログ

jira_issue_worklog テーブルは、課題に費やされた時間を示し、各作業時間ログ エントリを (つまり、課題に作業が記録されるたびに) 記録します。

作成者

作業時間ログ エントリを作成し、時間の帰属先となるユーザーを示す一意の識別子。

作成時刻

作業時間ログ エントリが作成された日時 (UTC タイム ゾーン)。

ドキュメントの内容

作業時間ログ ドキュメントの詳細 (ADF 形式)。

課題 ID

作業時間ログが属する課題を示す一意の識別子。

課題の作業ログ ID

作業時間ログ エントリを示す一意の識別子。これを作業時間ログ データの主キーとして使用します。

行の更新時刻

開始日時

課題の作業が開始された日時 (UTC タイム ゾーン)。

消費時間 (秒)

課題に記録された時間 (秒単位)。

作成日時

作業時間ログ エントリが最後に更新された日時 (UTC タイム ゾーン)。

更新者:

作業時間ログ エントリを最後に更新したユーザーを示す一意の識別子。

ワークスペース ID