적용 대상:
Microsoft Fabric의 SQL 분석 엔드포인트 및 Microsoft Fabric의 웨어하우스
이 함수는 AI_ANALYZE_SENTIMENT 입력 텍스트를 분석하여 다음과 같은 감시 라벨 중 하나를 반환합니다: positive, negative, mixed, 또는 neutral.
메모
-
AI_ANALYZE_SENTIMENT는 미리 보기로 제공됩니다. -
AI_ANALYZE_SENTIMENTSQL 분석 엔드포인트와 Microsoft Fabric의 Warehouse에서만 제공됩니다.
Syntax
AI_ANALYZE_SENTIMENT ( 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를 다음 값 중 하나로 반환합니다:
positivenegativemixedneutral
Remarks
AI 모델이 텍스트를 처리할 수 없으면 AI 기능이 반환 NULL 됩니다. 일반적인 이유는 다음과 같습니다.
- 책임 있는 AI 규칙은 입력 텍스트에서 부적절한 내용을 차단합니다.
- 입력 텍스트가 토큰 제한을 초과합니다. 현재 모델은 최대 15KB의 텍스트를 지원합니다.
Examples
A. 문자열 안의 감정을 분석하세요
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 절은 입력값이 처리되지 않으면 쿼리가 실패하게 만듭니다.