Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update General Reference-1.Data Types & Altibase Properties.md #467

Open
wants to merge 6 commits into
base: master
Choose a base branch
from

Conversation

Soyoon-Choi
Copy link
Collaborator

General Reference 1 국문 7.3과 대조해서

  1. 수정된 프로퍼티 단순 수정 완료 및 추가 된 국문 설명 내용 삽입
  2. 삭제된 프로퍼티 전부 삭제 완료 된 것 확인함
  3. 새로 추가된 프로퍼티 국문 내용 삽입하고 properties overview 표 수정 완료

했습니다.
이제 이 곳에서 영문 번역 로그를 볼 수 있습니다.

다만 release notes를 기반으로 수정하다가 애매한 부분이 두 군데 발견됐으니 코멘트를 확인하시고 답변 부탁드립니다.

General Reference 1 국문 7.3과 대조해서
1. 수정된 프로퍼티 단순 수정 완료 및 추가 된 국문 설명 내용 삽입
2. 삭제된 프로퍼티 전부 삭제 완료 된 것 확인함
3. 새로 추가된 프로퍼티 국문 내용 삽입하고 properties overview 표 수정 완료
@Soyoon-Choi
Copy link
Collaborator Author

MM_MSGLOG_FILE
현재 작업중인 release note에는 국문, 영문 모두 해당 프로퍼티의 기본값 1로 변경되었다고 되어 있지만
국문/영문 7.3 매뉴얼에는 altibase_mm.log로 기록(비슷한 다른 메세지로그 파일 프로퍼티도 다 로그 파일로 기본값이 등록되어 있음)
확인 필요합니다.

PARALLEL_QUERY_THREAD_MAX
PARALLEL_QUERY_QUEUE_SIZE
위의 두 프로퍼티 위치가
국문에선 기타 프로퍼티 장에, 영문에선 Performance 프로퍼티 장에 위치
확인해주시면 수정하겠습니다.

1. 릴리즈 노트 내용을 기반으로 빠진 내용 국문으로 삽입
2. 삭제된 뷰 항목 삭제
2. 목차 재생성
@Soyoon-Choi
Copy link
Collaborator Author

general reference 2 관련 확인 부탁드립니다

  1. SYS_REPLICATIONS_

1-1.
CURRENT_READ_XLOGFILE_NO
CURRENT_READ_XLOGFILE_OFFSET

두 칼럼의 설명이 누락되었습니다.(국문에도 없습니다.)

1-2.
릴리즈 노트에는 REMOTE_LAST_DDL_XSN 칼럼만 새로 삽입되었다고 설명하는데 실제 영문 매뉴얼에서는
PEER_REPLICATION_NAME
REMOTE_LAST_DDL_XSN
CURRENT_READ_XLOGFILE_NO
CURRENT_READ_XLOGFILE_OFFSET
네 칼럼이 표와 상세 설명 모두 빠져있었습니다.
단순 과거 릴리즈/패치 사항이 업데이트 안된 매뉴얼이어서 그런지, 릴리즈노트의 내용 수정이 필요한지 확인이 필요합니다.

  1. SYS_REPL_OLD_ITEMS_

REMOTE_USER_NAME
REMOTE_TABLE_NAME
REMOTE_PARTITION_NAME
PARTITION_COUNT
PARTITION_METHOD
PARTITION_ORDER
PARTITION_MIN_VALUE
PARTITION_MAX_VALUE
INVALID_MAX_SN
위의 9개 칼럼이 새로 추가되었다고 릴리즈 노트에 나와있지만 실제로는 위의 새 칼럼들과 더불어

TABLE_ID
TABLE_PARTITION_TYPE
IS_PARTITION
REPLICATION_UNIT
TBS_TYPE

이 5개의 칼럼 또한 표와 상세 설명에서 모두 빠져있었습니다.
단순 과거 릴리즈/패치 사항이 업데이트 안된 매뉴얼이어서 그런지, 릴리즈노트의 내용 수정이 필요한지 확인 필요합니다.

1. General Reference 1의 영문 초안을 작성
2. General Reference 2의 목차 오류 삭제
3. 사소한 General Reference 1 국문의 오류 수정

하나의 디스크 인덱스를 CREATE INDEX 문으로 생성하거나 ALTER INDEX ~ REBUILD 문으로 재구축할 때, 디스크 인덱스 키들을 정렬하는 용도로 사용할 최대 메모리 크기를 설정한다. 디스크 인덱스 키들의 크기만큼 메모리가 할당되며 필요한 때에 이 프로퍼티의 설정값만큼 증가한다. 디스크 인덱스를 생성(또는 재구축)하는 동안 할당된 메모리 크기는 V$MEMSTAT의 Storage_Disk_Index에서 확인할 수 있으며 동시에 생성(또는 재구축)하는 디스크 인덱스 수 * DISK_INDEX_BUILD_SORT_AREA_SIZE 만큼 메모리가 할당될 수 있다.
디스크 인덱스를 생성(또는 재구축)하는 동안 할당된 메모리 크기는 V$MEMSTAT의 Storage_Disk_Index에서 확인할 수 있으며 동시에 생성(또는 재구축)하는 디스크 인덱스 수 * DISK_INDEX_BUILD_SORT_AREA_SIZE 만큼 메모리가 할당될 수 있다.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

무엇과 '동시에'인지 설명이 필요합니다. 디스크 인덱스를 생성, 또는 재구축하는 중간에 MEMSTAT뷰로 조회를 하면 그 순간에 할당된 메모리 크기가 조회되지만 시스템 내부에서 계속 DISK_INDEX_BUILD_SORT_AREA_SIZE 프로퍼티 값만큼 더 할당되어 실제의 메모리 할당값이 조회시점보다 더 크게 변할 수 있다는 뜻일까요?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

디스크 인덱스를 생성(또는 재구축)하는 동안 할당된 메모리 크기는 V$MEMSTAT의 Storage_Disk_Index에서 확인할 수 있다. (디스크 인덱스를 생성 또는 재구축하는 동안 )할당된 메모리의 크기는 디스크 인덱스 수 * DISK_INDEX_BUILD_SORT_AREA_SIZE 만큼 (이 필요하므로) 메모리가 할당 될 수 있다. 의 뜻으로 보입니다.

'동시에'는 큰 의미 없는 단어로 보이네요~

즉, "DISK_INDEX_BUILD_SORT_AREA_SIZE" 의 국문 설명도 좀 수정되어야 할것 같네요..


이중화 송신자의 IP 주소를 설정하는 프로퍼티이다. 값으로 ANY나 IP 주소를 입력할 수 있다.
If the value is set to ANY, the default value, users can use every IP address of the local server which creates replication objects for replication communication. In this case, the IP address allocated by OS is used for the sender IP address. If the value is set to a specific IP address, users can only use that IP address when the local server communicates with a remote server(receiver). Users can set several IP addresses by adding REPLICATION_SENDER_IP = *value*. These values are used in a row. IPv4, IPv6, and IPv6 extension address formats are supported.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IPv6 확장 주소 형태 : IPv6 extension address format이라고 번역했지만 이게 IPv6 extension header format을 뜻하는 것이라면 맞게 수정하겠습니다

Altibase 7.3 Replication Manual 영문 송신자 IP 주소 설정 절 없습니다. 추후 해당 매뉴얼의 내용 보강이 필요합니다.

@@ -12781,25 +12794,25 @@ $ openssl ciphers

#### SSL_CIPHER_SUITES
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

BUG-50669에서 작업한 것이 있어 그대로 복사-붙여넣기 했습니다. #465

@@ -12879,29 +12892,29 @@ An example of this value could be $ALTIBASE_HOME/cert/server- key.pem.

#### SSL_LOAD_CONFIG
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

BUG-50669에서 작업한 것이 있어 그대로 복사-붙여넣기 했습니다. #465


This is a flag value indicating whether spatial topological(ST) information will be recorded in the altibase_st.log file.

If this value is 0, the messages are not recorded. If this value is larger than 0, the messages are recorded.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

형식을 다른 메세지로그 관련 프로퍼티 설명과 맞추기 위해 수정했습니다. 검토 부탁드립니다.

##### 설명
##### Description

This is a flag value indicating whether spatial topological(ST) information will be recorded in the altibase_st.log file.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

st에 관한 설명이 있어야 할거 같아서 Spatial topological이라고 우선 썼는데 st에 관한 정확한 풀이를 다른 매뉴얼에서도 못찾아서..맞는지 검수 부탁드립니다.

General Reference 2의 영문 초안을 작성

기존 매뉴얼에 이미 있는 내용은 그대로 쓰거나, 최대한 수정하지 않는 선에서 작성했습니다.
| REMOTE_LAST_DDL_XSN | BIGINT | 원격 서버에서 가장 최근에 처리한 DDL SN |
| CURRENT_READ_XLOGFILE_NO | INTEGER | consistent replication의 receiver가 xlogfile에서 읽은 가장 마지막 file number와 offset |
| CURRENT_READ_XLOGFILE_OFFSET | INTEGER | consistent replication의 receiver가 xlogfile에서 읽은 가장 마지막 file 내에서의 offset |
| PEER_REPLICATION_NAME | VARCHAR(40) | 로컬 이중화한 원격 이중화 이름<br />Local replicated remote replication name |
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

로컬 이중화 -> 영문 번역을 Local replication 으로 해도 될 지 확인 부탁드립니다. Replication Manual에서 로컬 이중화를 찾지 못했습니다.

| CURRENT_READ_XLOGFILE_OFFSET | INTEGER | consistent replication의 receiver가 xlogfile에서 읽은 가장 마지막 file 내에서의 offset |
| PEER_REPLICATION_NAME | VARCHAR(40) | 로컬 이중화한 원격 이중화 이름<br />Local replicated remote replication name |
| REMOTE_LAST_DDL_XSN | BIGINT | The most recently processed DDL statement's SN on the remote server |
| CURRENT_READ_XLOGFILE_NO | INTEGER | The last file number and offset that consistent replication's receiver reads on xlogfile |
Copy link
Collaborator Author

@Soyoon-Choi Soyoon-Choi Jan 5, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

국문에는 마지막 파일 넘버와 오프셋이라고 되어있는데 이건 넘버만 해당하는 게 아닌지..내용 확인 부탁드립니다.

##### LOCAL_PARTITION_NAME

원격 서버의 이중화 대상 파티션의 이름이다.

This is the name of the replication target partition on the local server.

##### REMOTE_USER_NAME

지역 서버의 이중화 대상 테이블 소유자의 사용자 이름으로, 지역 서버의 SYS_USERS_ 메타 테이블의 한 USER_NAME 값과 동일하다.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

지역<->원격 사용이 혼재되어있는 것 같고 로컬~ 칼럼의 경우 지역 서버의 뭐뭐로, 원격 서버의 뭐뭐와 동일하다/ 리모트~칼럼의 경우 원격 서버의 뭐뭐로, 지역 서버의 뭐뭐와 동일하다 형식이 되어야 할 것 같습니다. 내용 검수 부탁드립니다,

@@ -7820,17 +7825,17 @@ The actual values set for the property.

### V$QUEUE_DELETE_OFF

DELETE 문을 허용하지 않는 큐 테이블의 객체 식별자(OID) 정보를 가지고 있다. CREATE QUEUE 또는 ALTER QUEUE에서 DELETE OFF 절을 사용한 큐 테이블은 DELETE 문을 허용하지 않는다.
This view stores object identifier(OID) information of a queue table which does not allow DELETE statements. A queue table using the DELETE OFF clause in the CREATE QUEUE or ALTER QUEUE statements does not allow DELETE statements.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

DELETE문을 허용하지 않는다여서 allow를 쓰긴 했는데 DELETE statement can not be applied when users use DELETE OFF clause on the CREATE QUEUE or ALTER QUEUE statement. 도 고려..

- 0: RANGE
- 1: HASH
- 2: LIST
- 3: RANGE_USING_HASH
- 3: RANGE PARTITIONING USING HASH
- 100: NONE

##### PARTITION_COUNT
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

국문에 대사->대상 오타 있음
이 코멘트 밑의 내용이 혹시
파티션드 "테이블스페이스"를 구성하는 파티션 테이블의 총 개수 일까요..?
내용이 헷갈려서 우선 수정하지 않았습니다.

@Soyoon-Choi
Copy link
Collaborator Author

General Reference 2 관련하여 영문에는 Unsupported Meta Tables 절에 지원하지 않는 메타 테이블 리스트를 제공하고, 국문은 아예 Unsupported Meta Tables 절이 삭제되어있습니다. Unsupported Meta Tables 절을 삭제할 지 말지 의견 부탁드립니다.

@jina-altibase
Copy link
Collaborator

SYS_REPLICATIONS_ 의 2 컬럼은 삭제 되었습니다. 삭제하시면 됩니다.
1-1.
CURRENT_READ_XLOGFILE_NO
CURRENT_READ_XLOGFILE_OFFSET
1-2 아래 2 컬럼은 존재합니다.
PEER_REPLICATION_NAME
REMOTE_LAST_DDL_XSN
2.
소윤님이 언급한 5개의 컬럼은 존재하지 않아서, 작성할 필요가 없습니다~.

참고로, 컬럼들은 desc system_.테이블명; 으로 조회할 수 있습니다.


Transaction segments are created when the Altibase server starts up. If there is an insufficiency of transaction segments during transaction processing, the system logs "TRANSACTION_SEGMENT_COUNT is full" in the altibase_boot.log file. Then, transactions wait until they are allocated available transaction segments.

정리되지 않은 분산 트랜잭션이 있을 때 현재 값보다 작게 설정하고 Altibase 서버를 재시작한 경우 기존 언두 테이블스페이스의 공간에 접근할 수 없어 Altibase 서버 구동이 실패한다.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Altibase 분산 데이터베이스 시스템에서 이 프로퍼티 값을 이전 값보다 작게 설정하기를 원하면 분산 트랜잭션을 모두 종료한 후 Altibase 서버를 중지해야 한다. "
의 부연 설명으로 보이는데요,, 국문도 수정이 필요해 보이네요,, 굳이 설명에 쓰야 할지.. 모르겠지만,,, 어쨌든 부연설명을 하자면,,
"만약, 분산 트랜잭션을 모두 종료하지 않고, 이 프로퍼티의 값을 현재값(이전의 값)보다 작게 설정할 경우, 서버를 재시작할 때 Altibase 서버 구동이 실패할 수 있다. (이유: 기존 언두 스페이스의 공간에 접근할 수 없어서)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants