アトミックメトリクスは、メトリクスの統計的定義と計算ロジックを抽象化したものです。Dataphin は革新的な「開発としての設計」という理念を導入しており、メトリクスを定義すると同時にその計算ロジックも指定されます。このアプローチにより、開発効率が向上し、統計結果の一貫性が保証されます。本トピックでは、アトミックメトリクスを作成する方法について説明します。
前提条件
ビジネスエンティティが必要です。詳細については、「ビジネスエンティティの作成と管理」をご参照ください。
操作手順
Dataphin コンソールで、上部メニューにある [Development] をクリックします。デフォルトで [Development] ページが開きます。
上部メニューで プロジェクト を選択します。プロジェクトが Dev-Prod モード の場合は、環境 も選択する必要があります。
左側のナビゲーションウィンドウで、[Standard Modeling] > [Atomic Metric] を選択します。
アトミックメトリクスの一覧で、
アイコンをクリックし、[Create Atomic Metric] を選択します。[Create Atomic Metric] ダイアログボックスで、パラメータを設定します。
[Basic Information] セクションのパラメータを設定します。
パラメータ
説明
[ビジネスエンティティ]
ビジネスエンティティを選択します。
[主題領域]
デフォルトで、選択されたビジネスエンティティの主題領域が設定されます。
[英語名]
英語名を入力すると、Dataphin はデータ標準で事前定義された語根に基づいてリアルタイムで候補を提示します。推奨される語根を英語名として選択できます。詳細については、「語根の作成と管理」をご参照ください。
英語名は、次の要件を満たす必要があります。
英字、数字、アンダースコア (_) のみ使用できます。
長さは 64 文字を超えることはできません。
[中国語名]
中国語名は、次の要件を満たす必要があります。
任意の文字を使用できます。
長さは 128 文字を超えることはできません。
[測定単位]
アトミックメトリクスの測定単位を選択します。オプションには、[Monetary Unit]、[Time Unit]、[Ratio Unit]、[Ranking]、[Object Quantifier]、[Weight Unit]、[Other] があります。
[Monetary Unit]： Fen (CNY)、Yuan (CNY)、Ten Thousand Yuan (CNY)、Million Yuan (CNY)、Ten Million Yuan (CNY)、Hundred Million Yuan (CNY)、Cent (USD)、Dollar (USD)、Euro (EUR)、Hong Kong Dollar (HKD)。
[Time Unit]： Day、Month、Week、Year、Hour、Minute、Second、Quarter、Millisecond。
[Ratio Unit]： Decimal、Percentile、Permille。
[Ranking]： Rank (position)。
[Object Quantifier]： Account、Transaction、Item、Unit、Instance、Person-day、Household、Lot、Sheet、Pack。
[Weight Unit]： Ton、Kilogram。
[Other]： Other。
[データ型]
アトミックメトリクスのデータ型を選択します。オプションには、[string]、[bigint]、[double]、[datetime]、[timestamp]、[decimal]、[Text (varchar, char)]、[Numeric] ([int, smallint, tinyint, float])、[Date (date)]、[Other] ([boolean, binary]) があります。
[メトリック仕様]
メトリック仕様を入力します。これは、メトリクスの定義と計算ロジックを自然言語で記述したもので、ビジネスユーザーがメトリクスの計算方法を理解するのに役立ちます。例：
合計注文数：店舗からの有効な注文の総数です。異常な注文や未完了の注文は除きます。仕様は 1,000 文字を超えることはできません。[説明]
アトミックメトリクスの簡単な説明を入力します。説明は 1,000 文字を超えることはできません。
[Calculation Logic] セクションのパラメータを設定します。
ビジネス要件に基づいて、データの適時性を選択し、アトミックメトリクスの計算ロジックを設定できます。[データの適時性]のオプションには、[Day]、[Hour]、[Minute] があります。
説明Doris および SelectDB コンピュートエンジンは、データの適時性オプション [Minute] をサポートしていません。
パラメータ
説明
[ソース主テーブル]
ソーステーブルを選択します。モデリング標準を維持するため、ディメンション論理テーブルまたはファクト論理テーブルのみ選択できます。
[統計期間識別子]
イベントまたはビジネスプロセスの時間を示すフィールドを指定します。このパラメータは、プロセスファクト論理テーブル (da テーブル)、高速ファクト論理テーブル (df テーブル)、およびディメンション論理テーブルでのみサポートされます。イベントファクト論理テーブル (di テーブル) ではサポートされません。
計算ロジック
アトミックメトリクスの計算ロジックを定義する式を記述します。例：
count(distinct order_id)。ここで、order_idはソース論理テーブルモデルのフィールドです。説明利用可能なフィールドの一覧にあるフィールドをクリックすると、そのフィールドを計算ロジックエディタに追加できます。
[加算性]
同じ統計粒度でメトリクス (派生メトリクスとして) を合計することが意味を持つかどうかを指定します。一般的に、distinct カウントに基づくメトリクスは加算性を持ちません。
例えば、ユーザーごとの取引額を合計することは意味があります。ユーザー A の取引額が 100 で、ユーザー B の取引額が 200 の場合、その合計は 300 になります。しかし、製品ごとの購入者数を合計することは意味がありません。製品 A の購入者が 100 人で、製品 B の購入者が 50 人の場合、合計の 150 は、両方の製品を購入したユーザーが二重にカウントされるため、実態より多くなる可能性があります。
パラメータを設定した後、[Save and Submit] をクリックします。
次のステップ
プロジェクトが Dev-Prod モード の場合、アトミックメトリクスを本番環境に公開する必要があります。詳細については、「公開タスクの管理」をご参照ください。
アトミックメトリクスを作成した後、それに基づいて派生メトリクスを作成できます。詳細については、「派生メトリクスの作成」をご参照ください。