Schritt 1: Remotedienst (AWS Lambda-Funktion) in der Management Console erstellen¶

Sprachunabhängige Ein- und Ausgabe über JSON¶

Die Informationen in diesem Abschnitt gelten für alle Lambda-Funktionen, die als Remotedienste für externe Snowflake-Funktionen verwendet werden. Plattformspezifische Informationen zur Eingabe und Ausgabe der externen Funktion finden Sie in den folgenden Unterabschnitten.

Bei AWS besteht die Konvention für einen HTTP-kompatiblen Dienst darin, den Text innerhalb eines JSON-Objekts zurückzugeben, das auch den HTTP-Statuscode enthält. Der JSON-Text für den typischen Rückgabewert einer AWS Lambda-Funktion sieht wie folgt aus:

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

Copy

Die Struktur des JSON-Eingangs ist ähnlich wie die vorhergehende, enthält aber zusätzliche Schlüssel-Wert-Paare, die Sie wahrscheinlich nicht benötigen, und schließt die statusCode aus.

Python-spezifische Lambda-Funktionseingabe¶

Das folgende Material gilt für Snowflake-kompatible Lambda-Funktionen in der Sprache Python, einschließlich der Lambda-Beispielfunktionen im Tutorial. Diese Information wird zusätzlich zu den sprachunabhängigen Regeln für Ein- und Ausgabe.

Eine Snowflake-kompatible Lambda-Funktion in der Python-Sprache erhält zwei Parameter, event und context. Einfache externe Funktionen benötigen typischerweise nur den Parameter event.

Der Parameter event enthält viele Unterfelder, von denen eines body ist. Der Körper ist eine JSON-kompatible Zeichenfolge, die ein Wörterbuch enthält.

Das Wörterbuch enthält einen Schlüssel namens data. Der entsprechende Wert für data ist ein Array. Dieses Array enthält die von Snowflake übergebenen Zeilen.

Jede Zeile wird durch ein Array dargestellt, das innerhalb des Arrays data verschachtelt ist.

(Da AWS Lambda die von Snowflake gesendete HTTP-POST-Anforderung verarbeitet, den Text extrahiert und den Text innerhalb des Ereignisparameters übergibt, muss diese von Snowflake bereitgestellte Beispielfunktion nicht die gesamte HTTP-POST-Anforderung parsen.)

Der Beispiel für eine synchrone Lambda-Funktion enthält Code, der zeigt, wie der Parameter event zu lesen ist.

Snowflake-Beispielfunktionen¶

Snowflake stellt zwei Beispielfunktionen bereit:

• Das kürzere Beispiel ist synchron. Wenn Sie neu im Umgang mit externen Funktionen oder Lambda-Funktionen sind, empfiehlt Snowflake, dass Sie damit Ihre erste externe Beispielfunktion erstellen.

  Erfahrene Benutzer können es auch kopieren und ändern, um es als Ausgangspunkt für benutzerdefinierte Remotedienste zu verwenden.

  Der Code ist in Beispiel synchrone Lambda-Funktion verfügbar.

• Das andere Beispiel ist asynchron.

  Dieses Beispiel ist in erster Linie als Beispiel für die Erstellung angepasster asynchroner Remotedienste gedacht.

  Der Code ist unter Asynchrone Lambda-Beispielfunktion verfügbar.

Benutzerdefinierte Lambda-Funktion¶

Sie können Ihre eigene Lambda-Funktion von Grund auf neu schreiben, oder Sie können eine der Funktionen verwenden, die unter Snowflake-Beispielfunktionen (unter diesem Thema) als Ausgangspunkt beschrieben sind.

Wenn Sie einen vorhandenen Remotedienst verwenden möchten, können Sie den Großteil der Anweisungen in diesem Schritt des Lernprogramms überspringen. Gehen Sie stattdessen wie folgt vor:

1. Notieren Sie sich Ihre AWS-Konto-ID auf dem Arbeitsblatt unter Your AWS Account ID.

2. Notieren Sie sich den Namen der Lambda-Funktion des Remotedienstes auf dem Arbeitsblatt unter Lambda Function Name.

3. Rufen Sie Schritt 2: Proxydienst (Amazon API Gateway) in der AWS Management Console erstellen auf.