AI_SUMMARIZE (Transact-SQL)

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

AI_SUMMARIZE 입력된 텍스트의 간결한 요약을 생성합니다.

메모

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

Syntax

Transact-SQL 구문 표기 규칙

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

Arguments

text

예를 들어 nvarchar, varchar, nchar, char같은 문자 유형의 표현식입니다.

오류 때

이 절은 ON ERROR AI 함수가 처리 오류를 어떻게 처리하는지를 제어합니다.

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

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

반환 형식

생성된 요약을 포함한 nvarchar 를 반환합니다.

Remarks

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

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

Examples

A. 문장을 요약해 보세요

SELECT ai_summarize('The hotel was clean and staff were friendly.') AS summary;

예상 결과: Clean hotel, friendly staff.

B. 검토 텍스트를 표로 요약하세요

다음 쿼리는 모든 review_text 값을 외부 AI 서비스에 보내 요약합니다.

SELECT review_id,
       ai_summarize(review_text DEFAULT 'N/A' ON ERROR) AS review_summary
FROM dbo.hotel_reviews;

선택적 DEFAULT 'N/A' ON ERROR 절은 AI 함수가 처리할 수 없는 모든 입력값에 대해 'N/A' 값을 반환하도록 지시합니다.

관련 콘텐츠

  • Last updated on