Atlassian Data Lake のデータ モデルについて理解する

各製品は、Atlassian Data Lake に独自のテーブルと列のセットを保持しています。製品のすべてのデータを含めることを選択した場合は、それらの各テーブルに対して、さらに列が追加されます。

製品テーブルは、スター スキーマで製品データをキャプチャします。つまり、一部のテーブルは他のテーブルを参照します。このため、Atlassian Analytics で必要なデータを取得するには、複数のクエリを結合しなければならない場合があります。

データ共有のデータ モデル

データ共有を使用すると、Atlassian Data Lake を組織の環境またはサードパーティ ツールに接続できます。ただし、データ共有のデータ モデルは、Atlassian Analytics で利用できるものとは異なります。データ共有のデータ モデルの詳細をご確認ください。

データの鮮度

ほとんどのテーブルでは、ご利用の製品でデータ レイクに変更が反映されるまで、少なくとも 30 分を要します。これは、カスタム分析を行う場合や、最新の情報を入手することが重要である場合に特に役立ちます。

ただし、次のテーブルでは、変更が反映されるまでに約 3 〜 6 時間かかります。

• jira_issue

• jira_issue_cycle_time

• jira_issue_field

• jira_issue_status_history

• jira_project

Data Lake の日付とタイムスタンプ

日付とタイムスタンプのを含む列 (created_at、updated_at、など) はすべて UTC タイムゾーンであることに注意してください。これらを変換して別のタイムゾーンを使用するには、ワークスペース設定でワークスペースのタイムゾーンを変更するか、ダッシュボードの設定で個々のダッシュボードのタイムゾーンを変更します。

命名規則

テーブルと列の SQL 名に、特定の目的を示す特定の単語が含まれる場合があります。

テーブル名

_mapping

SQL 名にこのサフィックスが付いているテーブルには、その他のテーブルへの外部キーが格納されています。このテーブルの主な機能は、分析してインサイトを得るためにテーブルを横断してデータを組み合わせることです。

たとえば、Opsgenie スキーマの opsgenie_alert_responder_mapping テーブルは、どの対応者タイプがアラートに応答したかを表示するためのものです。このテーブルには、opsgenie_team、opsgenie_schedule、opsgenie_escalation、atlassian_account、の各テーブルへの外部キーがあります。

_history または _history_

SQL 名に history が付いているテーブルには、特定のオブジェクトに関する現在までのすべての更新が格納されます。これに対応して、ほとんどの履歴テーブルには、そのオブジェクトの最新情報のみが格納される履歴なしテーブルがあります。

たとえば、jira_issue_history テーブルには、Jira が同じ課題 (ID で表示) に関する新しいデータを送信するたびに更新がキャプチャされます。これは通常、課題が別のステータスにトランジションするときなど、特定のイベントや状態の変更時に行われます。特定の課題に関するこれらのイベントはすべて履歴テーブルに保存されます。履歴なしテーブルである jira_issue には、課題の最新の更新のみが保存されます。

列の名前

_id

このサフィックスは主キーと外部キー専用です。これらの列を使用してテーブルを結合します。

たとえば、jira_issue テーブルでは、issue_id が課題オブジェクトの主キー、project_id がこのテーブルを jira_project テーブルに結合するために使用できる外部キーです。

_by または account_id または _account_id

このサフィックスは、列が account テーブルの外部キーであることを示します。列には、アカウントが実行したアクションのアカウント識別子が格納されます。

たとえば、confluence_page テーブルの created_by にある値は、ページを作成したユーザーのアカウント ID です。

唯一の例外は、account テーブルの account_id 列です。これはそのテーブルの主キーです。

_at または _until

これらのサフィックスは、値がタイムスタンプになることを示します。たとえば、confluence_page テーブルのcreated_at や opsgenie_alert テーブルの snoozed_until などです。

_ref

このサフィックスは、値が特定のオブジェクトの製品内識別子になることを示します。たとえば、jira_issue テーブルの issue_ref などです。これは、データ レイク内にある一意の識別子で結合に必要な、オブジェクトの ID (_id サフィックス) とは異なります。