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

Dataphin:オーディエンスグループ オフラインサービスの作成と管理

最終更新日:Mar 06, 2025

Dataphin タグプラットフォームは、オーディエンスグループサービス機能を提供し、Data Integration を介したオーディエンスグループのバッチエクスポートを可能にし、ダウンストリームのオーディエンスグループ分析アプリケーションをサポートします。このガイドでは、新しいオーディエンスグループ オフラインサービスの作成方法について説明します。

制限事項

高可用性を確保するために、システムはオーディエンスグループ オフラインサービスの実行時に、一時テーブル({target table}_dpfx_b)にデータを書き込みます。完了すると、元のターゲットテーブルの名前が変更され({target table}_dpfx_tmp)、一時テーブルがその場所に置き換わります。元のターゲットテーブル({target table}_dpfx_tmp)は削除されます。元のターゲットテーブルの名前変更と一時テーブルのターゲットテーブルへの名前変更の間には、データが使用できない短い期間があります。

前提条件

  • アプリケーションが作成され、オフライン オーディエンスグループ サービスに関連付けられています。具体的な操作については、「アプリケーションの作成」をご参照ください。

  • オフライン オーディエンスグループ サービスを作成する前に、対応するエンティティを確立する必要があります。詳細な手順については、「エンティティの作成」をご参照ください。

オーディエンスグループ オフラインサービスの作成

  1. Dataphin ホームページで、トップメニューバーから [タグ] > [タグアプリケーション] を選択します。

  2. 左側のナビゲーションウィンドウで、[サービス管理] > [オーディエンスグループ オフラインサービス] を選択します。

  3. [オーディエンスグループ オフラインサービス] ページで、[オフラインサービスの作成] をクリックします。

  4. [オフラインサービスの作成] 構成ページで、必要なパラメーターを構成します。

    パラメーター

    説明

    [基本情報]

    [タスク名]

    タスクの名前を入力します。命名規則は次のとおりです。

    64 文字以内で、中国語、英語、数字、およびアンダースコア(_)を使用できます。

    [アプリケーションの選択]

    プロジェクトに関連付けられているアプリケーションを選択します。

    [所有者]

    オーディエンスグループ オフラインサービスの所有者を選択します。キーワードで検索できます。

    [スケジュールタイプ]

    定期スケジュールと手動スケジュールのタスクタイプをサポートしています。

    • [手動スケジュール]: 1 回限りの統合。タスクが公開された後、タスクリストページで手動で実行できます。

    • [定期スケジュール]: 構成された定期スケジュールに従って実行をスケジュールします。

    [説明]

    タスクの簡単な説明を 1000 文字以内で入力します。

    [フィールドマッピング]

    [オーディエンスグループの選択]

    構成する必要のあるオーディエンスグループを選択します。

    [タグ同期が必要ですか]

    デフォルトは [いいえ] で、オーディエンスグループのエンティティ ID のみを同期します。[はい] を選択すると、[入力タグ] で同期するタグを選択できます。

    [ターゲットデータソース]

    オーディエンスグループ サービスに対応するターゲットデータソースを選択します。ターゲットデータソースは、MySQL、OracleAnalyticDB for PostgreSQLGreenplumopenGauss データソース、または Dataphin で作成されたプロジェクトにすることができます。

    説明

    プロジェクトのターゲットデータソースは、現在のアカウント(一般 および タグプロジェクト)が参加しているプロジェクトのみをサポートし、プロジェクト テナントアカウントには ライトスルー 権限があります。

    必要なデータソースがない場合は、[+データソースの作成] をクリックして作成できます。具体的な操作については、「データソース管理」をご参照ください。

    [スキーマ]

    ターゲットデータソースタイプが openGauss、AnalyticDB for PostgreSQL、または Greenplum の場合、データソースのスキーマを選択できます。

    [ターゲットテーブル]

    ターゲットデータソース内のターゲットテーブルを選択します。openGauss、AnalyticDB for PostgreSQL、または Greenplum データソースタイプのターゲットテーブルは、スキーマの下にあります。

    • プロジェクト間のセーフモードが有効になっている場合、プロジェクト間のテーブル作成はサポートされていません。詳細については、「セキュリティ設定」をご参照ください。

    • 現在のターゲットテーブルの本番環境に対するテーブルデータの書き込み権限がない場合は、[権限のリクエスト] をクリックして権限を申請できます。詳細については、「テーブル権限のリクエスト、更新、および返却」をご参照ください。

    • 対応するターゲットテーブルがない場合は、入力タグを選択した後、[ワンクリックテーブル作成] をクリックして、必要なターゲットテーブルを作成できます。

    • システムによって生成されたテーブル作成ステートメントで、テーブル名、フィールドタイプ、精度などが要件を満たしていることを確認してから、[作成] をクリックします。

    • テーブル名とテーブル注釈はどちらもシステムによって自動的に生成され、必要に応じて変更できます。

    • システムによって生成されたテーブル作成ステートメントは、入力タグのタイプを参照し、予備的な変換を実行します。これは必要に応じて変更できます。

    • ターゲットデータソースがプロジェクトの場合、システムはデフォルトでパーティションテーブルを生成します。調整しないことをお勧めします。

    • ターゲットデータソースタイプが AnalyticDB for PostgreSQL の場合、パーティションテーブルの選択はサポートされていません。

    • 入力タグを選択した後、エクスポートされたタグのコード値とコード名を設定できます。タグ値またはコード名を個別にエクスポートすることも、両方をエクスポートすることもできますが、少なくとも 1 つはエクスポートする必要があります。

    • ワンクリックテーブル作成が実行されるときに、タグに構成済みのルックアップテーブルがある場合、コード名のエクスポートを選択できます。エクスポートされたコード名は {tag code}_codename です。ワンクリックテーブル作成後、システムは自動的にフィールドをマッピングします。

    [日付パーティション]

    ターゲットテーブルのパーティションフィールドを選択します。

    • 選択したターゲットテーブルがパーティションテーブルの場合、システムはデフォルトでテーブルの最初のパーティションフィールドに設定されます。

    • 選択したターゲットテーブルが非パーティションテーブルの場合、日付パーティションを選択する必要はありません。

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

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

    説明

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

    [ロードポリシー]

    ロードポリシーは [上書きポリシー] のみをサポートします。上書きデータポリシーでは、プライマリキー/制約の競合が発生した場合、最初に元のデータが削除され、次に新しいデータ行全体が挿入されます。

    [マッピングフィールド]

    タグ同期が必要ない場合は、マッピングするフィールドを選択します。

    • 同一名マッピング: [同一名マッピング] をクリックして、同じ名前のタグとそのマッピングフィールドを関連付けます。

    • 消去: image.png アイコンをクリックして、マッピングされた関係を消去します。

    • 出力: 構成済みのルックアップテーブルを持つタグの出力コンテンツを選択します。タグ値コード名を選択できます。デフォルトでは、すべてのタグ値が選択されています。全選択(ページ全体)の場合は、出力タグリストの下部にあるタグ値コード名を選択できます。

    [メンテナンス構成]

    [繰り返し]

    特定の時間範囲内でタスクをスケジュールするサイクル。日次スケジュールをサポートしています。オーディエンスグループ オフラインタスクは、構成されたスケジュール時間に従って実行されます。

  5. [公開] をクリックして、オーディエンスグループ オフラインサービスタスクの作成を完了します。

オーディエンスグループ オフラインサービスの管理

  1. オーディエンスグループ オフラインサービスページには、タスク名、所有者、アプリケーション名、オーディエンスグループ名、エンティティ、エンティティ ID、タスクステータス、実行ステータス、ターゲットテーブル、スケジュールタイプ、および使用可能な操作などの情報が表示されます。

    ターゲットテーブルにマウスポインターを合わせると、そのフルネームとデータソースの名前が表示されます。データソースタイプが openGauss の場合は、ターゲットテーブルスキーマも表示できます。

  2. (オプション) [自分のもののみ] を選択し、タスク名を入力するか、[フィルター] をクリックして アプリケーション名エンティティ-エンティティ IDターゲットソースタイプタスクステータス実行ステータス、または スケジュールタイプ で絞り込むことで、タスクをフィルタリングします。

  3. オーディエンスグループ オフラインサービスタスクリストの [アクション] 列では、さまざまな操作を実行できます。

    アクション項目

    説明

    編集

    タスクステータスが公開中ではないまたは非公開中ではないの場合、image.png アイコンをクリックして [オフラインサービスの編集] ページで編集し、再公開できます。タスク名、スケジュールタイプ、ターゲットデータソースタイプ、およびロードポリシーの変更はサポートされていません。

    詳細

    image.png アイコンをクリックして、[オフラインサービスの表示] ページで現在のタグ オフラインサービスの詳細情報を表示します。タスクステータスが編集中公開失敗公開済み、またはオフラインの場合、ページ下部にある [編集] をクリックして、現在のオーディエンスグループ オフラインサービスを編集できます。

    インスタンスの表示

    image.png アイコンをクリックして、現在のオーディエンスグループ オフラインサービスによって生成された実行インスタンスを表示します。

    非公開

    タスクステータス公開済みまたは非公開失敗のオーディエンスグループ オフラインサービスの場合、image.png 非公開アイコンをクリックして、現在のオーディエンスグループ オフラインサービスを非公開にすることができます。

    データバックフィル

    タスクステータス公開済み定期スケジュール オーディエンスグループ オフラインサービスの場合、image データバックフィルアイコンをクリックしてデータバックフィルを実行できます。バックフィルのデフォルトのデータタイムスタンプは昨日の(T-1)データです。

    実行

    手動スケジュール タイプのスケジュールを持つタスクの場合、image.png 実行アイコンをクリックして、データタイムスタンプ を選択することで [実行] ダイアログボックスで手動実行できます。

    削除

    タスクステータスがオフラインまたは公開失敗のオーディエンスグループ オフラインサービスの場合、image..png 削除アイコンをクリックして、現在のオーディエンスグループ オフラインサービスを削除します。