【PL/SQL】予約語完全ガイド｜11カテゴリ500語・TOP10事故予約語・V$RESERVED_WORDS・命名規則・引用符識別子の罠

-- ❌ 予約語を変数名にするとコンパイルエラー
DECLARE
  date   DATE;                 -- DATEは予約語
  count  NUMBER;               -- COUNTは予約語（キーワード）
  level  NUMBER;               -- LEVELも要注意
BEGIN
  date := SYSDATE;             -- PLS-00103: 識別子 "DATE" が必要
END;

-- ⭕ プレフィックスで回避
DECLARE
  v_date       DATE;
  v_count      NUMBER;
  v_level      NUMBER;
BEGIN
  v_date := SYSDATE;
END;

-- Oracle 12c以降は V$RESERVED_WORDS ビューで全予約語を一覧可能
SELECT keyword, length, reserved, res_type, res_attr, res_semi, duplicate
FROM V$RESERVED_WORDS
WHERE reserved = 'Y'
ORDER BY keyword;

-- 列の意味
-- reserved:  'Y'=予約語（厳格）、'N'=非予約だが特殊用途あり
-- res_type:  'Y'=データ型として予約
-- res_attr:  'Y'=属性として予約
-- res_semi:  'Y'=セミ予約（一部構文で使用可能）
-- duplicate: 'Y'=重複（複数の役割を持つ）

-- 予約語は絶対NG
DECLARE
  begin NUMBER;   -- PLS-00103: 識別子 "begin" が不正
BEGIN
  NULL;
END;

-- キーワードは文脈依存でエラーが出たり出なかったり
DECLARE
  date NUMBER;    -- 状況によってはコンパイル通るがSELECT内で衝突
BEGIN
  SELECT TO_CHAR(date, 'YYYY-MM-DD') INTO ...;  -- ここでエラー
END;

-- 非予約（標準関数名）は上書き可能だが危険
DECLARE
  FUNCTION substr(...) RETURN VARCHAR2 IS ...;   -- 標準SUBSTRが隠蔽される
BEGIN
  -- 以降この変数内では独自substrが呼ばれる
  NULL;
END;

① DATE    → v_date, order_date, created_dt
② COUNT   → v_count, total_count, row_cnt
③ LEVEL   → v_level, depth, priority_level
④ TYPE    → v_type, record_type, kind
⑤ NAME    → v_name, full_name, display_name
⑥ NUMBER  → v_number, order_number, no
⑦ ROWNUM  → v_rownum, seq_no
⑧ TIMESTAMP → v_ts, updated_ts
⑨ VALUE   → v_value, attr_value
⑩ SIZE    → v_size, dimension

-- ❌ テーブル列名に DATE を使うと引用符必須
CREATE TABLE events (
  id   NUMBER,
  date DATE       -- ORA-00904
);

-- ⭕ 意味のある列名に
CREATE TABLE events (
  id          NUMBER,
  event_date  DATE,      -- 具体的な意味を持つ名前
  created_at  TIMESTAMP,
  updated_at  TIMESTAMP
);

-- ❌ 引用符で予約語を使う（非推奨）
CREATE TABLE orders (
  id     NUMBER,
  "DATE" DATE,             -- 引用符必須になる
  "ORDER" VARCHAR2(10)
);

-- 以降も常に引用符が必要
SELECT "DATE", "ORDER" FROM orders;  -- 引用符無しはエラー

-- 大小文字区別の罠
CREATE TABLE t (
  "Name"   VARCHAR2(100),  -- 登録名は Name（PascalCase）
  "name"   VARCHAR2(100)   -- 別列として共存可能
);

SELECT name FROM t;        -- Oracleは大文字化してNAMEを探す→ORA-00904
SELECT "Name" FROM t;      -- これなら動く

-- 既存 "User Name" 列を扱う（レガシーDB対応）
DECLARE
  v_name VARCHAR2(100);
BEGIN
  SELECT "User Name" INTO v_name
  FROM legacy_users
  WHERE id = 1;

  UPDATE legacy_users
  SET "User Name" = 'New Name'
  WHERE id = 1;
END;

-- ①PLS-00103: 識別子 "BEGIN" が必要
DECLARE
  begin NUMBER;    -- 予約語を変数名に
BEGIN
  NULL;
END;
-- Error at line 2: PLS-00103

-- ②ORA-00904: 無効な識別子
SELECT date FROM events;  -- date列は引用符必須
-- ORA-00904: "DATE": invalid identifier

-- ③ORA-00936: 式がありません
SELECT FROM users;  -- 列指定忘れ or 予約語衝突

-- ④PLS-00201: 識別子を宣言してください
DECLARE
  v_name VARCHAR2(100);
BEGIN
  username := 'taro';  -- 宣言していない識別子
END;

-- ⑤ORA-00957: 列名が重複
CREATE TABLE t (
  id NUMBER,
  id NUMBER  -- 重複（予約語との衝突でも発生しうる）
);

-- ⑥ORA-00942: 表またはビューが存在しません
SELECT * FROM "ORDER";  -- 大小文字違いで別名扱い
-- 実際は ORDER テーブル（大文字）で登録されているが引用符で小文字指定している

-- ⭕ プロジェクト標準の命名規則
DECLARE
  -- 変数（Variable）：v_
  v_count        NUMBER;
  v_user_name    VARCHAR2(100);
  v_order_date   DATE;

  -- パラメータ（Parameter）：p_
  PROCEDURE update_user(
    p_id      NUMBER,
    p_status  VARCHAR2
  ) IS ...

  -- 定数（Constant）：c_
  c_tax_rate     CONSTANT NUMBER := 0.10;
  c_max_retry    CONSTANT NUMBER := 3;

  -- 例外（Exception）：e_
  e_not_found    EXCEPTION;
  e_invalid      EXCEPTION;

  -- 型（Type）：t_
  TYPE t_ids     IS TABLE OF NUMBER;
  TYPE t_user    IS RECORD (...);

  -- カーソル（Cursor）：cur_
  CURSOR cur_active_users IS
    SELECT id, email FROM users WHERE status = 'active';

  -- グローバル変数（Global、パッケージ）：g_
  g_session_id   VARCHAR2(100);
  g_debug_mode   BOOLEAN := FALSE;
BEGIN
  NULL;
END;

-- ①現在のスキーマ確認
SELECT column_name FROM user_tab_columns
WHERE table_name = 'ORDERS'
ORDER BY column_id;

-- ② 予約語列の使用は引用符で
SELECT id, "DATE", "TYPE" FROM orders;

-- ③ PL/SQL変数に取り込む時は%TYPEで型継承
DECLARE
  v_date orders."DATE"%TYPE;
  v_type orders."TYPE"%TYPE;
BEGIN
  SELECT "DATE", "TYPE" INTO v_date, v_type
  FROM orders WHERE id = 1;
END;

-- ④ 可能ならビューで別名を付けて上位アプリから隠す
CREATE OR REPLACE VIEW v_orders AS
SELECT
  id,
  "DATE"  AS event_date,
  "TYPE"  AS event_type
FROM orders;

-- 以降、v_ordersを使えば予約語に触れない
SELECT event_date, event_type FROM v_orders WHERE id = 1;

-- ⑤ 最終解：リネーム（サービス停止で計画）
ALTER TABLE orders RENAME COLUMN "DATE" TO event_date;
ALTER TABLE orders RENAME COLUMN "TYPE" TO event_type;