カテゴリ：

:doc:`/sql-reference/functions-string`（AI 関数）

AI_TRANSLATE

注釈

AI_TRANSLATE は TRANSLATE (SNOWFLAKE.CORTEX) の更新されたバージョンです。最新の関数については、 AI_TRANSLATE を使用してください。

指定された入力テキストをサポートされている言語から別の言語に翻訳します。

構文

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

引数

text

翻訳するテキストを含む文字列。

source_language

現在使われているテキストの言語の言語コードを指定する文字列。対応言語コードのリストについては、 使用上の注意 をご参照ください。ソース言語コードが空の文字列 '' の場合、ソース言語は自動的に検出されます。

target_language

テキストを翻訳する必要のある言語コードを指定する文字列。対応言語コードのリストについては、 使用上の注意 をご参照ください。

オプション：

return_error_details

エラーが発生した場合にエラーの詳細を返すかどうかを示す BOOLEAN フラグ。TRUE に設定した場合、関数は値とエラーメッセージを含む OBJECT を返します。そのうちの1つは関数が成功したか失敗したかに応じて NULL になります。詳細については、`エラー動作`_を参照してください。

戻り値

原文からターゲット言語への翻訳を含む文字列。

エラー動作

デフォルトでは、AI_TRANSLATEが入力を処理できない場合、関数はNULLを返します。クエリが複数の行を処理する場合、エラーのある行はNULLを返し、クエリの完了を妨げません。

エラー時の戻り値は``return_error_details``引数によって異なります。次の表は、``return_error_details``引数に基づいて、どのような戻り値が返されるかを示しています。

return_error_details

戻り値

説明
FALSE

引数が省略された場合

NULL

TRUE

``value``と``error``のフィールドを持つOBJECT
value:翻訳されたテキストを含む VARCHAR 値、またはエラーが発生した場合は NULL。

error:エラーが発生した場合はエラーメッセージを含む VARCHAR 値、または関数が成功した場合は NULL。

AI関数のエラー処理について詳しくは、:doc:`/release-notes/bcr-bundles/2026_02/bcr-2184`を参照してください。

使用上の注意

以下の言語が AI_TRANSLATE 関数でサポートされています。ソース言語とターゲット言語に対応する言語コードを使用します。

AI_TRANSLATE モデルは、翻訳されるテキストに異なる言語が混在している場合にも対応しています（例: 「スパングリッシュ」）。この場合、ソース言語として空の文字列（''）を指定すると、ソーステキストで使用される言語が自動検出されます。

言語

コード

アラビア語

'ar'

中国語

'zh'

クロアチア語

'hr'

チェコ語

'cs'

オランダ語

'nl'

英語

'en'

フィンランド語

'fi'

フランス語:

'fr'

ドイツ語

'de'

ギリシャ語

'el'

ヘブライ語

'he'

ヒンディー語

'hi'

イタリア語

'it'

日本語

'ja'

韓国語

'ko'

ノルウェー語

'no'

ポーランド語

'pl'

ポルトガル語

'pt'

ルーマニア語

'ro'

ロシア語

'ru'

スペイン語

'es'

スウェーデン語

'sv'

トルコ語

'tr'

アクセス制御の要件

ユーザーは、 SNOWFLAKE.CORTEX_USER データベースロール が付与されているロールを使用する必要があります。この権限の詳細については、 Cortex LLM 権限 をご参照ください。

例

次の例では、テーブルの各行を英語からドイツ語に翻訳しています（この例では、 review_content は reviews テーブルからの列です）。

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

次の例では、架空の製品レビューを英語からスペイン語に翻訳しています。

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

このクエリの結果は次のとおりです。

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.

次の例では、通話記録をドイツ語から英語に翻訳しています。

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

結果は次のとおりです。

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!

最後に、次の例では、2つの異なる言語（大文字と小文字）から英語への翻訳を説明します。ソース言語の仕様は空の文字列であることに注意してください。AI_TRANSLATE は言語を自動的に検出するということです。

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

このクエリ結果は次のとおりです。

I'm going to like your photos on Insta.