Schritt 1: Remotedienst (Azure-Funktion) über Portal erstellen¶

Funktion erstellen¶

Um die in diesem Abschnitt beschriebenen Aufgaben auszuführen, müssen Sie sich auf dem Bildschirm Function App des Azure-Portals befinden. Der Name Ihrer Azure Functions-App wird normalerweise links oben am Bildschirms angezeigt.

So erstellen Sie die über HTTP ausgelöste Funktion:

1. Suchen Sie im Menüstrukturbaum auf der linken Seite nach dem Abschnitt mit dem Titel Functions. Klicken Sie in diesem Abschnitt auf das Element mit der Bezeichnung Functions, um eine Funktion hinzuzufügen.

2. Klicken Sie auf die Schaltfläche + Add.

3. Wählen Sie auf der rechten Seite in der Liste der potenziellen Trigger die Option HTTP trigger aus.

4. Geben Sie den Namen ein, der für Ihre über HTTP ausgelöste Funktion verwendet werden soll.

   Notieren Sie sich diesen Namen auf dem Arbeitsblatt unter HTTP-Triggered Function name.

5. Geben Sie den Wert für Authorization level ein.

   Snowflake empfiehlt, als Autorisierungsstufe Function auszuwählen.

   Weitere Informationen zu möglichen Autorisierungsstufen finden Sie in der Microsoft-Dokumentation unter Über HTTP ausgelöste Funktionen.

6. Klicken Sie auf die Schaltfläche Add.

   Dadurch gelangen Sie zu einem Bildschirm, auf dem der Name der Funktion und darunter das Wort Function angezeigt werden.

7. Klicken Sie im Strukturbaum auf der linken Seite auf Code + Test.

8. Ersetzen Sie den Standardcode durch Ihren eigenen Code.

   Beispielcode für eine JavaScript-„echo“-Funktion finden Sie unten.

   Die Funktion liest jede Zeile und kopiert diese Zeile dann in die Ausgabe (Ergebnisse). Die Zeilennummer ist ebenfalls in der Ausgabe enthalten. Die Ausgabe wird als Teil eines mehrstufigen Wörterbuchs zurückgegeben.

   Diese Funktion akzeptiert Daten in demselben Format (JSON), das von Snowflake gesendet und gelesen wird, und gibt Daten auch in diesem Format zurück. Weitere Informationen zu Datenformaten finden Sie unter Eingangs- und Ausgangsdatenformate von Remotediensten.

   Normalerweise gibt die Funktion den HTTP-Code 200 zurück. Wenn keine Zeilen an die Funktion übergeben werden (d. h. wenn der Anforderungstext leer ist), gibt die Funktion den Fehlercode 400 zurück.

   module.exports = async function(context, request) {
       context.log('JavaScript HTTP trigger function processed a request.');
   
       if (request.body) {
           var rows = request.body.data;
           var results = [];
           rows.forEach(row => {
               results.push([row[0], row]);
           });
   
           results = {data: results}
           context.res = {
               status: 200,
               body: JSON.stringify(results)
           };
      }
      else {
          context.res = {
              status: 400,
              body: "Please pass data in the request body."
          };
      }
   };
   

   Copy

9. Klicken Sie über dem Code auf die Schaltfläche Save.

Funktion testen¶

Um die soeben erstellte, über HTTP ausgelöste Azure-Funktion zu testen, fügen Sie die folgenden Beispieldaten in das Feld Body ein, und klicken Sie dann auf die Schaltfläche Test/Run:

{
    "data": [ [ 0, 43, "page" ], [ 1, 42, "life, the universe, and everything" ] ]
}

Copy

Der Inhalt der Ausgabe sollte in etwa wie folgt aussehen:

{ "data":
    [
        [ 0, [ 0, 43, "page" ] ],
        [ 1, [ 1, 42, "life, the universe, and everything" ]  ]
    ]
}

Copy

Beachten Sie, dass die Formatierung von der oben gezeigten abweichen kann.

App Service Authentication für die Azure Functions-App aktivieren¶

Um die folgenden Schritte ausführen zu können, müssen Sie sich auf dem Bildschirm Function App Ihrer Azure Functions-App befinden.

1. Suchen Sie im linken Menüfenster den Abschnitt mit dem Namen Settings, und klicken Sie dort auf Authentication.

   Wenn am linken Rand das Menü Developer angezeigt wird (mit Code + Test, Integration usw.) und der untere Bildschirmrand eine Bildlaufleiste enthält, dann versuchen Sie den Schieberegler nach links zu schieben, um zum Abschnitt Function App oder App Service zurückzukehren, und suchen Sie dann nach Settings.

2. Klicken Sie auf die Schaltfläche Add identity provider.

3. Wählen Sie im Dropdown-Menü Identity provider die Option Microsoft aus.

4. Wählen Sie unter App registration type die Option Create new app registration aus.

5. Geben Sie im Feld Name den Namen Ihrer App ein.

6. Wählen Sie unter Supported account types die Option Current tenant - Single tenant aus.

7. Wählen Sie unter Restrict access die Option Require authentication aus.

8. Wählen Sie unter Unauthenticated requests die Option HTTP 401 Unauthorized aus.

9. Klicken Sie auf Next: Permissions. Überprüfen Sie die Berechtigungen.

10. Klicken Sie auf Add. Eine neue Azure AD-Anwendung wird erstellt, und die Anwendungsseite wird angezeigt.

11. Klicken Sie auf den Link, der den Namen Ihrer Anwendung anzeigt, um zur Seite Ihrer Azure AD-Anwendung zu gelangen.

12. Suchen Sie das Feld Application (client) ID.

    Notieren Sie sich diese ID im Feld Azure Function App AD Application ID Ihres Arbeitsblatts.

    Wichtig

    Stellen Sie sicher, dass Sie die ID und nicht den Azure AD-Anwendungsnamen kopieren. Die ID sollte eine UUID enthalten.