AI_TRANSLATE (Transact-SQL)

Применимо к:Конечная точка аналитики SQL в Microsoft Fabric и хранилище в Microsoft Fabric

AI_TRANSLATE переводит вводный текст на целевой язык.

Note

  • AI_TRANSLATE находится в предварительной версии.
  • AI_TRANSLATEдоступна только в SQL analytics endpoint и Warehouse в Microsoft Fabric.

Syntax

Соглашения о синтаксисе Transact-SQL

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

Arguments

text

Выражение типа иероглифа, например nvarchar, varchar, nchar или char.

lang_code

Языковой код для цели перевода.

Поддерживаемые ценности: de, en, fr, it, es, el, plsvfics.

НА ОШИБКЕ

Этот ON ERROR пункт управляет, как функция ИИ обрабатывает ошибки обработки.

  • NULL ON ERROR возвращается NULL , когда функция не может обработать значение. Это поведение по умолчанию и не требует явного указания.
  • ERROR ON ERROR вызывает сбой всего запроса, если при обработке любого входного значения возникает ошибка.
  • DEFAULT <value> ON ERROR возвращает указанное значение по умолчанию, а не NULL когда возникает ошибка.

Ошибки могут быть вызваны проверками безопасности ответственного ИИ , ограничениями по размеру входов, временными сервисными проблемами или другими сбоями обработки.

Типы возвращаемых данных

Возвращает nvarchar(max) с переведённым текстом.

Remarks

Функции ИИ возвращаются NULL , если модель ИИ не может обработать текст. Некоторые из распространенных причин:

  • Правила ответственного ИИ блокируют неподходящий контент в вводном тексте.
  • Входной текст превышает ограничения маркера. Текущая модель поддерживает до 15 КБ текста.

Examples

А. Перевести на немецкий

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

Ожидаемый результат: Das Hotel war großartig.

B. Переводите текст обзора на несколько языков

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;

Если перевод на немецкий не удаётся, вместо ошибки вернётся NULL первая функция.

Предложение NULL ON ERROR инструктирует функцию ИИ, переводящую текст на французский, провалить запрос, если какое-либо входное значение не может быть переведено. Предложение DEFAULT 'N/A' ON ERROR инструктирует функцию ИИ, переводящую текст на испанский, вернуть значение N/A для каждого входного значения, которое невозможно обработать.

Связанный контент

  • Last updated on