CREATE PROVISIONED THROUGHPUT

CREATE PROVISIONED THROUGHPUT

새 Provisioned Throughput 리소스를 만들거나 기존 리소스를 교체하는 명령이에요. Provisioned Throughput은 특정 기간 동안 Snowflake에서 지원하는 모델에 대해 예약된 처리 용량(PTU)을 제공해요.

출처: 문서

본문

새 Provisioned Throughput 리소스를 만들거나 기존 리소스를 교체해요.

구문 (Syntax)

CREATE [ OR REPLACE ] PROVISIONED THROUGHPUT <name>
    CLOUD_PROVIDER = '<cloud_provider>'
    MODEL = '<model_name>'
    PTUS = <num_ptus>
    TERM_START = '<start_date>'
    TERM_END = '<end_date>';

필수 매개변수 (Required parameters)

name Provisioned Throughput 리소스의 식별자(즉 이름)를 지정하는 문자열로, 리소스가 만들어지는 스키마 안에서 고유해야 해요.

또한 식별자는 반드시 알파벳 문자로 시작해야 하며, 전체 식별자 문자열이 큰따옴표로 묶이지 않는 한 공백이나 특수 문자를 포함할 수 없어요 (예: "My object"). 큰따옴표로 묶인 식별자는 대소문자를 구분해요.

자세한 내용은 식별자 요구 사항(Identifier requirements)을 참고해요.

CLOUD_PROVIDER = 'cloud_provider' Provisioned Throughput이 할당될 클라우드 공급자를 지정해요. 지원되는 값은 aws와 azure예요.

MODEL = 'model_name' Provisioned Throughput이 예약되는 모델을 지정해요. 지원되는 모델은 다음과 같아요.

• Mistral Large 2
• Llama 3.1-405B
• Llama 3.1-70B
• Llama 3.1-8B
• Snowflake-Llama3.3-70B
• Snowflake-Llama3.3-405B

PTUS = num_ptus 할당할 Provisioned Throughput 단위(PTU)의 수를 지정해요. 값은 지정된 모델의 최소 및 증분 PTU 요구 사항을 충족해야 해요.

TERM_START = 'start_date' Provisioned Throughput 기간의 시작 날짜를 YYYY-MM-DD 형식으로 지정해요.

TERM_END = 'end_date' Provisioned Throughput 기간의 종료 날짜를 YYYY-MM-DD 형식으로 지정해요.

접근 제어 요구 사항 (Access Control Requirements)

⚠️ 주의: Provisioned Throughput 리소스를 만들려면 역할이 계정 수준에서 CREATE PROVISIONED THROUGHPUT 권한을 가져야 해요.

사용 메모 (Usage Notes)

⚠️ 주의: 고객은 Snowflake 서비스를 사용할 때 (User 객체를 제외하고) 개인 데이터·민감 데이터·수출 통제 데이터·기타 규제 데이터를 메타데이터로 입력하지 않도록 해야 해요. 자세한 내용은 Snowflake의 메타데이터 필드를 참고해요.

Provisioned Throughput은 최소 및 증분 PTU 요구 사항의 적용을 받아요. PTU 요청이 지정된 모델에 대해 이 요구 사항을 충족하는지 확인해요.

Provisioned Throughput 기간은 지정된 날짜의 오전 8시(Pacific Time)에 시작되고 종료돼요.

Provisioned Throughput은 자동으로 갱신되지 않아요. 다른 기간에 대해 처리 용량을 예약하려면 새 Provisioned Throughput 리소스를 만들어요.

OR REPLACE와 IF NOT EXISTS 절은 서로 배타적이에요. 같은 문에서 둘 다 사용할 수 없어요.

CREATE OR REPLACE <object> 문은 원자적(atomic)으로 동작해요. 즉, 객체를 교체할 때 기존 객체는 삭제되고 새 객체는 단일 트랜잭션 안에서 생성돼요.

예시 (Example)

AWS에서 Llama 3.1-8B 모델용 my_pt라는 Provisioned Throughput 리소스를 만들어 2025년 4월 15일부터 5월 15일까지 64 PTU를 할당해요.

CREATE PROVISIONED THROUGHPUT my_pt
    CLOUD_PROVIDER = 'aws'
    MODEL = 'llama3.1-8B'
    PTUS = 64
    TERM_START = '2025-04-15'
    TERM_END = '2025-05-15';

업데이트된 PTU와 기간으로 my_pt라는 기존 Provisioned Throughput 리소스를 교체해요.

CREATE OR REPLACE PROVISIONED THROUGHPUT my_pt
    CLOUD_PROVIDER = 'aws'
    MODEL = 'llama3.1-8B'
    PTUS = 128
    TERM_START = '2025-06-01'
    TERM_END = '2025-07-01';

더 알아보기 (Learn more)

• Snowflake의 Provisioned Throughput — 예약 처리 용량 개요