최종 수정: 에
PARTITIONS
설명
이 테이블 함수는 임시 파티션 테이블을 생성하여 특정 테이블의 파티션 목록을 조회할 수 있게 합니다.
구문
PARTITIONS(
"catalog"="<catalog>",
"database"="<database>",
"table"="<table>"
)
필수 매개변수
| 필드 | 설명 |
|---|---|
<catalog> | 쿼리할 클러스터의 Catalog 이름을 지정합니다. |
<database> | 쿼리할 클러스터의 데이터베이스 이름을 지정합니다. |
<table> | 쿼리할 클러스터의 테이블 이름을 지정합니다. |
반환 값
| 필드 | 설명 |
|---|---|
| PartitionId | 파티션 ID |
| PartitionName | 파티션 이름 |
| VisibleVersion | 파티션 버전 |
| VisibleVersionTime | 파티션 버전이 커밋된 시간 |
| State | 파티션 상태 |
| PartitionKey | 파티션 키 |
| Range | 파티션 범위 |
| DistributionKey | 파티셔닝에 사용하는 분산 키 |
| Buckets | 파티션의 버킷 수 |
| ReplicationNum | 파티션의 복제본 수 |
| StorageMedium | 파티션에 사용하는 저장 매체 |
| CooldownTime | 파티션의 쿨다운 시간 |
| RemoteStoragePolicy | 파티션의 원격 스토리지 정책 |
| LastConsistencyCheckTime | 파티션의 마지막 일관성 검사 시간 |
| DataSize | 파티션 내 데이터 크기 |
| IsInMemory | 파티션이 메모리에 저장되는지 여부 |
| ReplicaAllocation | 파티션의 복제 전략 |
| IsMutable | 파티션의 변경 가능 여부 |
| SyncWithBaseTables | 파티션이 기본 테이블과 동기화되어 있는지 여부(비동기 구체화된 뷰의 경우) |
| UnsyncTables | 동기화되지 않은 기본 테이블(비동기 구체화된 뷰 파티션의 경우) |
예제
internal Catalog의 test 데이터베이스에 있는 example_table의 파티션 목록을 조회합니다.
select * from partitions("catalog"="internal","database"="test","table"="example_table");
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime | State | PartitionKey | Range | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| 43209 | p1 | 1 | 2025-01-17 12:35:22 | NORMAL | created_at | [types: [DATEV2]; keys: [0000-01-01]; ..types: [DATEV2]; keys: [2023-01-01]; ) | id | 10 | 1 | HDD | 9999-12-31 23:59:59 | | \N | 0.000 | 0 | tag.location.default: 1 | 1 | 1 | \N |
| 43210 | p2 | 1 | 2025-01-17 12:35:22 | NORMAL | created_at | [types: [DATEV2]; keys: [2023-01-01]; ..types: [DATEV2]; keys: [2024-01-01]; ) | id | 10 | 1 | HDD | 9999-12-31 23:59:59 | | \N | 0.000 | 0 | tag.location.default: 1 | 1 | 1 | \N |
| 43211 | p3 | 1 | 2025-01-17 12:35:22 | NORMAL | created_at | [types: [DATEV2]; keys: [2024-01-01]; ..types: [DATEV2]; keys: [2025-01-01]; ) | id | 10 | 1 | HDD | 9999-12-31 23:59:59 | | \N | 0.000 | 0 | tag.location.default: 1 | 1 | 1 | \N |
| 43212 | p4 | 1 | 2025-01-17 12:35:22 | NORMAL | created_at | [types: [DATEV2]; keys: [2025-01-01]; ..types: [DATEV2]; keys: [2026-01-01]; ) | id | 10 | 1 | HDD | 9999-12-31 23:59:59 | | \N | 0.000 | 0 | tag.location.default: 1 | 1 | 1 | \N |
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
example_table에서 파티션 이름이 p1인 파티션의 정보를 조회합니다.
select * from partitions("catalog"="internal","database"="test","table"="example_table") where PartitionName = "p1";
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| PartitionId | PartitionName | VisibleVersion | VisibleVersionTime | State | PartitionKey | Range | DistributionKey | Buckets | ReplicationNum | StorageMedium | CooldownTime | RemoteStoragePolicy | LastConsistencyCheckTime | DataSize | IsInMemory | ReplicaAllocation | IsMutable | SyncWithBaseTables | UnsyncTables |
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
| 43209 | p1 | 1 | 2025-01-17 12:35:22 | NORMAL | created_at | [types: [DATEV2]; keys: [0000-01-01]; ..types: [DATEV2]; keys: [2023-01-01]; ) | id | 10 | 1 | HDD | 9999-12-31 23:59:59 | | \N | 0.000 | 0 | tag.location.default: 1 | 1 | 1 | \N |
+-------------+---------------+----------------+---------------------+--------+--------------+--------------------------------------------------------------------------------+-----------------+---------+----------------+---------------+---------------------+---------------------+--------------------------+----------+------------+-------------------------+-----------+--------------------+--------------+
example_table에서 파티션 이름이 p1인 파티션의 ID를 조회합니다.
select PartitionId from partitions("catalog"="internal","database"="test","table"="example_table") where PartitionName = "p1";
+-------------+
| PartitionId |
+-------------+
| 43209 |
+-------------+