Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
SQL-Analyseendpunkt in Microsoft Fabric und Warehouse in Microsoft Fabric
AI_TRANSLATE übersetzt den Eingabetext in eine Zielsprache.
Note
-
AI_TRANSLATEbefindet sich in der Vorschau. -
AI_TRANSLATEist nur im SQL-Analytics-Endpunkt und im Warehouse in Microsoft Fabric verfügbar.
Syntax
Transact-SQL-Syntaxkonventionen
AI_TRANSLATE ( text, lang_code [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )
Arguments
text
Ein Ausdruck eines Charaktertyps, zum Beispiel nvarchar, varchar, nchar oder char.
lang_code
Sprachcode für das Übersetzungsziel.
Unterstützte Werte: de, en, fr, it, es, el, plsvfi. cs
EIN FEHLER
Die Klausel ON ERROR steuert, wie eine KI-Funktion mit Verarbeitungsfehlern umgeht.
-
NULL ON ERRORgibt zurück,NULLwenn die Funktion einen Wert nicht verarbeiten kann. Das ist das Standardverhalten und muss nicht explizit angegeben werden. -
ERROR ON ERRORführt dazu, dass die gesamte Abfrage fehlschlägt, wenn während der Verarbeitung eines Eingabewerts ein Fehler auftritt. -
DEFAULT <value> ON ERRORgibt den angegebenen Standardwert zurück, anstattNULLwenn ein Fehler auftritt.
Fehler können durch Sicherheitsprüfungen der Responsible AI, Eingabegrößenbeschränkungen, vorübergehende Serviceprobleme oder andere Verarbeitungsfehler verursacht werden.
Rückgabetypen
Gibt nvarchar(max) mit übersetztem Text zurück.
Bemerkungen
KI-Funktionen kehren zurück, NULL wenn das KI-Modell den Text nicht verarbeiten kann. Häufige Gründe sind:
- Verantwortungsvolle KI-Regeln blockieren unangemessene Inhalte im Eingabetext.
- Eingabetext überschreitet Tokengrenzwerte. Das aktuelle Modell unterstützt bis zu 15 KB Text.
Beispiele
A. Ins Deutsche übersetzen
SELECT ai_translate('The hotel was great', 'de') AS translation_de;
Erwartetes Ergebnis: Das Hotel war großartig.
B. Übersetze Rezensionstexte in mehrere Sprachen
SELECT review_id,
ai_translate(review_text, 'de') AS review_de,
ai_translate(review_text, 'fr' ERROR ON ERROR) AS review_fr,
ai_translate(review_text, 'es' DEFAULT 'N/A' ON ERROR) AS review_es
FROM dbo.hotel_reviews;
Wenn die Übersetzung ins Deutsche fehlschlägt, wird die erste Funktion anstelle eines Fehlers zurückgegeben NULL .
Die Klausel NULL ON ERROR weist die KI-Funktion, die Text ins Französische übersetzt, an, die Abfrage nicht zu beantworten, falls kein Eingabewert übersetzt werden kann. Die Klausel DEFAULT 'N/A' ON ERROR weist die KI-Funktion an, die den Text ins Spanische übersetzt, den Wert N/A für jeden nicht verarbeiteten Eingabewert zurückzugeben.