メタデータ管理ツール
1. 概要
メタデータ管理ツールは主に、AEシステムのイベントプロパティとユーザープロパティのタイプ変更や削除を行うために使用します。メタデータを調整するとデータのETL処理が一時停止されるため、タイプのインポートミスやデータの異常が確認された場合にのみ本ツールを使用し、頻繁に操作しないことをお勧めします。
二次開発ツールでレポーティング済みイベントプロパティを変更した後は、業務担当者に「データ → データ管理 → イベントプロパティ」ページでプロパティの接続関係が正常かどうかを確認してもらってください（一覧の「接続ステータス」列と、ページ右上の「ソースイベントプロパティ管理ページへ」から開くレポーティング済みイベントプロパティの一覧を確認します。ユーザープロパティも同様に、「データ → データ管理 → ユーザープロパティ」ページで確認します）。これにより、タイプの変更が原因で、そのプロパティを使用しているダッシュボード、レポート、タグなどのアセットが正常に計算できなくなる事態を防げます。
2. 使用方法
メタデータ管理ツールは、オンプレミス版サービスのユーザーのみが使用できます。rootユーザーで、オンプレミスクラスター内の二次開発ツールがデプロイされているサーバー（分散構成ではデフォルトで最初の3台）にログインし、su - taを実行します
次にta-tool modify_metaを実行すると、メタデータ管理ツールの画面に入ります。
su - ta
ta-tool modify_meta
2.1 処理するプロジェクトのappidを入力する
まず、変更対象のプロジェクトのappidを入力する必要があります。appidはAEシステムの「プロジェクト管理」ページで確認できます。
请输入需要属性修改或删除项目的appid >××××
2.2 プロジェクト名の確認
appidを入力すると、変更対象のプロジェクト名が表示されます。「y」を入力すると確定、「n」を入力すると操作をキャンセルします
请确认您将修改的项目：项目测试展示 <y/n> y
2.3 メタデータの操作タイプを選択する
次に、実行する操作タイプの追加を開始します。ここでは操作を繰り返し追加できます。1つの操作の設定が完了したら、「添加完成」を選択するまで別の操作を追加できます。変更や削除の操作は、すべてまとめて一度に行うことをお勧めします。
请选择操作类型
1. 修改事件属性类型
2. 修改用户属性类型
3. 删除事件属性
4. 删除用户属性
5. 添加完成
>
2.4 イベントプロパティのタイプを変更する
2.4.1 通常のイベントプロパティの変更
-
例：イベントプロパティargNumのタイプをnumberからstringに変更します：
- 操作タイプの選択：1
- イベントプロパティ名の入力：argNum
- 変更後のタイプの入力：string
请选择操作类型
>1
当前操作仅修改上报事件属性，请在修改后进入<数据管理-事件属性>页面确认是否存在异常！
请输入要修改的事件属性名>argNum
当前类型：[number]，请输入修改类型
number. 数值类型
string. 字符串类型
datetime. 时间类型
bool. 布尔类型
array. 列表类型
row. 对象类型
array_row. 对象列表类型
>string
2.4.2 オブジェクト、オブジェクトグループのサブプロパティの変更
メタデータ管理ツールでは、「親プロパティ.サブプロパティ」の形式で、変更/削除時にオブジェクト（グループ）のサブプロパティを指定できます
-
例：オブジェクト（グループ）プロパティargrowのサブプロパティchannel_idのタイプをnumberからstringに変更します：
- 操作タイプの選択：1
- イベントプロパティ名の入力：argrow.channel_id
- 変更後のタイプの入力：string
请选择操作类型
>1
当前操作仅修改上报事件属性，请在修改后进入<数据管理-事件属性>页面确认是否存在异常！
请输入要修改的事件属性名>argrow.channel_id
当前类型：[number]，请输入修改类型
number. 数值类型
string. 字符串类型
datetime. 时间类型
bool. 布尔类型
array. 列表类型
>string
2.5 ユーザープロパティのタイプを変更する
2.5.1 通常のユーザープロパティの変更
-
例：ユーザープロパティuser_argNumのタイプをnumberからstringに変更します：
- 操作タイプの選択：2
- ユーザープロパティ名の入力：user_argNum
- 変更後のタイプの入力：string
请选择操作类型
>2
请输入要修改的用户属性名>user_argNum
当前类型：[number]，请输入修改类型
number. 数值类型
string. 字符串类型
datetime. 时间类型
bool. 布尔类型
array. 列表类型
row. 对象类型
array_row. 对象列表类型
>string
2.5.2 オブジェクト、オブジェクトグループのサブプロパティの変更
-
例：オブジェクト（グループ）プロパティuser_argrowのサブプロパティchannel_idのタイプをnumberからstringに変更します：
- 操作タイプの選択：2
- ユーザープロパティ名の入力：user_argrow.channel_id
- 変更後のタイプの入力：string
请选择操作类型
>2
请输入要修改的用户属性名>user_argrow.channel_id
当前类型：[number]，请输入修改类型
number. 数值类型
string. 字符串类型
datetime. 时间类型
bool. 布尔类型
array. 列表类型
>string
2.6 イベントプロパティを削除する
-
例：通常のイベントプロパティargboolと、オブジェクト（グループ）プロパティargrowのサブプロパティlevelを削除します：
- 操作タイプの選択：3
- イベントプロパティ名の入力：argbool,argrow.level
请选择操作类型
>3
当前操作仅删除上报事件属性，请在删除后进入<数据管理-事件属性>页面确认是否存在异常！
请输入要删除的事件属性名，多个用逗号分隔>argbool,argrow.level
2.7 ユーザープロパティを削除する場合の操作
-
例：通常のユーザープロパティuser_argboolと、オブジェクト（グループ）プロパティuser_argrowのサブプロパティlevelを削除します：
- 操作タイプの選択：4
- ユーザープロパティ名の入力：user_argbool,user_argrow.level
请选择操作类型
>4
请输入要删除的用户属性名，多个用逗号分隔>user_argbool,user_argrow.level
2.8 変更・削除操作の追加完了
- すべての設定が完了したら、「5」を入力して確定します
请选择操作类型
>5
以下为[项目测试展示]项目准备调整的属性meta:
事件属性类型修改列表：
argnum: number -> string
argrow.channel_id: number -> string
用户属性类型修改列表：
user_argnum: number -> string
user_argrow.channel_id: number -> string
待删除的事件属性列表：
argbool
argrow.level
待删除的用户属性列表：
user_argbool
user_argrow.level
警告：操作完成后，在已导入的数据中，修改过类型的属性值将置为NULL；修改属性类型和删除属性操作都无法回滚！
警告：您要操作的属性包含资产依赖,会影响对应资产,请确认后再操作！
-----事件属性[argrow.channel_id]，影响类型为[普通依赖]，变更类型为[update]-----
-----事件属性[argnum]，影响类型为[普通依赖]，变更类型为[update]-----
-----用户属性[user_argnum]，影响类型为[普通依赖]，变更类型为[update]-----
-----事件属性[argbool]，影响类型为[普通依赖]，变更类型为[delete]-----
-----事件属性[argrow.level]，影响类型为[普通依赖]，变更类型为[delete]-----
-----用户属性[user_argrow.channel_id]，影响类型为[普通依赖]，变更类型为[update]-----
-----用户属性[user_argbool]，影响类型为[普通依赖]，变更类型为[delete]-----
-----用户属性[user_argrow.level]，影响类型为[普通依赖]，变更类型为[delete]-----
操作の完了後、タイプを変更したプロパティの値はNULLに設定されます。変更と削除はいずれもロールバックできません。
2.9 操作を確認する
- 実行前に最終確認が行われます。「y」を入力すると確定、「n」を入力すると操作をキャンセルします
准备执行操作，请确认(y/n)>y
请再次确认(y/n)>y
2.10 関連する操作を実行する
確認が完了すると、管理ツールはまずAEシステムのデータETLサービスを一時停止します。その後、今回の設定に含まれるすべての操作を実行し、すべての操作が完了するとデータETLサービスを再起動します。この間に送信されたデータは格納が遅れますが、失われることはありません。
...
=== 停止ta1 ETL服务 ===
=== ta1 ETL 停止成功 ===
...
事件属性类型修改成功，argnum: number -> string
...
用户属性类型修改成功，user_argnum: number -> string
...
事件属性类型删除成功，argbool
...
用户属性类型删除成功，user_argbool
...
----------属性修改任务执行成功----------
== 等待etl组件启动 ==
== ta1ETL 启动成功 ===
----------开始关闭更新全局锁----------
----------关闭更新全局锁完成----------
项目属性调整成功
2.11 最終結果の表示
2.12 データへの影響
2.12.1 通常のプロパティ
通常のプロパティを変更すると、そのプロパティについて以前にインポートされたデータはnullに設定されます。
2.12.2 親プロパティ
親プロパティを変更すると、その親プロパティについて以前にインポートされたデータはnullに設定されます。これには、その親プロパティのすべてのサブプロパティの値も含まれます。
2.12.3 サブプロパティ
サブプロパティを変更すると、そのサブプロパティについて以前にインポートされたデータはnullに設定されますが、同じ親プロパティの他のサブプロパティには影響しません。
3. 注意事項
- 変更や削除の実行中は、セッションの切断や、Ctrl + Cによる操作の中断はできるだけ避けてください。
- プロパティの変更や削除を行うとETL処理が停止するため、データのリアルタイムな流入に影響しないよう、頻繁な操作は避けてください。
- サブプロパティを複雑な構造のタイプに変更することはできません。