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

Dataphin:動作リレーションシップの作成と管理

最終更新日:Mar 06, 2025

動作リレーションシップは、特定のアクションを介したエンティティ間の接続を定義します。たとえば、ユーザーが製品を購入するは、購入というアクションを介した ユーザー エンティティと 製品 エンティティの関係を表します。定義された動作リレーションシップは、動作統計、動作プリファレンス、およびルールの組み合わせタイプのタグ、またはオーディエンスグループの選択に直接使用できます。このトピックでは、動作リレーションシップを追加する方法について説明します。

前提条件

動作リレーションシップをバインドするエンティティを最初に作成する必要があります。詳細については、「エンティティの作成」をご参照ください。

動作リレーションシップの作成

  1. Dataphin ホームページの上部メニューバーで、[タグ] > [タグ ワークベンチ] を選択します。

  2. 上部メニューバーで、[プロジェクト] を選択します。

  3. 左側のナビゲーションウィンドウで、[データ準備] > [動作リレーションシップ] を選択します。

  4. [動作リレーションシップ] ページで、[動作リレーションシップの追加] をクリックします。

  5. 構成ウィザードに従って、動作リレーションシップの [基本情報][処理ロジック]、および [操作構成] を構成します。

    • 基本情報

      パラメーター

      説明

      所有者

      動作リレーションシップの所有者を選択します。

      説明

      動作リレーションシップの簡単な説明を 1,000 文字以内で入力します。

    • 処理ロジック

      • データソース

        プロジェクトに基づいて動作リレーションシップを構成するためのソーステーブルを選択します。

        パラメーター

        説明

        プロジェクト/データセグメント

        オフラインデータセットを参照するために必要な [プロジェクト] または [データバージョン] を選択します。ドロップダウンリストには、現在のテナントアカウントの下にあるすべてのプロジェクト (オフラインコンピューティングソースにバインドされている) とデータセグメントが含まれます。

        説明

        Intelligent R&D エディションを購入していない場合は、[プロジェクト] のみを選択できます。

        論理テーブル/ソーステーブル

        データセットを定義するための論理テーブル/ソーステーブルを選択します。

        • 論理テーブル: プロジェクト/データセグメントで [データセグメント] を選択した場合、ソーステーブルを選択できます。論理テーブルでは、リードスルー権限を持つ論理テーブルのみを選択できます。

          論理テーブルを選択する場合は、最初に [論理テーブルタイプ] を選択し、次に [主題領域] を選択し、最後に主題領域内のすべての論理テーブルからターゲット [論理テーブル] を選択します。主題領域と論理テーブルの両方でキーワード検索がサポートされています。論理テーブルタイプには、[論理ファクトテーブル][論理ディメンションテーブル][論理集計テーブル] が含まれます。

          説明

          論理テーブルのデフォルトの出力メソッドには、関連付けは含まれません。

        • ソーステーブル: プロジェクト/データセグメントで [プロジェクト] を選択した場合、ソーステーブルを選択できます。ソーステーブルでは、プロジェクトテナントアカウントの [クエリテーブルデータ] 権限を持つテーブルのみを選択できます。権限がない場合は、[権限をリクエスト] をクリックして申請できます。

        日付パーティション

        ソーステーブルのパーティションフィールドを選択します。

        • 選択したソーステーブルがパーティションテーブルの場合、システムはデフォルトでフィールド名を日付パーティションとして使用します。デフォルトのフィールド名がソーステーブルのパーティションフィールドリストにない場合、システムはテーブルの最初のパーティションフィールドを日付パーティションとして使用します。

        • 選択したソーステーブルが パーティション化されていないテーブル の場合、日付パーティションを選択する必要はありません。

        パーティションフィールドの形式

        日付形式を入力するか、既存の日付形式を選択します。[yyyymmdd][yyyy-mm-dd][yyyy/mm/dd][yyyy.mm.dd] を選択できます。

        説明

        コンピュートエンジンが MaxCompute の場合のみ、パーティションフィールドの形式を [yyyymmdd][yyyy-mm-dd][yyyy/mm/dd]、または [yyyy.mm.dd] として選択できます。

        説明

        パラメーターのサンプルリファレンスが必要な場合は、[サンプル構造を展開] をクリックして、Dataphin が提供するリファレンスサンプル情報を表示できます。

      • 動作主体

        動作主体は、[計画] モジュールで定義されたエンティティに由来し、特定の動作を実行する主体 (通常は) (例: 消費者、販売者) を表すために使用されます。主体の属性は、動作タグ、オーディエンスグループの選択フィルター条件として、消費者の年齢層、消費者の性別など、主体を表すためにソーステーブルフィールドを介して定義されます。

        パラメーター

        説明

        動作主体

        主体

        タグアーキテクチャで作成されたエンティティを選択します。たとえば、メンバーです。

        主体 ID

        主体にバインドされている主体 ID を選択します。たとえば、メンバー ID です。

        列名

        動作主体を表すソーステーブルのフィールド名を選択します。たとえば、ソーステーブルの member_id フィールドです。

        フィールドタイプ

        選択したフィールド名のフィールドタイプを表示します。たとえば、String です。

        値の型

        選択したフィールド名の値の型を表示します。たとえば、string です。

        説明

        主体の簡単な説明を 1,000 文字以内で入力します。

        主体の属性

        属性名

        主体の属性名を入力します。64 文字以内で、中国語、英語、数字、アンダースコア (_)、またはハイフン (-) が使用できます。

        属性コード

        属性の属性コードを入力します。これは属性の一意の識別子です。属性名が複数ある場合は、属性の一意の定義を識別するために使用できます。

        列名

        動作主体の属性を表すソーステーブルのフィールド名を選択します。たとえば、ソーステーブルの birthday フィールドです。

        フィールドタイプ

        選択したフィールド名のフィールドタイプを表示します。たとえば、String です。

        値の型

        選択したフィールド名の値の型を表示します。たとえば、string です。

        コード値の構成

        属性の値がコードとして記録されている場合は、コード値を構成することにより、属性に対応する解釈を構成できます。整数10 進数 (M, 0)ブール値、および 文字列型の フィールドのみがルックアップテーブルの構成をサポートしています。

        1. image.png をクリックして、[ルックアップテーブルの構成] ダイアログボックスを開きます。

        2. [ルックアップテーブルの構成] ダイアログボックスで、関連パラメーターを構成します。

          • ルックアップテーブルの構成: デフォルトでは構成されていません。[リファレンステーブル] を選択して、指標に対応するルックアップテーブルを構成できます

          • ルックアップテーブルソース: 現在、[手動構成] のみサポートされています。

          • ルックアップテーブル名: ルックアップテーブルの名前を入力します。128 文字以内で、中国語、英語、数字、および特殊文字がサポートされています。

          • ルックアップテーブルの説明: ルックアップテーブルの簡単な説明を 1,000 文字以内で入力します。

          • コード情報: 単一入力とバッチ入力をサポートし、最大 500 グループまでサポートします。

            • 単一入力: [コード値の追加] をクリックし、[コード値][コード名] を入力します。どちらも空にせず、一意である必要があります。さらに、コード値の型は指標の値の型と一致する必要があります。image.png をクリックして現在の行を削除できます。

            • バッチ入力: [バッチ入力] をクリックし、[バッチ入力コード情報] ダイアログボックスで、コード値とコード名をバッチ入力します。各グループは行で区切り、コード値とコード名はコロン (:) で区切ります。[クリックして識別] をクリックすると、システムはバッチ入力ボックスのコード情報を自動的に解析し、コード情報リストに入力します。

            • ワンクリックパージ: [ワンクリックパージ] をクリックすると、システムは情報リストを自動的にクリアします。

        3. [確認] をクリックして、コード値の構成を完了します。

          説明

          コード情報をバッチ入力する場合、コード値またはコード名が重複していると、確認をクリックした後、システムは最初のエラー行を自動的に特定します。

        説明

        主体の属性の簡単な説明を 1,000 文字以内で入力します。

        説明

        ソーステーブルに主体の属性を表すフィールドがない場合、主体の属性を構成する必要はありません。

        動作主体で定義する必要がある主体、主体 ID、フィールド名、およびその他の情報を選択します。システムは構成に基づいてフィールドタイプと値の型を自動的に解析します。また、主体の関連説明情報を入力することもできます。主体の作成については、「エンティティの作成」をご参照ください。

        説明

        [主体の属性の追加] をクリックして、属性名、属性コード、フィールド名など、主体に対応する複数の属性情報を追加します。

      • 動作

        動作設定領域では、動作名と対応する属性情報 (属性名、属性コード、フィールド名など) を入力する必要があります。複数の属性情報を追加する必要がある場合は、[+ 動作属性の追加] をクリックします。

        パラメーター

        説明

        動作名

        主体の動作名を入力します。64 文字以内で、中国語、英語、数字、アンダースコア (_)、またはハイフン (-) が使用できます。

        動作属性

        属性名

        • 動作の [動作時間] 属性は必須フィールドであり、変更できません。

        • 属性名には、64 文字以内で、中国語、英語、数字、アンダースコア (_)、またはハイフン (-) が使用できます。

        属性コード

        属性の属性コードを入力します。これは属性の一意の識別子です。属性名が複数ある場合は、属性の一意の定義を識別するために使用できます。

        列名

        動作属性を表すソーステーブルのフィールド名を選択します。たとえば、ソーステーブルの time フィールドです。

        説明
        • E-MapReduce 5.x、AsiaInfo DP 5.3 Hadoop、および AnalyticDB for PostgreSQL 以外のコンピュートエンジンでは、[動作時間] 属性のフィールド名で、date、datetime、string、char、varchar、int、bigint、double、decimal などのデータ型のフィールドを選択できます。タイムスタンプ以外のフィールドタイプの場合、システムはフィールドのデータ型と選択した日付形式に基づいて、形式変換を自動的に実行します。

        • E-MapReduce 5.x、AsiaInfo DP 5.3 Hadoop、および AnalyticDB for PostgreSQL 以外のコンピュートエンジンでは、動作時間属性のフィールド名でパーティションフィールドを選択できます。

        フィールドタイプ

        選択したフィールド名のフィールドタイプを表示します。たとえば、date です。

        値の型

        選択したフィールド名のフィールドタイプを表示します。たとえば、datetime です。

        コード値の構成

        属性の値がコードとして記録されている場合は、コード値を構成することにより、属性に対応する解釈を構成できます。整数10 進数 (M, 0)ブール値、および 文字列型の フィールドのみがルックアップテーブルの構成をサポートしています。

        1. image.png をクリックして、[ルックアップテーブルの構成] ダイアログボックスを開きます。

        2. [ルックアップテーブルの構成] ダイアログボックスで、関連パラメーターを構成します。

          • ルックアップテーブルの構成: デフォルトでは [未構成] です。[リファレンステーブル] を選択して、指標に対応するルックアップテーブルを構成できます

          • ルックアップテーブルソース: 現在、[手動構成] のみサポートされています。

          • ルックアップテーブル名: ルックアップテーブルの名前を入力します。128 文字以内で、中国語、英語、数字、および特殊文字がサポートされています。

          • ルックアップテーブルの説明: ルックアップテーブルの簡単な説明を 1,000 文字以内で入力します。

          • コード情報: 単一入力とバッチ入力をサポートし、最大 500 グループまでサポートします。

            • 単一入力: [コード値の追加] をクリックし、[コード値][コード名] を入力します。どちらも空にせず、一意である必要があります。さらに、コード値の型は指標の値の型と一致する必要があります。image.png をクリックして現在の行を削除できます。

            • バッチ入力: [バッチ入力] をクリックし、[バッチ入力コード情報] ダイアログボックスで、コード値とコード名をバッチ入力します。各グループは行で区切り、コード値とコード名はコロン (:) で区切ります。[クリックして識別] をクリックすると、システムはバッチ入力ボックスのコード情報を自動的に解析し、コード情報リストに入力します。

            • ワンクリックパージ: [ワンクリックパージ] をクリックすると、システムは情報リストを自動的にクリアします。

        3. [確認] をクリックして、コード値の構成を完了します。

          説明

          コード情報をバッチ入力する場合、コード値またはコード名が重複していると、確認をクリックした後、システムは最初のエラー行を自動的に特定します。

        説明

        動作属性の簡単な説明を 1,000 文字以内で入力します。

      • 動作オブジェクト (オプション)

        動作オブジェクトは、動作のオブジェクトを表し、通常は (例: 製品、Web ページ など) です。既存のプラットフォームエンティティにバインドできます。エンティティにバインドしない場合、オブジェクト名または ID が一意の識別子として機能します。

        パラメーター

        説明

        エンティティのバインド

        動作オブジェクトがエンティティにバインドされている場合、オブジェクトはプラットフォームエンティティを選択できます。

        オブジェクト ID

        動作オブジェクトがエンティティにバインドされている場合、プラットフォームエンティティのオブジェクト ID (動作のオブジェクト) を選択する必要があります。

        オブジェクトの一意の識別子

        エンティティにバインドしない場合は、オブジェクトの一意の識別子を指定する必要があります。オブジェクト ID として設定することをお勧めします。ここで、ID と名前は識別子としてのみ使用され、オブジェクト属性としては使用されません。オブジェクト属性として扱う必要がある場合は、オブジェクト属性セクションで再度追加してください。

        オブジェクト属性

        オブジェクトの [属性名][属性コード][フィールド名]、および [説明] 情報を入力します。

        複数の属性情報を追加する必要がある場合は、[オブジェクト属性の追加] をクリックします。

    • 操作構成

      説明

      [操作構成] を実行する前に、[データプレビュー] をクリックしてデータを表示し、構成が正しいことを確認できます。

      1. スケジューリングサイクル

        • 計画更新時間: 1 日の特定の時間にスケジューリングできます。タスクは 1 日に 1 回自動的に実行されます。必要に応じて実行時間ポイントを指定できます。

        • スケジューリング実行プラン: [プレビュー] をクリックします。スケジューリング実行プランには、構成されたスケジューリングサイクルと条件付きスケジューリングに従って、特定の月の毎日について、すべてのスケジューリングインスタンスとそのスケジューリングタイプが表示されます。プレビュー日付タイプは、[データタイムスタンプ] または [実行日 (スケジューリング日)] に従って選択できます。

          1 日のすべてのインスタンスに複数のスケジューリングタイプステータスがある場合は、含まれるスケジューリングタイプステータスが色で表示され、各スケジューリングタイプステータスに対応するインスタンスの名前と数が表示されます。たとえば、下の図は、特定の月の 4 日に、現在のスケジューリングタスクに 44 の通常のスケジューリングインスタンス、2 つの一時停止されたインスタンス、および 12 のドライランインスタンスがあることを示しています。image

          特定の日のスケジューリングタイプモジュールにマウスポインターを合わせると、その日の現在のスケジューリングタスクの詳細なスケジューリングインスタンスリスト (スケジューリングタイプ、スケジューリング条件、条件名を含む) が表示されます。

        • 条件付きスケジューリング: 複数のスケジューリング条件を設定できます。システムは、上から下に順番に条件を評価します。条件に一致すると、対応するスケジューリングが実行され、後続のすべてのスケジューリング条件の評価が終了します。どの条件にも一致しない場合は、デフォルトのスケジューリング構成が実行されます。詳細については、「条件付きスケジューリングルールの説明」をご参照ください。

          重要

          条件付きスケジューリングは、スケジューリングタイプが 通常のスケジューリング の場合にのみ有効です。

      2. スケジューリング依存関係

        スケジューリング依存関係とは、ノード間のアップストリームとダウンストリームの依存関係を指します。Dataphin では、アップストリームタスクノードが正常に実行された場合にのみ、ダウンストリームタスクノードが実行を開始します。

        • 自動解析

          システムは、タスク系列に基づいてアップストリーム依存関係ノードを自動的に解析し、関連付けを行います。データの更新は、アップストリームデータの出力に依存します。

          説明
          • 自動解析の結果が期待どおりでない場合は、image.png をクリックして有効ボタンを閉じることができます。閉じると、ノードに依存しないことを意味します。

          • このサイクルのデフォルトの依存関係。

        • 依存関係の追加

          自動解析 でスケジューリング依存関係を解析できない場合、または 自動解析 によって生成されたアップストリーム依存関係構成が実際のアプリケーションと一致しない場合は、ノードのアップストリーム依存関係を手動で追加できます。

          [依存関係の追加] をクリックし、[物理ノード] または [論理テーブルノード] の追加を選択し、ポップアップダイアログボックスで 1 つ以上のターゲット物理ノードまたは論理テーブルノードを選択して、[確認] をクリックします。

          説明
          • Intelligent R&D エディションを購入していない場合は、[物理ノード] 依存関係のみを追加できます。

          • 依存関係を手動で追加した後、もう一度自動解析をクリックします。生成された解析ノードが手動で追加された依存関係ノードと一致する場合、システムは自動的に上書き操作を実行します。

        • 依存関係の編集

          スケジューリング依存関係リストで、ターゲットアップストリーム依存関係テーブルの [アクション] 列の image アイコンをクリックします。ポップアップダイアログボックスで、[依存関係サイクル][依存関係ポリシー]、および [依存関係フィールド] (論理テーブルノードのみ変更をサポート) を変更できます。依存関係の構成と説明については、「オフラインタスクスケジューリング依存関係の構成」、「スケジューリング依存関係シーンルールと例」をご参照ください。

          ターゲットアップストリーム依存関係テーブルの [アクション] 列の image アイコンをクリックして、対応する依存関係ノードを削除します。

  6. 構成が正しいことを確認したら、[公開] をクリックして、動作リレーションシップの作成と構成を完了します。

動作リレーションシップの管理

  1. 動作リレーションシップページには、動作リレーションシップ名、動作主体、動作、所有者、最終変更時刻、ステータスなどの情報を含む、動作リレーションシップのリストが表示されます。

  2. (オプション) 動作主体、所有者、ステータスを選択するか、動作リレーションシップ名を入力して、ターゲット動作リレーションシップをフィルタリングできます。

  3. 動作リレーションシップリストでは、動作リレーションシップに対して次の操作を実行できます。

    操作項目

    説明

    コピー

    現在の動作リレーションシップ情報をコピーして、新しい動作リレーションシップを作成します。

    編集

    現在のデータセットの編集可能な情報 ([基本情報][処理ロジック]、[操作構成] を含む) を編集できます。

    説明

    動作リレーションシップのソーステーブルで [テーブル構造情報が取得されていません] というメッセージが表示された場合は、ソーステーブルが削除されたか、テーブル名が変更されたかを確認してください。

    非公開

    現在の動作リレーションシップの構成の詳細を表示できます。

    詳細

    公開済み の動作リレーションシップを非公開にします

    削除

    編集中公開失敗、および 非公開 の動作リレーションシップの削除をサポートします

次のステップ

動作リレーションシップの構成が完了したら、動作リレーションシップを介してオフラインタグを処理できます。具体的な操作については、「オフラインタグ」をご参照ください。