Appearance
ADM-004-2 what_day_master_seed_from_zatsuneta(ざつねたからの一括シード)
概要
「ざつねた」から〇〇の日データを取得し db_what_day_master へ一括投入する。実行後に新規追加されたレコードの一覧(最大 50 件)をレスポンスとして返す。
POST パラメータ
| フィールド | 必須 | 型・制約 | 説明 |
|---|---|---|---|
action | ○ | 文字列 | what_day_master_seed_from_zatsuneta |
what_day_master_nonce | ○ | 文字列 | what_day_master_admin で発行した nonce |
成功時 data
| 論理名 | 物理名 | 型 | 説明 |
|---|---|---|---|
| 処理件数 | processed | int | シードサービスが処理したエントリ数 |
| 挿入件数 | inserted | int | DB に実際に挿入されたエントリ数(inserted == new_records_total) |
| 新規レコード一覧 | new_records | array(最大 50 件) | 新規追加レコードの配列(下表参照) |
| 新規レコード総数 | new_records_total | int | 実際の挿入件数(50 件超でも実数を返す) |
| 表示件数打ち切りフラグ | new_records_truncated | bool | new_records_total > 50 のとき true |
| 成功メッセージ | success_msg | string | Messages::WHAT_DAY_MASTER_SEED_SUCCESS |
new_records の各要素
| 論理名 | 物理名 | 型 |
|---|---|---|
| ID | id | int |
| 名称 | name | string |
| 月日 | mmdd | int |
| 作成日時 | created_at | string |
失敗・ブロック(success: false の data に含み得るキー)
| 条件 | message の内容 |
|---|---|
| nonce フィールドが未送信または非文字列 | Messages::AUTH_FAILED |
| nonce 不正 | Messages::AUTH_FAILED |
manage_options 権限なし | Messages::PERMISSION_DENIED |
シードサービスで \Throwable | Messages::WHAT_DAY_MASTER_SEED_ERROR(エラーログに詳細を記録) |
補足: シード実行前に get_max_id() でシード前の最大 ID を記録し、シード後に select_where_id_greater_than で新規レコードを取得する。50 件を超える場合は new_records_truncated: true を返し、表示側でトランケーション通知を行う。