Création d’une procédure stockée¶

Créer une procédure¶

1. Écrivez une logique de procédure en tant que gestionnaire à l’aide de l’un des langages pris en charge, comme Python, Java et Scala.

2. Choisissez un outil ou une API pour créer la procédure avec le gestionnaire que vous avez écrit.

   Pour plus d’informations sur chacun de ces éléments, voir Outils de création de procédures.

   SQL	Utilisez SQL et écrivez la logique dans un ou plusieurs langages.
   Snowpark	Utilisez l’API Snowpark pour Java, Python ou Scala.
   Ligne de commande	Exécutez les commandes Snowflake CLI pour créer la procédure.
   Python API	Exécutez les commandes Python côté client pour créer la procédure.
   REST	Faites des requêtes auprès d’une API RESTful pour créer la procédure.

3. Exécutez la procédure à l’aide de l’un des outils suivants, en fonction de vos besoins.

Outils de création de procédures¶

Vous pouvez créer une procédure en utilisant l’une des méthodes disponibles avec Snowflake, en fonction du langage et de l’ensemble des compétences dont vous disposez. Choisissez l’outil qui correspond à vos besoins dans la table suivante.

Propriétés clés¶

Les paragraphes suivants décrivent certaines des propriétés requises ou généralement utilisées lors de la création d’une procédure.

Nom de la procédure:

Le nom de la procédure ne doit pas nécessairement correspondre au nom du gestionnaire. Pour plus d’informations sur les contraintes et les conventions relatives aux noms, voir Nommage et surcharge de procédures et d’UDFs.

Arguments:

Pour plus d’informations sur les exigences, voir Définition des arguments pour UDFs et les procédures stockées.

Type de retour:

Pour plus d’informations sur la façon dont Snowflake fait correspondre les types de données SQL aux types de données des gestionnaires, voir Mappage des types de données entre SQL et les langages de traitement.

Nom du gestionnaire:

Si nécessaire, il s’agit du nom de la classe ou de la méthode contenant le code qui s’exécute lorsque la procédure est appelée. Vous devez spécifier un nom de gestionnaire uniquement pour les gestionnaires écrits en Java, Python et Scala. Pour les gestionnaires JavaScript et Snowflake Scripting, tout le code spécifié en ligne sera exécuté comme le gestionnaire.

Dépendances:

Pour un gestionnaire écrit en Java, Python ou Scala, vous devrez peut-être aussi spécifier la bibliothèque Snowpark, par exemple lors de la création de la procédure.

Pour plus d’informations sur la mise à disposition des dépendances pour votre gestionnaire, voir Mettre les dépendances à la disposition de votre code.

Environnement d’exécution du langage du gestionnaire:

Lorsque le langage du gestionnaire est Java, Python ou Scala, spécifiez la version d’exécution pour indiquer la version d’environnement d’exécution prise en charge à utiliser. Gardez à l’esprit que si vous utilisez la version par défaut, celle-ci évoluera au fil du temps.

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 :

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.

Notes sur l’utilisation¶

Créer une procédure stockée avec SQL¶

Vous pouvez créer une procédure stockée avec SQL en suivant les étapes suivantes.

1. Écrivez le code du gestionnaire qui s’exécute lorsque la procédure est appelée.

   Vous pouvez utiliser l’un des langages du gestionnaire pris en charge. Pour plus d’informations, voir Langages et outils pris en charge.

2. Choisissez si vous allez garder le code du gestionnaire en ligne avec l’instruction CREATE PROCEDURE SQL ou si vous allez y faire référence dans une zone de préparation.

   Chacun a ses avantages. Pour plus d’informations, voir Conserver le code du gestionnaire en ligne ou dans une zone de préparation.

3. Exécutez une instruction CREATE PROCEDURE dans SQL, en spécifiant les propriétés de la procédure.

   Le code de l’exemple suivant crée une procédure appelée myProc avec un gestionnaire en ligne MyClass.myMethod. Le langage du gestionnaire est Java, qui (comme les gestionnaires de procédures écrits en Scala et Python) nécessite un objet Session de la bibliothèque Snowpark. Ici, la clause PACKAGES fait référence à la bibliothèque Snowpark incluse dans Snowflake.

   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