AI_TRANSLATE (Transact-SQL)

Berlaku untuk:Titik akhir analitik SQL di Microsoft Fabric dan Warehouse di Microsoft Fabric

AI_TRANSLATE menerjemahkan teks input ke dalam bahasa target.

Note

  • AI_TRANSLATE dalam tahap pratinjau.
  • AI_TRANSLATEhanya tersedia di titik akhir analitik SQL dan Gudang di Microsoft Fabric.

Syntax

Konvensi sintaks Transact-SQL

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

Arguments

kirim pesan teks

Ekspresi jenis karakter, misalnya nvarchar, varchar, nchar, atau char.

lang_code

Kode bahasa untuk target terjemahan.

Nilai yang didukung: de, , , enfriteselplsvfics

KARENA KESALAHAN

Klausul ini ON ERROR mengatur bagaimana fungsi AI menangani kesalahan pemrosesan.

  • NULL ON ERROR Mengembalikan NULL ketika fungsi tidak dapat memproses sebuah nilai. Ini adalah perilaku default dan tidak perlu dijelaskan secara eksplisit.
  • ERROR ON ERROR menyebabkan seluruh kueri gagal jika terjadi kesalahan saat memproses nilai input apa pun.
  • DEFAULT <value> ON ERROR mengembalikan nilai default yang ditentukan, bukan NULL saat terjadi kesalahan.

Kesalahan dapat disebabkan oleh pemeriksaan keamanan AI yang bertanggung jawab , batas ukuran input, masalah layanan sementara, atau kegagalan pemrosesan lainnya.

Tipe pengembalian

Mengembalikan nvarchar(max) dengan teks terjemahan.

Remarks

Fungsi AI kembali NULL jika model AI tidak dapat memproses teks. Alasan umum termasuk:

  • Aturan AI yang bertanggung jawab memblokir konten yang tidak pantas dalam teks input.
  • Teks input melebihi batas token. Model saat ini mendukung hingga 15 KB teks.

Examples

A. Terjemahkan ke bahasa Jerman

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

Hasil yang diharapkan: Das Hotel war großartig.

B. Menerjemahkan teks ulasan ke dalam berbagai bahasa

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;

Jika terjemahan ke bahasa Jerman gagal, fungsi pertama akan kembali NULL menggantikan error.

Klausa ini NULL ON ERROR menginstruksikan fungsi AI yang menerjemahkan teks ke bahasa Prancis untuk gagal dalam kueri jika ada nilai input yang tidak dapat diterjemahkan. Klausa ini DEFAULT 'N/A' ON ERROR menginstruksikan fungsi AI yang menerjemahkan teks ke bahasa Spanyol untuk mengembalikan nilai N/A untuk setiap nilai input yang tidak dapat diproses.

Konten terkait

  • Last updated on