AI_ANALYZE_SENTIMENT (Transact-SQL)

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

Функция анализирует AI_ANALYZE_SENTIMENT входный текст и возвращает одну из таких меток настроения: positive, negative, mixed, или neutral.

Note

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

Syntax

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

AI_ANALYZE_SENTIMENT ( text [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

Arguments

text

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

НА ОШИБКЕ

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

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

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

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

Возвращает nvarchar с одним из следующих значений:

  • positive
  • negative
  • mixed
  • neutral

Remarks

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

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

Examples

А. Анализируйте настроения по цепочке

SELECT ai_analyze_sentiment('This hotel was great!') AS sentiment;

Ожидаемый результат: positive

B. Анализируйте настроения по столбцу таблицы

SELECT review_id,
       ai_analyze_sentiment(review_text ERROR ON ERROR) AS sentiment
FROM dbo.hotel_reviews;

Необязательное ERROR ON ERROR предложение приводит к неудаче запроса, если какое-либо входное значение не может быть обработано.