DJND4001 / DJND4002 汎用マスタ(通用字典)知识点

数据源:updsv7_opho_ci @ 192.168.1.72:5432 (opho profile の Postgres MCP) 表コメントは PG pg_class.obj_description より

1. 位置付け — 汎用マスタとは何か

DJND4001 と DJND4002 はどちらも 汎用マスタ(generic / common code master)、すなわち「共通辞書」。業務テーブルにある cde_* 系カラムの値は、すべてこの 2 テーブルを参照している。

DJND4001 = コードDB (コード値の本体:コード値ごとの表示名・有効期間)
DJND4002 = コード一覧DB (cde_sybt ごとの辞書定義:項目名・入力制御・桁数・表示順)

項目	DJND4001 (コードDB)	DJND4002 (コード一覧DB)
行数	277,926	427
列数	43	111
一意制約	`(cde_sybt, cde_val, dstart)`	`(cde_sybt)`

2. 4 フィールドで必ず絞り込む(必須)

中文导览:查代码必须同时带 (ccompkb, dstart, dend, cde_sybt) 这四个字段,缺任何一个都会串到别的字典。

DJND4001 / DJND4002 を問わず、コードを特定するには 次の 4 フィールドを同時に指定 すること:

(ccompkb, dstart, dend, cde_sybt)

ccompkb (2) — 会社区分
dstart (date, NOT NULL in 4001) — 有効開始日
dend (date, NOT NULL in 4001) — 有効終了日
cde_sybt (3) — コード種別(辞書 ID)

どれか 1 つでも欠けると、別の辞書に流れる(串数据)。

ある日付時点で有効なコード値を引く書き方:

WHERE ccompkb = :ccompkb
  AND cde_sybt = :cde_sybt
  AND cde_val  = :cde_val
  AND dstart <= :date
  AND dend   >= :date

5. inp シリーズの値ルール(4002 全 inp に共通)

中文导览:inp 系列(全部统一)取值规则:'000' 表示直接文本输入,其它值表示引用别的 cde_sybt。

DJND4002 の すべての inp 系カラム — inp0..inp12、および inp_name / inp_dname / inp_sname / inp_rname / inp_kname01/02/03 — は同じルール:

値	意味
`'000'`	入力文字列(直接テキスト入力)
その他	他汎用マスタを参照(当該 cde_sybt の値を引く)

つまり:

inp0 = '000' → nme0 はテキストボックス
inp0 = '597' → nme0 はプルダウン、値は cde_sybt='597' (俸給月額) の 4001 から取る

4002 の 1 行で、4001 の項目が「テキスト」なのか「どの辞書を引きに行くのか」が分かる構造になっている。

6. 4001 ↔ 4002 の対応関係

4002 (cde_sybt ごとに 1 行)  ────  定義  ────►  4001 ((cde_sybt, cde_val) ごとに 1 行)
   cde_nme                                       name / dname / sname / rname / kname01..03
   nme0..nme12  (項目名)                          dta1..dta12 (実データ)
   use0..use12  (入力制御:必須/任意)              — (対応なし、UI 層のバリデーション)
   inp0..inp12  ('000' テキスト / 他 cde_sybt)    — (形式定義のみ、実値は dta* 側)
   ord0..ord12  (桁数)                            — (対応なし、UI 層の制約)
   ctrl_cde1..5 (連携参照の定義)                  ctrl_cde1..5 (連携参照の実際の値)
   disp_hyoji / disp_jun                         — (UI 表示制御のみ)

中文导览:use 是输入校验(必填/可选),inp 是输入形式(文本 vs 字典引用) — 不要混淆。

7. よく使うクエリテンプレート

7.1 ある cde_sybt の、ある日付時点で有効な全コード値

SELECT cde_val, name, dname, kname01
FROM djnd4001
WHERE ccompkb = '01'
  AND cde_sybt = :cde_sybt
  AND :date BETWEEN dstart AND dend
ORDER BY ord0, cde_val;   -- 注:4001 自体に ord 列は無し、並び順は 4002 定義に依る

7.2 ある cde_sybt の項目定義(4002)

SELECT cde_nme, cde_exp, cde_num_nme,
       nme0, use0, inp0, ord0,
       nme1, use1, inp1, ord1,
       -- ...
       disp_hyoji, disp_jun
FROM djnd4002
WHERE ccompkb = '01'
  AND cde_sybt = :cde_sybt
  AND :date BETWEEN dstart AND dend;

7.3 ある項目がどの辞書を参照しているか

-- "cde_sybt=597 の nme5(俸給月額)が参照している辞書は?"
SELECT inp5 FROM djnd4002
WHERE ccompkb = '01' AND cde_sybt = '597';
-- inp5='000' → 直接入力;それ以外 → 参照先の cde_sybt

7.4 cde_sybt ごとの行数分布

SELECT cde_sybt, COUNT(*) AS cnt
FROM djnd4001
WHERE ccompkb = '01'
GROUP BY cde_sybt
ORDER BY cnt DESC;
-- 718 / 716 / 714 各 6607 行
-- 710 / 595 / 706 / 708 / 712 / 704 / 597 各 6542 行
-- 「同じ cde_sybt で行数が揃っている」ものは年度/版ごとに履歴を持っている典型例
-- → dstart / dend で世代を切り替えている

8. 注意点

現在の MCP 接続先は updsv7_opho_ci(CI 環境)。本ノートのデータ・インデックスはすべてこの DB 基準。
4001 の dstart / dend は NOT NULL。主表には必ず期間が入る。アプリ側で dstart が空に見えるケースは、ビューや作業テーブルを経由しているケースがほとんどで、生の 4001 を直接引いているのではない。
4001 の 277k 行のうち、cde_sybt=718 / 716 / 714 各 6607 行のように「同 cde_sybt で同数」になる分布 — これは典型的には「年度/版ごとに同じ構造の履歴を積み、dstart / dend で世代を分ける」設計のしるし。
use0..use12(必須桁入力 / 必須入力 / 任意入力)は 入力値の検証。一方、inp0..inp12('000' / 他 cde_sybt)は 入力形式(テキストか辞書参照か)で、別物。混同しないこと。
ctrl_cde1..5(4002 側)と ctrl_cde1..5(4001 側)はそれぞれ「連携参照の定義」と「連携参照の実際の値」を担う両端。

6.1 KiB Raw Permalink Blame History