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

Dataphin:タグオフラインサービスの作成と管理

最終更新日:Mar 06, 2025

Dataphin は、バッチタグクエリサービスを介して、タグテーブルをダウンストリーム アプリケーションシステムに出力することをサポートしています。このトピックでは、新しいタグオフラインタスクの作成方法について説明します。

制限事項

データの 高可用性 を確保するために、タグオフラインサービスはデータを一時テーブル ({target table}_dpfx_b) に書き込みます。データの書き込みが完了すると、元のターゲットテーブルの名前が変更され ({target table}_dpfx_tmp)、一時テーブルの名前がターゲットテーブルに変更されます。最後に、元のターゲットテーブル ({target table}_dpfx_tmp) が削除されます。元のターゲットテーブルの名前変更が完了してから一時テーブルの名前がターゲットテーブルに変更されるまで、データが短時間利用できなくなります。

前提条件

  • タグオフラインサービスを作成する前に、タグアセットマーケットで必要なタグを選択し、サービスが配置される アプリケーション の使用 権限 を取得していることを確認してください。具体的な操作については、「タグまたはオーディエンスグループの権限をリクエストする」をご参照ください。

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

  • タグオフラインサービスを作成する前に、対応するエンティティを作成する必要があります。具体的な操作については、「エンティティを作成する」をご参照ください。

タグオフラインサービスの作成

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

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

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

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

    パラメーター

    説明

    基本情報

    タスク名

    オフラインタスクの名前を入力します。日本語、英語、数字、および アンダースコア (_) が使用でき、64 文字以内です。

    アプリケーションの選択

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

    オーナー

    オフラインサービスの オーナー を選択します。 キーワード で検索できます。

    エンティティ

    オフラインサービスに対応するエンティティ名を選択します。

    エンティティ ID の選択

    エンティティに対応する ID 名を選択します。

    説明

    [フィールドマッピング] で、[タグを入力] を選択して、選択したエンティティ ID に基づいてオプションのタグ範囲をフィルタリングします。

    スケジュールタイプ

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

    • 手動スケジュール: 1 回限りの統合。タスクが 公開 されると、タスクリストページで手動実行を選択できます。

    • 繰り返しスケジュール: 構成された繰り返しスケジュールに従ってスケジュール実行されます。

    説明

    簡単な説明を 1000 文字以内入力します。

    フィールドマッピング

    ターゲット データソース

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

    説明

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

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

    スキーマ

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

    ターゲットテーブル

    ターゲット データソースでターゲット テーブルを選択します。openGauss データソース タイプは、スキーマ下のターゲット テーブルです。

    • 複数レベルの パーティションテーブル はサポートされていません

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

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

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

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

    • テーブル名とテーブル コメント はシステムによって自動的に生成され、必要に応じて変更できます。

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

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

    • ターゲット データソース タイプが 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 ボタンをクリックして、 データソース フィールド マッピング 関係を構成します。

    マッピング

    システムは、選択されたタグとその マッピング フィールド関係を表示します。出力タグ マッピング の マッピング フィールドを選択する必要があります。

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

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

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

    メンテナンス構成

    繰り返し

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

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

タグオフラインサービスの管理

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

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

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

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

    操作項目

    説明

    編集

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

    詳細

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

    インスタンスの表示

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

    非公開

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

    データバックフィル

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

    実行

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

    削除

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