SYSTEM$CLUSTERING_RATIO

SYSTEM$CLUSTERING_RATIO (클러스터링 비율) — Deprecated

테이블의 하나 이상의 열에 기반해 테이블의 클러스터링 비율을 계산해요. 비율은 0부터 100까지의 숫자예요. 비율이 높을수록 테이블이 더 잘 클러스터링된 것이에요.

출처: Snowflake SQL Reference - SYSTEM$CLUSTERING_RATIO

본문

테이블의 클러스터링 비율은 테이블의 어떤 열이든 또는 테이블의 클러스터링 키(clustering key)로 명시적으로 정의된 열을 사용해 계산할 수 있어요. 클러스터링 키는 CREATE TABLE 또는 ALTER TABLE을 사용해 테이블에 정의할 수 있어요.

클러스터링 비율과 클러스터링 키에 대한 자세한 내용은 Snowflake 테이블 구조 이해를 참고하세요.

구문

SYSTEM$CLUSTERING_RATIO( '<table_name>' , '( <col1> [ , <col2> ... ] )' [ , '<predicate>' ] )

인자

table_name

클러스터링 비율을 계산하려는 테이블이에요.

col1 [ , col2 ... ]

클러스터링 비율을 계산하는 데 사용되는 테이블의 열이에요.

  • 클러스터링 키가 없는 테이블의 경우 이 인자는 필수예요. 이 인자를 생략하면 오류가 반환돼요.

  • 클러스터링 키가 있는 테이블의 경우 이 인자는 선택 사항이에요. 이 인자를 생략하면 Snowflake는 정의된 클러스터링 키를 사용해 비율을 계산해요.

    참고: 이 인자를 사용해 테이블에 정의된 클러스터링 키와 관계없이 테이블의 어떤 열이든 비율을 계산할 수 있어요.

predicate

클러스터링 비율을 계산할 열의 값 범위를 필터링하는 절(clause)이에요. predicate는 절의 시작 부분에 WHERE 키워드를 사용하지 않음을 참고하세요.

사용 시 참고 사항

  • 모든 인자는 문자열이에요(즉 작은따옴표로 묶어야 해요).

  • predicate에 문자열이 포함되어 있으면 그 문자열은 작은따옴표로 묶어야 하며, 그런 다음 작은따옴표를 사용해 이스케이프해야 해요. 예를 들어: SYSTEM$CLUSTERING_RATIO( ... , 'col1 = 100 and col2 = ''A''' )

예시

테이블의 두 열을 사용해 테이블의 클러스터링 비율을 계산해요.

SELECT SYSTEM$CLUSTERING_RATIO('t2', '(col1, col3)');

+-------------------------------+
| SYSTEM$CLUSTERING_RATIO('T2') |
|-------------------------------|
| 77.1                          |
+-------------------------------+

테이블의 두 열과 그 중 한 열에 대한 조건(predicate)을 사용해 클러스터링 비율을 계산해요.

SELECT SYSTEM$CLUSTERING_RATIO('t2', '(col1, col2)', 'col1 = ''A''');

+-------------------------------+
| SYSTEM$CLUSTERING_RATIO('T2') |
|-------------------------------|
| 87.7                          |
+-------------------------------+

테이블에 정의된 클러스터링 키를 사용해 클러스터링 비율을 계산해요.

SELECT SYSTEM$CLUSTERING_RATIO('t1');

+-------------------------------+
| SYSTEM$CLUSTERING_RATIO('T1') |
|-------------------------------|
| 100.0                         |
+-------------------------------+

더 알아보기