自動クラスタリング: 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"
    } ]
    }
    
    Copy
  • デフォルトでは、最新の10件のメッセージがこの関数によって返されます。新しい関数構文では、オプションの第2引数に整数を指定すると、より多くまたはより少なくメッセージを返すことができます。たとえば、次のようにすると、最新の25件のエラーが返されます。

    SELECT SYSTEM$CLUSTERING_INFORMATION( 'my_table' , 25);
    
    Copy

参照: 985