자동 클러스터링: SYSTEM$CLUSTERING_INFORMATION 구문 및 출력 변경 사항¶

주의

이 동작 변경 사항은 2023_04 번들에 있습니다.

번들의 현재 상태는 번들 기록 섹션을 참조하십시오.

현재, SYSTEM$CLUSTERING_INFORMATION 함수를 사용하여 지난 14일 동안 발생한 자동 클러스터링 오류를 볼 수 있습니다.

이전:

사용자는 자동 클러스터링 중에 발생한 오류에 대한 설명 메시지를 얻을 수 없습니다.

현재:

SYSTEM$CLUSTERING_INFORMATION 함수의 JSON 출력에는 오류 배열을 포함한 새 필드 clustering_errors 가 포함됩니다. 각 오류에는 타임스탬프와 설명 메시지가 포함됩니다.

예를 들어 함수의 새 출력은 다음과 같을 수 있습니다.

{
"cluster_by_keys" : "LINEAR(i)",
"notes" : "Clustering key columns contain high cardinality key I which
might result in expensive re-clustering. Consider reducing the
cardinality of clustering keys. Please refer to
https://docs.snowflake.net/manuals/user-guide/tables-clustering-keys.html
for more information.",
"total_partition_count" : 0,
"total_constant_partition_count" : 0,
"average_overlaps" : 0.0,
"average_depth" : 0.0,
"partition_depth_histogram" : {
    "00000" : 0,
    // omitted for brevity
},
"clustering_errors" : [ {
    "timestamp" : "2023-04-03 17:50:42 +0000",
    "error" : "(003325) Clustering service has been disabled.\n"
} ]
}

기본적으로 이 함수는 가장 최근 메시지를 10개 반환합니다. 새 함수 구문을 사용하면 더 많거나 적은 메시지를 반환하기 위해 정수를 선택적인 두 번째 인자로 지정할 수 있습니다. 예를 들어 다음은 가장 최근 오류를 25개 반환합니다.
```
SELECT SYSTEM$CLUSTERING_INFORMATION( 'my_table' , 25);
```

참조: 985