AI_TRANSLATE(Transact-SQL)

適用対象:Microsoft Fabric の SQL 分析エンドポイントと Microsoft Fabric のウェアハウス

AI_TRANSLATE 入力テキストを目標言語に翻訳します。

Note

  • AI_TRANSLATE はプレビュー段階です。
  • AI_TRANSLATESQL分析エンドポイントおよびMicrosoft FabricのWarehouseでのみ利用可能です。

Syntax

Transact-SQL 構文表記規則

AI_TRANSLATE ( text, lang_code [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

引数

SMS 送信

例えばnvarchar、varchar、nchar、charなど、文字タイプの表現です。

lang_code

翻訳対象の言語コード。

支持値: de、 en、 fr、 it、 es、 el、 pl、 sv、 fi、 cs。

エラーで

ON ERROR節はAI関数が処理エラーをどのように扱うかを制御します。

  • NULL ON ERROR 関数が値を処理できない場合に NULL 返します。 これはデフォルトの動作であり、明示的に指定する必要はありません。
  • ERROR ON ERROR 入力値の処理中にエラーが発生した場合、クエリ全体が失敗します。
  • DEFAULT <value> ON ERROR エラーが発生した場合、 NULL ではなく指定されたデフォルト値を返します。

エラーは 責任あるAI の安全チェック、入力サイズ制限、一時的なサービス問題、その他の処理障害によって引き起こされることがあります。

戻り値の型

翻訳テキスト付きで nvarchar(max) を返します。

Remarks

AIモデルがテキストを処理できない場合、AI関数は NULL を返します。 一般的な理由は次のとおりです。

  • 責任あるAIルールは 入力テキスト内の不適切な内容をブロックします。
  • 入力テキストがトークンの制限を超えています。 現在のモデルでは、最大 15 KB のテキストがサポートされています。

Examples

A. ドイツ語に翻訳

SELECT ai_translate('The hotel was great', 'de') AS translation_de;

想定される結果: Das Hotel war großartig.

B. レビューテキストを複数の言語に翻訳する

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;

ドイツ語への翻訳が失敗した場合、最初の関数はエラーではなく NULL を返します。

NULL ON ERROR節は、テキストをフランス語に翻訳するAI関数が、入力値が翻訳できない場合にクエリに失敗するよう指示します。 DEFAULT 'N/A' ON ERROR条項は、テキストをスペイン語に翻訳するAI関数に、処理できないすべての入力値に対してN/A値を返すよう指示します。

関連するコンテンツ

  • Last updated on