二次開発ツール

最終更新 2026/10/02

1. 概要

バージョン2.8で、従来のデータ消去ツールは二次開発ツールに統合されました。

ta-toolは、AEのプライベートデプロイ版クラスター向けの二次開発ツールです。デフォルトでは最初の3台のサーバー（シングルノード構成の場合は必ずデプロイされます）にデプロイされ、ユーザーが便利に使えるさまざまな二次開発機能を提供します。現在の機能は次のとおりです：

データ消去
プロパティタイプの変更と削除
イベントデータの重複排除
カスタムデータのインポート。カスタムデータはSQLでイベントテーブルやユーザーテーブルと結合して照会できます
カスタムテーブルの削除
クエリキーの生成。クエリキーを使うと、ユーザーはPOSTメソッドでクエリAPIを呼び出せます
定期実行スクリプトの設定。SQLでAEのバックエンドのデータを照会し、AEデータベースに書き戻せます
定期実行スクリプトの設定。DataXエンジンを使って、DataXが対応しているデータソースのデータをAEデータベースに書き込めます
データのアーカイブとデータの復元

2. 使用方法

二次開発ツールがデプロイされているサーバー（分散構成の場合はデフォルトで最初の3台）にログインし、su - taコマンドを実行してtaユーザーに切り替えます。ta-toolを実行すると、次のようにコマンドのヘルプが表示されます：

su - ta
ta-tool

usage: ta-tool <命令> [选项]
命令:
user_event_import [-conf <configPath >|--configration <configPaht>] [-d <date>|--date <date>]   数据回溯
data_transfer [-conf <configPath >|--configration <configPaht>] [-d <date>|--date <date>]       导入自定义数据到TA系统
drop_table [-t <table>|--table <table>]                                                         删除指定表
generate_api_secret [-appid <appid>]                                                            基于appid生成对应的api_secret
generate_root_secret                                                                            生成root查询秘钥
data_archive [start|stop|retry] [-jobid <jobid>]                                                归档命令 (start启动任务,stop停止任务，retry 失败任务重跑需指定jobid)
data_reload  [start|stop|retry] [-jobid <jobid>]                                                回档命令 (start启动任务,stop停止任务，retry 失败任务重跑需指定jobid)
datax_engine [-conf <configPath >|--configration <configPaht>]                                  基于DATAX引擎导入数据到TA系统
update_user_by_foreignkey [-conf <configPath >|--configration <configPaht>]                     外部用户属性关联导入
data_del                                                                                        数据删除功能
dupevent_del  [-hashNum <hashNum>|-needIncludeServerTime <true|false>]                          重复事件去重功能
modify_meta                                                                                     元数据修改功能

选项:
 -appid,--appid <appid>                设置appid参数
 -conf,--configration <configration>   设置配置文件路径
 -d,--date <date>                      设置日期参数
 -h,--help                             显示帮助文档并退出
 -jobid,--jobid <jobid>                任务id 用户归档/回档失败时的指定任务重跑
 -t,--table <table>                    设置表名时删除指定表

示例:
ta-tool --help  显示帮助信息
ta-tool user_event_import -conf /data/home/ta/import_configs/*.json [-d 2019-08-01]      自定义用户事件数据导入TA系统
ta-tool data_transfer -conf /data/home/ta/dt_configs/*.json [--date 2019-08-01]          导入自定义表到TA系统
ta-tool drop_table -t test                                                               删除test表
ta-tool generate_api_secret -appid test-appid                                            生成api_secret
ta-tool generate_root_secret                                                             生成root查询密钥
ta-tool data_archive start                                                               数据归档
ta-tool data_reload start                                                                数据回档
ta-tool data_archive retry -jobid jobid_1234                                             数据归档失败任务重试
ta-tool data_reload  retry -jobid jobid_1234                                             数据回档失败任务重试
ta-tool datax_engine -conf /data/home/ta/datax_configs/stream2stream.json                调用datax引擎
ta-tool data_del                                                                         数据删除
ta-tool dupevent_del                                                                     事件数据去重
ta-tool modify_meta                                                                      元数据修改