AI_TRANSLATE (Transact-SQL)

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

AI_TRANSLATE 입력된 텍스트를 목표 언어로 번역합니다.

메모

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

Syntax

Transact-SQL 구문 표기 규칙

AI_TRANSLATE ( text, lang_code [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

Arguments

text

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

lang_code

번역 대상의 언어 코드.

지원 값: de, en, fr, it, esel, , pl, , sv, . fics

오류 때

이 절은 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_translate('The hotel was great', 'de') AS translation_de;

예상 결과: Das Hotel war großartig.

B. 리뷰 텍스트를 여러 언어로 번역하기

SELECT review_id,
       ai_translate(review_text, 'de') AS review_de,
       ai_translate(review_text, 'fr' ERROR ON ERROR) AS review_fr,
       ai_translate(review_text, 'es' DEFAULT 'N/A' ON ERROR) AS review_es
FROM dbo.hotel_reviews;

독일어 번역이 실패하면, 오류 대신 첫 번째 함수가 반환 NULL 됩니다.

이 절은 NULL ON ERROR 텍스트를 프랑스어로 번역하는 AI 함수가 입력값을 번역할 수 없을 경우 쿼리에 실패하도록 지시합니다. 이 절은 DEFAULT 'N/A' ON ERROR 텍스트를 스페인어로 번역하는 AI 함수가 처리할 수 없는 모든 입력값에 대해 값을 N/A 반환하도록 지시합니다.

관련 콘텐츠

  • Last updated on