クロスソース構成の一括アップロード
構成のアップロード機能を使うと、EXCELで構成のフィールドとアセット情報をすばやく編集し、クロスソース構成を一度に一括作成できます
操作する際は、まずページの作成フローでクロスソース構成を1つ作成し、それをエクスポートしてからEXCELでコピー・修正するとよいでしょう
1. 一括アップロードの流れ
EXCELによる構成のアップロードの説明
2. EXCELテンプレート
📎 跨源资产映射模板_空白.xlsx（69 KB） 📎 跨源资产映射模板_含样例.xlsx（83 KB）3. サブシートの説明
EXCELでクロスソースアセット構成を編集する場合、次のサブシートがあります
- クロスソースアセット構成リスト
- タグテーブル明細設定
- イベントプロパティ明細設定
- イベント名明細設定
- イベントとイベントプロパティの関係設定
- エンティティテーブル明細設定
- 参照テーブル明細設定
- 列挙値設定
クロスソースアセット構成のEXCELサブシートのプレビュー
各サブシートの用途は次のとおりです
| サブシート名 | タイプ | 使用シーン |
|---|---|---|
| クロスソースアセット構成リスト | 共通 | 1行が1件のクロスソースアセット構成に対応します。構成のデータソース、アセットタイプ、構成フィールドなどの情報を宣言する必要があります |
| タグテーブル明細設定 | タグテーブル | クロスソースタグテーブルのアセットリストです。元のアセット名、値の取得方式、出力アセット名などの情報を含みます |
| イベントプロパティ明細設定 | イベントテーブル | クロスソースイベントテーブルのイベントプロパティ系のアセットリストです。元のアセット名、値の取得方式、出力アセット名などの情報を含みます |
| イベント名明細設定 | イベントテーブル | クロスソースイベントテーブルのイベント系のアセットリストです。出力イベント名、オリジナルイベント一覧などの情報を含みます |
| イベントとイベントプロパティの関係設定 | イベントテーブル | クロスソースイベントテーブルのイベントプロパティとイベントのマッチング関係 |
| エンティティテーブル明細設定 | エンティティテーブル | クロスソースエンティティテーブルのアセットリストです。元のアセット名、値の取得方式、出力アセット名などの情報を含みます |
| 参照テーブル明細設定 | 参照テーブル | クロスソース参照テーブルのアセットリストです。元のアセット名、値の取得方式、出力アセット名などの情報を含みます |
| 列挙値設定 | 共通 | タグ、イベントプロパティ、エンティティプロパティ、ディメンションプロパティの列挙値を設定 |
⚠ 実際に使用する際は、必要に応じて対応するサブシートに入力します。例：
- クロスソースタグテーブルを構成する場合の入力先：<クロスソースアセット構成リスト>、<タグテーブル明細設定>
- クロスソースイベントテーブルを構成する場合の入力先：<クロスソースアセット構成リスト>、<イベントプロパティ明細設定>、<イベント名明細設定>、<イベントとイベントプロパティの関係設定>
- 一部のアセットに列挙値を設定する必要がある場合は、上記に加えて次も入力します：<列挙値設定>
4. クロスソースアセット構成_共通フィールドの説明
| クロスソースアセット構成名 | クロスソースアセット構成表示名 | 構成の説明 | アセットタイプ | データソース選択 | ワイド・ロングタイプ | 構成詳細 | ステータス |
|---|---|---|---|---|---|---|---|
| route_tag_all_key | ★★タグテーブル全フィールドテンプレート★★ | 構成詳細にすべての構成フィールドと説明を表示 ★★★★★★★★★★ | タグテーブル | hive.ws_test.welletltzi | ワイドテーブル | 分析主体列: efsad_col_1 分析主体: ユーザー ---アップロード前にこの線を削除--- タグ名列: tag_name タグ値列: tag_value ---アップロード前にこの線を削除--- タグ日付バージョン:履歴バージョンのみ/最新バージョンのみ/履歴バージョンおよび最新版 日付情報列:col_FOULK 日付情報のフォーマット:yyyyMMdd |
ヘッダーフィールドのプレビュー
各フィールドの説明は次のとおりです
| フィールド名 | 説明 |
|---|---|
| クロスソースアセット構成名 | 現在の構成の名前です。小文字で始め、数字、小文字、アンダースコアを使用できます。長さは80文字まで |
| クロスソースアセット構成の表示名 | 現在の構成の表示名です。長さは80文字まで |
| 構成の説明 | 現在の構成の備考・説明です。長さは200文字まで |
| アセットタイプ | タグテーブル、イベントテーブル、エンティティテーブル、参照テーブルを設定可能 |
| データソース選択 | データソース名です。フルネームで入力する必要があります。例：hive.ws_test.tbl_name |
| ワイド・ロングタイプ | ワイドテーブルまたはロングテーブル。ロングテーブルに設定できるのは「タグテーブル」アセットのみ |
| 構成詳細 | アセットに応じて、「名前: 値」の形式でフィールドの構成情報を入力します。詳しくは下記の「アセット固有フィールドの説明」の章を参照 |
| ステータス | クロスソース構成の検証ステータスです。ダウンロード時にシステムが自動入力するため、入力不要 |
5. アセットリスト_共通フィールドの説明
1つ目のサブシートで構成を宣言したら、対応するタイプのアセット明細設定で、その構成のアセットリストを設定する必要があります
例：1つ目のサブシートで「クロスソースタグテーブル」構成（名前はroute_config_01）を宣言した場合、<タグテーブル明細設定>で設定するタグリストのサンプルは次のとおりです
| クロスソースアセット構成名 | 元のタグ名 | 元のタグタイプ | 出力タグ名 | 出力タグ表示名 | 値の取得方式 | 出力タグタイプ | 拡張情報 | 列挙値ロジック | ステータス |
|---|---|---|---|---|---|---|---|---|---|
| route_config_01 | tag_01 | 数値 | tag_01 | タグ_01 | 数値 | 更新方法:手動アップロード | |||
| route_config_01 | tag_02 | 時間 | tag_02 | タグ_02 | 時間 | 値タイムゾーン:8 備考:時間タイプのタグは「値タイムゾーン」を拡張 | 更新方法:手動アップロード | ||
| route_config_01 | tag_03 | テキスト | tag_03 | タグ_03 | テキスト | 備考:追加の説明内容 | 更新方法:手動アップロード | ||
| route_config_01 | tag_04 | リスト | tag_04 | タグ_04 | リスト | 更新方法:手動アップロード | |||
| route_config_01 | tag_05 | リスト | tag_05 | タグ_05 | リスト | 備考:追加の説明内容 | 更新方法:手動アップロード |
タグアセットリスト_プレビュー
アセットタイプによってヘッダーフィールドも少しずつ異なるため、以下では{アセット}で統一して表記します
すべてのアセットで入力が必要なフィールドは次のとおりです。その他の固有フィールドと設定ロジックは「アセット固有フィールドの説明」の章を参照してください
| フィールド名 | 説明 |
|---|---|
| クロスソースアセット構成名 | 現在のアセット情報に対応するクロスソース構成名です。<クロスソースアセット構成リスト>に入力されている必要があります |
| 元の{アセット}名 | 通常は、データソースの列名（ワイドテーブル）またはデータ行の値（ロングテーブル）を入力します |
| 元の{アセット}タイプ | ダウンロード時にシステムが自動入力するため、入力不要 |
| 出力{アセット}名 | 対応するアセットの名前を設定します。対応するアセットの規則に従う必要があります |
| 出力{アセット}表示名 | 対応するアセットの表示名を設定します。対応するアセットの規則に従う必要があります |
| 値の取得方式 | 値に特別な処理が必要な場合はSQL関数を入力できます。入力すると「元のアセット名」は無視されます |
| 出力{アセット}タイプ | 対応するアセットのデータタイプを設定します。値の取得方式がある場合は、処理後のデータタイプを入力する必要があります |
| 拡張情報 | アセットのその他の構成情報です。通常は「備考」で、シーンによっては他の構成フィールドがある場合もあります |
| 列挙値ロジック | 列挙値を設定できるのは数値、文字列、リストタイプのアセットのみです。現在は「更新方法: 手動アップロード」にのみ設定できます |
| ステータス | ダウンロード時にシステムが自動入力するため、入力不要 |
6. 各アセットの固有フィールドの説明
アセットによっては、構成情報にカスケード依存関係がある場合があります。対応するアセットの<構成の説明>マニュアルの内容を参照してください
EXCELにも同様の依存関係と検証ロジックがあり、そのうえで一括編集とアップロードの機能を提供しています
6.1 クロスソースタグテーブル
🔵 構成詳細
このブロックの情報は、<クロスソースアセット構成リスト>サブシートの「構成詳細」列に入力します
複数のフィールドは「名前: 値」の形式で、改行で区切って対応するセルに記入します
| アセットタイプ | 構成詳細 |
|---|---|
| タグテーブル | 分析主体列: efsad_col_1 分析主体: ユーザー ---アップロード前にこの線を削除--- タグ名列: tag_name タグ値列: tag_value ---アップロード前にこの線を削除--- タグ日付バージョン:履歴バージョンのみ/最新バージョンのみ/履歴バージョンおよび最新版 日付情報列:col_FOULK 日付情報のフォーマット:yyyyMMdd |
クロスソースタグテーブル_構成詳細のプレビュー
| フィールド名 | フィールド区分 | 必須/任意 | ロジックの説明 | サンプル値 |
|---|---|---|---|---|
| 主体列 | 分析主体情報 | 必須 | データソース内でタグの主体情報を記録している列 | user_name |
| 分析主体 | 分析主体情報 | 必須 | プロジェクト内でデータソースに対応する分析主体 | プレイヤー |
| タグ名列 | 値の取得情報 | 「ロングテーブル」の場合のみ入力 | ロングテーブル内でタグ名を記録している列 | tag_name |
| タグ値列 | 値の取得情報 | 「ロングテーブル」の場合のみ入力 | ロングテーブル内で大部分のタグ値を記録している列 | tag_value |
| タグ日付バージョン | 日付バージョン情報 | 必須 | タグデータに日付情報が含まれるかどうか、およびその記録方式 | 履歴バージョンのみ、最新バージョンのみ、履歴バージョンおよび最新版 |
| 日付情報列 | 日付バージョン情報 | 「タグ日付バージョン」が「最新バージョンのみ」以外の場合に入力 | データソース内でタグ値の日付情報を記録している列 | tag_date |
| 日付情報のフォーマット | 日付バージョン情報 | 「タグ日付バージョン」が「最新バージョンのみ」以外の場合に入力 | データソース内でタグ値の日付情報を記録している形式 | yyyyMMdd |
🔵 アセット名とデータタイプ
クロスソースタグの出力アセットは、次のデータタイプに対応しています：
文字列、数値、ブール値、時間、リスト
プロパティ名は小文字で始め、小文字、数字、アンダースコアのみを含み、長さは80文字以内にする必要があります
値の取得方式に関する複雑なシーンは、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
🔵 タグの拡張情報
クロスソースタグでは「値タイムゾーン」フィールドを設定する必要があります。タグ値に対応するタイムゾーンを示すもので、デフォルト値は「現地時間」(99)です
分析スイートとエンゲージスイートの一部の機能では、同じタイムゾーン設定のタグしか使用できません
| 出力タグタイプ | 拡張情報 |
|---|---|
| ブール値 | 値タイムゾーン: 99 |
| 数値 | 値タイムゾーン: 99 |
| 数値 | 備考:追加の説明内容 値タイムゾーン: 99 |
クロスソースタグ_拡張情報のプレビュー
6.2 クロスソース参照テーブル
🔵 構成詳細
このブロックの情報は、<クロスソースアセット構成リスト>サブシートの「構成詳細」列に入力します
複数のフィールドは「名前: 値」の形式で、改行で区切って対応するセルに記入します
| アセットタイプ | 構成詳細 |
|---|---|
| 参照テーブル | 主体属性表タイプ: イベントプロパティ 分析主体プロパティ: item_id 分析主体列: item_id ---アップロード前にこの線を削除--- 時間粒度: 時間 |
クロスソース参照テーブル_構成詳細のプレビュー
| フィールド名 | フィールド区分 | 必須/任意 | ロジックの説明 | サンプル値 |
|---|---|---|---|---|
| 主体属性表タイプ | 分析主体情報 | 必須 | ディメンション情報を関連付ける分析主体プロパティがイベントプロパティかユーザープロパティか | イベントプロパティ |
| 主体プロパティ | 分析主体情報 | 必須 | ディメンション情報を関連付ける分析主体プロパティの名前 | item_id |
| 主体列 | 分析主体情報 | 必須 | データソース内で分析主体プロパティと関連付けるデータ列の名前 | item_id |
| 時間粒度 | 特殊マッチングロジック | 「分析主体プロパティ」が時間タイプの場合のみ入力 | 分析主体プロパティが「時間」の場合に、関連付け時に切り捨てる時間粒度 | 月 |
⚠ 分析主体プロパティのデータタイプが「時間」の場合は、構成詳細に「時間粒度」を入力する必要があります。また、分析主体列のタイプは「文字列」で、内容の形式はyyyy-MM-dd HH:mm:ssである必要があります
使用シーン：分析主体プロパティが「登録時間」で、業務上特定の月に新規獲得キャンペーンがあり、データソースAの1列目に新規獲得キャンペーンの月（例：2025-01-01）が記録されている場合は、分析主体プロパティの時間粒度も月に設定し、データソースAの1列目と関連付けます
🔵 アセット名とデータタイプ
クロスソースディメンションプロパティの出力アセットは、次のデータタイプに対応しています：
文字列、数値、ブール値、時間
プロパティ名は小文字で始め、小文字、数字、アンダースコアのみを含み、長さは80文字以内にする必要があります
値の取得方式に関する複雑なシーンは、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
6.3 クロスソースエンティティテーブル
現在のバージョンのクロスソースエンティティテーブルは、送信された「ユーザープロパティ」を置き換えるために使用します。他の機能への影響を避けるため、以下の情報は運用コマンドで設定する必要があります
「データソース名」、「分析主体列」
EXCELで設定する際は次の点に注意してください
- 1つのプロジェクトに存在できる「エンティティテーブル」のクロスソース構成は1件のみです
- 「クロスソースアセット構成名」には固定値
user_entity_routeを入力する必要があります - 「データソース選択」には
hive.ws_product.entityを入力する必要があります - 「構成詳細」には
key: valueを入力する必要があります
🔵 構成詳細
このブロックの情報は、<クロスソースアセット構成リスト>サブシートの「構成詳細」列に入力します
複数のフィールドは「名前: 値」の形式で、改行で区切って対応するセルに記入します
| アセットタイプ | 構成詳細 |
|---|---|
| エンティティテーブル | 分析主体列: (運用コマンドで設定する必要があります)ここはプレースホルダーとして残します ---アップロード前にこの線を削除--- データ更新日時カラム: update_time_pix |
クロスソースエンティティテーブル_構成詳細のプレビュー
| フィールド名 | フィールド区分 | 必須/任意 | ロジックの説明 | サンプル値 |
|---|---|---|---|---|
| 主体列 | 分析主体情報 | 必須 | データソース内でユーザーの識別情報を記録している列。ユーザーのドリルダウン機能に影響 | user_id |
| データ更新日時カラム | データ鮮度情報 | 任意 | データソース内でデータの更新時間を記録している列。エンゲージスイートで使用 | update_time |
🔵 アセット名とデータタイプ
クロスソースディメンションプロパティの出力アセットは、次のデータタイプに対応しています：
文字列、数値、ブール値、時間、リスト、オブジェクト、オブジェクトグループ
プロパティ名は小文字で始め、小文字、数字、アンダースコアのみを含み、長さは80文字以内にする必要があります
オブジェクトグループのサブプロパティは、親プロパティ名とサブプロパティ名を半角ピリオドで区切ります
値の取得方式に関する複雑なシーンは、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
6.4 クロスソースイベントテーブル
🔵 構成詳細
このブロックの情報は、<クロスソースアセット構成リスト>サブシートの「構成詳細」列に入力します
複数のフィールドは「名前: 値」の形式で、改行で区切って対応するセルに記入します
| アセットタイプ | 構成詳細 |
|---|---|
| イベントテーブル | 分析主体列: ユーザーIDを表す列の名前(任意、ユーザーデータのドリルダウンに影響) ---アップロード前にこの線を削除--- イベント名の取得方法: カラム値を読み取る/固定値 イベント名: イベント名が固定値の場合に入力 イベント名列: イベント名がある列の名前 ---アップロード前にこの線を削除--- イベント時間の取得方法: カラム値を読み取る/カスタムSQL イベント時間列: イベント時間がある列の名前 イベント時間ロジック: カスタムSQLの場合に入力 ---アップロード前にこの線を削除--- イベントタイムゾーンの取得方法: カラム値を読み取る/固定値/カスタムSQL イベントタイムゾーン: タイムゾーンが固定値の場合に入力 イベントタイムゾーン列: イベントタイムゾーンがある列の名前 イベントのタイムゾーンロジック: カスタムSQLの場合に入力 ---アップロード前にこの線を削除--- データパーティショニング方式: 単一列日付パーティション/プッシュダウンロジックのカスタム 日付情報列: 日付パーティションがある列の名前 日付情報のフォーマット: yyyy-MM-dd/yyyymmdd プッシュダウンロジック: カスタムプッシュダウンロジックのSQL |
クロスソースイベントテーブル_構成詳細のプレビュー
| フィールド名 | フィールド区分 | 必須/任意 | ロジックの説明 | サンプル値 |
|---|---|---|---|---|
| 主体列 | 分析主体情報 | 任意 | ユーザーIDを表す列の名前。ユーザーデータのドリルダウンに影響 | user_id |
| イベント名の取得方法 | イベント名情報 | 必須 | カラム値を読み取る/固定値 | カラム値を読み取る |
| イベント名 | イベント名情報 | イベント名の取得方法=「固定値」の場合に入力 | イベント名が固定値の場合に入力 | user_login |
| イベント名列 | イベント名情報 | イベント名の取得方法=「カラム値を読み取る」の場合に入力 | イベント名がある列の名前 | event_name |
| イベント時間の取得方法 | イベント時間情報 | 必須 | カラム値を読み取る/カスタムSQL | カラム値を読み取る |
| イベント時間列 | イベント時間情報 | イベント時間の取得方法=「カラム値を読み取る」の場合に入力 | イベント時間がある列の名前 | event_time |
| イベント時間ロジック | イベント時間情報 | イベント時間の取得方法=「カスタムSQL」の場合に入力 | カスタムSQLの場合に入力 | try_cast( ts as timestamp ) |
| イベントタイムゾーンの取得方法 | イベントタイムゾーン情報 | 必須 | カラム値を読み取る/固定値/カスタムSQL | カラム値を読み取る |
| イベントタイムゾーン | イベントタイムゾーン情報 | イベントタイムゾーンの取得方法=「固定値」の場合に入力 | タイムゾーンが固定値の場合に入力 | 8 |
| イベントタイムゾーン列 | イベントタイムゾーン情報 | イベントタイムゾーンの取得方法=「カラム値を読み取る」の場合に入力 | イベントタイムゾーンがある列の名前 | tz |
| イベントのタイムゾーンロジック | イベントタイムゾーン情報 | イベントタイムゾーンの取得方法=「カスタムSQL」の場合に入力 | カスタムSQLの場合に入力 | try_cast( tz as double ) |
| データパーティショニング方式 | データパーティション情報 | 必須 | 単一列日付パーティション/プッシュダウンロジックのカスタム | 単一列日付パーティション |
| 日付情報列 | データパーティション情報 | データパーティショニング方式=「単一列日付パーティション」の場合に入力 | 日付パーティションがある列の名前 | pt |
| 日付情報のフォーマット | データパーティション情報 | データパーティショニング方式=「単一列日付パーティション」の場合に入力 | yyyy-MM-dd/yyyymmdd | yyyy-MM-dd |
| プッシュダウンロジック | データパーティション情報 | データパーティショニング方式=「プッシュダウンロジックのカスタム」の場合に入力 | カスタムプッシュダウンロジックのSQL |
カスタムプッシュダウンロジックの詳細は、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
🔵 クロスソースイベントテーブルで設定が必要なアセット
クロスソースイベントテーブルを構成する場合は、次の3種類のアセットを設定する必要があります：
- イベントプロパティ明細設定
- イベント名明細設定
- イベントとイベントプロパティの関係設定
🔵 イベントプロパティ名とデータタイプ
クロスソースイベントプロパティの出力アセットは、次のデータタイプに対応しています：
文字列、数値、ブール値、時間、リスト、オブジェクト、オブジェクトグループ
プロパティ名は小文字で始め、小文字、数字、アンダースコアのみを含み、長さは80文字以内にする必要があります
オブジェクトグループのサブプロパティは、親プロパティ名とサブプロパティ名を半角ピリオドで区切ります
値の取得方式に関する複雑なシーンは、クロスソース構成の複雑なシーンとSQLサンプルを参照してください
🔵 イベント名明細設定
| クロスソースアセット構成名 | 出力されたイベント名 | オリジナルイベント一覧 | 出力されたイベントの表示名 | 拡張情報 | ステータス |
|---|---|---|---|---|---|
| route_event_config | device_first | デバイスアクティベーション | |||
| route_event_config | login | ('login1', 'login2','login3') | ログイン | 備考: 3つのバージョンの名称変更をまとめたもの | |
| route_event_config | level_up | ('lv_u') | レベルアップ |
イベント名明細設定のプレビュー
1列目には対応するクロスソース構成名を入力します。出力されたイベント名、オリジナルイベント一覧などの情報は、ニーズやシーンに応じて入力します
イベント名は小文字で始め、小文字、数字、アンダースコアのみを含み、長さは60文字以内にする必要があります
シーンA: イベント名列の値をそのまま出力イベント名として使用する
- 出力イベント名に元の値を入力するだけです
シーンB: 複数の元のイベントを1つの出力イベントにまとめる
- 例：同じ意味のイベントでも、トラッキングのバージョン変更により、元のイベント名が複数存在する場合
- 「出力されたイベント名」に想定するイベント名を入力します
- 「オリジナルイベント一覧」に、まとめる元のイベントのリストを半角の括弧、シングルクォート、カンマで入力します。例：( 'login1', 'login2' )
シーンC: 元のイベントの名前を変更する
- 上記のシーンBと同じ操作方法で、出力イベント名を入力した後、オリジナルイベント一覧にイベント名を1つだけ入力します。例：( 'login_old' )
🔵 イベントとイベントプロパティの関係設定
| クロスソースアセット構成名 | イベント名 | イベントプロパティ名 |
|---|---|---|
| route_event_config | device_first | channel |
| route_event_config | login | channel |
| route_event_config | level_up | channel |
| route_event_config | level_up | level_after |
| route_event_config | level_up | map_id |
イベントとイベントプロパティの関係設定のプレビュー
1列目には対応するクロスソース構成名を入力します
2列目と3列目には、関連のあるイベント名とプロパティ名をそれぞれ入力します。イベントが複数のプロパティと関連している場合は、複数行に入力します（例：level_up）