Snowflake Cortex-AI-Funktion: Verbesserungen bei der Behandlung mehrzeiliger Fehler (Vorschau)¶

Nicht betroffene AI-Funktionen¶

Die folgendenAI-Funktionen sind nicht von dieser Verhaltensänderung betroffen:

• AI_EXTRACT: Diese Funktion behandelt Fehler bereits, indem sie Fehlerinformationen als separates Feld im Ergebnis zurückgibt und nicht dazu führt, dass mehrzeilige Abfragen aufgrund eines Einzelfehlers fehlschlagen. Das Verhalten von AI_EXTRACT ist ähnlich wie das neue Verhalten anderer AI-Funktionen, wenn``return_error_details`` TRUE ist, obwohl diese Funktion return_error_details nicht akzeptiert.

• AI_AGG und AI_SUMMARIZE_AGG: Aggregatfunktionen fallen nicht in den Bereich dieser BCR. Snowflake prüft immer noch, wie sich Zeilen, die Fehler verursachen, in der Aggregation verhalten sollen. Das Verhalten dieser Funktionen kann sich in einer zukünftigen BCR ändern.

• AI_EMBED: Diese Funktion gibt einen VECTOR-Wert zurück, was derzeit für nicht VARIANT-Objekte unterstützt wird. Das Verhalten dieser Funktion kann sich in einer zukünftigen BCR ändern.

• Ältere AI-Funktionen imSNOWFLAKE.CORTEX-Namespace. Snowflake beabsichtigt keine Änderung des Verhaltens dieser Funktionen.

Neues Verhalten mit und ohne Fehler¶

Das erste Codebeispiel zeigt die Ausgabe, wenn die Funktion erfolgreich ist, und das zweite Beispiel zeigt die Ausgabe, wenn die Funktion aufgrund eines ungültigen Sprachcodes fehlschlägt.

-- succeeds
SELECT AI_TRANSLATE(spanish_comment, 'es', 'en') as english_comment, "Este es un commentario" as spanish_comment;

Ergebnis:

+-------------------+------------------+
| ENGLISH_COMMENT   | SPANISH_COMMENT  |
|-------------------+------------------|
| This is a comment | Este es un       |
|                   | comentario       |
+-------------------+------------------+

-- fails
SELECT AI_TRANSLATE(spanish_comment, 'es', 'xx') as english_comment, "Este es un commentario" as spanish_comment;

Ergebnis

+-------------------+------------------+
| ENGLISH_COMMENT   | SPANISH_COMMENT  |
|-------------------+------------------|
| NULL              | Este es un       |
|                   | comentario       |
+-------------------+------------------+

Neues Verhalten mit Fehlerdetails¶

Wie zuvor zeigt das erste Codebeispiel eine erfolgreiche Funktion und das zweite eine fehlgeschlagene Funktion.

  -- succeeds
  SELECT AI_TRANSLATE(spanish_comment, 'es', 'en', TRUE) as result, "Este es un commentario" as spanish_comment;

Result:

+--------------------------------+------------------+
| RESULT                         | SPANISH_COMMENT  |
|--------------------------------|------------------|
| {                              | Este es un       |
|   "value": "This is a comment",| comentario       |
|   "error": NULL                |                  |
| }                              |                  |
+--------------------------------+------------------+

-- fails
SELECT AI_TRANSLATE(spanish_comment, 'es', 'xx', TRUE) as result, "Este es un commentario" as spanish_comment;

Ergebnis:

+--------------------------------+------------------+
| RESULT                         | SPANISH_COMMENT  |
|--------------------------------|------------------|
| {                              | Este es un       |
|   "value": NULL,               | comentario       |
|   "error": "Invalid language   |                  |
|           \"xx\"               |                  |
+--------------------------------+------------------+

Mehrzeilige Abfrage¶

Die folgenden Beispiele zeigen, wie Sie das neue Fehlerbehandlungsverhalten in einer mehrzeiligen Abfrage verwenden können. Tritt beim Verarbeiten einer Zeile ein Fehler auf, wird diese Zeile nicht in das Ergebnis aufgenommen. Bei den Beispieldaten wird angenommen, dass es sich um eine Tabelle mit Benutzerkommentaren in verschiedenen Sprachen handelt, und die Abfrage versucht, diese alle mit AI_TRANSLATE ins Englische zu übersetzen.

SELECT
  AI_TRANSLATE(comment, comment_language, 'en') as translation_result,
  comment_language,
  comment
FROM comments
WHERE translation_result IS NOT NULL;

Das folgende Beispiel zeigt die Verwendung des:code:return_error_details-Parameter, um das gleiche Ergebnis wie im vorherigen Beispiel zu erzielen.

SELECT
  AI_TRANSLATE(comment, comment_language, 'en', TRUE) as translation_result,
  comment_language,
  comment
FROM comments
WHERE translation_result:value IS NOT NULL;

Ref: 2184