카테고리:

시스템 함수 (시스템 정보)

SYSTEM$CLUSTERING_RATIO — 사용되지 않음

테이블에 있는 하나 이상의 열을 기반으로 테이블의 클러스터링 비율을 계산합니다. 비율은 0 에서 100 사이의 숫자입니다. 비율이 높을수록 테이블이 더 잘 클러스터됩니다.

테이블의 클러스터링 비율은 테이블의 모든 열이나, 테이블의 클러스터링 키로 명시적으로 정의된 열을 사용하여 계산할 수 있습니다. 클러스터링 키는 CREATE TABLE 또는 ALTER TABLE 을 사용하여 테이블에 대해 정의될 수 있습니다.

클러스터링 비율 및 클러스터링 키에 대한 자세한 내용은 Snowflake 테이블 구조 이해하기 를 참조하십시오.

구문

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

인자

table_name

클러스터링 비율을 계산할 테이블입니다.

col1 [ , col2 ... ]

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

  • 클러스터링 키가 없는 테이블의 경우, 이 인자가 필요합니다. 이 인자를 생략하면 오류가 반환됩니다.

  • 클러스터링 키가 있는 테이블의 경우, 이 인자는 선택 사항입니다. 인자가 생략되면 Snowflake는 정의된 클러스터링 키를 사용하여 비율을 계산합니다.

참고

이 인자를 사용하여, 테이블에 대해 정의된 클러스터링 키와 관계없이 테이블의 모든 열에 대한 비율을 계산할 수 있습니다.

predicate

클러스터링 비율을 계산할 열의 값 범위를 필터링하는 절입니다. predicate 는 절의 시작 부분에서 WHERE 키워드를 사용하지 않습니다.

사용법 노트

  • 모든 인자는 문자열입니다(즉, 작은따옴표로 묶어야 함).

  • predicate 가 문자열을 포함하는 경우, 문자열은 작은따옴표로 묶어야 하며, 작은따옴표를 사용하여 이스케이프해야 합니다. 예:

    SYSTEM$CLUSTERING_RATIO( ... , 'col1 = 100 and col2 = ''A''' )

테이블의 두 열을 사용하여 테이블의 클러스터링 비율을 계산합니다.

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

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

테이블의 두 열, 그리고 해당 열 중 하나의 조건자를 사용하여 테이블의 클러스터링 비율을 계산합니다.

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 |
+-------------------------------+
맨 위로 이동