CREATE PROVISIONED THROUGHPUT

Cria um novo recurso de taxa de transferência provisionada ou substitui um já existente.

Sintaxe

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

Parâmetros obrigatórios

name

Cadeia de caracteres que especifica o identificador (ou seja, o nome) do recurso de taxa de transferência provisionada; deve ser exclusivo para o esquema no qual o recurso é criado.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

CLOUD_PROVIDER = 'cloud_provider'

Especifica o provedor de nuvem onde a taxa de transferência provisionada será alocada. Os valores suportados são aws e azure.

MODEL = 'model_name'

Especifica o modelo para o qual a taxa de transferência provisionada está sendo reservada. Os modelos suportados incluem:

  • 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

Especifica o número de unidades de taxa de transferência provisionada (PTUs) a serem alocadas. O valor deve atender aos requisitos mínimos e incrementais do PTU para o modelo especificado.

TERM_START = 'start_date'

Especifica a data de início do prazo de taxa de transferência provisionada no formato YYYY-MM-DD.

TERM_END = 'end_date'

Especifica a data final do prazo de taxa de transferência provisionada no formato YYYY-MM-DD.

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Objeto

CREATE PROVISIONED THROUGHPUT

Nível da conta.

USAGE

Esquema no qual você planeja criar a taxa de transferência provisionada.

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Atenção

Para criar um recurso de taxa de transferência provisionada, sua função deve ter o privilégio CREATE PROVISIONED THROUGHPUT no nível da conta.

Notas de uso

Atenção

Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

  • A taxa de transferência provisionada está sujeita aos requisitos mínimos e incrementais do PTU. Certifique-se de que sua solicitação do PTU atenda a esses requisitos para o modelo especificado.

  • O prazo para a taxa de transferência provisionada começa e termina às 8h00 da manhã. PT nas datas especificadas.

  • A taxa de transferência provisionada não é renovada automaticamente. Para reservar uma taxa de transferência para outro período, crie um novo recurso de taxa de transferência provisionada.

  • As cláusulas OR REPLACE e IF NOT EXISTS são mutuamente exclusivas. Elas não podem ser usadas na mesma instrução.

  • Instruções CREATE OR REPLACE <object> são atômicas. Ou seja, quando um objeto é substituído, o objeto antigo é excluído e o novo objeto é criado em uma única transação.

Exemplo

Crie um recurso de taxa de transferência provisionada chamado my_pt para o modelo Llama 3.1-8B em AWS, alocando 64 PTUs por um período de 15 de abril de 2025 a 15 de maio de 2025:

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

Substitua um recurso de taxa de transferência provisionada existente chamado my_pt por PTUs e datas de vigência atualizadas:

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