AI_TRANSLATE¶

Syntaxe¶

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

Arguments¶

text

Chaîne contenant le texte à traduire.

source_language

Chaîne spécifiant le code de la langue dans laquelle le texte est actuellement rédigé. Voir Notes sur l’utilisation pour une liste des codes de langue pris en charge. Si le code de la langue source est une chaîne vide, '', la langue source est automatiquement détectée.

target_language

Chaîne spécifiant le code de la langue dans laquelle le texte doit être traduit. Voir Notes sur l’utilisation pour une liste des codes de langue pris en charge.

Facultatif :

return_error_details

Un indicateur BOOLEAN qui indique s’il faut renvoyer les détails de l’erreur en cas d’erreur. Lorsqu’il est défini sur TRUE, la fonction renvoie un OBJECT qui contient la valeur et le message d’erreur, dont l’un est NULL selon que la fonction réussit ou échoue. Voir Comportement d’erreur pour plus de détails.

Renvoie¶

Chaîne contenant une traduction du texte d’origine dans la langue cible.

Comportement d’erreur¶

Par défaut, si AI_TRANSLATE ne peut pas traiter l’entrée, la fonction renvoie NULL. Si la requête traite plusieurs lignes, les lignes contenant des erreurs renvoient NULL et n’empêchent pas l’achèvement de la requête.

La valeur de retour sur l’erreur dépend de l’argument return_error_details. La table suivante indique la valeur de retour basée sur l’argument return_error_details :

return_error_details	Valeur de retour	Description
FALSE Non transmise	NULL
TRUE	OBJECT avec les champs value et error	value : Une valeur VARCHAR qui contient le texte traduit, ou NULL si une erreur s’est produite. error : Une valeur VARCHAR qui contient le message d’erreur si une erreur s’est produite, ou NULL si la fonction a fonctionné.

See moreShow less

Expand

Pour plus d’informations sur le traitement des erreurs pour les fonctions AI, voir Snowflake Cortex AI Function: Multirow error handling improvements.

Notes sur l’utilisation¶

Les langues suivantes sont prises en charge par la fonction AI_TRANSLATE. Utilisez le code de la langue correspondant à la langue source et à la langue cible.

Le modèle AI_TRANSLATE prend également en charge un mélange de langues différentes dans le texte à traduire (par exemple, le « Spanglish »). Dans ce cas, spécifiez une chaîne vide ('') comme langue source afin de détecter automatiquement les langues utilisées dans le texte source.

Exigences en matière de contrôle d’accès¶

Les utilisateurs doivent utiliser un rôle auquel le rôle de base de données SNOWFLAKE.CORTEX_USER a été accordé. Voir Privilèges LLM Cortex pour plus d’informations sur ce privilège.

Exemples¶

L’exemple suivant traduit chaque ligne d’une table de l’anglais vers l’allemand (dans cet exemple, review_content est une colonne de la table reviews) :

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

L’exemple suivant traduit un avis fictif sur un produit de l’anglais vers l’espagnol :

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');

Le résultat de cette requête est le suivant :

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.

L’exemple suivant traduit une transcription d’appel de l’allemand vers l’anglais :

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');

Le résultat est le suivant :

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!

Et enfin, l’exemple suivant illustre la traduction d’un texte de deux langues différentes (dans ce cas l’anglais et l’espagnol, ou le « Spanglish ») vers l’anglais. Notez que la spécification de la langue source est la chaîne vide, qui indique AI_TRANSLATE pour détecter automatiquement la langue.

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

Les résultats de cette requête sont les suivants :

I'm going to like your photos on Insta.

Avis juridiques¶

Reportez-vous à Snowflake AI et ML.