AI_TRANSLATE (Transact-SQL)

Si applica a:Endpoint di analisi SQL in Microsoft Fabric e Warehouse in Microsoft Fabric

AI_TRANSLATE traduce il testo in input nella lingua di destinazione.

Note

  • AI_TRANSLATE è in anteprima.
  • AI_TRANSLATEè disponibile solo nell'endpoint SQL Analytics e nel Warehouse in Microsoft Fabric.

Syntax

Convenzioni relative alla sintassi Transact-SQL

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

Arguments

text

Un'espressione di un tipo di carattere, ad esempio nvarchar, varchar, nchar o char.

lang_code

Codice linguistico per il target di traduzione.

Valori supportati: de, en, fr, ites, el, pl. svfics

ERRORE

La ON ERROR clausola controlla come una funzione IA gestisce gli errori di elaborazione.

  • NULL ON ERROR ritorna NULL quando la funzione non riesce a elaborare un valore. Questo è il comportamento predefinito e non deve essere specificato esplicitamente.
  • ERROR ON ERROR fa fallire l'intera query se si verifica un errore durante l'elaborazione di qualsiasi valore di input.
  • DEFAULT <value> ON ERROR restituisce il valore predefinito specificato invece di NULL quando si verifica un errore.

Gli errori possono essere causati da controlli di sicurezza Responsible AI , limiti di dimensione degli input, problemi di servizio transitori o altri fallimenti di elaborazione.

Tipi restituiti

Restituisce nvarchar(max) con testo tradotto.

Remarks

Le funzioni IA tornano NULL se il modello IA non riesce a processare il testo. I motivi comuni includono:

  • Le regole di IA responsabile bloccano contenuti inappropriati nel testo di input.
  • Il testo di input supera i limiti dei token. Il modello corrente supporta fino a 15 KB di testo.

Examples

A. Traduce in tedesco

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

Risultato previsto: Das Hotel war großartig.

B. Traduci il testo della recensione in più lingue

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;

Se la traduzione in tedesco fallisce, la prima funzione verrà restituita NULL invece dell'errore.

La NULL ON ERROR clausola istruisce la funzione AI che traduce il testo in francese di fallire la query se qualsiasi valore di input non può essere tradotto. La DEFAULT 'N/A' ON ERROR clausola istruisce la funzione AI che traduce il testo in spagnolo a restituire il valore N/A per ogni valore di input che non può essere elaborato.

Contenuti correlati

  • Last updated on