AI_TRANSLATE (Transact-SQL)

Aplica-se a:Endpoint de análise SQL no Microsoft Fabric e Warehouse no Microsoft Fabric

AI_TRANSLATE traduz o texto de entrada para a língua-alvo.

Note

  • AI_TRANSLATE está em versão de prévia.
  • AI_TRANSLATEestá disponível apenas no endpoint de análise SQL e no Warehouse no Microsoft Fabric.

Syntax

Transact-SQL convenções de sintaxe

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

Arguments

enviar SMS

Uma expressão de um tipo de carácter, por exemplo nvarchar, varchar, nchar ou char.

lang_code

Código linguístico para o destino de tradução.

Valores suportados: de, en, frit, , es, el, pl, sv, , fi, , . cs

ERRO

A ON ERROR cláusula controla como uma função de IA lida com erros de processamento.

  • NULL ON ERROR retorna NULL quando a função não consegue processar um valor. Este é o comportamento padrão e não precisa de ser especificado explicitamente.
  • ERROR ON ERROR faz com que toda a consulta falhe se ocorrer um erro durante o processamento de qualquer valor de entrada.
  • DEFAULT <value> ON ERROR devolve o valor padrão especificado em vez de NULL quando ocorre um erro.

Os erros podem ser causados por verificações de segurança da IA responsável , limites de tamanho de entrada, problemas de serviço transitórios ou outras falhas de processamento.

Tipos de devolução

Devolve nvarchar(max) com texto traduzido.

Remarks

As funções de IA retornam NULL se o modelo de IA não conseguir processar o texto. Razões comuns incluem:

  • As regras de IA responsável bloqueiam conteúdos inadequados no texto de entrada.
  • O texto de entrada ultrapassa os limites de tokens. O modelo atual suporta até 15 KB de texto.

Exemplos

A. Traduzir para alemão

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

Resultado esperado: Das Hotel war großartig.

B. Traduzir texto de revisão para várias línguas

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 a tradução para alemão falhar, a primeira função devolverá NULL em vez do erro.

A NULL ON ERROR cláusula instrui a função de IA que traduz texto para francês a falhar a consulta se qualquer valor de entrada não puder ser traduzido. A DEFAULT 'N/A' ON ERROR cláusula instrui a função de IA que traduz texto para espanhol a devolver o valor N/A de cada valor de entrada que não possa ser processado.

Conteúdo relacionado

  • Last updated on