Étape 1 : Créez le service distant (fonctionAWS Lambda) dans la console de gestion¶

Entrée et sortie indépendantes du langage via JSON¶

Les informations de cette section s’appliquent à toutes les fonctions Lambda utilisées comme services distants pour les fonctions externes de Snowflake. Pour des informations spécifiques à la plate-forme concernant l’entrée et la sortie des fonctions externes, voir la ou les sous-sections ci-dessous.

Sur AWS, la convention pour un service compatible HTTP est de renvoyer le corps à l’intérieur d’un objet JSON qui inclut également le code de statut HTTP. Le JSON pour une valeur de retour typique d’une fonction AWS Lambda ressemble à ceci :

{
"statusCode": <http_status_code>,
"body":
        {
            "data":
                  [
                      [ 0, <value> ],
                      [ 1, <value> ]
                      ...
                  ]
        }
}

Copy

La structure de l’entrée JSON est similaire à la précédente, mais inclut des paires clé-valeur supplémentaires dont vous n’aurez probablement pas besoin, et exclut les statusCode.

Entrée de la fonction Lambda spécifique à Python¶

Les informations suivantes s’appliquent aux fonctions Lambda en langage Python compatibles avec Snowflake, et incluent des exemples de fonctions Lambda dans ce tutoriel. Ces informations s’ajoutent aux règles d’entrée et de sortie indépendantes du langage.

Une fonction Lambda en langage Python compatible avec Snowflake reçoit deux paramètres, event et context. Les fonctions externes simples ne nécessitent généralement que le paramètre event.

Le paramètre event comprend de nombreux sous-champs, dont l’un est body. Le corps est une chaîne compatible JSON qui contient un dictionnaire.

Le dictionnaire comprend une clé nommée data ; la valeur correspondante pour data est un tableau. Ce tableau contient les lignes transmises par Snowflake.

Chaque ligne est représentée par un tableau qui est imbriqué dans le tableau data.

(Etant donné que AWS Lambda traite commodément la requête HTTP POST envoyée par Snowflake, extrait le corps et transmet le corps à l’intérieur du paramètre d’événement, ces exemples de fonctions n’ont pas besoin d’analyser l’intégralité de la requête HTTP POST.)

Le Exemple de fonction Lambda synchrone comprend du code montrant comment lire le paramètre event.

Exemples de fonctions Snowflake¶

Snowflake fournit deux exemples de fonctions :

• L’exemple le plus court est synchrone. Si vous êtes novice en matière de fonctions externes ou de fonctions Lambda, Snowflake vous recommande d’utiliser ceci pour créer votre premier exemple de fonction externe.

  Les utilisateurs expérimentés peuvent également copier ce code et le modifier pour l’utiliser comme point de départ de services à distance personnalisés.

  Le code est disponible dans cet exemple de fonction Lambda synchrone.

• L’autre exemple est asynchrone.

  Cet exemple est principalement destiné à servir d’exemple pour créer des services distants asynchrones personnalisés.

  Le code est disponible dans cet exemple de fonction Lambda asynchrone.

Fonction Lambda personnalisée¶

Vous pouvez écrire votre propre fonction Lambda à partir de zéro, ou vous pouvez utiliser l’une des fonctions décrites dans Exemples de fonctions Snowflake (dans cette rubrique) comme point de départ.

Si vous souhaitez utiliser un service distant existant, vous pouvez ignorer la plupart des instructions de cette étape du tutoriel. Au lieu de cela, faites ce qui suit :

1. Enregistrez votre ID de compte AWS dans le champ Your AWS Account ID de la feuille de calcul de suivi.

2. Enregistrez le nom de la fonction Lambda du service distant dans le champ Lambda Function Name de la feuille de calcul de suivi.

3. Allez à Etape 2 : Créez le service proxy (Amazon API Gateway) dans la console de gestion AWS.