すべてのプロダクト
Search
ドキュメントセンター

Dataphin:アトミックメトリックを作成する

最終更新日:May 29, 2025

アトミックメトリックは、メトリックの統計口径と特定のアルゴリズムを抽象化したものです。Dataphin は革新的に開発自動化の概念を導入しており、メトリック定義では統計口径設計(計算ロジック)も明確化することで、開発効率の向上と統計結果の整合性を確保しています。このトピックでは、アトミックメトリックを作成する方法について説明します。

前提条件

ビジネスエンティティを作成済みであること。詳細については、「ビジネスエンティティを作成および管理する」をご参照ください。

手順

  1. Dataphin ホームページの上部ナビゲーションバーで、[開発] をクリックします。デフォルトでデータ [開発] ページが表示されます。

  2. 上部ナビゲーションバーで、プロジェクトを選択します(開発 - 本番モードでは、環境を選択する必要があります)。

  3. 左側のナビゲーションウィンドウで、[ディメンショナルモデリング] > [アトミックメトリック] を選択します。

  4. アトミックメトリックリストで、image アイコンをクリックし、[アトミックメトリックの作成] を選択します。

  5. [アトミックメトリックの作成] ダイアログボックスで、パラメーターを構成します。

    1. [基本情報] セクションのパラメーターを構成します。

      パラメーター

      説明

      ビジネスエンティティ

      ビジネスオブジェクトまたはビジネスアクティビティを選択します。

      データドメイン

      ビジネスオブジェクトまたはビジネスアクティビティが属する主題領域がデフォルトで選択されています。

      英語名

      • 英語名を入力すると、Dataphin はデータ標準で構成されたルートと入力データをリアルタイムで照合します。推奨されるルートをビジネスエンティティの英語名として選択できます。詳細については、「ルートを作成および管理する」をご参照ください。

      • 英語名は、以下の要件を満たしている必要があります。

        • 文字、数字、またはアンダースコア (_) のみを含めることができます。

        • 64 文字を超えることはできません。

      中国語名

      名前は、以下の要件を満たしている必要があります。

      • 任意の文字を含めることができます。

      • 128 文字を超えることはできません。

      測定単位

      アトミックメトリックの測定単位を選択します。オプションには、[通貨単位][時間単位][比率単位][ランキング][オブジェクト数量詞][重量単位][その他] が含まれます。

      • [通貨単位]: セント (CNY)、元 (CNY)、1 万元 (CNY)、100 万元 (CNY)、1,000 万元 (CNY)、1 億元 (CNY)、セント (USD)、ドル (USD)、ユーロ (EUR)、ドル (HKD)。

      • [時間単位]: 日、月、週、年、時、分、秒、四半期、ミリ秒。

      • [比率単位]: 10 進数、パーセンタイル、千単位の区切り文字。

      • [ランキング]: ランキング (順位)。

      • [オブジェクト数量詞]: 世帯、トランザクション、アイテム、個、時間、人日、会社、手、シート、パッケージ。

      • [重量単位]: トン、キログラム。

      • [その他]: その他。

      データ型

      アトミックメトリックのデータ型を選択します。オプションには、[string][bigint][double][datetime][timestamp][decimal][テキスト (varchar、Char)][数値] (int、smallint、tinyint、float)、[日付時刻 (date)][その他] (boolean、binary) が含まれます。

      メトリック口径

      メトリック口径を入力します。これは、メトリックの定義と処理ロジックを自然言語で記述したもので、ビジネス担当者がメトリック処理ロジックを理解するのに役立ちます。例: 合計注文数: 店舗における有効な注文の合計数。異常な注文や不完全な注文は除く。メトリック口径は 1,000 文字を超えることはできません。

      説明

      アトミックメトリックの簡単な説明を入力します。説明は 1,000 文字を超えることはできません。

    2. [計算ロジック] セクションのパラメーターを構成します。

      ビジネス要件に基づいて、データの時間的制約を選択し、アトミックメトリックの計算ロジックを構成できます。データの時間的制約のオプションには、 が含まれます。

      パラメーター

      説明

      メインソーステーブル

      ソーステーブルを選択します。モデリング標準を確保するために、論理ディメンションテーブルまたは論理ファクトテーブルのみがソーステーブルとしてサポートされています。

      統計期間識別子

      統計期間識別子では、イベント (ビジネスプロセス) の時間フィールドを指定できます。論理フローファクトテーブル (df テーブル) と論理ディメンションテーブルのみがサポートされており、論理イベントファクトテーブル (di テーブル) はサポートされていません (ds パーティションフィールドがデフォルトで使用されるとも解釈できます)。

      計算ロジック

      アトミックメトリックを定義する計算ロジックを記述します。例: count(distinct order_id)。ここで、order_id はソース論理テーブルモデルのフィールドです。

      説明

      該当するリストのフィールドをクリックして、計算ロジックエディターに追加します。

      加法性

      加法性は、同じ統計粒度でメトリック (派生メトリック) を追加することがビジネス的に意味があるか、ビジネスルールに準拠しているかを示します。一般に、個別カウントを使用するメトリックは加法的ではありません。

      たとえば、ユーザー粒度でトランザクション金額を追加することはビジネス的に意味があります。張三のトランザクション金額が 100 で、李四のトランザクション金額が 200 の場合、2 人の合計トランザクション金額は 300 になります。ただし、製品粒度で購入者数を追加することはビジネス的に意味がありません。ブランド A の電話の購入者が 100 人で、ブランド B の電話の購入者が 50 人の場合、合計 150 人は水増しされている可能性があります。なぜなら、両方の製品を購入した人がいる可能性があり、それらを追加すると、これらの人の数が 2 回カウントされるためです。

    3. 構成が完了したら、[保存して送信] をクリックして、アトミックメトリックを送信します。

次の手順

  • プロジェクトモードが開発 - 本番の場合、アトミックメトリックを本番環境に公開する必要があります。詳細については、「公開タスクを管理する」をご参照ください。

  • アトミックメトリックを作成した後、必要に応じて、それに基づいて派生メトリックを作成できます。詳細については、「派生メトリックを作成する」をご参照ください。