pg-*: add Korean translation (#23040)

This commit is contained in:
HoJeong Im
2026-06-30 11:24:10 +09:00
committed by GitHub
parent bd03a4bb2d
commit 4fd88bcf4f
18 changed files with 470 additions and 0 deletions
+28
View File
@@ -0,0 +1,28 @@
# pg_amcheck
> 하나 이상의 PostgreSQL 데이터베이스에서 손상 여부를 검사.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgamcheck.html>.
- 특정 데이터베이스 검사:
`pg_amcheck {{데이터베이스_이름}}`
- 모든 데이터베이스 검사:
`pg_amcheck {{[-a|--all]}}`
- 지정한 패턴과 일치하는 데이터베이스 검사:
`pg_amcheck {{[-d|--database]}} {{패턴}}`
- 데이터베이스 내 특정 테이블 검사:
`pg_amcheck {{[-t|--table]}} {{패턴}} {{dbname}}`
- 데이터베이스 내 특정 스키마 검사:
`pg_amcheck {{[-s|--schema]}} {{패턴}} {{dbname}}`
- 도움말 표시:
`pg_amcheck {{[-?|--help]}}`
+24
View File
@@ -0,0 +1,24 @@
# pg_archivecleanup
> PostgreSQL의 오래된 WAL 아카이브 파일을 정리.
> 더 많은 정보: <https://www.postgresql.org/docs/current/pgarchivecleanup.html>.
- 지정한 WAL 파일까지 아카이브 디렉터리 정리:
`pg_archivecleanup {{경로/대상/아카이브}} {{경로/대상/wal_파일}}`
- dry run 수행 (실제 삭제하지 않고 삭제 대상 파일만 표시):
`pg_archivecleanup {{[-n|--dry-run]}} {{경로/대상/아카이브}} {{경로/대상/wal_파일}}`
- 삭제 여부를 결정하기 전에 파일 확장자 제거:
`pg_archivecleanup {{[-x|--strip-extension]}} {{확장자}} {{경로/대상/아카이브}} {{경로/대상/wal_파일}}`
- 백업 히스토리 파일도 함께 삭제:
`pg_archivecleanup {{[-b|--clean-backup-history]}} {{경로/대상/아카이브}} {{경로/대상/wal_파일}}`
- 디버그 로그 출력 활성화:
`pg_archivecleanup {{[-d|--debug]}} {{경로/대상/아카이브}} {{경로/대상/wal_파일}}`
+37
View File
@@ -0,0 +1,37 @@
# pg_basebackup
> 실행 중인 PostgreSQL 클러스터의 베이스 백업을 생성.
> 전체 또는 증분 백업, 특정 시점 복구, 복제 스탠바이 서버 구축에 사용됨.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgbasebackup.html>.
- 원격 PostgreSQL 서버의 베이스 백업 생성:
`pg_basebackup {{[-h|--host]}} {{호스트}} {{[-D|--pgdata]}} {{경로/대상/백업_디렉토리}}`
- 진행 상황을 표시하며 백업 생성:
`pg_basebackup {{[-h|--host]}} {{호스트}} {{[-D|--pgdata]}} {{경로/대상/백업_디렉토리}} {{[-P|--progress]}}`
- tar 형식의 (`gzip`) 압축 파일 생성:
`pg_basebackup {{[-D|--pgdata]}} {{경로/대상/백업_디렉토리}} {{[-F|--format]}} {{[t|tar]}} {{[-z|--gzip]}}`
- 이전 manifest 파일을 사용하여 증분 백업 생성:
`pg_basebackup {{[-D|--pgdata]}} {{경로/대상/백업_디렉토리}} {{[-i|--incremental]}} {{경로/대상/오래된_manifest}}`
- 스탠바이 서버 구성을 위한 복구 설정 파일 생성:
`pg_basebackup {{[-D|--pgdata]}} {{경로/대상/백업_디렉토리}} {{[-R|--write-recovery-conf]}}`
- 백업 중 tablespace 위치 변경:
`pg_basebackup {{[-D|--pgdata]}} {{경로/대상/백업_디렉토리}} {{[-T|--tablespace-mapping]}} {{경로/대상/오래된_tablespace}}={{경로/대상/새로운_tablespace}}`
- 서버 부하를 줄이기 위해 전송 속도 제한:
`pg_basebackup {{[-D|--pgdata]}} {{경로/대상/백업_디렉토리}} {{[-r|--max-rate]}} {{100M}}`
- 백업과 동시에 WAL 로그를 스트리밍:
`pg_basebackup {{[-D|--pgdata]}} {{경로/대상/백업_디렉토리}} {{[-X|--wal-method]}} stream`
+28
View File
@@ -0,0 +1,28 @@
# pg_checksums
> PostgreSQL 데이터베이스 클러스터의 데이터 체크섬을 활성화, 비활성화하거나 검사.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgchecksums.html>.
- 데이터베이스 클러스터의 데이터 체크섬 검사:
`pg_checksums {{[-D|--pgdata]}} {{경로/대상/데이터}}`
- 데이터베이스 클러스터의 데이터 체크섬 활성화:
`pg_checksums {{[-e|--enable]}} {{[-D|--pgdata]}} {{경로/대상/데이터}}`
- 데이터베이스 클러스터의 데이터 체크섬 비활성화:
`pg_checksums {{[-d|--disable]}} {{[-D|--pgdata]}} {{경로/대상/데이터}}`
- 자세한 출력과 함께 데이터 체크섬 검사:
`pg_checksums {{[-v|--verbose]}} {{[-D|--pgdata]}} {{경로/대상/데이터}}`
- 진행 상황을 표시하며 데이터 체크섬 검사:
`pg_checksums {{[-P|--progress]}} {{[-D|--pgdata]}} {{경로/대상/데이터}}`
- 도움말 표시:
`pg_checksums {{[-?|--help]}}`
+37
View File
@@ -0,0 +1,37 @@
# pg_combinebackup
> 증분 백업 체인을 사용하여 전체 (합성) PostgreSQL 백업을 재구성.
> 여러 백업을 지정할 경우 가장 오래된 백업부터 최신 백업 순으로 지정해야 함.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgcombinebackup.html>.
- 전체 백업과 증분 백업을 하나의 합성 전체 백업으로 결합:
`pg_combinebackup {{경로/대상/전체_백업}} {{경로/대상/증분_백업}} {{[-o|--output]}} {{경로/대상/출력_디렉터리}}`
- dry run 수행(실제 파일을 생성하지 않고 수행 예정 작업만 표시):
`pg_combinebackup {{[-n|--dry-run]}} {{경로/대상/전체_백업}} {{경로/대상/증분_백업}} {{[-o|--output]}} {{경로/대상/출력_디렉터리}}`
- 파일 복사 대신 하드 링크 사용 (더 빠르며, 동일한 파일 시스템 필요):
`pg_combinebackup {{[-k|--link]}} {{경로/대상/전체_백업}} {{경로/대상/증분_백업}} {{[-o|--output]}} {{경로/대상/출력_디렉터리}}`
- 지원되는 경우 파일 복제 (reflink)를 사용하여 효율적으로 복사:
`pg_combinebackup --clone {{경로/대상/전체_백업}} {{경로/대상/증분_백업}} {{[-o|--output]}} {{경로/대상/출력_디렉터리}}`
- `copy_file_range` 시스템 호출을 사용하여 효율적으로 복사:
`pg_combinebackup --copy-file-range {{경로/대상/전체_백업}} {{경로/대상/증분_백업}} {{[-o|--output]}} {{경로/대상/출력_디렉터리}}`
- 재구성 중 tablespace 위치 변경:
`pg_combinebackup {{경로/대상/백업1 경로/대상/백업2 ...}} {{[-T|--tablespace-mapping]}} /{{경로/대상/오래된_tablespace}}=/{{경로/대상/새로운_tablespace}} {{[-o|--output]}} {{경로/대상/출력_디렉터리}}`
- 더 빠르지만 안전하지 않은 쓰기를 위해 fsync 비활성화 (테스트 전용):
`pg_combinebackup {{[-N|--no-sync]}} {{경로/대상/백업1 경로/대상/백업2 ...}} {{[-o|--output]}} {{경로/대상/출력_디렉터리}}`
- 상세한 디버그 출력 표시:
`pg_combinebackup {{[-d|--debug]}} {{경로/대상/백업1 경로/대상/백업2 ...}} {{[-o|--output]}} {{경로/대상/출력_디렉터리}}`
+32
View File
@@ -0,0 +1,32 @@
# pg_config
> 설치된 PostgreSQL 버전에 대한 정보를 표시.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgconfig.html>.
- PostgreSQL 실행 파일 디렉터리 표시:
`pg_config --bindir`
- 라이브러리 파일 디렉터리 표시:
`pg_config --libdir`
- 헤더 파일 (C include 파일) 디렉터리 표시:
`pg_config --includedir`
- 공유 데이터 파일 디렉터리 표시:
`pg_config --sharedir`
- 로케일 데이터 디렉터리 표시:
`pg_config --localedir`
- 도움말 표시:
`pg_config {{[-?|--help]}}`
- 버전 표시:
`pg_config --version`
+16
View File
@@ -0,0 +1,16 @@
# pg_controldata
> PostgreSQL 데이터베이스 클러스터의 제어 정보를 표시.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgcontroldata.html>.
- 지정한 데이터 디렉터리의 제어 정보 표시:
`pg_controldata {{[-D|--pgdata]}} {{경로/대상/데이터}}`
- 도움말 표시:
`pg_controldata {{[-?|--help]}}`
- 버전 표시:
`pg_controldata {{[-V|--version]}}`
+24
View File
@@ -0,0 +1,24 @@
# pg_createsubscriber
> 물리적 복제본을 새로운 논리적 복제본으로 변환.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgcreatesubscriber.html>.
- 특정 데이터베이스의 물리적 복제본을 논리적 복제본으로 변환:
`pg_createsubscriber {{[-d|--database]}} {{데이터베이스_이름}} {{[-D|--pgdata]}} {{경로/대상/데이터}} {{[-P|--publisher-server]}} {{connstr}}`
- dry run 수행 (대상 디렉터리를 변경하지 않음):
`pg_createsubscriber {{[-n|--dry-run]}} {{[-d|--database]}} {{데이터베이스_이름}} {{[-D|--pgdata]}} {{경로/대상/데이터}} {{[-P|--publisher-server]}} {{connstr}}`
- 구독에 Two-phase commit 활성화:
`pg_createsubscriber {{[-T|--enable-two-phase]}} {{[-d|--database]}} {{데이터베이스_이름}} {{[-D|--pgdata]}} {{경로/대상/데이터}} {{[-P|--publisher-server]}} {{connstr}}`
- 자세한 출력과 함께 변환:
`pg_createsubscriber {{[-v|--verbose]}} {{[-d|--database]}} {{데이터베이스_이름}} {{[-D|--pgdata]}} {{경로/대상/데이터}} {{[-P|--publisher-server]}} {{connstr}}`
- 도움말 표시:
`pg_createsubscriber {{[-?|--help]}}`
+36
View File
@@ -0,0 +1,36 @@
# pg_receivewal
> PostgreSQL 클러스터의 write-ahead log을 스트리밍함.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgreceivewal.html>.
- WAL을 로컬 디렉토리로 스트리밍 (최소 필수 옵션):
`pg_receivewal {{[-D|--directory]}} {{디렉토리}}`
- 호스트, 포트, 사용자명을 지정하고 자세한 출력과 함께 WAL 스트리밍:
`pg_receivewal {{[-v|--verbose]}} {{[-h|--host]}} {{호스트}} {{[-p|--port]}} {{포트}} {{[-U|--username]}} {{사용자명}} {{[-D|--directory]}} {{디렉토리}}`
- 복제 슬롯(replication slot) 사용 (필요 시 생성):
`pg_receivewal {{[-S|--slot]}} {{slot_name}} --create-slot {{[-h|--host]}} {{호스트}} {{[-p|--port]}} {{포트}} {{[-U|--username]}} {{사용자명}} {{[-D|--directory]}} {{디렉토리}}`
- 지정한 WAL 위치 (LSN)까지 스트리밍:
`pg_receivewal {{[-E|--endpos]}} {{lsn}} {{[-D|--directory]}} {{디렉토리}} {{[-h|--host]}} {{호스트}} {{[-p|--port]}} {{포트}} {{[-U|--username]}} {{사용자명}}`
- 오류 발생 시 재시도(루프) 비활성화:
`pg_receivewal {{[-n|--no-loop]}} {{[-D|--directory]}} {{디렉토리}} {{[-h|--host]}} {{호스트}} {{[-p|--port]}} {{포트}} {{[-U|--username]}} {{사용자명}}`
- 동기식 flush 수행 (WAL 데이터를 즉시 디스크에 기록):
`pg_receivewal --synchronous {{[-D|--directory]}} {{디렉토리}} {{[-h|--host]}} {{호스트}} {{[-p|--port]}} {{포트}} {{[-U|--username]}} {{사용자명}}`
- WAL 출력을 압축하여 저장 (`gzip`, 압출 레벨 0-9):
`pg_receivewal {{[-Z|--compress]}} {{level|method}} {{[-D|--directory]}} {{디렉토리}} {{[-h|--host]}} {{호스트}} {{[-p|--port]}} {{포트}} {{[-U|--username]}} {{사용자명}}`
- 상태 보고 간격 설정:
`pg_receivewal {{[-s|--status-interval]}} {{초}} {{[-D|--directory]}} {{디렉토리}} {{[-h|--host]}} {{호스트}} {{[-p|--port]}} {{포트}} {{[-U|--username]}} {{사용자명}}`
+24
View File
@@ -0,0 +1,24 @@
# pg_recvlogical
> PostgreSQL 논리 디코딩 스트림을 제어.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgrecvlogical.html>.
- 새로운 논리 복제 슬롯 생성:
`pg_recvlogical {{[-d|--dbname]}} {{데이터베이스_이름}} {{[-S|--slot]}} {{슬롯_이름}} --create-slot`
- 논리 복제 슬롯의 변경 사항을 파일로 스트리밍:
`pg_recvlogical {{[-d|--dbname]}} {{데이터베이스_이름}} {{[-S|--slot]}} {{슬롯_이름}} --start {{[-f|--file]}} {{파일이름}}`
- 논리 복제 슬롯 삭제:
`pg_recvlogical {{[-d|--dbname]}} {{데이터베이스_이름}} {{[-S|--slot]}} {{슬롯_이름}} --drop-slot`
- two-phase commit이 활성화된 논리 복제 슬롯 생성:
`pg_recvlogical {{[-d|--dbname]}} {{데이터베이스_이름}} {{[-S|--slot]}} {{슬롯_이름}} --create-slot {{[-t|--enable-two-phase]}}`
- 도움말 표시:
`pg_recvlogical {{[-?|--help]}}`
+24
View File
@@ -0,0 +1,24 @@
# pg_resetwal
> PostgreSQL 데이터베이스 클러스터의 write-ahead log 및 제어 정보를 초기화.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgresetwal.html>.
- 지정한 데이터 디렉터리의 WAL 및 제어 정보 초기화:
`pg_resetwal {{[-D|--pgdata]}} {{경로/대상/데이터}}`
- dry run 수행:
`pg_resetwal {{[-D|--pgdata]}} {{경로/대상/데이터}} {{[-n|--dry-run]}}`
- WAL 및 제어 정보 강제 초기화:
`pg_resetwal {{[-D|--pgdata]}} {{경로/대상/데이터}} {{[-f|--force]}}`
- 도움말 표시:
`pg_resetwal {{[-?|--help]}}`
- 버전 정보 표시:
`pg_resetwal {{[-V|--version]}}`
+24
View File
@@ -0,0 +1,24 @@
# pg_rewind
> PostgreSQL 데이터 디렉토리를 동일한 기반에서 분기된 다른 데이터 디렉토리와 동기화.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgrewind.html>.
- 대상 데이터 디렉토리를 원본 데이터 디렉토리와 동기화:
`pg_rewind {{[-D|--target-pgdata]}} {{경로/대상/대상_데이터}} --source-pgdata {{경로/대상/원본_데이터}}`
- 연결 문자열을 사용하여 원본 서버와 대상 데이터 디렉터리를 동기화 :
`pg_rewind {{[-D|--target-pgdata]}} {{경로/대상/대상_데이터}} --source-server {{connstr}}`
- dry run 실행:
`pg_rewind {{[-D|--target-pgdata]}} {{경로/대상/대상_데이터}} --source-pgdata {{경로/대상/원본_데이터}} {{[-n|--dry-run]}}`
- 진행 상황을 표시하며 동기화:
`pg_rewind {{[-D|--target-pgdata]}} {{경로/대상/대상_데이터}} --source-pgdata {{경로/대상/원본_데이터}} {{[-P|--progress]}}`
- 도움말 표시:
`pg_rewind {{[-?|--help]}}`
+16
View File
@@ -0,0 +1,16 @@
# pg_test_fsync
> 시스템에서 가장 빠른 wal_sync_method를 확인.
> 더 많은 정보: <https://www.postgresql.org/docs/current/pgtestfsync.html>.
- 기본 fsync 성능 벤치마크 실행 (5초):
`pg_test_fsync`
- 사용자 지정 테스트 시간으로 벤치마크 실행:
`pg_test_fsync {{[-s|--secs-per-test]}} {{초}}`
- 지정한 파일 사용해 벤치마크 실행 (파일은 pg_wal 디렉터리와 동일한 파일 시스템에 있어야 함):
`pg_test_fsync {{[-f|--filename]}} {{경로/대상/파일}}`
+12
View File
@@ -0,0 +1,12 @@
# pg_test_timing
> 시스템의 타이밍 오버헤드를 측정하여 클록 단조성(ensure clock monotonicity)을 확인.
> 더 많은 정보: <https://www.postgresql.org/docs/current/pgtesttiming.html>.
- 기본 타이밍 테스트 실행 (3초):
`pg_test_timing`
- 사용자 지정 시간 동안 타이밍 테스트 실행:
`pg_test_timing {{[-d|--duration]}} {{초}}`
+28
View File
@@ -0,0 +1,28 @@
# pg_upgrade
> PostgreSQL 데이터베이스 클러스터를 새로운 메이저 버전으로 업그레이드.
> 더 많은 정보: <https://www.postgresql.org/docs/current/pgupgrade.html>.
- 업그레이드 전에 클러스터 검사:
`pg_upgrade {{[-c|--check]}} {{[-b|--old-bindir]}} {{경로/대상/오래된_bin}} {{[-B|--new-bindir]}} {{경로/대상/새로운_bin}} {{[-d|--old-datadir]}} {{경로/대상/오래된_데이터}} {{[-D|--new-datadir]}} {{경로/대상/새로운_데이터}}`
- 실제 업그레이드 수행:
`pg_upgrade {{[-b|--old-bindir]}} {{경로/대상/오래된_bin}} {{[-B|--new-bindir]}} {{경로/대상/새로운_bin}} {{[-d|--old-datadir]}} {{경로/대상/오래된_데이터}} {{[-D|--new-datadir]}} {{경로/대상/새로운_데이터}}`
- 업그레이드 중 여러 병렬 작업 사용:
`pg_upgrade {{[-j|--jobs]}} {{여러_jobs}} {{[-b|--old-bindir]}} {{경로/대상/오래된_bin}} {{[-B|--new-bindir]}} {{경로/대상/새로운_bin}} {{[-d|--old-datadir]}} {{경로/대상/오래된_데이터}} {{[-D|--new-datadir]}} {{경로/대상/새로운_데이터}}`
- 기존 및 새로운 PostgreSQL 포트 지정:
`pg_upgrade {{[-p|--old-port]}} {{port}} {{[-P|--new-port]}} {{port}} {{[-b|--old-bindir]}} {{경로/대상/오래된_bin}} {{[-B|--new-bindir]}} {{경로/대상/새로운_bin}} {{[-d|--old-datadir]}} {{경로/대상/오래된_데이터}} {{[-D|--new-datadir]}} {{경로/대상/새로운_데이터}}`
- 새로운 클러스터로 파일을 복사하는 대신 하드 링크 사용:
`pg_upgrade {{[-k|--link]}} {{[-b|--old-bindir]}} {{경로/대상/오래된_bin}} {{[-B|--new-bindir]}} {{경로/대상/새로운_bin}} {{[-d|--old-datadir]}} {{경로/대상/오래된_데이터}} {{[-D|--new-datadir]}} {{경로/대상/새로운_데이터}}`
- 도움말 표시:
`pg_upgrade {{[-?|--help]}}`
+28
View File
@@ -0,0 +1,28 @@
# pg_verifybackup
> PostgreSQL 클러스터의 베이스 백업 무결성을 검증.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgverifybackup.html>.
- Verify a backup stored in a specific directory:
`pg_verifybackup {{경로/대상/백업}}`
- 진행 상황을 표시하며 백업 검증:
`pg_verifybackup {{[-P|--progress]}} {{경로/대상/백업}}`
- 첫 번째 오류가 발생하면 즉시 종료하며 백업 검증:
`pg_verifybackup {{[-e|--exit-on-error]}} {{경로/대상/백업}}`
- 지정한 파일 또는 디렉터리를 무시하고 백업 검증:
`pg_verifybackup {{[-i|--ignore]}} {{경로/대상/파일_또는_디렉터리}} {{경로/대상/백업}}`
- 다른 위치의 manifest 파일을 사용하여 백업 검증:
`pg_verifybackup {{[-m|--manifest-path]}} {{경로/대상/백업_manifest}} {{경로/대상/백업}}`
- 도움말 표시:
`pg_verifybackup {{[-?|--help]}}`
+36
View File
@@ -0,0 +1,36 @@
# pg_waldump
> PostgreSQL 데이터베이스 클러스터의 write-ahead log (WAL)을 사람이 읽기 쉬운 형태로 출력.
> 더 많은 정보: <https://www.postgresql.org/docs/current/pgwaldump.html>.
- 지정한 WAL 세그먼트의 레코드 표시:
`pg_waldump {{시작_세그먼트}}`
- 두 WAL 세그먼트 사이의 레코드 표시:
`pg_waldump {{시작_세그먼트}} {{종료_세그먼트}}`
- Specify the WAL 파일 디렉터리 지정:
`pg_waldump {{시작_세그먼트}} {{종료_세그먼트}} {{[-p|--path]}} {{path}}`
- 새로 생성되는 WAL 항목을 실시간으로 계속 표시:
`pg_waldump {{시작_세그먼트}} {{종료_세그먼트}} {{[-f|--follow]}}`
- 표시할 레코드 수 제한:
`pg_waldump {{시작_세그먼트}} {{종료_세그먼트}} {{[-n|--limit]}} {{수}}`
- 개별 레코드 대신 요약 통계 표시:
`pg_waldump {{시작_세그먼트}} {{종료_세그먼트}} {{[-z|--stats]}}`
- 특정 리소스 관리자 기준으로 필터링:
`pg_waldump {{시작_세그먼트}} {{종료_세그먼트}} {{[-r|--rmgr]}} {{리소스_관리자_이름}}`
- 도움말 표시:
`pg_waldump {{[-?|--help]}}`
+16
View File
@@ -0,0 +1,16 @@
# pg_walsummary
> WAL 요약 파일의 내용을 출력.
> 더 많은 정보: <https://www.postgresql.org/docs/current/app-pgwalsummary.html>.
- WAL 요약 파일을 텍스트로 변환하여 출력:
`pg_walsummary {{경로/대상/파일}}`
- 수정된 각 블록을 개별 항목으로 출력 (범위 출력이 아님):
`pg_walsummary {{[-i|--individual]}} {{경로/대상/파일}}`
- 일반 출력은 생략하고 오류만 표시:
`pg_walsummary {{[-q|--quiet]}} {{경로/대상/파일}}`