[CBRD-27369] Serialize concurrent UPDATE STATISTICS per class (gate + piggyback) - #7900

… piggyback)

동일 테이블에 여러 세션이 UPDATE STATISTICS ... WITH FULLSCAN 을 동시 호출하면 처리율이
붕괴한다(제보: 순차 대비 ~1/386, shell_heavy cbrd_21362 가 ~10시간으로 늘어 QA timeout).

원인: CBRD-26959(CUBRID#7476) 이후 UPDATE STATISTICS 는 히스토그램을 기본 수집한다. 컬럼마다
_db_histogram 카탈로그 행을 S(존재확인)→X(blob 쓰기) 로 잠그고 커밋까지 유지하는데, 다수 세션이
같은 소수 행 집합에 S/X 를 교차 요구하면서 락 컨보이와 데드락 폭풍이 발생한다. 구버전은
update_statistics_update_histogram 기본값이 false 라 _db_histogram 을 건드리지 않아 경합이 없었다.

수정: UPDATE STATISTICS 를 클래스 단위로 직렬화한다. 수집 시작에 클래스별 게이트 락을
트랜잭션 스코프로 잡아(커밋 시 해제) 한 번에 한 세션만 통계·히스토그램을 쓰게 한다.

- 게이트 자원은 통계 수집 전용 OID다: 클래스 OID 에 예약 슬롯 비트(bit 14,
  UPDATE_STATS_GATE_OID_MASK)를 세운 값으로, 실제 슬롯·카탈로그 가상 디렉터리 OID(bit 15)·기타
  어떤 락 사용처와도 겹치지 않는다. 따라서 이 OID 의 X 는 자기충돌해 통계 수집을 직렬화하지만
  테이블의 실제 클래스 OID·행·카탈로그 접근 락과 무관해 조회·DML 을 막지 않는다(PostgreSQL
  ANALYZE 의 ShareUpdateExclusiveLock 과 같은 의미). bit 15 를 비워 두어
  OID_IS_VIRTUAL_CLASS_OF_DIR_OID() 가 이 OID 에 false 가 되게 한다(락 매니저가 그 플래그를
  특별 취급하므로).
- piggyback: 게이트 진입 전/후로 클래스 통계 timestamp 를 읽어, 대기 중 다른 세션이 갱신했으면
  do_update_stats 가 재스캔·히스토그램 빌드·store 를 건너뛴다(N 회 전수 스캔 → 1 회).
  drop histogram / no histogram 요청은 skip 대상에서 제외한다.

신규: xstats_enter_update_gate / sqst_enter_update_gate / stats_enter_update_gate +
NET_SERVER_QST_ENTER_UPDATE_GATE + OID_GET_UPDATE_STATS_GATE_OID.

http://jira.cubrid.org/browse/CBRD-27369

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PbvVtggcaYxe1uFvUiahig

# 제목: 변경 요약 (50자 이내)  (refactor, hotfix, feature)

# 본문: 변경 사항에 대한 자세한 설명
# - 주요 변경 사항 1
# - 주요 변경 사항 2

# 참고: 이 라인 아래의 내용은 커밋 메시지에서 제거됩니다.

…on, judge freshness by the _db_class row chn

Greptile review of PR CUBRID#7900 (two findings):

1. The piggyback skipped a waiting request whenever the class statistics had been
   refreshed meanwhile, regardless of that request's collection options: a WITH FULLSCAN
   request waiting behind a default (sampling) collection, or one with explicit BUCKETS /
   RANDOM SEED, returned success without producing what it asked for.  The gate now also
   reports the stored statistics_strategy, and do_update_stats () skips only when the
   committed collection satisfies the request -- never for explicit BUCKETS / RANDOM SEED,
   a WITH FULLSCAN request only when the stored collection was itself a full scan, and a
   plain (sampling) request on any collection.

2. Freshness was judged by the second-granular ci_time_stamp behind a ts_before > 0
   guard, so a class without statistics (every waiter read 0) never piggybacked on the
   first collection, and two collections within one second were indistinguishable.  It is
   now judged by the _db_class row's cache coherency number, which
   catcls_update_class_stats () bumps on every write (old_chn + 1): a changed chn -- or
   bookkeeping appearing where there was none -- means a concurrent collection committed
   while we waited, at any granularity.  The row is read through a scan cache without an
   MVCC snapshot (catcls_get_class_stats ()) so the latest committed version is seen
   regardless of the waiter's own snapshot.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PbvVtggcaYxe1uFvUiahig

# 제목: 변경 요약 (50자 이내)  (refactor, hotfix, feature)

# 본문: 변경 사항에 대한 자세한 설명
# - 주요 변경 사항 1
# - 주요 변경 사항 2

# 참고: 이 라인 아래의 내용은 커밋 메시지에서 제거됩니다.

CI 의 indent 가 catalog_class.c / statistics_sr.c 에서 120칸 경계에 수동 개행한 두 줄을
한 줄로 합쳤다. CI 잡이 낸 gitdiff 를 그대로 적용한 것으로 동작 변화는 없다.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PbvVtggcaYxe1uFvUiahig

# 제목: 변경 요약 (50자 이내)  (refactor, hotfix, feature)

# 본문: 변경 사항에 대한 자세한 설명
# - 주요 변경 사항 1
# - 주요 변경 사항 2

# 참고: 이 라인 아래의 내용은 커밋 메시지에서 제거됩니다.

…stogram rows

A query compile on a table reads the table's _db_histogram rows through the
object layer's locking lookup (db_find_multi_unique: S_SELECT_WITH_LOCK unique
search + dirty-version fetch, both S locks). An UPDATE STATISTICS holds those
rows X-locked until its transaction commits, so with autocommit off every
SELECT on that table blocked in stats_get_histogram until the statistics
session committed (reproduced: SELECT waited on the _db_histogram instance
S_LOCK for the whole transaction).

The optimizer only needs the last committed histogram, so give it a read path
that takes no lock and does not build the transaction snapshot:

- mvcc_satisfies_committed: visibility rule for "latest committed version"
  (mvcc_satisfies_dirty minus other transactions' uncommitted versions).
- xbtree_find_unique: an S_SELECT lookup on _db_histogram uses that rule with
  NULL_LOCK, like the catalog classes; S_SELECT_WITH_LOCK / S_UPDATE (writers)
  are unchanged.
- LC_FETCH_COMMITTED_VERSION: xlocator_fetch reads the object under the same
  rule (previous versions from the log when the current one is uncommitted).
- obj_find_multi_attr_committed / db_get_histogram_committed: the unlocked
  lookup + fetch, used by stats_get_histogram. Writers keep db_get_histogram.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Uq9B87BEyUD6WGbWe6vfxu