BUG-50968 PROJ-2765 Checkpoint Scale 매뉴얼 수정

Manuals/Altibase_trunk/kor/General_Reference-1.Data Types & Altibase Properties.md

@@ -3596,8 +3596,8 @@ Altibase 서버의 환경 설정에 관한 프로퍼티 파일은 ALTIBASE_HOME
   <td>TRANSACTION_TABLE_SIZE</td>
   </tr>
   <tr>
-  <td rowspan="17">B</td>
-  <td rowspan="17">&nbsp;</td>
+  <td rowspan="18">B</td>
+  <td rowspan="18">&nbsp;</td>
   <td>ARCHIVE_DIR</td>
   <td rowspan="6">&nbsp;</td>
   </tr>
@@ -3656,6 +3656,10 @@ Altibase 서버의 환경 설정에 관한 프로퍼티 파일은 ALTIBASE_HOME
   <td>SYSTEM</td>
   </tr>
   <tr>
+  <td>CHECKPOINT_SCALE_SINGLE_DW_BUFFER_SIZE</td>
+  <td>SYSTEM</td>
+  </tr>
+  <tr>
   <td rowspan="57">R</td>
   <td rowspan="57">&nbsp;</td>
   <td>REPLICATION_ACK_XLOG_COUNT</td>
@@ -10826,6 +10830,30 @@ Unsigned Integer
 
 현재까지 사용된 디스크 언두 테이블스페이스의 크기는 프로퍼티 SYS_UNDO_FILE_MAX_SIZE 에서 몇 퍼센트를 사용하는지 확인하고, 설정한 임계치를 초과하면 스냅샷(shapshot)은 자동으로 중지된다.
 
+#### CHECKPOINT_SCALE_SINGLE_DW_BUFFER_SIZE (단위: 바이트)
+
+##### 데이터 타입
+
+Unsigned Integer
+
+##### 기본값
+
+524288000 (500 MByte)
+
+##### 속성
+
+변경 가능, 단일 값
+
+##### 값의 범위
+
+[1 MByte, 2 Gbyte]
+
+##### 설명
+
+체크포인트 스케일을 싱글로 설정했을 경우 사용하는 더블 라이트 파일의 크기를 설정하는 프로퍼티이다. 이는 곧 더티 페이지를 더블 라이트 하기 위한 버퍼의 크기이기도 하다.
+
+더블 라이트 방식으로 체크포인트 이미지 파일을 쓰기 위한 버퍼가 부족하다면 자동으로 풀라이트 방식으로 일시적으로 전환하여 체크포인트를 수행한다.
+
 ### 이중화 프로퍼티
 
 다음 속성값들은 데이터베이스의 이중화 기능을 위한 값들이다. 데이터베이스 이중화에 대한 자세한 내용은 *Getting Started Guide*의 데이터베이스 이중화 장과 *Replication Manual*을 참조하기 바란다.

Manuals/Altibase_trunk/kor/General_Reference-2.The Data Dictionary.md

@@ -4502,6 +4502,7 @@ iSQL> SELECT * FROM V$TAB;
 | V\$MEM_BTREE_NODEPOOL                 | 메모리 BTREE 인덱스를 위한 노드 풀 정보                      |
 | V\$MEM_RTREE_HEADER                   | 메모리 RTREE 인덱스의 헤더 정보                              |
 | V\$MEM_RTREE_NODEPOOL                 | 메모리 RTREE 인덱스를 위한 노드 풀 정보                      |
+| V$MEM_STABLE                          | 핑퐁 체크포인트 이미지 파일의 안정적인 파일 정보             |
 | V\$MEM_TABLESPACES                    | 메모리에 생성된 테이블스페이스 정보                          |
 | V\$MEM_TABLESPACE_CHECKPOINT_PATHS    | 체크포인트 발생시 반영되는 DB 파일의 위치 정보               |
 | V\$MEM_TABLESPACE_STATUS_DESC         | 메모리 테이블스페이스의 상태 정보                            |
@@ -6962,20 +6963,21 @@ RESET_LSN중 로그파일 안의 오프셋 부분을 나타낸다.
 
 로그 앵커 정보를 보여준다.
 
-| Column name               | Type        | Description                                                           |
-|---------------------------|-------------|-----------------------------------------------------------------------|
-| BEGIN_CHKPT_LFGID         | INTEGER     | 사용하지 않음(0)                                                      |
-| BEGIN_CHKPT_FILE_NO       | INTEGER     | 가장 최근 수행된 체크포인트의 체크포인트 시작 로그의 로그 파일 번호   |
-| BEGIN_CHKPT_FILE_OFFSET   | INTEGER     | 가장 최근 수행된 체크포인트의 체크포인트 시작 로그의 로그 오프셋      |
-| END_CHKPT_LFGID           | INTEGER     | 사용하지 않음(0)                                                      |
-| END_CHKPT_FILE_NO         | INTEGER     | 가장 최근 수행된 체크포인트의 체크포인트 종료 로그의 로그 파일 번호   |
-| END_CHKPT_FILE_OFFSET     | INTEGER     | 가장 최근 수행된 체크포인트의 체크포인트 종료 로그의 로그 오프셋      |
-| SERVER_STATUS             | VARCHAR(15) | 서버의 상태를 나타낸다.                                               |
-| ARCHIVELOG_MODE           | VARCHAR(12) | 데이터베이스의 아카이브 로그 모드 여부                                |
-| TRANSACTION_SEGMENT_COUNT | INTEGER     | 언두 테이블스페이스에 생성할 트랜잭션 세그먼트의 개수                 |
-| OLDEST_LFGID              | INTEGER     | 사용하지 않음(0)                                                      |
-| OLDEST_LOGFILE_NO         | INTEGER     | 재구동 복구 시에 디스크 관련 리두가 시작되는 로그 파일 번호           |
+| Column name               | Type        | Description                                                  |
+| ------------------------- | ----------- | ------------------------------------------------------------ |
+| BEGIN_CHKPT_LFGID         | INTEGER     | 사용하지 않음(0)                                             |
+| BEGIN_CHKPT_FILE_NO       | INTEGER     | 가장 최근 수행된 체크포인트의 체크포인트 시작 로그의 로그 파일 번호 |
+| BEGIN_CHKPT_FILE_OFFSET   | INTEGER     | 가장 최근 수행된 체크포인트의 체크포인트 시작 로그의 로그 오프셋 |
+| END_CHKPT_LFGID           | INTEGER     | 사용하지 않음(0)                                             |
+| END_CHKPT_FILE_NO         | INTEGER     | 가장 최근 수행된 체크포인트의 체크포인트 종료 로그의 로그 파일 번호 |
+| END_CHKPT_FILE_OFFSET     | INTEGER     | 가장 최근 수행된 체크포인트의 체크포인트 종료 로그의 로그 오프셋 |
+| SERVER_STATUS             | VARCHAR(15) | 서버의 상태를 나타낸다.                                      |
+| ARCHIVELOG_MODE           | VARCHAR(12) | 데이터베이스의 아카이브 로그 모드 여부                       |
+| TRANSACTION_SEGMENT_COUNT | INTEGER     | 언두 테이블스페이스에 생성할 트랜잭션 세그먼트의 개수        |
+| OLDEST_LFGID              | INTEGER     | 사용하지 않음(0)                                             |
+| OLDEST_LOGFILE_NO         | INTEGER     | 재구동 복구 시에 디스크 관련 리두가 시작되는 로그 파일 번호  |
 | OLDEST_LOGFILE_OFFSET     | INTEGER     | 재구동 복구 시에 디스크 관련 리두가 시작되는 로그 파일 오프셋(offset) |
+| CHECKPOINT_SCALE          | VARCHAR(12) | 핑퐁 체크포인트 스케일 설정                                  |
 
 #### 칼럼 정보
 
@@ -6992,9 +6994,15 @@ RESET_LSN중 로그파일 안의 오프셋 부분을 나타낸다.
 데이터베이스의 아카이브 로그 모드 여부를 나타낸다.
 
 -   ARCHIVE: 이 모드에서는 미디어 복구 수행에 사용하기 위해 불필요한 로그 파일이 별도의 디렉터리에 저장된다.
-
 -   NOARCHIVE: 이 모드에서는 불필요한 로그 파일이 삭제된다.
 
+##### CHECKPOINT_SCALE
+
+핑퐁 체크포인트를 수행할 때 체크포인트 이미지를 유지하는 방식을 나타낸다.
+
+* PAIR: 체크포인트 이미지 파일이 생성되면 파일들을 전부 유지한다.
+* SINGLE: 가장 최신의 체크포인트 이미지 파일 하나만을 유지한다.
+
 ### V\$LOCK_WAIT
 
 시스템에서 수행되는 트랜잭션 간의 대기 정보를 나타낸다.
@@ -7507,12 +7515,37 @@ RTREE 인덱스에 할당된 노드의 총 수를 나타낸다.
 
 RTREE 인덱스에서 사용되었던 노드가 삭제 대기중인 노드 수를 나타낸다.
 
+### V\$MEM_STABLE
+
+핑퐁 체크포인트 이미지 파일의 안정적인 파일 정보를 보여준다.
+
+| Column name | Type         | Description                                 |
+| ----------- | ------------ | ------------------------------------------- |
+| SPACE_ID    | INTEGER      | 테이블스페이스 식별자                       |
+| SPACE_NAME  | VARCHAR(512) | 테이블스페이스 이름                         |
+| FILE_NUM    | INTEGER      | 체크포인트 이미지 파일의 번호               |
+| CURRENT_DB  | INTEGER      | 안정적인 체크포인트 이미지 파일의 핑퐁 번호 |
+
+#### 칼럼 정보
+
+##### FILE_NUM
+
+체크포인트 이미지 파일의 번호를 나타낸다.
+
+##### CURRENT_DB
+
+안정적인 체크포인트 이미지 파일의 핑퐁 번호를 나타낸다.
+
+체크포인트 스케일이 페어로 설정된 경우, CURRENT_DB 값은 테이블스페이스 단위로 동일하기 때문에 FILE_NUM 값이 0번에 해당하는 레코드만 출력한다.
+
+체크포인트 스케일이 싱글로 설정된 경우, CURRENT_DB 값은 체크포인트 이미지 파일 단위로 다르기 때문에 모든 체크포인트 이미지 파일에 대한 레코드가 출력된다.
+
 ### V\$MEM_TABLESPACES
 
 메모리에 생성된 테이블스페이스 정보를 보여준다.
 
 | Column name         | Type         | Description                                       |
-|---------------------|--------------|---------------------------------------------------|
+| ------------------- | ------------ | ------------------------------------------------- |
 | SPACE_ID            | INTEGER      | 테이블스페이스 식별자                             |
 | SPACE_NAME          | VARCHAR(512) | 테이블스페이스 이름                               |
 | SPACE_STATUS        | INTEGER      | 테이블스페이스 상태                               |
@@ -7528,7 +7561,7 @@ RTREE 인덱스에서 사용되었던 노드가 삭제 대기중인 노드 수
 | ALLOC_PAGE_COUNT    | BIGINT       | 테이블스페이스의 전체 페이지 개수                 |
 | FREE_PAGE_COUNT     | BIGINT       | 테이블스페이스의 프리(Free) 페이지 개수           |
 | RESTORE_TYPE        | BIGINT       | 메모리에 테이블스페이스를 올리는 방법             |
-| CURRENT_DB          | INTEGER      | 핑퐁 체크포인트 대상 파일 집합                    |
+| CURRENT_DB          | INTEGER      | 핑퐁 체크포인트 대상 파일 집합 ???                |
 | HIGH_LIMIT_PAGE     | BIGINT       | 테이블스페이스가 가질 수 있는 최대 페이지 개수    |
 | PAGE_COUNT_PER_FILE | BIGINT       | 데이터베이스 이미지 파일당 페이지 개수            |
 | PAGE_COUNT_IN_DIS K | INTEGER      | 디스크에 존재하는 페이지의 개수                   |
@@ -7595,7 +7628,9 @@ Altibase는 핑퐁 체크포인트 방식을 사용하기 때문에 각 데이
 
 ##### CURRENT_DB
 
-체크포인트 시 더티 페이지 (Dirty Page, 변경된 페이지)가 내려가는 데이터베이스 이미지 파일 그룹으로 0 혹은 1 값을 가진다.
+체크포인트 스케일이 페어로 설정된 경우, CURRENT_DB 값은 가장 최근에 갱신 또는 생성된 안정적인 체크포인트 이미지 파일 그룹의 핑퐁 번호(0 혹은 1)값을 나타낸다.
+
+체크포인트 스케일이 싱글로 설정된 경우, -1로 나오며 해당 값은 V$MEM_STABLE 테이블을 이용해 확인해야 한다.
 
 ##### HIGH_LIMIT_PAGE
 

Manuals/Altibase_trunk/kor/SQL Reference.md

@@ -2423,7 +2423,7 @@ Two-pass sort 조인을 사용해서 명시된 테이블을 조인하도록 지
 
 **alter_database :: =**
 
-![](media/SQL/97f0082b35f7c7b2023c79e718472981.png)
+![](media/SQL/alter_database.png)
 
 
 
@@ -2511,6 +2511,10 @@ Two-pass sort 조인을 사용해서 명시된 테이블을 조인하도록 지
 
 ![](media/SQL/8df50a0b0a940bcf36d59c734118d74c.png)
 
+**checkpoint_scale_clause ::=**
+
+![](media/SQL/checkpoint_scale_clause.png)
+
 #### 전제 조건
 
 ALTER DATABASE구문은 Altibase 다단계 구동에서 서비스 전 단계에서 SYS 사용자가 –sysdba 관리자 모드로 접속한 후 수행할 수 있다. 단 SESSION CLOSE 의 경우에는 –sysdba 모드로 접속하지 않아도 사용할 수 있다.
@@ -2733,11 +2737,21 @@ change_tracking_clause
 
 증분 백업을 위한 페이지 변경 추적 기능의 활성화 또는 비활성화를 지정한다.
 
-*snapshot_clauses*
+*snapshot_clause*
 
 BEGIN SNAPSHOT을 할 때의 시점을 기준 SNAPSHOT SCN으로 설정하고, 설정된 SCN을
 기준으로 iLoader를 사용하여 데이터를 EXPORT한다.
 
+*checkpoint_scale_clause*
+
+CONTROL 구동 단계에서 수행하는 핑퐁 체크포인트의 체크포인트 스케일 설정을 변경한다. ??
+
+CHECKPOINT SCALE PAIR 는 생성된 모든 체크포인트 이미지 파일을 유지한다.
+
+CHECKPOINT SCALE SINGLE은 가장 최근의 체크포인트 이미지 파일 1개를 유지한다.
+
+체크포인트 스케일 설정을 변경하는 경우 체크포인트 이미지 파일을 일부 삭제하거나, 또는 복사하여 생성할 수 있다.
+
 #### 예제
 
 \<질의\> 데이터베이스 mydb를 구동하여 정상 서비스를 제공하도록 한다.
@@ -5697,7 +5711,7 @@ Conjoin success.
 
 **create_database ::=**
 
-![create_database_image92](media/SQL/create_database_image92.gif)
+![create_database_image92](media/SQL/create_database.png)
 
 #### 전제 조건
 
@@ -5767,6 +5781,16 @@ Altibase 백업과 복구에 대한 자세한 정보는 *Administrator’s Manua
   UTF8  
   UTF16
 
+*checkpoint_scale_clause*
+
+핑퐁 체크포인트의 체크포인트 스케일 설정을 변경한다
+
+CHECKPOINT SCALE PAIR는 생성된 모든 체크포인트 이미지 파일을 유지한다.
+
+CHECKPOINT SCALE SINGLE은 가장 최근의 체크포인트 이미지 파일 1개를 유지한다.
+
+만약 체크포인트 스케일을 지정하지 않을 경우  CHECKPOINT SCALE PAIR가 자동으로 설정된다.
+
 #### 예제
 
 \<질의\> 이름이 mydb이고, 데이터베이스 캐릭터 셋은 KSC5601, 내셔널 캐릭터 셋은

Manuals/Altibase_trunk/kor/Utilities Manual.md

@@ -151,6 +151,7 @@ Copyright ⓒ 2001~2023 Altibase Corp. All Rights Reserved.<br>
   - [dumpct](#dumpct)
   - [dumpdb](#dumpdb)
   - [dumpddf](#dumpddf)
+  - [dumpdwf](#dumpdwf)
   - [dumpla](#dumpla)
   - [dumplf](#dumplf)
   - [dumptrc](#dumptrc)
@@ -4097,6 +4098,106 @@ DataFileDescSlot ID           [ 1, 2 ]
 
 
 
+## dumpdwf
+
+### 개요
+
+dumpdwf는 더블 라이트(Double Write) 파일의 메타, 헤더 정보 또는 기록된 페이지의 페이지 번호를 출력한다.
+
+```
+dumpdwf {-f double_write_file_name} {-p} {-s}
+```
+
+### 구문
+
+![dumpdwf](media/Utilities/dumpdwf.png)
+
+### 파라미터
+
+| 파라미터 | 설명                                                         |
+| -------- | :----------------------------------------------------------- |
+| \-f      | 정보를 얻고 싶은 더블 라이트 파일의 이름으로 이 옵션은 반드시 입력해야 한다. 생략하면 dumpdwf는 에러 메시지를 출력하고 종료한다. |
+| \-p      | 더블 라이트 파일에 기록된 페이지의 페이지 번호를 출력한다.   |
+| \-s      | 정보를 출력하지 않고 오류 메세지만 출력한다.                 |
+
+### 설명
+
+더블 라이트 파일의 메타, 헤더 정보 또는 기록된 페이지의 페이지 번호를 출력한다.
+
+### 사용예
+
+쉘 프롬프트 상에서 다음과 같이 수행한다.
+
+```
+$ dumpdwf -f SYS_DOUBLE_WRITE
+$ dumpdwf -f SYS_DOUBLE_WRITE -p
+```
+
+
+
+### 출력 항목
+
+다음은 dumpdwf의 출력 예이다.
+
+```
+[DOUBLE WRITE META]
+  Version                   1 
+  FileSize          524361728 
+  MaxPageCount          16000 
+  PageListPerUnit        8192 
+  PIDListPageCount          2 
+  FootPrint        :
+616c7469 62617365 20646f75 626c6520 77726974 65206669 6c65206d 65746100 ; altibase double write file meta.
+
+[DOUBLE WRITE HEADER]
+  KeyLSN                    0.6159017    
+  NextRedoLSN               0.6487449    
+  RedoLSN                   0.6158960    
+  PageCount                 1 
+  FileInfo         
+    SpaceID                 0 
+    PingPongNum             1 
+    FileNum                 0 
+  Status           WRITTEN
+
+[DOUBLE WRITE PAGE INFO]
+  [     1] PID: 127
+```
+
+출력 내용 중, 필드들은 다음과 같은 의미를 갖는다.
+
+##### [DOUBLE WRITE META]
+
+| 필드 이름        | 설명                                                   |
+| ---------------- | ------------------------------------------------------ |
+| Version          | 더블 라이트 파일의 버전                                |
+| FileSize         | 더블 라이트 파일의 크기                                |
+| MaxPageCount     | 더블 라이트 파일에 기록할 수 있는 페이지의 최대 개수   |
+| PageListPerUnit  | 페이지 번호 저장을 위한 단위 크기당 페이지 번호의 개수 |
+| PIDListPageCount | 페이지 번호 저장을 위한 단위 크기의 개수               |
+| FootPrint        | 더블 라이트 파일 구분을 위한 임의의 변수               |
+
+##### [DOUBLE WRITE HEADER]
+
+| 필드 이름    | 설명                                                         |
+| ------------ | ------------------------------------------------------------ |
+| KeyLSN       | 더블 라이트 시점을 확인하기 위한 LSN<br>더블 라이트 시점의 마지막 Checkpoint End 로그가 기록된 LSN을 기록한다. KeyLSN 과 마지막 Checkpoint End LSN 이 동일하지 않은 경우 더블 라이트 리커버리는 수행되지 않는다. |
+| NextRedoLSN  | 체크포인트 이미지에 더티 페이지가 모두 기록되었을 때의 Redo LSN |
+| RedoLSN      | 체크포인트 이미지에 더티 페이지를 기록하기 전의 Redo LSN<br>Redo LSN 과 체크포인트 이미지 헤더의 Redo LSN 이 동일하지 않은 경우 더블 라이트 리커버리는 수행되지 않는다. |
+| PageCount    | 더블 라이트 파일에 기록되어 있는 더티 페이지의 개수          |
+| **FileInfo** | 더블 라이트가 수행된 체크포인트 이미지 파일에 대한 정보      |
+| SpaceID      | 더블 라이트가 수행된 체크포인트 이미지 파일의 테이블스페이스 번호 |
+| PingPongNum  | 더블 라이트가 수행된 체크포인트 이미지 파일의 핑퐁 체크포인트 번호 |
+| FileNum      | 더블 라이트가 수행된 체크포인트 이미지 파일의 파일 번호      |
+| Status       | 더블 라이트 파일의 상태로 WRITTEN 인 경우 더블 라이트 리커버리가 필요하다. EMPTY 인 경우 더티 페이지가 기록되어 있지 않은 상태이므로 더블 라이트 리커버리는 필요하지 않다. |
+
+##### [DOUBLE WRITE PAGE INFO]
+
+| 필드 이름 | 설명                                                     |
+| --------- | -------------------------------------------------------- |
+| [번호]    | 출력 순서를 나타내는 번호이다.                           |
+| PID: 번호 | 더블 라이트 파일에 기록된 더티 페이지의 페이지 번호이다. |
+
 ## dumpla
 
 ### 개요