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

DataWorks:アトミックメトリック

最終更新日:Nov 09, 2025

アトミックメトリックは、ビジネスアクティビティの統計基準と計算ロジックを定義します。ビジネスプロセスに基づいてアトミックメトリックを作成し、特定のビジネスアクティビティを測定できます。たとえば、ビジネスアクティビティが購入の場合、アトミックメトリックは支払金額になります。このトピックでは、アトミックメトリックの作成方法について説明します。

前提条件

統計分析のために特定のビジネスアクティビティを定義するには、データドメインとビジネスプロセスを作成する必要があります。詳細については、「ビジネスプランニング」をご参照ください。

機能紹介

アトミックメトリックは、インテリジェントデータモデリングにおける最小の測定単位です。ビジネス動作の定量的計算に使用されます。「何を計算するか」と「どのように計算するか」を定義します。

アトミックメトリックは、次の 2 つの部分で構成されます。

  • 基本情報: メトリックの基本情報とビジネス定義を定義します。通常、ファクトテーブルの数値フィールドです。たとえば、amt (金額) です。

  • 計算ロジック (集計関数): 計算メソッドを定義します。たとえば、SUM (合計)、COUNT (カウント)、AVG (平均)、MAX (最大)、MIN (最小) です。

そのコア機能は、分割できないことです。その定義には、期間やチャネルソースなどの業務フィルタは含まれません。派生メトリクスと複合指標を構築するための基盤となります。

アトミックメトリックの作成

  1. [アトミックメトリック] ページに移動します。

    1. DataWorks コンソールにログインします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションウィンドウで、[データ開発と O&M] > [データモデリング] を選択します。表示されたページで、ドロップダウンリストから目的のワークスペースを選択し、[データモデリングへ] をクリックします。

    2. [インテリジェントデータモデリング] ページの上部のナビゲーションバーで [データメトリクス] をクリックします。

    3. [データメトリクス] ページの左側のナビゲーションウィンドウで、[アトミックメトリック] をクリックして [アトミックメトリック] ページを開きます。

  2. アトミックメトリックを作成します。

    1. [アトミックメトリック] ページで、新建 アイコンをクリックして新しいアトミックメトリックを作成します。

  3. アトミックメトリックを構成します。

    1. 基本情報を構成します。

      次の表の説明に従って、アトミックメトリックの基本情報を構成します。

      パラメーター

      説明

      略語

      アトミックメトリックの略語です。これはメトリックの一意の識別子であり、作成後に変更することはできません。

      英語名

      アトミックメトリックの英語名です。

      メトリックが測定する値の英語の用語を使用します。これにより、メトリックの統計タイプをすばやく理解できます。

      中国語名

      アトミックメトリックの中国語名です。

      メトリックが測定する値の中国語の用語を使用します。これにより、メトリックの統計タイプをすばやく理解できます。

      ビジネス定義

      アトミックメトリックによって測定されるビジネスアクティビティの統計的定義です。これにより、統計分析中のあいまいさを防ぎます。

      たとえば、実際の注文支払金額 のビジネス定義は 注文が生成された後、ユーザーが支払いチャネルを通じて支払った合計金額です。この金額は、すべてのクーポン割引が差し引かれた後にユーザーが実際に支払った合計金額です。 となります。

      業務カテゴリ

      業務カテゴリは、データドメインまたはデータマートに関連付けることができます。

      ビジネスプロセス

      アトミックメトリックが属するビジネスプロセスです。統計分析のビジネスアクティビティを指定します。

      オーナー

      アトミックメトリックのオーナーです。デフォルトでは、アトミックメトリックを作成したユーザーになります。

      説明

      アトミックメトリックの説明です。

    2. 計算ロジックを構成します。

      計算ロジックは、アトミックメトリックの計算メソッドと単位のみを定義します。実際には、定義された計算ロジックに基づいてコードを記述し、実際の計算を実行する必要があります。次の表にパラメーターを示します。

      パラメーター

      説明

      関数

      メトリック計算に使用する関数を選択します。

      小数点以下の桁数

      小数点以下の桁数。選択した測定単位によって決まります。たとえば、支払金額を元で測定する場合、小数点以下の桁数を 2 に設定します。

      データ単位

      アトミックメトリックの統計データ型に基づいて、適切な測定単位を選択します。たとえば、支払金額を測定するには、[通貨単位] を選択できます。

      説明

      既存の単位タイプがビジネス要件を満たさない場合は、測定単位ページに移動して作成します。詳細については、「測定単位」をご参照ください。

      重複排除

      ビジネスニーズに基づいて、統計分析中に重複を削除するかどうかを指定します。たとえば、アトミックメトリックがメンバー数である場合、単純に合計するのではなく、重複を削除する必要があります。

  4. [保存] をクリックします。

  5. [送信] をクリックして、アトミックメトリックの現在のバージョンを公開します。アトミックメトリックは、モデルまたは派生メトリクスによって参照される前に送信する必要があります。

    説明
    • 保存されたアトミックメトリックのみを送信できます。

    • アトミックメトリックを送信するたびに、新しいバージョンが生成されます。正常に送信されたバージョンを再度送信することはできません。

バージョンと関連テーブルの管理

メトリック編集ページの右側のナビゲーションウィンドウでは、メトリックバージョンの管理や関連テーブルの表示もできます。

操作

説明

メトリックバージョンの管理

メトリックのすべてのバージョン情報を表示します。次の操作も実行できます。

  • バージョンの比較

    選択したバージョン間の内容の差異を比較します。最大 2 つのバージョンを選択して比較できます。バージョンを 1 つだけ選択した場合、現在保存されているメトリックの内容と比較されます。

  • ロールバック

    目的のメトリックバージョンに切り替えます。切り替えると、メトリック編集ページの内容がターゲットバージョンの内容で上書きされます。

    説明

    ロールバック操作は、インターフェイス構成を選択したバージョンに更新するだけです。モデルと派生メトリクスに最新の構成を参照させる場合は、再度保存して送信する必要があります。

関連テーブルの表示

メトリックに関連付けられているモデルテーブルのフィールドを表示します。フィールドの横にある [詳細の表示] をクリックすると、モデルテーブルの詳細ページに移動して詳細を確認できます。

アトミックメトリックのインポート

多くのアトミックメトリックを作成するには、バッチインポート機能を使用できます。DataWorks はインポートテンプレートを提供します。インポートしたいアトミックメトリックをテンプレートに入力し、ファイルをアップロードできます。

  1. [アトミックメトリック] ページに移動し、导入 アイコンにカーソルを合わせ、[Excel からインポート] をクリックします。

    アトミックメトリックページへの移動方法については、「アトミックメトリックの作成」セクションの手順をご参照ください。

  2. インポートタイプを選択し、テンプレートをダウンロードします。

    [インポートタイプの確認] タブで、アトミックメトリックのインポートタイプを選択し、対応するテンプレートをダウンロードして、テンプレートに入力します。

    説明

    インポートタイプを選択すると、対応するテンプレートをプレビューし、フィールドの内容を準備できます。

    导入原子指标

  3. データをインポートして確認します。

    [データインポート] タブで、データファイルをアップロードしてプレビューします。DataWorks にすでに存在する名前のフィールドのみをプレビューし、必要に応じて削除または変更することができます。

    • 選択したインポートタイプによって、[インポートモード][インポートステータス] が決まります。

      • インポートモード: インポートされたファイル内のオブジェクトが DataWorks 内の既存のオブジェクトと同じ名前を持つ場合、オブジェクトをスキップするか、既存のオブジェクトを上書きするかを選択できます。

      • インポートステータス:

        • インポートして保存: 新しいバージョンを作成せずにデータをインポートして保存します。

        • インポートして送信: データをインポートし、新しいバージョンとして送信します。

    • バッチインポートは .xlsx ファイルのみをサポートします。一度に最大 30,000 件のデータレコードをインポートでき、ファイルサイズは 10 MB を超えることはできません。

    导入原子指标

  4. インポート結果を表示します。

    [完了] タブで、インポートの詳細を表示できます。リストで、アトミックメトリックの横にある [詳細] をクリックして編集ページを開き、追加の操作を実行します。インポートが失敗した場合は、提供された詳細に基づいてエラーを解決し、再度インポートを試みてください。

アトミックメトリックのエクスポート

多くのアトミックメトリックをエクスポートするには、バッチエクスポート機能を使用できます。导出原子指标

  1. アトミックメトリックのリストページに移動します。

    アトミックメトリックページで、左側のディレクトリツリーの上にある image アイコンをダブルクリックして、アトミックメトリックリストを開きます。このページでは、作成されたすべてのアトミックメトリックを表示できます。

  2. エクスポートするメトリックを選択します。

    説明

    [すべてエクスポート] を使用する場合は、このステップをスキップできます。

    次の 2 つの方法でメトリックを選択できます。

    • キーワードで検索: 検索ボックスにキーワードを入力して、必要なメトリックを検索します。

      説明

      あいまい検索がサポートされています。キーワードを入力すると、名前にキーワードが含まれるすべてのアトミックメトリックが表示されます。

    • 直接選択: リストから必要なメトリックを選択します。

  3. アトミックメトリックをバッチエクスポートします。

    次の 3 つの方法のいずれかでメトリックをエクスポートできます。

    • すべてエクスポート: 現在のワークスペース内のすべてのアトミックメトリックをエクスポートします。

    • 検索結果をエクスポート: 検索ボックスに入力されたキーワードに一致するすべてのメトリックをエクスポートします。

    • 選択項目をエクスポート: 選択したメトリックをエクスポートします。

  4. エクスポート結果を表示してダウンロードします。

    アトミックメトリックのエクスポートタスクを開始すると、自動的に [アトミックメトリックのエクスポートステータスの詳細] ページにリダイレクトされ、エクスポートステータスをモニターできます。エクスポートが成功したら、[ファイルのダウンロード] をクリックして、アトミックメトリックをローカルコンピューターにダウンロードします。

アトミックメトリックのバッチ削除と送信

廃止されたアトミックメトリックが複数ある場合、または作成されたが送信されていないメトリックが複数ある場合は、アトミックメトリックリストに移動して、バッチで削除または送信できます。

  1. アトミックメトリックのリストページに移動します。

    アトミックメトリックページで、左側のディレクトリツリーの上にある image アイコンをダブルクリックして、アトミックメトリックリストを開きます。このページでは、作成されたすべてのアトミックメトリックを表示できます。

  2. バッチ操作のメトリックを選択します。

    説明

    バッチ送信では、保存されているが送信されていないアトミックメトリックのみを選択できます。

  3. 必要に応じて、メトリックをバッチで削除または送信することを選択します。

    • バッチ削除: メトリックが削除されると、モデルや派生メトリクスから参照できなくなります。

      説明

      アトミックメトリックがモデルまたは派生メトリクスによって参照されている場合は、メトリックを削除する前に参照を削除する必要があります。

    • バッチ送信: モデルや派生メトリクスから参照できるようにメトリックを送信します。この操作により、新しいバージョンレコードも生成されます。メトリックバージョンの詳細については、「バージョンと関連テーブルの管理」をご参照ください。

次のステップ

アトミックメトリックを作成した後、派生メトリクスとモデルから参照して、特定の時間、ディメンション、およびビジネス条件のターゲットメトリックの値を取得できます。詳細については、「派生メトリクス」および「モデルをコンピュートエンジンに公開する」をご参照ください。