SlotKeeper 設計と品質

cancel_reservation query

001_select_reservations.sql

SQL種別

SELECT

SQLの概要

取消対象の予約と版を確認するため、指定した予約を取得する。

利用するテーブル

  • reservations

引数

DDLテーブル DDL項目 SQL項目 日本語名 型 nullable
reservations reservation_id reservation_id 予約ID。 VARCHAR(36) no

戻り値

DDLテーブル DDL項目 SQL項目 日本語名 型 nullable
reservations reservation_id reservation_id 予約ID。 VARCHAR(36) no
reservations resource_id resource_id 予約対象の資源ID。 VARCHAR(36) no
reservations owner_principal_id owner_principal_id 予約者の認証subject。 VARCHAR(200) no
reservations start_at start_at 予約開始日時。UTCで保存する。 TIMESTAMPTZ no
reservations end_at end_at 予約終了日時。UTCで保存し、この時刻を含まない。 TIMESTAMPTZ no
reservations purpose purpose 予約目的。1〜200文字。本人と管理者だけに返す。 VARCHAR(200) no
reservations status status 予約状態。confirmedまたはcancelled。 VARCHAR(20) no
reservations row_version row_version 楽観ロック用の行バージョン。 INT no

条件

  • WHERE
    • reservations.reservation_id = @reservation_id

002_update_resources_control_version.sql

SQL種別

UPDATE

SQLの概要

同一資源の再予約と取消を競合させるため、資源の内部制御版を進めて現在値を取得する。

利用するテーブル

  • resources

引数

DDLテーブル DDL項目 SQL項目 日本語名 型 nullable
resources resource_id resource_id 資源ID。 VARCHAR(36) no

戻り値

DDLテーブル DDL項目 SQL項目 日本語名 型 nullable
resources resource_id resource_id 資源ID。 VARCHAR(36) no
resources active active 新規予約を受け付けるかどうか。 BOOLEAN no
resources row_version row_version 利用者に公開する楽観ロック用の行バージョン。 INT no

条件

  • WHERE
    • resource_id = @resource_id

003_update_reservations.sql

SQL種別

UPDATE

SQLの概要

予約を取消状態へ変更し、版を1つ進める。

利用するテーブル

  • reservations

引数

DDLテーブル DDL項目 SQL項目 日本語名 型 nullable
reservations reservation_id reservation_id 予約ID。 VARCHAR(36) no

戻り値

DDLテーブル DDL項目 SQL項目 日本語名 型 nullable
reservations reservation_id reservation_id 予約ID。 VARCHAR(36) no
reservations resource_id resource_id 予約対象の資源ID。 VARCHAR(36) no
reservations owner_principal_id owner_principal_id 予約者の認証subject。 VARCHAR(200) no
reservations start_at start_at 予約開始日時。UTCで保存する。 TIMESTAMPTZ no
reservations end_at end_at 予約終了日時。UTCで保存し、この時刻を含まない。 TIMESTAMPTZ no
reservations purpose purpose 予約目的。1〜200文字。本人と管理者だけに返す。 VARCHAR(200) no
reservations status status 予約状態。confirmedまたはcancelled。 VARCHAR(20) no
reservations row_version row_version 楽観ロック用の行バージョン。 INT no

条件

  • WHERE
    • reservation_id = @reservation_id

004_insert_reservation_events.sql

SQL種別

INSERT

SQLの概要

予約取消の履歴を取消と同じtransactionで追記する。

利用するテーブル

  • reservation_events

引数

DDLテーブル DDL項目 SQL項目 日本語名 型 nullable
reservation_events event_id event_id 履歴ID。 VARCHAR(36) no
reservation_events reservation_id reservation_id 対象の予約ID。 VARCHAR(36) no
reservation_events actor_principal_id actor_principal_id 操作した利用者の認証subject。 VARCHAR(200) no
reservation_events occurred_at occurred_at 操作日時。 TIMESTAMPTZ no

戻り値

なし

条件

なし