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>';

Copy

必填参数¶

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

指定要分配的预置吞吐量单位 (PTUs) 的数量。该值必须满足指定模型的最低和增量 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:00 PT 开始和结束。
预置吞吐量不会自动续订。要为下一个期限预留吞吐量，请创建新的预置吞吐量资源。

OR REPLACE 和 IF NOT EXISTS 子句互斥。它们不能同时用于同一条语句中。
CREATE OR REPLACE <object> 语句是原子的。也就是说，当对象被替换时，旧对象将被删除，新对象将在单个事务中创建。

示例¶

为 AWS 上的 Llama 3.1-8B 模型创建名为 my_pt 预置吞吐量资源，并为 2025 年 4 月 15 日至 2025 年 5 月 15 日的期限分配 64 PTUs。

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

Copy

将名为 my_pt 的现有预置吞吐量资源替换为更新的 PTUs 和期限日期：

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';

Copy