25.5.14 ndb_index_stat — NDB Index Statistics Utility

25.5.14 ndb_index_stat — NDB Index Statistics Utility

ndb_index_stat은 NDB 테이블의 인덱스에 대해 fragment별 통계 정보를 제공합니다. 여기에는 캐시 버전과 수명, 파티션당 인덱스 엔트리 수, 그리고 인덱스가 사용하는 메모리 양이 포함됩니다.

Usage

특정 NDB 테이블에 대한 기본 인덱스 통계를 얻으려면, 테이블 이름을 첫 번째 인자로 사용하고, 그 뒤에 이 테이블을 포함하는 데이터베이스 이름을 --database (-d) 옵션을 사용하여 바로 지정하여, 다음과 같이 ndb_index_stat을 호출합니다:

1ndb_index_stat table -d database

이 예제에서는, test 데이터베이스 안에 있는 mytable이라는 이름의 NDB 테이블에 대해, 이와 같은 정보를 얻기 위해 ndb_index_stat을 사용합니다:

1$> ndb_index_stat -d test mytable
2table:City index:PRIMARY fragCount:2
3sampleVersion:3 loadTime:1399585986 sampleCount:1994 keyBytes:7976
4query cache: valid:1 sampleCount:1994 totalBytes:27916
5times in ms: save: 7.133 sort: 1.974 sort per sample: 0.000

sampleVersion은 통계 데이터가 가져온 캐시의 버전 번호입니다. --update 옵션을 사용하여 ndb_index_stat을 실행하면 sampleVersion이 증가합니다.

loadTime은 캐시가 마지막으로 갱신된 시점을 나타냅니다. 이는 유닉스 에포크 이후의 초 단위 값으로 표현됩니다.

sampleCount는 파티션당 발견된 인덱스 엔트리 수입니다. 이를 fragment 수(fragCount로 표시됨)와 곱하여 전체 엔트리 수를 추정할 수 있습니다.

sampleCount는 SHOW INDEX나 INFORMATION_SCHEMA.STATISTICS의 카디널리티와 비교할 수 있지만, 후자의 둘은 테이블 전체에 대한 뷰를 제공하는 반면, ndb_index_stat은 fragment별 평균을 제공합니다.

keyBytes는 인덱스에서 사용되는 바이트 수입니다. 이 예제에서 프라이머리 키는 정수이며, 각 인덱스에 4바이트가 필요하므로, 이 경우 keyBytes는 다음과 같이 계산될 수 있습니다:

1    keyBytes = sampleCount * (4 bytes per index) = 1994 * 4 = 7976

이 정보는 또한 INFORMATION_SCHEMA.COLUMNS의 해당 컬럼 정의를 사용하여 얻을 수도 있습니다 (이를 위해서는 MySQL 서버와 MySQL 클라이언트 애플리케이션이 필요합니다).

totalBytes는 테이블의 모든 인덱스가 소비하는 총 메모리 양을 바이트 단위로 나타낸 것입니다.

앞선 예제에 표시된 타이밍은 ndb_index_stat의 각 호출에 대해 개별적으로 측정된 값입니다.

--verbose 옵션은 다음과 같이 약간의 추가 출력을 제공합니다:

1$> ndb_index_stat -d test mytable --verbose
2random seed 1337010518
3connected
4loop 1 of 1
5table:mytable index:PRIMARY fragCount:4
6sampleVersion:2 loadTime:1336751773 sampleCount:0 keyBytes:0
7read stats
8query cache created
9query cache: valid:1 sampleCount:0 totalBytes:0
10times in ms: save: 20.766 sort: 0.001
11disconnected
12
13$>

프로그램의 출력이 비어 있는 경우, 이는 아직 통계가 존재하지 않음을 나타낼 수 있습니다. 통계가 생성되도록 (또는 이미 존재하는 경우 갱신되도록) 강제하려면, --update 옵션을 사용하여 ndb_index_stat을 호출하거나, mysql 클라이언트에서 해당 테이블에 대해 ANALYZE TABLE을 실행하십시오.

Options

다음 표에는 NDB Cluster ndb_index_stat 유틸리티에 특화된 옵션이 나와 있습니다. 추가 설명은 표 뒤에 나와 있습니다.

• --character-sets-dir

Property	Value
Command-Line Format	--character-sets-dir=path

캐릭터 세트가 들어 있는 디렉터리입니다.

• --connect-retries

Property	Value
Command-Line Format	--connect-retries=#
Type	Integer
Default Value	12
Minimum Value	0
Maximum Value	12

포기하기 전에 커넥션을 재시도할 횟수입니다.

• --connect-retry-delay

Property	Value
Command-Line Format	--connect-retry-delay=#
Type	Integer
Default Value	5
Minimum Value	0
Maximum Value	5

매니지먼트 서버에 접속 시도 사이에 대기할 초 단위 시간입니다.

• --connect-string

Property	Value
Command-Line Format	--connect-string=connection_string
Type	String
Default Value	[none]

--ndb-connectstring과 동일합니다.

• --core-file

Property	Value
Command-Line Format	--core-file

에러 발생 시 코어 파일을 작성합니다. 디버깅에 사용됩니다.

• --database=name, -d name

Property	Value
Command-Line Format	--database=name
Type	String
Default Value	[none]
Minimum Value	``
Maximum Value	``

조회 중인 테이블이 포함된 데이터베이스 이름입니다.

• --defaults-extra-file

Property	Value
Command-Line Format	--defaults-extra-file=path
Type	String
Default Value	[none]

글로벌 파일을 읽은 후 지정된 파일을 읽습니다.

• --defaults-file

Property	Value
Command-Line Format	--defaults-file=path
Type	String
Default Value	[none]

지정된 파일에서만 디폴트 옵션을 읽습니다.

• --defaults-group-suffix

Property	Value
Command-Line Format	--defaults-group-suffix=string
Type	String
Default Value	[none]

concat(group, suffix)로 된 그룹도 읽습니다.

• --delete

Property	Value
Command-Line Format	--delete

지정된 테이블에 대한 인덱스 통계를 삭제하고, 이전에 설정되었던 자동 갱신을 중지합니다.

• --dump

Property	Value
Command-Line Format	--dump

쿼리 캐시의 내용을 덤프합니다.

• --help

Property	Value
Command-Line Format	--help

도움말 텍스트를 표시하고 종료합니다.

• --login-path

Property	Value
Command-Line Format	--login-path=path
Type	String
Default Value	[none]

로그인 파일에서 지정된 경로를 읽습니다.

• --no-login-paths

Property	Value
Command-Line Format	--no-login-paths

로그인 경로 파일에서 옵션을 읽지 않습니다.

• --loops=#

Property	Value
Command-Line Format	--loops=#
Type	Numeric
Default Value	0
Minimum Value	0
Maximum Value	MAX_INT

명령을 지정된 횟수만큼 반복합니다 (테스트용).

• --ndb-connectstring

Property	Value
Command-Line Format	--ndb-connectstring=connection_string
Type	String
Default Value	[none]

ndb_mgmd에 접속하기 위한 커넥션 문자열을 설정합니다. 구문: [nodeid=id;][host=]hostname[:port]. NDB_CONNECTSTRING과 my.cnf에 있는 항목을 무시합니다.

• --ndb-mgm-tls

Property	Value
Command-Line Format	--ndb-mgm-tls=level
Type	Enumeration
Default Value	relaxed
Valid Values	relaxed<br>strict

매니지먼트 서버에 접속할 때 요구되는 TLS 지원 수준을 설정합니다. 값은 relaxed 또는 strict 중 하나입니다. 기본값인 relaxed는 TLS 커넥션을 시도하지만 성공이 필수는 아님을 의미합니다. strict는 접속에 TLS가 필수임을 의미합니다.

• --ndb-mgmd-host

Property	Value
Command-Line Format	--ndb-mgmd-host=connection_string
Type	String
Default Value	[none]

--ndb-connectstring과 동일합니다.

• --ndb-nodeid

Property	Value
Command-Line Format	--ndb-nodeid=#
Type	Integer
Default Value	[none]

이 노드의 노드 ID를 설정합니다. 이는 --ndb-connectstring에 의해 설정된 어떤 ID도 무시합니다.

• --ndb-optimized-node-selection

Property	Value
Command-Line Format	--ndb-optimized-node-selection

트랜잭션을 위한 노드 선택 최적화를 활성화합니다. 기본적으로 활성화되어 있으며, 비활성화하려면 --skip-ndb-optimized-node-selection을 사용합니다.

• --ndb-tls-search-path

Property	Value
Command-Line Format	--ndb-tls-search-path=list
Type	Path name
Default Value (Unix)	$HOME/ndb-tls
Default Value (Windows)	$HOMEDIR/ndb-tls

CA 파일을 검색할 디렉터리 목록을 지정합니다. 유닉스 플랫폼에서 디렉터리 이름은 콜론(:)으로 구분되며, Windows 시스템에서는 세미콜론(;) 문자가 구분자로 사용됩니다. 디렉터리 참조는 상대 또는 절대일 수 있습니다. 각 디렉터리는 하나 이상의 환경 변수를 포함할 수 있고, 각 환경 변수는 접두사 달러 기호($)로 표시되며 사용 전에 확장됩니다.

검색은 가장 왼쪽에 위치한 디렉터리부터 시작하여, 파일이 발견될 때까지 왼쪽에서 오른쪽으로 진행됩니다. 빈 문자열은 빈 검색 경로를 의미하며, 이 경우 모든 검색이 실패합니다. 단일 점(.)으로 구성된 문자열은 검색 경로가 현재 작업 디렉터리로 제한됨을 나타냅니다.

검색 경로가 제공되지 않으면, 컴파일 시에 설정된 기본값이 사용됩니다. 이 값은 사용하는 플랫폼에 따라 달라집니다. Windows에서는 \ndb-tls이고, 기타 플랫폼(Linux 포함)에서는 $HOME/ndb-tls입니다. 이는 -DWITH_NDB_TLS_SEARCH_PATH를 사용하여 NDB Cluster를 컴파일함으로써 재정의할 수 있습니다.

• --no-defaults

Property	Value
Command-Line Format	--no-defaults

로그인 파일 이외의 어떤 옵션 파일에서도 디폴트 옵션을 읽지 않습니다.

• --print-defaults

Property	Value
Command-Line Format	--print-defaults

프로그램 인자 목록을 출력하고 종료합니다.

• --query=#

Property	Value
Command-Line Format	--query=#
Type	Numeric
Default Value	0
Minimum Value	0
Maximum Value	MAX_INT

첫 번째 키 애트리뷰트에 대해 랜덤 범위 쿼리를 수행합니다 (int unsigned여야 합니다).

• --sys-drop

Property	Value
Command-Line Format	--sys-drop

NDB 커널의 모든 통계 테이블 및 이벤트를 drop합니다. 이는 모든 통계가 손실되도록 합니다.

• --sys-create

Property	Value
Command-Line Format	--sys-create

NDB 커널에 모든 통계 테이블 및 이벤트를 생성합니다. 이는 이들 중 어느 것도 이전에 존재하지 않을 때만 동작합니다.

• --sys-create-if-not-exist

Property	Value
Command-Line Format	--sys-create-if-not-exist

프로그램이 호출될 때 이미 존재하지 않는 NDB 시스템 통계 테이블이나 이벤트(또는 둘 다)를 생성합니다.

• --sys-create-if-not-valid

Property	Value
Command-Line Format	--sys-create-if-not-valid

유효하지 않은 것들을 drop한 후, 아직 존재하지 않는 NDB 시스템 통계 테이블이나 이벤트를 생성합니다.

• --sys-check

Property	Value
Command-Line Format	--sys-check

NDB 커널에 필요한 모든 시스템 통계 테이블 및 이벤트가 존재하는지 검증합니다.

• --sys-skip-tables

Property	Value
Command-Line Format	--sys-skip-tables

어떤 통계 테이블에도 --sys-* 옵션을 적용하지 않습니다.

• --sys-skip-events

Property	Value
Command-Line Format	--sys-skip-events

어떤 이벤트에도 --sys-* 옵션을 적용하지 않습니다.

• --update

Property	Value
Command-Line Format	--update

지정된 테이블의 인덱스 통계를 갱신하고, 이전에 설정되었던 자동 갱신을 다시 시작합니다.

• --usage

Property	Value
Command-Line Format	--usage

도움말 텍스트를 표시하고 종료합니다. --help와 동일합니다.

• --verbose

Property	Value
Command-Line Format	--verbose

상세 출력(버보스 출력)을 활성화합니다.

• --version

Property	Value
Command-Line Format	--version

버전 정보를 표시하고 종료합니다.

ndb_index_stat system options.

다음 옵션은 NDB 커널의 통계 테이블을 생성하고 갱신하는 데 사용됩니다. 이들 옵션은 통계 옵션과 혼용할 수 없습니다 ( ndb_index_stat statistics options 참조).

• --sys-drop
• --sys-create
• --sys-create-if-not-exist
• --sys-create-if-not-valid
• --sys-check
• --sys-skip-tables
• --sys-skip-events

ndb_index_stat statistics options.

여기에 나열된 옵션은 인덱스 통계를 생성하는 데 사용됩니다. 이들은 주어진 테이블과 데이터베이스에 대해 동작합니다. 시스템 옵션과 혼용할 수 없습니다 ( ndb_index_stat system options 참조).

• --database
• --delete
• --update
• --dump
• --query