Automatic Clustering: Änderungen bei Syntax und Ausgabe von SYSTEM$CLUSTERING_INFORMATION

Achtung

Diese Verhaltensänderung ist in Bundle 2023_04 enthalten.

Den aktuellen Status des Bundles finden Sie unter Bundle-Verlauf.

Aktuell können Sie die Funktion SYSTEM$CLUSTERING_INFORMATION verwenden, um Automatic Clustering-Fehler anzuzeigen, die in den letzten 14 Tagen aufgetreten sind.

Bisher

Benutzer können keine beschreibenden Meldungen für Fehler erhalten, die beim Automatic Clustering auftreten.

Jetzt
  • Die JSON-Ausgabe der Funktion SYSTEM$CLUSTERING_INFORMATION enthält ein neues Feld, clustering_errors, das ein Array von Fehlern enthält. Jeder Fehler enthält einen Zeitstempel und eine beschreibende Meldung.

    Die neue Ausgabe der Funktion könnte zum Beispiel wie folgt aussehen:

    {
    "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
  • Standardmäßig werden von der Funktion die 10 neuesten Meldungen zurückgegeben. Die neue Funktionssyntax ermöglicht es Ihnen, eine ganze Zahl als optionales zweites Argument anzugeben, um mehr oder weniger Meldungen zurückzugeben. Im folgenden Beispiel werden die letzten 25 Fehler zurückgegeben:

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

Ref.: 985