メインコンテンツまでスキップ

メタイベント削除ツール

最終更新 2026/11/11

1. 概要​

メタイベント削除ツール event_del_full は、指定したプロジェクト内の1つ以上のイベントについて、 すべての履歴データとイベント定義 を削除します。同時に、イベントとプロパティの関連付け、関連するスーパーイベントの定義とそのプロパティの関連付けも削除します。プロパティ定義自体は保持されます。

本ツールは、イベントデータとイベント定義を完全に削除する場合に使用します。期間やその他の条件を指定して、一部のデータだけを削除することはできません。

注意

削除操作は取り消せません。事前に削除範囲を確認し、必要に応じてデータをバックアップしてください。イベントを削除しても、そのイベントのデータ送信は停止しません。その後もデータの送信や再送が行われると、イベントとそのデータが再び作成される可能性があります。

2. 使用方法​

2.1 操作前の準備​

本説明は、二次開発ツールがデプロイされたプライベートデプロイ環境を対象としています。操作前に、対象プロジェクトの appid と削除するイベント名を準備し、次の事項を確認してください。

  • 対象イベントのデータ送信を停止し、未処理または再送待ちのデータがないか確認していること。
  • 関連する分析、レポート、スーパーイベントへの削除の影響を確認していること。
  • ETL(データ処理サービス)を停止する場合は、適切な作業時間を確保していること。ETL の停止は、他のプロジェクトのデータ処理にも影響する可能性があります。

現在の環境でこのコマンドが使用できるか不明な場合や、上記の影響を確認できない場合は、事前に管理者またはテクニカルサポートにお問い合わせください。

2.2 ツールの起動​

二次開発ツールのインストールと設定が完了しているサーバーにログインし、実行権限を持つアカウントでコマンドを実行します。ta アカウントを使用する環境では、root でログインした後に su - ta を実行し、次のコマンドでツールを起動できます。

ta-tool event_del_full

起動時に追加のパラメータは不要です。画面の案内に従って入力してください。入力待ちの段階では、quit を入力するとツールを終了できます。削除開始後のキャンセル方法は「3.3 途中でのキャンセル」を参照してください。

2.3 appid の入力とプロジェクトの確認​

操作対象の appId を入力するよう求められたら、対象プロジェクトの appid を入力します。検証に成功するとプロジェクト名が表示されます。内容をよく確認し、y を入力して続行してください。それ以外を入力すると操作をキャンセルします。

入力に対応するプロジェクトが存在しない旨のメッセージが表示された場合は、appid を確認してからコマンドを再実行してください。

2.4 削除するイベント名の入力​

削除するイベント名を入力するよう求められます。複数のイベントはカンマで区切ってください。入力するのは、データ送信時に使用する イベント名(key)であり、表示名ではありません 。

複数のイベントは、半角カンマ , または全角カンマ , で区切ることができます。例:

draw_card, gold_get

重複したイベント名は自動的にまとめられます。有効なイベント名が入力されていない場合は、再入力を求められます。

2.5 削除内容の確認​

プロジェクト名、削除対象のイベント一覧、削除範囲が表示され、 連続して2回の確認 を求められます。内容が正しければ、2回とも y を入力して続行してください。どちらかで別の内容を入力すると、操作をキャンセルします。

2.6 ETL を停止するかどうかの選択​

ETL を停止してから削除するかどうかを尋ねるプロンプト(<y/n> >)が表示されます。

  • y を入力: ETL を停止してから削除を実行し、終了時に自動で ETL の復旧を試みます。停止中は関連ノードのデータ処理に影響し、他のプロジェクトも影響を受ける可能性があります。
  • n を入力: ETL を停止せず、リスクの確認に進みます。実行中に対象イベントのデータが送信されないことが必須です。この条件を満たしていることを確認し、y を入力して続行してください。それ以外を入力するとキャンセルします。
  • それ以外を入力: 操作をキャンセルします。

K8s(コンテナ化)環境では、ETL の停止を選択する必要があります。 停止しない選択をすると、未対応である旨のメッセージが表示されて終了するため、コマンドを再実行してください。

ETL を停止しても、クライアントからのデータ送信は停止せず、未処理のデータも消去されません。そのため、どちらを選択する場合も、事前に送信と再送の状況を確認してください。

2.7 実行の待機と結果の確認​

確認が完了すると、イベントと環境の状態を確認し、必要なバックグラウンド同期タスクの終了を待ってから、イベントを順に削除します。削除対象のイベントが1つでも存在しない場合、削除を開始する前にタスクが終了します。

実行中は各イベントの削除状況が表示され、終了後に成功・失敗の件数とイベント一覧が出力されます。これらの一覧で削除結果を確認してください。途中でキャンセルした場合は、未処理のイベントがないかも確認してください。

選択した方法に応じて、ツールが自動的にキャッシュ更新を要求するか、ETL の復旧を試みるため、手動で呼び出す必要はありません。コマンドの終了を待ち、その後にエラーメッセージが表示されていないか確認してください。 イベントの削除成功は、データ処理サービスの復旧成功を意味しません。 キャッシュ更新や ETL の復旧に失敗した旨のメッセージが表示された場合は、ターミナル出力を保存し、管理者またはテクニカルサポートにお問い合わせください。

3. 注意事項​

3.1 削除範囲と関連する影響​

内容処理方法
指定イベントのすべての履歴データ(更新イベントのデータを含む)期間を問わず削除
指定イベントの定義とプロパティとの関連付け削除
関連するスーパーイベントの定義とプロパティとの関連付け削除
プロパティ定義保持
ユーザーデータ、プロジェクト情報、プロジェクトメンバー削除しない
指定していないイベントのデータとイベント定義直接は削除しない。ただし、共有するスーパーイベントは影響を受ける可能性がある

複数のイベントが同じスーパーイベントに関連付けられている場合、そのうち1つを削除すると、共有するスーパーイベントの定義とプロパティの関連付けも削除され、他のイベントの利用に影響する可能性があります。このような関連付けがある場合は、事前に管理者またはテクニカルサポートに影響を確認してください。

削除したイベントを参照する分析やレポートなどの設定は、ツールによって自動調整されません。事前に確認し、削除後に必要に応じて修正してください。

3.2 よくあるメッセージと対処方法​

メッセージまたは状況処理方法
バックグラウンドのデータ同期タスクが終了するまで削除を待機しているツールが自動的に待機して再試行します。長時間進展がない場合は、管理者またはテクニカルサポートに確認を依頼してください。
運用保守作業中のため、メタデータを変更する操作が禁止されている運用保守作業の終了後に再実行してください。現在の状態が不明な場合は、管理者にお問い合わせください。
プロジェクト内にイベントが存在しないプロジェクトの appid とイベント名を確認してください。表示名を入力していないこと、およびイベントがまだ削除されていないことを確認します。
ロックの待機中にイベントのメタデータが変更されたため、削除がキャンセルされたプロジェクト内のイベントとその関連付けを再確認し、削除範囲を確認してから実行してください。
一部のイベントの削除に失敗したため、ログの確認が必要失敗したイベントの一覧とエラー情報を保存し、原因を調査した後、「3.4 削除に失敗した場合の対処」に従ってください。

3.3 途中でのキャンセル​

実行開始後にキャンセルする場合は、Ctrl+C を1回押して停止を要求し、ツールが後処理を完了するまで待ってください。 キャンセルしても、削除済みのデータは復元されません。 処理中のイベントも、一部がすでに削除されている可能性があります。

ETL の復旧に影響しないよう、Ctrl+C を連続して押したり、プロセスを強制終了したりしないでください。キャンセル後にサービスの復旧失敗などのメッセージが表示された場合は、ターミナル出力を保存し、管理者またはテクニカルサポートにお問い合わせください。

3.4 削除に失敗した場合の対処​

1つのイベントの削除に失敗しても、通常は後続のイベントの処理を続行します。失敗したイベントでも一部のデータが削除済みの場合があり、削除済みのデータは自動では復元されません。

まず成功・失敗のイベント一覧とエラー情報を保存し、管理者またはテクニカルサポートに調査を依頼してください。再試行時は、引き続き削除が必要で、まだ存在することを確認したイベントだけを入力します。削除済みのイベントを含む一覧全体をそのまま再送信しないでください。イベントが存在しないために処理が終了する可能性があります。

すべてのイベントが削除済みで、キャッシュ更新または ETL の復旧のみが失敗した場合は、該当するサービスの問題に対処してください。イベントを再度削除する必要はありません。

このページは役に立ちましたか?