AI_EXTRACT (Transact-SQL)

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

AI_EXTRACT Функция извлекает значения из входного текста с помощью предоставленных вами классов и возвращает результат в виде JSON-объекта.

Note

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

Syntax

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

AI_EXTRACT ( text, class1, class2 [ , ...n ] [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

Arguments

text

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

Класс 1, класс 2, ... n

Одно или несколько имён свойств можно извлечь из текста.

НА ОШИБКЕ

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

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

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

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

Возвращается nvarchar(max) , содержащий JSON-текст.

Remarks

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

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

Examples

А. Извлечение свойств из предложения

SELECT ai_extract('Check-in was late and room dirty', 'sentiment', 'problem') AS extraction;

Ожидаемый результат: {"sentiment":"Negative","problem":"Dirty room"}

B. Parse извлекал JSON на столбцы

SELECT sentiment, time_reported, problem
FROM dbo.hotel_reviews
CROSS APPLY OPENJSON(
    ai_extract(review_text, 'sentiment', 'time_reported', 'problem')
) WITH (
    sentiment VARCHAR(1000),
    time_reported VARCHAR(100),
    problem VARCHAR(1000)
);

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

  • Last updated on