CREATE PROVISIONED THROUGHPUT¶
새 프로비저닝된 처리량 리소스 를 만들거나 기존 리소스를 바꿉니다.
구문¶
CREATE [ OR REPLACE ] PROVISIONED THROUGHPUT <name>
CLOUD_PROVIDER = '<cloud_provider>'
MODEL = '<model_name>'
PTUS = <num_ptus>
TERM_START = '<start_date>'
TERM_END = '<end_date>';
필수 매개 변수¶
name
프로비저닝된 처리량 리소스의 식별자(즉, 이름)를 지정하는 문자열로, 리소스가 생성되는 스키마에 대해 고유해야 합니다.
또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예:
"My object"
)로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
CLOUD_PROVIDER = 'cloud_provider'
프로비저닝된 처리량을 할당할 클라우드 공급자를 지정합니다. 지원되는 값은
aws
및azure
입니다.MODEL = 'model_name'
프로비저닝된 처리량이 예약되는 모델을 지정합니다. 지원되는 모델은 다음과 같습니다.
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
할당할 프로비저닝된 처리량 단위(PTU) 수를 지정합니다. 값은 지정된 모델에 대한 최소 및 증분 PTU 요구 사항을 충족해야 합니다.
TERM_START = 'start_date'
프로비저닝된 처리량 기간의 시작 날짜를
YYYY-MM-DD
형식으로 지정합니다.TERM_END = 'end_date'
프로비저닝된 처리량 기간의 종료 날짜를
YYYY-MM-DD
형식으로 지정합니다.
액세스 제어 요구 사항¶
이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
---|---|
CREATE PROVISIONED THROUGHPUT |
계정 수준. |
USAGE |
프로비저닝된 처리량을 생성할 계획이 있는 스키마입니다. |
스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한.
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
주의
프로비저닝된 처리량 리소스를 만들려면 계정 수준에서 역할에 CREATE PROVISIONED THROUGHPUT 권한이 있어야 합니다.
사용법 노트¶
주의
고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.
프로비저닝된 처리량에는 최소 및 증분 PTU 요구 사항이 적용됩니다. PTU 요청이 지정된 모델에 대한 이러한 요구 사항을 충족하는지 확인하십시오.
프로비저닝된 처리량에 대한 기간은 지정된 날짜의 오전 8시 (PT 기준)에 시작하여 종료됩니다.
프로비저닝된 처리량은 자동으로 갱신되지 않습니다. 다른 기간에 대해 처리량을 예약하려면 프로비저닝된 처리량 리소스를 새로 만드십시오.
OR REPLACE
및IF NOT EXISTS
절은 상호 배타적입니다. 두 문자를 같은 문에 함께 사용할 수 없습니다.CREATE OR REPLACE <오브젝트> 문은 원자성입니다. 즉, 오브젝트가 바뀔 때 단일 트랜잭션으로 이전 오브젝트가 삭제되고 새 오브젝트가 생성됩니다.
예¶
AWS 에서 Llama 3.1-8B
모델에 대해 my_pt
라는 프로비저닝된 처리량 리소스를 생성하여 2025년 4월 15일부터 2025년 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';
기존 프로비저닝된 처리량 리소스(my_pt
)를 업데이트된 PTU 및 기간 날짜로 바꿉니다.
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';