自动聚类：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