AI_TRANSLATE (Transact-SQL)

Gäller för:SQL-analysslutpunkt i Microsoft Fabric och Warehouse i Microsoft Fabric

AI_TRANSLATE översätter inmatad text till ett målspråk.

Note

  • AI_TRANSLATE är i förhandsversion.
  • AI_TRANSLATEfinns endast i SQL analytics endpoint och Warehouse i Microsoft Fabric.

Syntax

Transact-SQL syntaxkonventioner

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

Arguments

text

Ett uttryck för en karaktärstyp, till exempel nvarchar, varchar, nchar eller char.

lang_code

Språkkod för översättningsmålet.

Stödda värden: de, en, , frit, , es, elplsvfi. cs

PÅ MISSTAG

Klausulen ON ERROR styr hur en AI-funktion hanterar bearbetningsfel.

  • NULL ON ERROR returnerar NULL när funktionen inte kan bearbeta ett värde. Detta är standardbeteendet och behöver inte specificeras uttryckligen.
  • ERROR ON ERROR gör att hela frågan misslyckas om ett fel uppstår under bearbetningen av något indatavärde.
  • DEFAULT <value> ON ERROR returnerar det angivna standardvärdet istället för NULL när ett fel uppstår.

Fel kan orsakas av säkerhetskontroller för Responsible AI , begränsningar av inmatningsstorlek, problem med tillfällig service eller andra bearbetningsfel.

Returtyper

Returnerar nvarchar(max) med översatt text.

Remarks

AI-funktioner återvänder NULL om AI-modellen inte kan bearbeta texten. Vanliga orsaker är:

  • Ansvarsfulla AI-regler blockerar olämpligt innehåll i inmatningstexten.
  • Indatatexten överskrider tokengränserna. Den aktuella modellen stöder upp till 15 kB text.

Examples

A. Översätt till tyska

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

Förväntat resultat: Das Hotel war großartig.

B. Översätt recensionstext till flera språk

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;

Om översättningen till tyska misslyckas kommer den första funktionen att returnera NULL istället för fel.

Klausulen NULL ON ERROR instruerar AI-funktionen som översätter text till franska att misslyckas med frågan om något inmatningsvärde inte kan översättas. Klausulen DEFAULT 'N/A' ON ERROR instruerar AI-funktionen som översätter text till spanska att returnera värdet N/A för varje indatavärde som inte kan bearbetas.

Relaterat innehåll

  • Last updated on