AI_TRANSLATE
AI_TRANSLATE
주어진 입력 텍스트를 지원되는 언어에서 다른 언어로 번역하는 AI 함수예요. Snowflake Cortex AI 기반의 다국어 번역이 필요할 때 씁니다.
본문
AI_TRANSLATE(
<text>, <source_language>, <target_language> [, <return_error_details> ] )
text — 번역할 텍스트가 담긴 문자열이에요.
source_language — 텍스트가 현재 쓰인 언어 코드를 지정하는 문자열이에요. 소스 언어 코드가 빈 문자열('')이면 소스 언어를 자동으로 감지해요.
target_language — 텍스트를 번역할 언어 코드를 지정하는 문자열이에요.
return_error_details (선택) — 오류 시 오류 세부 정보를 반환할지 여부를 나타내는 BOOLEAN 플래그예요. TRUE면 값과 오류 메시지를 담은 OBJECT를 반환하는데, 성공·실패 여부에 따라 둘 중 하나가 NULL이에요.
반환값 — 원본 텍스트를 대상 언어로 번역한 문자열이에요.
오류 동작 — 기본적으로 AI_TRANSLATE가 입력을 처리할 수 없으면 NULL을 반환해요. 쿼리가 여러 행을 처리하면 오류가 있는 행은 NULL을 반환하고 쿼리가 완료되는 것을 막지 않아요. return_error_details가 TRUE면 값(value)과 오류(error) 필드를 가진 OBJECT인데, 오류가 있으면 value가 NULL이고 오류 메시지가 error에 들어가요.
사용 메모 — 지원되는 언어와 코드: Arabic 'ar', Chinese 'zh', Croatian 'hr', Czech 'cs', Dutch 'nl', English 'en', Finnish 'fi', French 'fr', German 'de', Greek 'el', Hebrew 'he', Hindi 'hi', Italian 'it', Japanese 'ja', Korean 'ko', Norwegian 'no', Polish 'pl', Portuguese 'pt', Romanian 'ro', Russian 'ru', Spanish 'es', Swedish 'sv', Turkish 'tr'.
번역 중인 텍스트에 서로 다른 언어가 섞여 있으면(예: "Spanglish") 소스 언어로 빈 문자열('')을 지정해 언어를 자동 감지하세요. AI_TRANSLATE는 최대 100,000 입력 토큰을 받아요. 지원 언어 전반에서 번역의 입력-출력 토큰 비율이 대략 1:1이므로, 번역 요청은 소스 텍스트(입력 토큰)와 생성된 번역(출력 토큰)을 합쳐 최대 200,000 토큰까지 처리할 수 있어요.
접근 제어 요구사항 — 사용자는 SNOWFLAKE.CORTEX_USER 데이터베이스 역할이 부여된 역할을 사용해야 해요.
예시 — 테이블의 각 행을 영어에서 독일어로 번역:
SELECT AI_TRANSLATE(review_content, 'en', 'de') FROM reviews LIMIT 10;
소스 언어를 빈 문자열로 지정해 자동 감지하게 할 수도 있어요.
SELECT AI_TRANSLATE('Voy a likear tus fotos en Insta.', '', 'en')
I'm going to like your photos on Insta.
참고: AI_TRANSLATE는 TRANSLATE의 업데이트 버전이에요. 최신 기능을 쓰려면 AI_TRANSLATE를 사용하세요.