Erstellen einer gespeicherten Prozedur¶

Eine Prozedur erstellen¶

1. Schreiben Sie Prozedurlogik als Handler in einer der verschiedenen unterstützten Sprachen, darunter Python, Java und Scala.

2. Wählen Sie ein Tool oder eine API aus, um die Prozedur mit dem von Ihnen geschriebenen Handler zu erstellen.

   Weitere Informationen dazu finden Sie unter Tools zur Erstellung von Prozeduren.

   SQL	Verwenden Sie SQL und schreiben Sie Logik in einer von mehreren Sprachen.
   Snowpark	Verwenden Sie die Snowpark-API für Java, Python oder Scala.
   Befehlszeile	Führen Sie die Snowflake CLI-Befehle aus, um die Prozedur zu erstellen.
   Python API	Führen Sie clientseitige Python-Befehle aus, um die Prozedur zu erstellen.
   REST	Stellen Sie Anfragen an RESTful-API, um die Prozedur zu erstellen.

3. Führen Sie die Prozedur mit einem von mehreren Tools aus, je nach Bedarf.

Tools zur Erstellung von Prozeduren¶

Sie können eine Prozedur mit einer von mehreren in Snowflake verfügbaren Methoden erstellen, je nachdem, welche Sprache und welche Fähigkeiten Sie haben. Wählen Sie aus der folgenden Tabelle das für Ihre Bedürfnisse geeignete Tool aus.

Wichtige Eigenschaften¶

Im Folgenden werden einige der Eigenschaften beschrieben, die beim Erstellen einer Prozedur erforderlich sind oder üblicherweise verwendet werden.

Prozedurname:

Der Name der Prozedur muss nicht mit dem Namen des Handlers übereinstimmen. Für weitere Informationen zu Einschränkungen und Konventionen bei der Namensvergabe finden Sie unter Benennen und Überladen von Prozeduren und UDFs.

Argumente:

Weitere Informationen zu den Anforderungen finden Sie unter Definieren von Argumenten für UDFs und gespeicherte Prozeduren.

Rückgabetyp:

Weitere Informationen zum Zuordnen von SQL-Datentypen zu Handler-Datentypen in Snowflake finden Sie unter Zuordnung von Datentypen zwischen SQL und Handler-Sprachen.

Handler-Name:

Falls erforderlich, ist dies der Name der Klasse oder Methode, die den Code enthält, der bei Aufruf der Prozedur ausgeführt wird. Die Angabe eines Handler-Namens ist nur für Handler erforderlich, die in Java, Python oder Scala geschrieben wurden. Bei JavaScript- und Snowflake Scripting-Handlern wird der gesamte Inline-Code als Handler ausgeführt.

Abhängigkeiten:

Bei einem in Java, Python oder Scala geschriebenen Handler müssen Sie möglicherweise auch die Snowpark-Bibliothek angeben, z. B. bei der Erstellung der Prozedur.

Weitere Informationen zur Bereitstellung der Abhängigkeiten für den Handler finden Sie unter Abhängigkeiten für Code zur Verfügung stellen.

Laufzeit der Handler-Sprache:

Wenn die Handler-Sprache Java, Python oder Scala ist, geben Sie die Laufzeitversion an, um anzugeben, welche unterstützte Laufzeitversion verwendet werden soll. Denken Sie daran, dass sich die Standardversion im Laufe der Zeit ändern wird, wenn Sie sie verwenden.

Anforderungen an die Zugriffssteuerung¶

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

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.

Nutzungshinweise¶

Eine gespeicherte Prozedur mit SQL erstellen¶

Sie können eine gespeicherte Prozedur mit SQL erstellen, indem Sie die folgenden Schritte ausführen.

1. Schreiben Sie den Handler-Code, der bei Aufruf der Prozedur ausgeführt werden soll.

   Sie können eine der unterstützten Handler-Sprachen verwenden. Weitere Informationen dazu finden Sie unter Unterstützte Sprachen und Tools.

2. Legen Sie fest, ob Sie den Handler-Code inline in der SQL-Anweisung CREATE PROCEDURE verwenden möchten oder auf den Handler-Code in einem Stagingbereich verweisen möchten.

   Beide Methoden haben Vor- und Nachteile. Weitere Informationen dazu finden Sie unter Speichern von Handler-Code inline oder in einem Stagingbereich.

3. Führen Sie eine CREATE PROCEDURE-Anweisung in SQL aus, und geben Sie dabei die Eigenschaften der Prozedur an.

   Der Code im folgenden Beispiel erstellt eine Prozedur namens myProc mit dem Inline-Handler MyClass.myMethod. Die Handler-Sprache ist Java, die (wie in Scala und Python geschriebene Prozedur-Handler) ein Session-Objekt aus der Snowpark-Bibliothek benötigt. Hier bezieht sich die PACKAGES-Klausel auf die Snowpark-Bibliothek, die in Snowflake enthalten ist.

   CREATE OR REPLACE PROCEDURE myProc(fromTable STRING, toTable STRING, count INT)
     RETURNS STRING
     LANGUAGE JAVA
     RUNTIME_VERSION = '11'
     PACKAGES = ('com.snowflake:snowpark:latest')
     HANDLER = 'MyClass.myMethod'
     AS
     $$
       import com.snowflake.snowpark_java.*;
   
       public class MyClass
       {
         public String myMethod(Session session, String fromTable, String toTable, int count)
         {
           session.table(fromTable).limit(count).write().saveAsTable(toTable);
           return "Success";
         }
       }
     $$;
   

   Copy