AI_EXTRACT (Transact-SQL)

적용 대상:Microsoft Fabric의 SQL 분석 엔드포인트 및 Microsoft Fabric의 웨어하우스

이 함수는 AI_EXTRACT 제공한 클래스를 사용해 입력 텍스트에서 값을 추출하고, 그 결과를 JSON 객체로 반환합니다.

메모

  • AI_EXTRACT 는 미리 보기로 제공됩니다.
  • AI_EXTRACTSQL 분석 엔드포인트와 Microsoft Fabric의 Warehouse에서만 제공됩니다.

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 AI 함수가 처리 오류를 어떻게 처리하는지를 제어합니다.

  • NULL ON ERROR 함수가 값을 처리할 수 없을 때 반환 NULL 합니다. 이것이 기본 동작이며 명시적으로 명시할 필요는 없습니다.
  • ERROR ON ERROR 입력값을 처리하는 과정에서 오류가 발생하면 전체 쿼리가 실패하게 됩니다.
  • DEFAULT <value> ON ERROR 오류가 발생했을 때 대신 지정된 기본값 NULL 을 반환합니다.

오류는 책임 있는 AI 안전 점검, 입력 크기 제한, 일시적인 서비스 문제, 기타 처리 실패로 인해 발생할 수 있습니다.

반환 형식

JSON 텍스트가 포함된 반환 항목 nvarchar(max) .

Remarks

AI 모델이 텍스트를 처리할 수 없으면 AI 기능이 반환 NULL 됩니다. 일반적인 이유는 다음과 같습니다.

  • 책임 있는 AI 규칙은 입력 텍스트에서 부적절한 내용을 차단합니다.
  • 입력 텍스트가 토큰 제한을 초과합니다. 현재 모델은 최대 15KB의 텍스트를 지원합니다.

Examples

A. 문장에서 속성 추출

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

예상 결과: {"sentiment":"Negative","problem":"Dirty room"}

B. 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