Kategorien:

Zeichenfolgen- und Binärfunktionen (AI-Funktionen)

AI_TRANSLATE

Bemerkung

AI_TRANSLATE ist die aktualisierte Version von TRANSLATE (SNOWFLAKE.CORTEX). Die neueste Funktionalität finden Sie unter AI_TRANSLATE.

Übersetzt den angegebenen Eingabetext von einer unterstützten Sprache in eine andere.

Syntax

AI_TRANSLATE(
    <text>, <source_language>, <target_language> [, <return_error_details> ] )

Argumente

text

Zeichenfolge, die den zu übersetzenden Text enthält.

source_language

Zeichenfolge, die den Sprachcode für die Sprache angibt, in der der Text aktuell vorliegt. Eine Liste der unterstützten Sprachcodes finden Sie in den Nutzungshinweisen. Wenn der Code der Quellsprache eine leere Zeichenfolge '' ist, wird die Quellsprache automatisch erkannt.

target_language

Zeichenfolge, die den Sprachcode für die Sprache angibt, in die der Text übersetzt werden soll. Eine Liste der unterstützten Sprachcodes finden Sie in den Nutzungshinweisen.

Optional:

return_error_details

Ein BOOLEAN Flag, das angibt, ob im Fehlerfall Fehlerdetails zurückgegeben werden sollen. Wenn sie auf TRUE gesetzt ist, gibt die Funktion ein OBJECT zurück, das den Wert und die Fehlermeldung enthält. Je nachdem, ob die Funktion erfolgreich war oder fehlgeschlagen ist, ist einer dieser beiden NULL. Siehe Fehlerverhalten für Details.

Rückgabewerte

Eine Zeichenfolge, die eine Übersetzung des Originaltextes in die Zielsprache enthält.

Fehlerverhalten

Wenn AI_TRANSLATE die Eingabe nicht verarbeiten kann, gibt die Funktion standardmäßig NULL zurück. Wenn die Abfrage mehrere Zeilen verarbeitet, geben Zeilen mit Fehlern NULL zurück, verhindern aber nicht, dass die Abfrage abgeschlossen wird.

Der Rückgabewert hängt bei einem Fehler vom return_error_details-Argument ab. Die folgende Tabelle zeigt den Rückgabewert in Abhängigkeit von dem return_error_details-Argument:

return_error_details

Rückgabewert

Beschreibung
FALSE

Nicht übergeben

NULL

TRUE

OBJECT mit value- und error-Feldern
value: Ein VARCHAR-Wert, der den übersetzten Text enthält, oder NULL, wenn ein Fehler aufgetreten ist.

error: Ein VARCHAR -Wert, der bei Auftreten eines Fehlers die Fehlermeldung enthält, oder NULL, wenn die Funktion erfolgreich war.

Weitere Informationen zur Fehlerbehandlung für AI-Funktionen finden Sie unter Snowflake Cortex AI Function: Multirow error handling improvements.

Nutzungshinweise

Die folgenden Sprachen werden von der Funktion AI_TRANSLATE unterstützt. Verwenden Sie den entsprechenden Sprachencode für die Quell- und Zielsprache.

Das AI_TRANSLATE-Modell unterstützt auch eine Mischung aus verschiedenen Sprachen in dem zu übersetzenden Text (z. B. „Spanglish“). Geben Sie in diesem Fall eine leere Zeichenfolge ('') als Ausgangssprache an, um die im Ausgangstext verwendeten Sprachen automatisch zu erkennen.

Sprache

Code

Arabisch

'ar'

Chinesisch

'zh'

Kroatisch

'hr'

Tschechisch

'cs'

Holländisch

'nl'

Englisch

'en'

Finnisch

'fi'

Französisch

'fr'

Deutsch

'de'

Griechisch

'el'

Hebräisch

'he'

Hindi

'hi'

Italienisch

'it'

Japanisch

'ja'

Koreanisch

'ko'

Norwegisch

'no'

Polnisch

'pl'

Portugiesisch

'pt'

Rumänisch

'ro'

Russisch

'ru'

Spanisch

'es'

Schwedisch

'sv'

Türkisch

'tr'

Anforderungen an die Zugriffssteuerung

Benutzer müssen eine Rolle verwenden, der die Datenbankrolle SNOWFLAKE.CORTEX_USER zugewiesen wurde: Weitere Informationen zu dieser Berechtigung finden Sie unter Cortex LLM-Berechtigungen.

Beispiele

Im folgenden Beispiel wird jede Zeile einer Tabelle von Englisch in Deutsch übersetzt (in diesem Beispiel ist review_content eine Spalte der Tabelle reviews):

SELECT AI_TRANSLATE(review_content, 'en', 'de') FROM reviews LIMIT 10;

Das folgende Beispiel übersetzt eine fiktive Produktbewertung vom Englischen ins Spanische:

SELECT AI_TRANSLATE(
  'Hit the slopes with Snowflake\'s latest innovation - "Skii Headphones" designed to keep your ears warm and your soul ablaze. Engineered specifically for snow weather, these rugged headphones combine crystal-clear sound with thermally-insulated ear cups to keep the chill out and the beats in. Whether you\'re carving through powder or cruising down groomers, Skii Headphones will fuel your mountain adventures with vibrant sound and unrelenting passion. Stay warm, stay fired up, and shred the mountain with Snowflake Skii Headphones',
'en','es');

Das Ergebnis dieser Abfrage ist:

Sube a las pistas con la última innovación de Snowflake: "Skii Headphones", diseñados para mantener tus oídos calientes y tu alma encendida. Diseñados específicamente para el clima de nieve, estos audífonos resistentes combinan un sonido cristalino con copas de oído aisladas térmicamente para mantener el frío fuera y los ritmos dentro. Ya sea que estés esculpiendo en polvo o deslizándote por pistas preparadas, los Skii Headphones alimentarán tus aventuras en la montaña con un sonido vibrante y una pasión incesante. Mantente caliente, mantente encendido y arrasa la montaña con los Skii Headphones de Snowflake.

Das folgende Beispiel übersetzt ein Anrufprotokoll vom Deutschen ins Englische:

SELECT AI_TRANSLATE(
  ('Kunde: Hallo
    Agent: Hallo, ich hoffe, es geht Ihnen gut. Um Ihnen am besten helfen zu können, teilen Sie bitte Ihren Vor- und Nachnamen und den Namen der Firma, von der aus Sie anrufen.
    Kunde: Ja, hier ist Thomas Müller von SkiPisteExpress.
    Agent: Danke Thomas, womit kann ich Ihnen heute helfen?
    Kunde: Also wir haben die XtremeX Helme in Größe M bestellt, die wir speziell für die kommende Wintersaison benötigen. Jedoch sind alle Schnallen der Helme defekt, und keiner schließt richtig.
    Agent: Ich verstehe, dass das ein Problem für Ihr Geschäft sein kann. Lassen Sie mich überprüfen, was mit Ihrer Bestellung passiert ist. Um zu bestätigen: Ihre Bestellung endet mit der Nummer 56682?
    Kunde: Ja, das ist meine Bestellung.
    Agent: Ich sehe das Problem. Entschuldigen Sie die Unannehmlichkeiten. Ich werde sofort eine neue Lieferung mit reparierten Schnallen für Sie vorbereiten, die in drei Tagen bei Ihnen eintreffen sollte. Ist das in Ordnung für Sie?
    Kunde: Drei Tage sind ziemlich lang, ich hatte gehofft, diese Helme früher zu erhalten. Gibt es irgendeine Möglichkeit, die Lieferung zu beschleunigen?
    Agent: Ich verstehe Ihre Dringlichkeit. Ich werde mein Bestes tun, um die Lieferung auf zwei Tage zu beschleunigen. Wie kommst du damit zurecht?
    Kunde: Das wäre großartig, ich wäre Ihnen sehr dankbar.
    Agent: Kein Problem, Thomas. Ich kümmere mich um die eilige Lieferung. Danke für Ihr Verständnis und Ihre Geduld.
    Kunde: Vielen Dank für Ihre Hilfe. Auf Wiedersehen!
    Agent: Bitte, gerne geschehen. Auf Wiedersehen und einen schönen Tag noch!'
,'de','en');

Das Ergebnis ist:

Customer: Hello
Agent: Hello, I hope you are well. To best assist you, please share your first and last name and the name of the company you are calling from.
Customer: Yes, this is Thomas Müller from SkiPisteExpress.
Agent: Thank you, Thomas, what can I help you with today?
Customer: So, we ordered the XtremeX helmets in size M, which we specifically need for the upcoming winter season. However, all the buckles on the helmets are defective and none of them close properly.
Agent: I understand that this can be a problem for your business. Let me check what happened with your order. To confirm: your order ends with the number 56682?
Customer: Yes, that's my order.
Agent: I see the issue. I apologize for the inconvenience. I will prepare a new delivery with repaired buckles for you immediately, which should arrive in three days. Is that okay for you?
Customer: Three days is quite a long time; I was hoping to receive these helmets sooner. Is there any way to expedite the delivery?
Agent: I understand your urgency. I will do my best to expedite the delivery to two days. How does that sound?
Customer: That would be great, I would be very grateful.
Agent: No problem, Thomas. I will take care of the urgent delivery. Thank you for your understanding and patience.
Customer: Thank you very much for your help. Goodbye!
Agent: You're welcome. Goodbye and have a nice day!

Das folgende Beispiel veranschaulicht die Übersetzung von Text aus zwei verschiedenen Sprachen (in diesem Fall Englisch und Spanisch, oder „Spanglish“) ins Englische. Beachten Sie, dass die Spezifikation der Ausgangssprache die leere Zeichenfolge ist, die AI_TRANSLATE anweist, die Sprache automatisch zu erkennen.

SELECT AI_TRANSLATE('Voy a likear tus fotos en Insta.', '', 'en')

Diese Abfrage führt zu folgenden Ergebnissen:

I'm going to like your photos on Insta.