| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 9. 함수와 연산자 | Fast Forward | Next |
Table 9-45(은)는, 실행시 환경설정 파라미터의 문의나 변경에 사용할 수 있는 함수를 나타내고 있습니다.
Table 9-45. 환경 설정 함수
| 이름 | 반환형 | 설명 |
|---|---|---|
current_setting(setting_name)
|
text | 현재의 설정값 |
set_config(setting_name,
new_value,
is_local)
|
text | 파라미터를 설정해, 신규값을 반환한다 |
함수current_setting는, 설정setting_name의 현재의 값을 생성합니다.
이 함수는,SQL의SHOW커멘드와 같습니다.
이하에 예를 나타냅니다.
SELECT current_setting('datestyle');
current_setting
-----------------
ISO, MDY
(1 row)
set_config함수는, 파라미터setting_name를new_value로 설정합니다.
다만,is_local가true의 경우, 새로운 값은 현재의 트랜잭션에서만 적용됩니다.
새로운 값을 현재의 세션에 적용하는 경우는, 대신에false를 사용해 주세요.
이 함수는, SQL의SET커멘드와 같습니다. 이하에 예를 나타냅니다.
SELECT set_config('log_statement_stats', 'off', false);
set_config
------------
off
(1 row)
Table 9-46에 나타내는 함수는, 제어용 시그널을 다른 서버 프로세스에 송신합니다. 이러한 함수의 사용은 슈퍼 유저에만 제한되고 있습니다.
Table 9-46. 서버 시그널 송신 함수
| 이름 | 반환형 | 설명 |
|---|---|---|
pg_cancel_backend(pid int)
|
boolean | 백엔드의 현재의 쿼리를 취소한다 |
pg_reload_conf()
|
boolean | 서버 프로세스에의해 환경설정 파일을 다시 로드한다 |
pg_rotate_logfile()
|
boolean | 서버 로그 파일을 순환시킨다 |
이들 함수 각각은, 성공의 경우true(참)를 반환하고, 그렇지 않은 경우는false(거짓)를 반환합니다.
pg_cancel_backend는 쿼리 취소(SIGINT) 시그널을 프로세스ID로 식별된 백엔드 프로세스에 보냅니다.
사용중인 백엔드 프로세스 ID는pg_stat_activity뷰의procpid열로부터, 혹은ps에 의해 서버상의postgres프로세스를 리스트 하는 것으로 찾아낼 수 있습니다.
pg_reload_conf는SIGHUP시그널을 서버에 보내, 그 결과 모든 서버 프로세스가 환경설정 파일을 재로드하게 됩니다.
pg_rotate_logfile는 로그 파일 관리자에게 즉석에서 신규 출력 파일에 변환신호를 보냅니다.
이것은 redirect_stderr이 로깅을 하기위해 사용될 경우에만 유효합니다.
사용되고 있지 않은 경우는, 로그 파일 관리자의 서브프로세스가 존재하지 않기 때문입니다.
Table 9-47에 나타내는 함수는 온라인 백업의 작성을 지원하는 것입니다. 최초의 3개의 함수의 사용은 슈퍼 유저에게 제한되고 있습니다.
Table 9-47. 백업 제어 함수
| 이름 | 반환형 | 설명 |
|---|---|---|
pg_start_backup(label text)
|
text | 온라인 백업의 실행을 설정 |
pg_stop_backup()
|
text | 온라인 백업의 실행을 정지 |
pg_switch_xlog()
|
text | 새로운 트랜잭션(transaction) 로그 파일에의 강제 이행 |
pg_current_xlog_location()
|
text | 현재의 트랜잭션(transaction) 로그의 기입 위치를 입수 |
pg_current_xlog_insert_location()
|
text | 현재의 트랜잭션(transaction) 로그의 삽입 위치를 입수 |
pg_xlogfile_name_offset(location text)
|
text, integer | 트랜잭션(transaction) 로그의 위치를 나타내는 문자열을, 파일명과 파일내의 10진의 바이트 오프셋(offset)으로 변환 |
pg_xlogfile_name(location text)
|
text | 트랜잭션(transaction) 로그의 위치를 나타내는 문자열을 파일명으로 변환 |
pg_start_backup는, 유저가 임의에 정의한 백업 라벨인, 파라미터를 1개받아들입니다(통상, 저장에 사용하는 백업 덤프 파일에 연관된 이름을 붙일 수 있습니다).
이 함수는, 데이터베이스 클러스터의 데이터 디렉토리에 백업 라벨 파일을 작성하고, 백업을 시작하는 트랜잭션(transaction) 로그의 위치를 텍스트 형식으로 반환합니다.
유저는 이 결과값에 주의할 필요는 없습니다. 그러나, 사용되는 일도 있기 때문에 이 값이 제공되고 있습니다.
postgres=# select pg_start_backup('label_goes_here');
pg_start_backup
-----------------
0/D4445B8
(1 row)
pg_stop_backup는,pg_start_backup로 작성된 라벨 파일을 삭제하고, 대신에, 트랜잭션(transaction) 로그 격납 영역에 백업 이력 파일을 작성합니다.
이력 파일에는pg_start_backup로 부여된 라벨, 백업의 트랜잭션(transaction) 로그의 위치의 개시 위치, 종료 위치, 백업 개시시각, 종료시각이 포함됩니다.
반환값은, 백업의 종료 트랜잭션(transaction) 로그의 위치입니다(이것도 이와 같이 드물게 사용되는 일이 있습니다).
종료 위치를 통지한 후, 현재의 트랜잭션(transaction) 로그의 삽입 위치는 자동적으로, 다음의 트랜잭션(transaction) 로그에 진행됩니다.
그러므로, 종료 트랜잭션(transaction) 로그 파일을 곧바로 아카이브(archive) 해, 백업을 완료시킬 수가 있습니다.
pg_switch_xlog는, 다음의 트랜잭션(transaction) 로그 파일로 이동해, 현재의 파일을 아카이브(archive) 할 수 있도록 합니다. (아카이브(archive)를 계속해 사용하는 것을 전제로 합니다. )
결과는, 완료한 현재의 트랜잭션(transaction) 로그 파일내의 종료 트랜잭션(transaction) 로그의 위치입니다.
전회의 트랜잭션(transaction) 로그 파일의 변환으로부터 트랜잭션(transaction) 로그에 변화가 없으면,pg_switch_xlog는 아무것도 실시하지 않고, 전회의 트랜잭션(transaction) 로그 파일의 종료 위치를 반환합니다.
pg_current_xlog_location는, 상기의 함수로 사용되는 서식과 같은 서식에서 현재의 트랜잭션(transaction) 로그의 기입 위치를 표시합니다.
이과 같이pg_current_xlog_insert_location는, 현재의 트랜잭션(transaction) 로그의 삽입 위치를 표시합니다.
삽입 위치는 "논리적"인 임의의 자기연출의 트랜잭션(transaction) 로그의 종료 위치입니다.
한편, 기입 위치는, 서버의 내부 버퍼로부터 작성된 실제의 종료 위치입니다.
기입 위치는 서버 외부로부터 검증 가능하지만 종단입니다.
통상은, 부분적으로 완료한 트랜잭션(transaction) 로그 파일의 아카이브(archive) 처리를 실시하고 싶은 경우에 필요하게 되는 것입니다.
삽입 위치는 서버를 디버그 할 때에 주로 사용됩니다. 이것들은 둘다 읽기전용의 조작이며, 슈퍼 유저 권한을 필요로 하지 않습니다.
pg_xlogfile_name_offset를 사용해, 상기 어느 함수의 결과로부터도, 대응하는 트랜잭션(transaction) 로그 파일과 바이트 오프셋(offset)를 추출할 수 있습니다.
이하에 예를 나타냅니다.
postgres=# select * from pg_xlogfile_name_offset(pg_stop_backup());
file_name | file_offset
--------------------------+-------------
00000001000000000000000D | 4039624
(1 row)
같이pg_xlogfile_name은, 트랜잭션(transaction) 로그 파일명만을 추출합니다.
지정한 트랜잭션(transaction) 로그의 위치가 정확하게 트랜잭션(transaction) 로그 파일의 경계에서 만났을 경우, 이러한 양함수는 전의 트랜잭션(transaction) 로그 파일의 이름을 반환합니다.
통상 이것은, 트랜잭션(transaction) 로그 파일의 아카이브(archive) 동작에서는 선호되는 동작입니다.
전의 파일이 현재의 아카이브(archive)로 필요로 하는 마지막 파일이기 때문입니다.
이러한 함수의 올바른 사용 방법에 대해서는,Section 23.3을 참조해 주세요.
Table 9-48그리고 나타난 함수는 데이터베이스 오브젝트의 실제의 디스크 영역을 계산합니다.
Table 9-48. 데이터베이스 오브젝트 용량 함수
| 이름 | 반환형 | 설명 |
|---|---|---|
pg_column_size(any) |
int | 특정의 값을 저장하는데 사용되는(가능한 경우, 압축된) 바이트수 |
pg_database_size(oid)
|
bigint | 지정된 OID를 가지는 데이터베이스로 사용되는 디스크 영역 |
pg_database_size(name)
|
bigint | 지정된 이름을 가지는 데이터베이스로 사용되는 디스크 영역 |
pg_relation_size(oid)
|
bigint | 지정된 OID를 가지는 테이블 혹은 인덱스로 사용되는 디스크 영역 |
pg_relation_size(text)
|
bigint | 지정된 이름을 가지는 테이블 혹은 인덱스로 사용되는 디스크 영역. 테이블명은 스키마명으로 수식 가능 |
pg_size_pretty(bigint)
|
text | 바이트 단위의 사이즈를 지정 사이즈의 가독성이 높은 서식으로 변환 |
pg_tablespace_size(oid)
|
bigint | 지정된 OID를 가지는 테이블스페이스에서 사용되는 디스크 영역 |
pg_tablespace_size(name)
|
bigint | 지정된 이름을 가지는 테이블스페이스에서 사용되는 디스크 영역 |
pg_total_relation_size(oid)
|
bigint | 특정된 OID를 가지는 테이블로 사용되는 디스크 영역에서, 인덱스와 toast 된 데이터를 포함한다 |
pg_total_relation_size(text)
|
bigint | 특정된 이름을 가지는 테이블로 사용되는 디스크 영역에서, 인덱스와 toast 된 데이터를 포함한다. 테이블명은 스키마명으로 수식 가능 |
pg_column_size는 어떤 개별의 데이터값을 저장하는데도 사용되는 영역을 나타냅니다.
pg_database_size와pg_tablespace_size는 데이터베이스 또는 테이블스페이스의 이름 또는 OID를 접수해 거기서 사용되는 총용량을 반환합니다.
pg_relation_size는 OID 혹은 테이블명, 인덱스 혹은 toast 테이블을 받아들여 바이트 단위의 용량을 반환합니다.
pg_size_pretty는, 적절히 kB, MB, GB, 혹은 TB단위를 사용해 눈으로 봐서도 알도록, 그 외의 함수의 하나의 결과를 정형하는데 사용할 수가 있습니다.
pg_total_relation_size는, 테이블 또는 TOAST 테이블의 OID 또는 이름을 받아들여 데이터 및 관련하는 인덱스, TOAST 테이블의 총용량을 바이트 단위로 반환합니다.
Table 9-49에 있는 함수는 서버를 호스팅 하고 있는 머신상의 파일에 대해, 파일 액세스를 제공합니다. 데이터베이스 클러스터 디렉토리와log_directory에 존재하는 파일만이 액세스 가능합니다. 클러스터 디렉토리내의 파일에 대해서 상대 경로를, 그리고 로그 파일에 대해서는log_directory환경 설정에 일치하는 경로를 사용해 주세요.
Table 9-49. 범용 파일 액세스 함수
| 이름 | 반환형 | 설명 |
|---|---|---|
pg_ls_dir(dirname text)
|
setof text | 디렉토리 내용의 리스트 |
pg_read_file(filename text, offset bigint, length bigint)
|
text | 텍스트 파일의 내용을 반환한다 |
pg_stat_file(filename text)
|
record | 파일 정보를 반환한다 |
pg_ls_dir는, 특별한 엔트리". ", 및 ".."(을)를 제외한, 지정된 디렉토리의 모든 이름을 반환합니다.
pg_read_file는 주어진offset로 시작되어, 최대length바이트(최초로 파일의 끝에 도달하면 이것보다 적게 됩니다만) 텍스트 파일의 일부분을 반환합니다.
offset가 음수의 경우에는 파일의 끝부터 읽어냅니다.
pg_stat_file는 파일 용량, 최종 액세스 시각, 최종 갱신 시각, 마지막에 시각을 변경한 file status(이것은 Unix 플랫폼만), 파일 작성 시각(Windows만) 및 만약 디렉토리이면 그것을 나타내는boolean를 반환합니다.
전형적인 사용법을 나타냅니다.
SELECT * FROM pg_stat_file('filename');
SELECT (pg_stat_file('filename')). modification;
Table 9-50에 나타내는 함수는 권고적 락을 관리합니다. 이러한 함수의 적절한 사용 방법에 대한 자세한 것은,Section 12.3.4을 참조해 주세요.
Table 9-50. 권고적 락용 함수
| 이름 | 반환형 | 설명 |
|---|---|---|
pg_advisory_lock(key bigint)
|
void | 배타 권고적 락을 획득 |
pg_advisory_lock(key1 int, key2 int)
|
void | 배타 권고적 락을 획득 |
pg_advisory_lock_shared(key bigint)
|
void | 공유 권고적 락을 획득 |
pg_advisory_lock_shared(key1 int, key2 int)
|
void | 공유 권고적 락을 획득 |
pg_try_advisory_lock(key bigint)
|
boolean | 가능하면 배타 권고적 락을 획득 |
pg_try_advisory_lock(key1 int, key2 int)
|
boolean | 가능하면 배타 권고적 락을 획득 |
pg_try_advisory_lock_shared(key bigint)
|
boolean | 가능하면 공유 권고적 락을 획득 |
pg_try_advisory_lock_shared(key1 int, key2 int)
|
boolean | 가능하면 공유 권고적 락을 획득 |
pg_advisory_unlock(key bigint)
|
boolean | 배타 권고적 락을 푼다 |
pg_advisory_unlock(key1 int, key2 int)
|
boolean | 배타 권고적 락을 푼다 |
pg_advisory_unlock_shared(key bigint)
|
boolean | 공유 권고적 락을 푼다 |
pg_advisory_unlock_shared(key1 int, key2 int)
|
boolean | 공유 권고적 락을 푼다 |
pg_advisory_unlock_all()
|
void | 현재의 세션으로 보관 유지하고 있는 권고적 락을 모두 푼다 |
pg_advisory_lock는, 애플리케이션이 정의한 자원에 락을 겁니다.
이것은, 단일의 64 비트 키치, 또는, 2개의 32 비트 키(이 2개의 키 스페이스는 중복 하지 않는 것에 주의)에 의해 식별됩니다.
다른 세션이 동일 자원에 대한 락을 보관 유지하고 있는 경우, 함수는 자원이 이용 가능하게 될 때까지 대기합니다.
락은 배타 락입니다. 복수의 락 요구가 대기 상태가 됩니다. 그러므로, 동일 자원이 3회 락이 걸렸을 경우, 다른 세션을 사용할 수 있도록 해방하기 위해서는 락 해제를 3회 실시하지 않으면 안됩니다.
pg_advisory_lock_shared의 동작은pg_advisory_lock와 같습니다만, 다른 세션의 공유 락과 공유할 수 있는 락인 점이 다릅니다.
배타 락 요구만 배척됩니다.
pg_try_advisory_lock는pg_advisory_lock와 같습니다만, 이 함수의 경우, 락이 이용 가능하게 될 때까지 대기하지 않습니다.
락을 즉석에서 취득해true를 반환하는지, 락을 획득할 수 없었던 경우에false를 반환하든지 둘 중 하나입니다.
pg_try_advisory_lock_shared의 동작은 pg_try_advisory_lock와 같습니다만, 배타 락이 아닌, 공유 락의 획득을 시도합니다.
pg_advisory_unlock는, 사전에 획득한 권고적 배타 락을 해방합니다(걸었던 락을 풉니다).
락을 푸는(해방하는)데에 성공했을 경우,true를 반환합니다.
락을 실제로 보관 유지하고 있지 않는 경우,false를 반환합니다, 게다가 SQL 경고가 서버로부터 발생합니다.
pg_advisory_unlock_shared의 동작은pg_advisory_unlock와 같습니다만, 권고적 공유 락을 해방하는(푸는) 점이 다릅니다.
pg_advisory_unlock_all는, 현재의 세션으로 보관 유지하는 권고적 락을 해방합니다. (이 함수는, 클라이언트와의 접속이 의도하지 않고 끊어졌을 경우에서도, 세션 종료시에 암묵적으로 호출 됩니다.)