업스테이지 AI 기능을 서버리스 네이티브 애플리케이션으로 Snowflake 환경 내부에 직접 배포해보세요. Native App은 Snowflake 계정 내에서 전적으로 실행되어 데이터 프라이버시와 컴플라이언스를 보장하면서, 문서 처리와 AI 작업을 위해 Snowflake의 컴퓨팅 리소스를 활용해요.
개요
Snowflake용 Native App은 강력한 AI 기능을 Snowflake 환경 내에서 직접 제공해요.
모든 처리는 Snowflake의 네이티브 컴퓨팅 풀과 컨테이너 서비스를 사용해 Snowflake 계정 내부에서 안전하게 이루어져요. 데이터는 환경 외부로 절대 유출되지 않아요.
업스테이지 콘솔과의 기능 차이점
- 페이로드 크기: 업스테이지 콘솔과 동일하게 요청당 최대 50MB까지 지원해요.
- 페이지 한도: 요청당 최대 100페이지(동기 처리).
- 응답 크기: 응답이 너무 큰 경우 Snowflake의 행당 크기 한도에 도달할 수 있어요.
Row is too large to be serialized for external function오류가 발생하면 아래 16MB 응답 한도 처리 섹션을 참고해주세요. - 파일 포맷 지원: Document Parsing 기능의 경우 HWP 파일 포맷은 지원되지 않아요.
- 처리 모드: 현재는 동기 처리만 지원해요.
- 자동 재개 및 재시작: 컴퓨팅 풀은 비용 절감을 위해 유휴 상태에서 일시 중지되지만, 자동 재개 중 AI 모델이 다시 로드되는 동안 약간의 지연이 발생할 수 있어요.
필수 사전 요구사항
Native App을 설치하기 전에 다음 권한이 있어야 해요.
CREATE COMPUTE POOL: Snowflake Container Services를 통해 애플리케이션 서비스를 실행하는 데 필요해요CREATE WAREHOUSE: Snowflake 내에서 쿼리를 실행하는 데 필요해요Database and Schema Access: 데이터베이스, 스키마, 스테이지에 대한 액세스를 부여하는 권한
이러한 권한은 일반적으로 계정 관리자가 보유해요. 권한이 없으시면 Snowflake 관리자에게 문의해주세요.
공통 설치 및 설정
Snowflake Marketplace에서 설치
- Snowflake Marketplace로 이동해
Upstage를 검색해주세요. - 업스테이지 리스팅에서 제품 항목을 클릭해 설치를 시작해주세요.
- 리스팅 세부 정보와 서비스 약관을 검토한 후
Try Now를 클릭해 확인해주세요. 별도로 지정하지 않으면 기본 이름으로 애플리케이션이 설치돼요. (예: Document Parse)


애플리케이션 초기화
설치 후 애플리케이션을 초기화해 컴퓨팅 서비스를 배포해주세요. 이 과정에서 문서 처리를 위한 GPU 리소스가 프로비저닝돼요.
중요: GPU 리소스 프로비저닝에는 5~10분이 소요돼요. 문서를 처리하기 전에 서비스가 준비되어 있어야 해요.
서비스 상태 확인:
모든 컨테이너 상태가 READY로 표시될 때까지 기다린 후 다음 단계로 진행해주세요.
여기까지예요! 이제 Native App을 사용해 저희 기능을 활용할 수 있어요.
사용 가능한 기능
Document Parse
사용법
방법 1: Snowflake 스테이지의 파일 처리 (권장)
액세스 권한을 부여한 후(설치 단계 3 참고) Snowflake 스테이지에서 파일을 직접 처리할 수 있어요.
기본 Document Parsing:
사용자 정의 옵션을 사용한 고급 사용법:
JSON 옵션 매개변수를 사용해 변환 동작을 사용자 정의할 수 있어요:
사용 가능한 옵션: 이 옵션들에 대한 자세한 정보는 Document Parse API 레퍼런스를 참고해주세요.
| 옵션 | 타입 | 기본값 | 설명 |
|---|---|---|---|
chart_recognition | boolean | true | 차트를 구조화된 표로 변환 |
merge_multipage_tables | boolean | false | 여러 페이지에 걸친 표를 병합 |
ocr | string | "auto" | OCR 모드: "auto" (이미지만) 또는 "force" (항상) |
output_formats | array | ["html"] | 출력 포맷: "text", "html", "markdown" |
coordinates | boolean | true | 바운딩 박스 좌표 포함 |
base64_encoding | array | [] | base64로 인코딩할 레이아웃 카테고리 (예: ["table"]) |
실용 예시:
방법 2: Base64로 인코딩된 데이터로 처리
파일 읽기를 직접 처리하고 싶거나 이미 base64로 인코딩된 데이터가 있는 경우:
base64 방식을 사용해야 할 때:
- 외부 소스에서 파일을 읽는 사용자 정의 로직
- 외부 API의 데이터 처리
- 앱에 보내기 전 파일 전처리
- 다른 시스템에서 이미 base64로 인코딩된 데이터가 있는 경우
응답 포맷
이 프로시저는 완전한 변환 결과 문서 구조를 담은 JSON 객체를 반환해요:
성능 팁
- 스캔된 문서: 최상의 결과를 위해
"ocr": "force"를 사용해주세요 - 디지털 PDF: 불필요한 OCR을 건너뛰려면
"ocr": "auto"(기본값)를 사용해주세요 - 대용량 문서: 가능하다면 배치 단위로 나눠 처리하는 것을 고려해주세요
- 표 추출: 여러 페이지에 걸친 표를 처리하려면
"merge_multipage_tables": true를 활성화해주세요 - 최소 응답:
"coordinates": false와"output_formats": ["text"]로 설정해주세요 - 고품질 스캔: 최상의 OCR 정확도를 위해 300 DPI 이상을 사용해주세요
16MB 응답 한도 처리
Snowflake는 직렬화된 데이터를 반환할 때 행당 16MB 하드 한도를 적용해요. Document Parse는 변환된 결과 전체를 단일 행으로 반환하기 때문에 크거나 이미지가 많은 문서는 이 한도를 초과해 다음 오류를 발생시킬 수 있어요:
이 오류가 발생하면 다음 중 하나 이상을 시도해 보세요:
- 여러 페이지 문서 분할: 문서를 더 작은 페이지 범위(예: 요청당 10~20페이지)로 나눠 별도로 처리해주세요. 결과는 Snowflake 저장 프로시저나 애플리케이션 코드에서 병합할 수 있어요.
base64_encoding비활성화: base64로 인코딩된 이미지 페이로드(예:["table"],["figure"])는 응답 크기의 큰 비중을 차지해요. 인코딩된 이미지가 필요하지 않다면base64_encoding을[](기본값)로 설정해주세요.- 출력 포맷 줄이기: 실제로 필요한 포맷만 요청해주세요. 예를 들어 세 가지(
text,html,markdown)를 모두 포함하는 대신"output_formats": ["text"]또는["markdown"]을 사용해주세요. - 좌표 제거: 사용 사례에 바운딩 박스 정보가 필요하지 않다면
"coordinates": false로 설정해주세요.
API 레퍼런스
상세한 API 명세와 고급 사용법은 다음을 참고해주세요:
비용 관리 팁
- 웨어하우스 자동 일시 중지: 비용 최소화를 위해 유휴 상태일 때 자동으로 일시 중지되도록 웨어하우스를 구성해주세요
- 컴퓨팅 풀 관리: 컴퓨팅 풀 사용량과 자동 일시 중지 설정을 모니터링해주세요
- 쿼리 최적화: 필터와 한도를 사용해 불필요한 문서 처리를 최소화해주세요
- 스토리지 최적화: 더 이상 필요하지 않은 처리된 문서는 아카이브하거나 삭제해주세요
- 출력 포맷 선택: 응답 크기와 처리 시간을 줄이기 위해 필요한 포맷만 요청해주세요
지원
도움 받기
Snowflake Native App 또는 기술 지원 관련 문의:
기술 지원
- 기술적 이슈는 업스테이지 고객지원을 방문해주세요
- 일반적인 이슈는 위의 트러블슈팅 섹션을 참고해주세요
- 서비스 상태 및 에러 메시지에서 진단 정보를 확인해주세요
영업 및 가격
- 엔터프라이즈 배포 옵션에 대해서는 영업팀에 문의해주세요
- 볼륨 할인 및 맞춤 솔루션은 contact@upstage.ai로 이메일을 보내주세요