AI_TRANSLATE (Transact-SQL)

Platí pro:Koncový bod analýzy SQL v Microsoft Fabric a Warehouse v Microsoft Fabric

AI_TRANSLATE překládá vstupní text do cílového jazyka.

Note

  • AI_TRANSLATE je ve verzi Preview.
  • AI_TRANSLATEje dostupný pouze v SQL analytics endpointu a Warehouse v Microsoft Fabric.

Syntax

Transact-SQL konvence syntaxe

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

Arguments

poslat SMS

Výraz typu znaku, například nvarchar, varchar, nchar nebo char.

lang_code

Jazykový kód pro cílovou překladovou adresu.

Podporované hodnoty: de, en, fr, it, , esel, pl, , sv, fi, . cs

NA CHYBĚ

Tato ON ERROR klauzule řídí, jak AI funkce zpracovává chyby zpracování.

  • NULL ON ERROR vrací NULL , když funkce nemůže zpracovat hodnotu. Toto je výchozí chování a není nutné to výslovně specifikovat.
  • ERROR ON ERROR způsobí, že celý dotaz selže, pokud při zpracování jakékoli vstupní hodnoty dojde k chybě.
  • DEFAULT <value> ON ERROR vrací zadanou výchozí hodnotu místo NULL toho, kdy nastane chyba.

Chyby mohou být způsobeny bezpečnostními kontrolami odpovědné AI , limity velikosti vstupů, přechodnými službami nebo jinými selháními zpracování.

Návratové typy

Vrací nvarchar(max) s přeloženým textem.

Remarks

AI funkce se vrátí NULL , pokud AI model nedokáže text zpracovat. Mezi běžné důvody patří:

  • Pravidla odpovědné AI blokují nevhodný obsah ve vstupním textu.
  • Vstupní text překračuje limity tokenů. Aktuální model podporuje až 15 kB textu.

Examples

A. Přeložit do němčiny

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

Očekávaný výsledek: Das Hotel war großartig.

B. Překládejte text přehledu do více jazyků

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;

Pokud překlad do němčiny selže, první funkce NULL se vrátí místo chyby.

Klauzule NULL ON ERROR instruuje AI funkci, která překládá text do francouzštiny, aby dotaz neuspěla, pokud nelze přeložit žádnou vstupní hodnotu. Klauzule DEFAULT 'N/A' ON ERROR instruuje AI funkci, která překládá text do španělštiny, aby vrátila hodnotu N/A pro každou vstupní hodnotu, kterou nelze zpracovat.