ステップ1: ポータルでリモートサービスを作成する（Azure Function）¶

関数を作成する¶

このセクションで説明されているタスクを実行するには、Azure Portalの Function App 画面が表示されている必要があります。Azure Functionsアプリの名前は通常、画面の左上隅の近くに表示されます。

HTTPでトリガーされる関数を作成するには:

1. 左側のメニューツリーで、 Functions というタイトルのセクションを探します。そのセクションで、 Functions というラベルの付いた項目をクリックして関数を追加します。

2. + Add ボタンをクリックします。

3. 右側の潜在的なトリガーのリストから HTTP trigger を選択します。

4. HTTP でトリガーされる関数に使用する名前を入力します。

   この名前を追跡ワークシートの HTTP-Triggered Function name フィールドに記録します。

5. Authorization level を入力します。

   Snowflakeは、認証レベルとして Function を選択することをお勧めします。

   可能な認証レベルの詳細については、 HTTPによってトリガーされた関数 をご参照ください。

6. Add というタイトルのボタンをクリックします。

   これにより、関数名とその下に Function という単語が表示された画面に移動します。

7. 左側のツリーメニューで、 Code + Test をクリックします。

8. デフォルトのコードを独自のコードに置き換えます。

   JavaScript「エコー」関数のサンプルコードを以下に示します。

   この関数は各行を読み取り、その行を出力（結果）にコピーします。行番号も出力に含まれます。出力は、マルチレベルディクショナリの一部として返されます。

   この関数は、Snowflakeが送信し、読み取る形式と同じ形式（JSON）でデータを受け入れ、返します。データ形式の詳細については、 リモートサービスの入力および出力データ形式 をご参照ください。

   通常、関数はHTTPコード200を返します。関数に行が渡されない場合（つまり、リクエストの本文が空の場合）、関数はエラーコード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. コードの上にある Save ボタンをクリックします。

関数をテストする¶

作成したHTTPによってトリガーされるAzure関数をテストするには、次のサンプルデータを Body フィールドに貼り付けて、 Test/Run ボタンをクリックします。

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

Copy

出力の内容は次のようになります。

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

Copy

フォーマットは上記と異なる場合があることに注意してください。

Azure Functionsアプリのアプリサービス認証を有効にする¶

以下のステップを実行する前に、Azure Functionsアプリの Function App 画面を開いている必要があります。

1. 左側のメニューペインで、 Settings という名前のセクションを探し、 Authentication をクリックします。

   左側の余白に Developer メニュー（Code + Test、 Integration など）が表示され、画面の下部にスクロールバーがある場合は、スクロールバーを左にスライドを試み、 Function App または App Service セクションに戻り、 Settings を探してください。

2. Add identity provider ボタンをクリックします。

3. Identity provider ドロップダウンメニューで、 Microsoft を選択します。

4. App registration type には、 Create new app registration を選択します。

5. Name フィールドに、アプリの名前を入力します。

6. Supported account types には、 Current tenant - Single tenant を選択します。

7. Restrict access には、 Require authentication を選択します。

8. Unauthenticated requests には、 HTTP 401 Unauthorized を選択します。

9. Next: Permissions をクリックします。権限を確認します。

10. Add をクリックします。新しいAzure AD アプリケーションが作成され、アプリケーションページが表示されます。

11. アプリケーションの名前を示すリンクをクリックして、Azure AD アプリケーションのページに移動します。

12. Application (client) ID フィールドを探します。

    このIDを追跡ワークシートの Azure Function App AD Application ID フィールドに記録します。

    重要

    Azure ADアプリケーション名ではなく、必ずIDをコピーしてください。IDにはUUIDが含まれている必要があります。