AI_TRANSLATE (Transact-SQL)

Şunlar için geçerlidir:Microsoft Fabric'te SQL analiz uç noktası ve Microsoft Fabric'teki Ambar

AI_TRANSLATE Giriş metnini hedef dile çevirir.

Note

  • AI_TRANSLATE önizleme aşamasındadır.
  • AI_TRANSLATEyalnızca SQL analytics endpoint ve Microsoft Fabric'te Warehouse olarak mevcuttur.

Syntax

Transact-SQL söz dizimi kuralları

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

Arguments

text

Bir karakter tipinin ifadesi , örneğin nvarchar, varchar, nchar veya char.

lang_code

Çeviri hedefi için dil kodu.

Desteklenen değerler: de, en, fr, it, es, elplsvfics, .

HATA ÜZERINE

Bu madde, ON ERROR bir yapay zeka fonksiyonunun işleme hatalarını nasıl ele aldığını kontrol eder.

  • NULL ON ERROR fonksiyon bir değeri işleyemediğinde döner NULL . Bu varsayılan davranıştır ve açıkça belirtilmesine gerek yoktur.
  • ERROR ON ERROR herhangi bir girdi değeri işlenirken hata oluşursa tüm sorgu başarısız olur.
  • DEFAULT <value> ON ERROR hata meydana geldiğinde değil NULL , belirtilen varsayılan değeri döndürür.

Hatalar, Sorumlu Yapay Zeka güvenlik kontrolleri, giriş boyutu sınırları, geçici hizmet sorunları veya diğer işlem hatalarından kaynaklanabilir.

Dönüş türleri

Çevirilmiş metinle birlikte nvarchar(max) döndürüyor.

Remarks

Yapay zeka modelleri metni işleyemezse yapay zeka fonksiyonları geri NULL döner. Yaygın nedenler şunlardır:

  • Sorumlu yapay zeka kuralları, giriş metnindeki uygunsuz içeriği engeller.
  • Giriş metni belirteç sınırlarını aşıyor. Geçerli model en fazla 15 KB metin destekler.

Examples

A. Almancaya çeviri

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

Beklenen sonuç: Das Hotel war großartig.

B. İnceleme metnini birden fazla dile çevir

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;

Almancaya çeviri başarısız olursa, hata yerine ilk fonksiyon geri NULL döner.

Bu madde, NULL ON ERROR metni Fransızcaya çeviren yapay zeka fonksiyonuna, herhangi bir giriş değeri çevrilemezse sorguda başarısız olmasını emreder. Bu madde, DEFAULT 'N/A' ON ERROR metni İspanyolcaya çeviren yapay zeka fonksiyonuna, işlenemeyen her giriş değeri için değeri N/A döndürmesini emrediyor.