28.3.26 The INFORMATION_SCHEMA PARTITIONS Table

28.3.26 INFORMATION_SCHEMA PARTITIONS 테이블

PARTITIONS 테이블은 테이블 파티션에 관한 정보를 제공합니다. 이 테이블의 각 row는 파티션된 테이블의 개별 파티션 또는 서브파티션에 대응합니다. 테이블 파티셔닝에 대한 더 자세한 내용은 Chapter 26, Partitioning을 참조하십시오.

PARTITIONS 테이블에는 다음과 같은 column이 있습니다:

• TABLE_CATALOG

  테이블이 속한 카탈로그의 이름입니다. 이 값은 항상 def입니다.

• TABLE_SCHEMA

  테이블이 속한 스키마(데이터베이스)의 이름입니다.

• TABLE_NAME

  파티션을 포함하는 테이블의 이름입니다.

• PARTITION_NAME

  파티션의 이름입니다.

• SUBPARTITION_NAME

  PARTITIONS 테이블 row가 서브파티션을 나타내는 경우, 서브파티션의 이름입니다. 그렇지 않으면 NULL입니다.

  NDB의 경우: 이 값은 항상 NULL입니다.

• PARTITION_ORDINAL_POSITION

  모든 파티션은 정의된 순서와 동일한 순서로 인덱싱되며, 첫 번째 파티션에 할당되는 번호는 1입니다. 파티션이 추가, 삭제, 재구성됨에 따라 인덱싱이 변경될 수 있으며, 이 column에 표시되는 숫자는 이러한 인덱싱 변경 사항을 반영한 현재 순서를 나타냅니다.

• SUBPARTITION_ORDINAL_POSITION

  주어진 파티션 내의 서브파티션 또한 테이블 내 파티션이 인덱싱되는 방식과 동일하게 인덱싱 및 재인덱싱됩니다.

• PARTITION_METHOD

  RANGE, LIST, HASH, LINEAR HASH, KEY, 또는 LINEAR KEY 중 하나입니다. 즉, Section 26.2, “Partitioning Types”에서 설명된 사용 가능한 파티셔닝 타입 중 하나입니다.

• SUBPARTITION_METHOD

  HASH, LINEAR HASH, KEY, 또는 LINEAR KEY 값 중 하나입니다. 즉, Section 26.2.6, “Subpartitioning”에서 설명된 사용 가능한 서브파티셔닝 타입 중 하나입니다.

• PARTITION_EXPRESSION

  테이블의 현재 파티셔닝 스킴을 생성한 CREATE TABLE 또는 ALTER TABLE 문에서 사용된 파티셔닝 함수의 표현식입니다.

  예를 들어, 다음 문을 사용하여 test 데이터베이스에 생성된 파티션 테이블을 생각해 보겠습니다:

1CREATE TABLE tp (
2      c1 INT,
3      c2 INT,
4      c3 VARCHAR(25)
5)
6PARTITION BY HASH(c1 + c2)
7PARTITIONS 4;

이 테이블의 파티션에 대한 PARTITIONS 테이블 row에서 PARTITION_EXPRESSION column은 다음과 같이 c1 + c2를 표시합니다:

1mysql> SELECT DISTINCT PARTITION_EXPRESSION
2         FROM INFORMATION_SCHEMA.PARTITIONS
3         WHERE TABLE_NAME='tp' AND TABLE_SCHEMA='test';
4+----------------------+
5| PARTITION_EXPRESSION |
6+----------------------+
7| c1 + c2              |
8+----------------------+

명시적으로 파티션되지 않은 테이블의 경우, 스토리지 엔진과 상관없이 이 column은 항상 NULL입니다.

• SUBPARTITION_EXPRESSION

  이 column은 테이블의 서브파티셔닝을 정의하는 서브파티셔닝 표현식에 대해, 테이블 파티셔닝을 정의하는 파티셔닝 표현식에 대해 PARTITION_EXPRESSION이 동작하는 것과 동일한 방식으로 동작합니다.

  테이블에 서브파티션이 없는 경우, 이 column은 NULL입니다.

• PARTITION_DESCRIPTION

  이 column은 RANGE 및 LIST 파티션에 사용됩니다. RANGE 파티션의 경우, 파티션의 VALUES LESS THAN 절에 설정된 값을 포함하며, 이는 정수 또는 MAXVALUE일 수 있습니다. LIST 파티션의 경우, 파티션의 VALUES IN 절에 정의된 값을 포함하며, 이는 콤마로 구분된 정수 값 목록입니다.

  PARTITION_METHOD가 RANGE 또는 LIST가 아닌 파티션의 경우, 이 column은 항상 NULL입니다.

• TABLE_ROWS

  파티션 내 테이블 row의 수입니다.

  파티션된 InnoDB 테이블의 경우, TABLE_ROWS column에 제공되는 row 수는 SQL 최적화에 사용되는 추정값이며, 항상 정확하지 않을 수 있습니다.

  NDB 테이블의 경우, 이 정보는 ndb_desc 유틸리티를 사용하여 얻을 수도 있습니다.

• AVG_ROW_LENGTH

  이 파티션 또는 서브파티션에 저장된 row의 평균 길이(바이트 단위)입니다. 이는 DATA_LENGTH를 TABLE_ROWS로 나눈 값과 동일합니다.

  NDB 테이블의 경우, 이 정보는 ndb_desc 유틸리티를 사용하여 얻을 수도 있습니다.

• DATA_LENGTH

  이 파티션 또는 서브파티션에 저장된 모든 row의 총 길이(바이트 단위)입니다. 즉, 파티션 또는 서브파티션에 저장된 바이트의 총 수입니다.

  NDB 테이블의 경우, 이 정보는 ndb_desc 유틸리티를 사용하여 얻을 수도 있습니다.

• MAX_DATA_LENGTH

  이 파티션 또는 서브파티션에 저장될 수 있는 최대 바이트 수입니다.

  NDB 테이블의 경우, 이 정보는 ndb_desc 유틸리티를 사용하여 얻을 수도 있습니다.

• INDEX_LENGTH

  이 파티션 또는 서브파티션에 대한 인덱스 파일의 길이(바이트 단위)입니다.

  NDB 테이블의 파티션의 경우, 테이블이 암시적 또는 명시적 파티셔닝을 사용하는지 여부와 상관없이 INDEX_LENGTH column 값은 항상 0입니다. 그러나 이와 동등한 정보는 ndb_desc 유틸리티를 사용하여 얻을 수 있습니다.

• DATA_FREE

  파티션 또는 서브파티션에 할당되었으나 사용되지 않은 바이트 수입니다.

  NDB 테이블의 경우, 이 정보는 ndb_desc 유틸리티를 사용하여 얻을 수도 있습니다.

• CREATE_TIME

  파티션 또는 서브파티션이 생성된 시각입니다.

• UPDATE_TIME

  파티션 또는 서브파티션이 마지막으로 수정된 시각입니다.

• CHECK_TIME

  이 파티션 또는 서브파티션이 속한 테이블이 마지막으로 체크된 시각입니다.

  파티션된 InnoDB 테이블의 경우, 이 값은 항상 NULL입니다.

• CHECKSUM

  체크섬 값이며, 없으면 NULL입니다.

• PARTITION_COMMENT

  파티션에 코멘트가 있는 경우 그 코멘트의 텍스트입니다. 없는 경우 이 값은 비어 있습니다.

  파티션 코멘트의 최대 길이는 1024 문자로 정의되며, 이 한도에 맞추기 위해 PARTITION_COMMENT column의 표시 너비 또한 1024 문자입니다.

• NODEGROUP

  파티션이 속한 노드그룹입니다. NDB Cluster 테이블의 경우, 이는 항상 default입니다. NDB 이외의 스토리지 엔진을 사용하는 파티션 테이블의 경우에도 값은 default입니다. 그렇지 않으면 이 column은 비어 있습니다.

• TABLESPACE_NAME

  파티션이 속한 테이블스페이스의 이름입니다. 테이블이 NDB 스토리지 엔진을 사용하지 않는 한(이 절의 끝부분에 있는 Notes 참조), 값은 항상 DEFAULT입니다.

Notes

• PARTITIONS는 비표준 INFORMATION_SCHEMA 테이블입니다.

• NDB 이외의 어떤 스토리지 엔진을 사용하는, 그리고 파티션되지 않은 테이블은 PARTITIONS 테이블에 하나의 row를 가집니다. 그러나 PARTITION_NAME, SUBPARTITION_NAME, PARTITION_ORDINAL_POSITION, SUBPARTITION_ORDINAL_POSITION, PARTITION_METHOD, SUBPARTITION_METHOD, PARTITION_EXPRESSION, SUBPARTITION_EXPRESSION, 및 PARTITION_DESCRIPTION column의 값은 모두 NULL입니다. 또한, 이 경우 PARTITION_COMMENT column은 비어 있습니다.

• 명시적으로 파티션되지 않은 NDB 테이블은 NDB 클러스터의 각 데이터 노드마다 PARTITIONS 테이블에 하나의 row를 가집니다. 각 row에 대해:

  • SUBPARTITION_NAME, SUBPARTITION_ORDINAL_POSITION, SUBPARTITION_METHOD, PARTITION_EXPRESSION, SUBPARTITION_EXPRESSION, CREATE_TIME, UPDATE_TIME, CHECK_TIME, CHECKSUM, 및 TABLESPACE_NAME column은 모두 NULL입니다.

  • PARTITION_METHOD는 항상 AUTO입니다.

  • NODEGROUP column은 default입니다.

  • PARTITION_COMMENT column은 비어 있습니다.