A. 레퍼런스

이 장을 마치면: 옵션, 설정, SQL 함수, 로그 파일, 디렉토리, 진단 쿼리, 용어를 한곳에서 찾는다.

A.1 명령 · 옵션

• 설치 옵션의 정본은 2장 2.1의 표다.

gritdb-start와 gritdb-stop 옵션:

• gritdb-start 사용법에 나오는 그 밖의 옵션(--asan, --valgrind, --crash-policy)은 개발용과 시험용이므로 쓰지 않는다. --crash-policy를 주면 기동에 실패한다.
• gritdb-start는 모르는 옵션을 받으면 Unknown option: <옵션>을 내고 기동하지 않는다.
• gritdb-stop은 모르는 옵션을 무시하고 정상 정지를 한다. 그래서 즉시 정지를 할 때는 철자(--quick, -q)를 확인한다.
• 두 명령 모두 끝날 때까지 기다리는 시한이 없다(4.1, 4.2).

종료 코드:

• 기동이 끝난 뒤의 비정상 종료는 gritdb-start 종료 코드에 나오지 않는다. 그래서 4.1의 20초 뒤 재확인을 한다.

환경 변수:

• 고객이 정할 환경 변수는 없다. GritDB 명령은 GRITDB_HOME, PGDATA, PGPORT를 읽지 않고, 실행 파일이 있는 자리에서 설치 경로를 찾는다.
• PG로 시작하는 환경 변수와 LD_LIBRARY_PATH가 없는 셸에서 기동한다(4.1).
• 기동한 셸의 TMPDIR 값이 GritDB 엔진의 임시 파일 자리가 된다(1.4, 7.6).

• 이 표에 없는 bin/ 명령(createdb, pg_controldata, pg_waldump 등)은 PostgreSQL 17 문서대로 쓴다. 등록 테이블을 다시 쓰는 작업은 하지 않는다(6.7).

A.2 설정

• 설정 뜻(PostgreSQL): shared_preload_libraries, wal_level, search_path, port, shared_buffers, wal_buffers, max_wal_size, min_wal_size, checkpoint_timeout, bgwriter_lru_maxpages, effective_cache_size, work_mem, restart_after_crash
• 관리 블록은 설치, 업그레이드, 재초기화 때마다 다시 써진다. 그래서 오래 쓸 값은 ALTER SYSTEM으로 넣는다(5.3).
• 반영 시점은 SELECT name, setting, context, pending_restart FROM pg_settings WHERE name = '<설정>';으로 확인한다(5.4).
• 이 문서가 바꾸라고 하는 그 밖의 PostgreSQL 설정: 작업자 수(6.4.1의 5번), 초기 복사 때 함께 복사하는 수 max_sync_workers_per_subscription(6.8), 접속 수 max_connections(5.4, 10.2), 시간대(5.3), listen_addresses(11.4), 감사 기록(11.9)
• 5장 5.2와 5.6의 표가 정본이다. 확장 설정의 정본은 6.6이다.

A.3 SQL 함수

• 설치 기본값에서는 모든 계정이 이 함수들을 실행할 수 있다. 실행 권한은 11.5에서 좁힌다. 등록 함수와 해제 함수는 서비스 계정만 쓰므로 역할에 주지 않는다. 11.5를 마친 뒤에는 역할에 줘도 일반 계정은 실행할 수 없다.
• 조회 함수는 접속한 데이터베이스의 것만 돌려준다. get_gritsurfer_unify_checkpoints()만 모든 데이터베이스에 공통이다.
• 이력 함수의 인자는 설치 파일 판마다 다를 수 있으므로 쓰기 전에 \df get_gritsurfer_query_history로 확인한다(3.5, 6.5).
• 6장 6.3과 6.5의 표가 정본이다.

자주 쓰는 열:

질의 상태(status):

• 이 절에 없는 gritdb 스키마의 함수는 GritDB 내부용이므로 부르지 않는다. 실행 권한은 11.5에서 거둔다.

A.4 로그 파일

• 9장 9.1의 표가 정본이다.

A.5 디렉토리

설치 경로(~/gritdb1):

• 설치 파일은 설치와 업그레이드가 바꾼다. 설정과 상태는 업그레이드가 그대로 둔다(3.5).
• 개발용 패키지면 run/gritdb/, tools/, .bashrc, build/가 더 있다(0장).

datafiles/ 안:

• 재배치 심링크(2.4): datafiles → --datafiles 실경로, datafiles/pgdata → --pgdata 실경로
• readlink -f ~/gritdb1/datafiles를 실행해 설치 때 정한 실경로가 나오는지 확인한다.

run/ 안:

A.6 진단 쿼리

서비스 계정으로 연 ~/gritdb1/bin/psql -p 5432 -d <db>에 복사해서 쓴다. “데이터베이스마다”가 붙지 않은 쿼리는 어느 데이터베이스에서나 같다.

복구용 복제 슬롯 보존량:

SELECT slot_name, active, wal_status,
       pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn)) AS retained_wal
FROM pg_replication_slots WHERE slot_name = 'gritsurfer_slot';

• 뷰와 함수: pg_replication_slots, pg_current_wal_lsn()
• active가 f이고 wal_status가 reserved이며 retained_wal이 늘기만 하지 않으면 정상이다.

cold file 상태별 개수와 크기(데이터베이스마다):

SELECT schema_name, table_name, status, count(*) AS files,
       pg_size_pretty(sum(file_size_bytes)) AS size
FROM get_gritsurfer_coldfiles()
GROUP BY schema_name, table_name, status
ORDER BY schema_name, table_name, status;

• STAGED가 늘기만 하지 않고 INACTIVE가 곧 사라지면 정상이다(7.8).

unify checkpoint 나이:

SELECT max(ckpt_lsn) AS ckpt_lsn, now() - max(created_at) AS age
FROM get_gritsurfer_unify_checkpoints();

• age가 짧게 유지되면 정상이다(7.2). 파일에서도 stat -c '%y' ~/gritdb1/datafiles/checkpoint/grit_unify.cp로 같은 것을 본다. 이 값은 unify checkpoint가 마지막으로 나아간 시간이다.

긴 트랜잭션:

SELECT pid, usename, application_name, state,
       now() - xact_start AS xact_age, left(query, 60) AS query
FROM pg_stat_activity
WHERE xact_start IS NOT NULL AND pid <> pg_backend_pid()
ORDER BY xact_start LIMIT 10;

• 오래 열린 트랜잭션과 idle in transaction이 없으면 정상이다. 있으면 그 응용 프로그램에서 끝낸다.

남은 prepared transaction(PREPARE TRANSACTION):

SELECT gid, prepared, owner, database FROM pg_prepared_xacts;

• pg_prepared_xacts가 0행이면 정상이다.

등록 테이블 목록(데이터베이스마다):

SELECT schema_name, table_name, register_ts FROM get_gritsurfer_tables() ORDER BY 1, 2;

• 함께 등록된 TOAST 테이블도 나온다.

최근 분석 질의(데이터베이스마다, 인자는 판마다 확인, 6.5):

SELECT query_start_time, status, pg_end_time - query_start_time AS total,
       left(query_text, 60) AS query
FROM get_gritsurfer_query_history(100, now() - interval '1 hour')
ORDER BY query_start_time DESC;

재기동 흔적:

SELECT pg_postmaster_start_time();

• 지난번 점검과 같은 값이면 정상이다. 바뀌었으면 재기동이 있었다(7.9). 함수 설명은 pg_postmaster_start_time()에 있다.

그 밖의 쿼리:

A.7 Oracle · Tibero 대응

• 이 표는 QuickStart 1.3의 표를 이어 쓴다.

A.8 용어