CREATE PROVISIONED THROUGHPUT

Erstellt eine neue bereitgestellte Durchsatzressource oder ersetzt eine bestehende.

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

Erforderliche Parameter

name

Zeichenfolge, die den Bezeichner (d. h. den Namen) für die bereitgestellte Durchsatzressource angibt; muss für das Schema, in dem die Ressource erstellt wird, eindeutig sein.

Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

CLOUD_PROVIDER = 'cloud_provider'

Gibt den Cloudanbieter an, dem der bereitgestellte Durchsatz zugewiesen wird. Unterstützte Werte sind aws und azure.

MODEL = 'model_name'

Gibt das Modell an, für das der bereitgestellte Durchsatz reserviert wird. Folgende Modelle werden unterstützt:

  • 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

Gibt die Anzahl der bereitgestellten Durchsatzeinheiten (PTUs) an, die zugewiesen werden sollen. Der Wert muss die minimalen und inkrementellen PTU-Anforderungen für das angegebene Modell erfüllen.

TERM_START = 'start_date'

Gibt das Startdatum der Laufzeit für den bereitgestellten Durchsatz im Format YYYY-MM-DD an.

TERM_END = 'end_date'

Gibt das Enddatum der Laufzeit für den bereitgestellten Durchsatz im Format YYYY-MM-DD an.

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung

Objekt

CREATE PROVISIONED THROUGHPUT

Kontoebene.

USAGE

Schema, in dem Sie den bereitgestellten Durchsatz erstellen möchten.

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Achtung

Um eine bereitgestellte Durchsatzressource zu erstellen, muss Ihre Rolle über die Berechtigung CREATE PROVISIONED THROUGHPUT auf der Ebene des Kontos verfügen.

Nutzungshinweise

Achtung

Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „User“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

  • Der bereitgestellte Durchsatz unterliegt den Mindestanforderungen und den inkrementellen Anforderungen an PTU. Vergewissern Sie sich, dass Ihre PTU-Anfrage diese Anforderungen für das angegebene Modell erfüllt.

  • Die Laufzeit für den bereitgestellten Durchsatz beginnt und endet um 8:00 Uhr morgens. PT zu den angegebenen Daten.

  • Der bereitgestellte Durchsatz wird nicht automatisch verlängert. Um Durchsatz für eine andere Laufzeit zu reservieren, erstellen Sie eine neue bereitgestellte Durchsatzressource.

  • Die OR REPLACE- und IF NOT EXISTS-Klauseln schließen sich gegenseitig aus. Sie können nicht beide in derselben Anweisung verwendet werden.

  • CREATE OR REPLACE <Objekt>-Anweisungen sind atomar. Das heißt, wenn ein Objekt ersetzt wird, erfolgt das Löschen des alten Objekts und das Erstellen des neuen Objekts in einer einzigen Transaktion.

Beispiel

Erstellen Sie eine bereitgestellte Durchsatzressource mit dem Namen my_pt für das Modell Llama 3.1-8B auf AWS und weisen Sie 64 PTUs für eine Laufzeit vom 15. April 2025 bis zum 15. Mai 2025 zu:

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

Ersetzen Sie eine vorhandene bereitgestellte Durchsatzressource namens my_pt mit aktualisierten PTUs und Laufzeitdaten:

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