149 lines
4.3 KiB
Markdown
149 lines
4.3 KiB
Markdown
# 移行結果統計情報表示スクリプト
|
||
|
||
## 概要
|
||
|
||
移行処理の結果を詳細な統計情報として表示するスクリプトです。Docker Compose環境で実行可能で、移行データの品質チェックや分析に役立ちます。
|
||
|
||
## 実行方法
|
||
|
||
### 1. Docker Composeで実行
|
||
|
||
```bash
|
||
# 統計情報を表示
|
||
docker compose exec app python migration_statistics.py
|
||
|
||
# または Makeタスクを使用
|
||
make migration-stats
|
||
```
|
||
|
||
### 2. 他の移行関連コマンド
|
||
|
||
```bash
|
||
# 移行実行
|
||
make migration-run
|
||
|
||
# Location2025移行
|
||
make migration-location2025
|
||
|
||
# データ保護移行
|
||
make migration-data-protection
|
||
|
||
# データベースシェル
|
||
make db-shell
|
||
|
||
# アプリケーションログ確認
|
||
make app-logs
|
||
```
|
||
|
||
## 表示される統計情報
|
||
|
||
### 📊 基本統計情報
|
||
- 各テーブルのレコード数
|
||
- 全体のデータ量概要
|
||
|
||
### 🎯 イベント別統計
|
||
- 登録イベント一覧
|
||
- イベント別参加チーム数、メンバー数、エントリー数
|
||
|
||
### 📍 GPSチェックイン統計
|
||
- 総チェックイン数、参加チーム数
|
||
- 時間帯別チェックイン分布
|
||
- CP利用ランキング（上位10位）
|
||
|
||
### 👥 チーム統計
|
||
- 総チーム数、クラス数
|
||
- クラス別チーム分布
|
||
- 平均メンバー数
|
||
|
||
### 🔍 データ品質チェック
|
||
- 重複データチェック
|
||
- 異常時刻データチェック
|
||
- データ整合性チェック
|
||
|
||
### 📄 JSON出力
|
||
- 統計情報をJSONファイルで出力
|
||
- 外部システムでの利用や保存に便利
|
||
|
||
## 出力例
|
||
|
||
```
|
||
================================================================================
|
||
📊 移行データ基本統計情報
|
||
================================================================================
|
||
|
||
📋 テーブル別レコード数:
|
||
テーブル名 日本語名 レコード数
|
||
-----------------------------------------------------------------
|
||
rog_newevent2 イベント 12件
|
||
rog_team チーム 450件
|
||
rog_member メンバー 1,200件
|
||
rog_entry エントリー 450件
|
||
rog_gpscheckin GPSチェックイン 8,500件
|
||
rog_checkpoint チェックポイント 800件
|
||
rog_location2025 ロケーション2025 50件
|
||
rog_customuser ユーザー 25件
|
||
-----------------------------------------------------------------
|
||
合計 11,487件
|
||
|
||
================================================================================
|
||
🎯 イベント別統計情報
|
||
================================================================================
|
||
|
||
📅 登録イベント数: 12件
|
||
|
||
イベント詳細:
|
||
ID イベント名 開催日 登録日時
|
||
------------------------------------------------------------
|
||
1 美濃加茂 2024-05-19 2024-08-25 10:30
|
||
2 岐阜市 2024-04-28 2024-08-25 10:30
|
||
3 大垣２ 2024-04-20 2024-08-25 10:30
|
||
...
|
||
```
|
||
|
||
## トラブルシューティング
|
||
|
||
### データベース接続エラー
|
||
```bash
|
||
# コンテナの状態確認
|
||
docker compose ps
|
||
|
||
# PostgreSQLログ確認
|
||
make db-logs
|
||
|
||
# アプリケーションログ確認
|
||
make app-logs
|
||
```
|
||
|
||
### 環境変数の確認
|
||
```bash
|
||
# 環境変数が正しく設定されているか確認
|
||
docker compose exec app env | grep POSTGRES
|
||
```
|
||
|
||
### 手動でのデータベース接続テスト
|
||
```bash
|
||
# PostgreSQLコンテナに直接接続
|
||
docker compose exec postgres-db psql -U admin -d rogdb
|
||
|
||
# テーブル確認
|
||
\dt
|
||
|
||
# 基本的なクエリテスト
|
||
SELECT COUNT(*) FROM rog_gpscheckin;
|
||
```
|
||
|
||
## 関連ファイル
|
||
|
||
- `migration_statistics.py` - 統計表示メインスクリプト
|
||
- `migration_final_simple.py` - GPS記録移行スクリプト
|
||
- `migration_location2025_support.py` - Location2025移行スクリプト
|
||
- `migration_data_protection.py` - データ保護移行スクリプト
|
||
- `Makefile` - 実行用タスク定義
|
||
|
||
## 注意事項
|
||
|
||
- Docker Composeが正常に起動していることを確認してください
|
||
- PostgreSQLコンテナが稼働していることを確認してください
|
||
- 統計情報は実行時点のデータベース状態を反映します
|
||
- JSON出力ファイルは `/app/` ディレクトリに保存されます
|