카테고리:

문자열 및 이진 함수 (AI 함수), 파일 함수 (AI 함수)

AI_COMPLETE

참고

AI_COMPLETE 은 COMPLETE (SNOWFLAKE.CORTEX) 의 업데이트된 버전입니다. 최신 기능의 경우 AI_COMPLETE 를 사용하십시오.

지원되는 언어 모델을 사용하여 텍스트 또는 이미지에서 응답(완료)을 생성합니다. 다음을 제공할 수 있습니다.

  • 모델로부터 응답을 생성하는 텍스트 프롬프트. 자세한 내용은 AI_COMPLETE (단일 문자열) 섹션을 참조하십시오.

  • 이미지와 프롬프트에 따라 응답을 생성하는 텍스트 프롬프트와 단일 이미지. 자세한 내용은 AI_COMPLETE (단일 이미지) 섹션을 참조하십시오.

  • 여러 이미지와 텍스트를 지원할 수 있는 프롬프트 오브젝트. 자세한 내용은 AI_COMPLETE (프롬프트 오브젝트) 섹션을 참조하십시오.

구문

함수의 구문은 공급자가 제공하는 입력 유형에 따라 달라집니다. 구문에 대한 자세한 내용은 다음 섹션을 참조하십시오.

모든 구문 변형은 선택적 return_error_details BOOLEAN 인자를 최종 매개 변수로 사용합니다. TRUE로 설정하는 경우 함수는 해당 값 및 오류 메시지가 포함된 OBJECT를 반환하며, 그중 하나는 함수의 성공 여부에 따라 NULL이 됩니다. 자세한 내용은 `오류 동작`_을 참조하세요.

오류 동작

기본적으로 AI_COMPLETE이 입력을 처리할 수 없는 경우, 함수는 NULL을 반환합니다. 쿼리가 여러 행을 처리하는 경우 오류가 있는 행은 NULL을 반환하며 쿼리가 완료되는 것을 중단하지 않습니다.

오류 시 반환 값은 return_error_details 인자에 따라 다릅니다. 다음 테이블은 return_error_details 인자를 기반으로 한 반환 값을 보여줍니다.

return_error_details

반환 값

설명
FALSE

성공하지 않음

NULL

TRUE

value 및 error 필드를 포함한 OBJECT
value: 완료 응답(일반 반환 값과 동일한 유형)이거나 오류가 발생한 경우 NULL입니다.

error: 오류가 발생한 경우 오류 메시지가 포함된 VARCHAR 값이거나 함수가 성공한 경우 NULL입니다.

AI 함수의 오류 처리에 대한 자세한 내용은 Snowflake Cortex AI Function: Multirow error handling improvements 섹션을 참조하세요.

액세스 제어 요구 사항

사용자는 SNOWFLAKE.CORTEX_USER 데이터베이스 역할 이 부여된 역할을 사용해야 합니다. 이 권한에 대한 자세한 내용은 Cortex LLM 권한 섹션을 참조하십시오.