CREATE PROVISIONED THROUGHPUT

Crée une nouvelle ressource de débit provisionné ou en remplace une existante.

Syntaxe

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

Paramètres requis

name

Chaîne qui spécifie l’identificateur (c’est-à-dire le nom) de la ressource de débit provisionné ; doit être unique pour le schéma dans lequel la ressource est créée.

De plus, l’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles (par exemple, "My object"). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

CLOUD_PROVIDER = 'cloud_provider'

Spécifie le fournisseur de Cloud où le débit provisionné sera alloué. Les valeurs prises en charge sont aws et azure.

MODEL = 'model_name'

Spécifie le modèle pour lequel le débit provisionné est réservé. Les modèles pris en charge sont les suivants :

  • Mistral Large 2

  • Llama 3.1-405B

  • Lamas 3.1-70B

  • Llama 3.1-8B

  • Snowflake-Lama3.3-70B

  • Snowflake-Lama3.3-405B

PTUS = num_ptus

Spécifie le nombre d’unités de débit provisionné (PTUs) à allouer. La valeur doit satisfaire aux exigences minimales et incrémentales de PTU pour le modèle spécifié.

TERM_START = 'start_date'

Spécifie la date de début de la période de débit provisionné au format YYYY-MM-DD.

TERM_END = 'end_date'

Spécifie la date de fin de la période de débit provisionné au format YYYY-MM-DD.

Exigences en matière de contrôle d’accès

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège

Objet

CREATE PROVISIONED THROUGHPUT

Niveau du compte.

USAGE

Schéma dans lequel vous planifiez de créer le débit provisionné.

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Attention

Pour créer une ressource de débit provisionné, votre rôle doit disposer du privilège CREATE PROVISIONED THROUGHPUT au niveau du compte.

Notes sur l’utilisation

Attention

Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

  • Le débit provisionné est soumis à des exigences minimales et incrémentielles sur le site PTU. Assurez-vous que votre requête PTU répond à ces exigences pour le modèle spécifié.

  • La durée du débit provisionné commence et se termine à 8 heures. PT aux dates indiquées.

  • Le débit provisionné ne se renouvelle pas automatiquement. Pour réserver du débit pour une autre période, créez une nouvelle ressource de débit provisionné.

  • Les clauses OR REPLACE et IF NOT EXISTS s’excluent mutuellement. Elles ne peuvent pas être utilisées dans la même instruction.

  • Les instructions CREATE OR REPLACE <objet> sont atomiques. En d’autres termes, lorsqu’un objet est remplacé, l’ancien objet est supprimé et le nouvel objet est créé dans une seule transaction.

Exemple

Créez une ressource de débit provisionné nommée my_pt pour le modèle Llama 3.1-8B sur AWS, en allouant 64 PTUs pour une période allant du 15 avril 2025 au 15 mai 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

Remplacez une ressource de débit provisionné existante nommée my_pt par une mise à jour des PTUs et des dates d’échéance :

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