Etape 1 : Créer le service distant (Azure Function) dans le portail¶

Créer la fonction¶

Pour effectuer les tâches décrites dans cette section, vous devez vous trouver dans l’écran Function App du portail Azure. Le nom de votre application Azure Functions doit être affiché, généralement dans le coin supérieur gauche de l’écran.

Pour créer la fonction déclenchée par HTTP :

1. Dans l’arborescence du menu de gauche, cherchez la section intitulée Functions. Dans cette section, cliquez sur l’élément étiqueté Functions pour ajouter une fonction.

2. Cliquez sur le bouton + Add.

3. Sélectionnez HTTP trigger dans la liste des déclencheurs potentiels sur la droite.

4. Entrez le nom à utiliser pour votre fonction déclenchée par HTTP.

   Enregistrez ce nom dans le champ HTTP-Triggered Function name de votre feuille de calcul de suivi.

5. Entrez le Authorization level.

   Snowflake recommande de choisir Function comme niveau d’autorisation.

   Pour plus d’informations sur les niveaux d’autorisation possibles, voir la documentation Microsoft : fonctions déclenchées par HTTP.

6. Cliquez sur le bouton intitulé Add.

   Vous accédez alors à un écran qui affiche le nom de la fonction et, en dessous, le mot Function.

7. Dans l’arborescence du menu de gauche, cliquez sur Code + Test.

8. Remplacez le code par défaut par votre propre code.

   Un exemple de code pour une fonction JavaScript « echo » est fourni ci-dessous.

   La fonction lit chaque ligne, puis copie cette ligne dans la sortie (résultats). Le numéro de ligne est également inclus dans la sortie. La sortie est renvoyée dans le cadre d’un dictionnaire à plusieurs niveaux.

   Cette fonction accepte et renvoie les données au même format (JSON) que celui envoyé et lu par Snowflake. Pour plus d’informations sur les formats de données, voir Formats des données d’entrée et de sortie des services à distance .

   Normalement, la fonction renvoie le code HTTP 200. Si aucune ligne n’est transmise à la fonction (c’est-à-dire si le corps de la requête est vide), la fonction renvoie le code d’erreur 400.

   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. Cliquez sur le bouton Save au-dessus du code.

Tester la fonction¶

Pour tester la fonction Azure Function déclenchée par HTTP que vous venez de créer, collez l’échantillon de données suivant dans le champ Body et cliquez sur le bouton Test/Run :

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

Copy

Le contenu de la sortie doit être similaire à ce qui suit :

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

Copy

Notez que le formatage peut être différent de ce qui est indiqué ci-dessus.

Activer l’authentification App Service pour l’application Azure Functions¶

Avant d’exécuter les étapes ci-dessous, vous devez vous trouver sur l’écran Function App de votre application Azure Functions.

1. Dans le volet de gauche du menu, cherchez la section nommée Settings et cliquez sur Authentication.

   Si la marge de gauche affiche le menu Developer (avec Code + Test, Integration, etc.), alors si vous avez une barre de défilement en bas de votre écran, essayez de faire glisser la barre de défilement vers la gauche pour revenir à la section Function App ou App Service puis cherchez Settings.

2. Cliquez sur le bouton Add identity provider.

3. Dans le menu déroulant Identity provider, sélectionnez Microsoft.

4. Pour App registration type, sélectionnez Create new app registration.

5. Dans le champ Name, tapez le nom de votre application.

6. Pour Supported account types, sélectionnez Current tenant - Single tenant.

7. Pour Restrict access, sélectionnez Require authentication.

8. Pour Unauthenticated requests, sélectionnez HTTP 401 Unauthorized.

9. Cliquez sur Next: Permissions. Examinez les autorisations.

10. Cliquez sur Add. Une nouvelle application Azure AD est créée et la page de l’application s’affiche.

11. Cliquez sur le lien qui indique le nom de votre application pour accéder à la page de votre application Azure AD.

12. Trouvez le champ Application (client) ID.

    Enregistrez cet ID dans le champ Azure Function App AD Application ID de votre feuille de calcul de suivi.

    Important

    Veillez à copier l’ID et non le nom de l’application Azure AD. L’ID doit contenir un UUID.