AI_FIX_GRAMMAR (Transact-SQL)

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

AI_FIX_GRAMMAR 이 기능은 문법을 교정하고 입력된 텍스트의 문장 품질을 향상시킵니다.

메모

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

Syntax

Transact-SQL 구문 표기 규칙

AI_FIX_GRAMMAR ( 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(max)를 반환합니다.

Remarks

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

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

Examples

A. 문자열 내 문법 고정

SELECT ai_fix_grammar('Th room are clean and staff were nice') AS fixed_text;

예상 결과: The rooms are clean, and the staff were nice.

B. 칼럼을 안전하게 업데이트하기

UPDATE dbo.hotel_reviews
SET review_text = ISNULL(ai_fix_grammar(review_text), review_text);