1단계: Portal에서 원격 서비스(Azure 함수) 만들기¶

함수 만들기¶

이 섹션에 설명된 작업을 수행하려면 Azure Portal의 Function App 화면에 있어야 합니다. Azure Functions 앱의 이름은 일반적으로 화면의 왼쪽 위 모서리 근처에 표시되어야 합니다.

HTTP로 트리거되는 함수를 만드는 방법은 다음과 같습니다.

1. 왼쪽 메뉴 트리에서 Functions 라는 제목의 섹션을 찾습니다. 그 섹션에서 Functions 레이블이 지정된 항목을 클릭하여 함수를 추가합니다.

2. + Add 버튼을 클릭합니다.

3. 오른쪽의 잠재적 트리거 목록에서 HTTP trigger 를 선택합니다.

4. HTTP로 트리거되는 함수에 사용할 이름을 입력합니다.

   추적 워크시트의 HTTP-Triggered Function name 필드에 이 이름을 기록합니다.

5. Authorization level 을 입력합니다.

   Function 을 인증 수준으로 선택하는 것이 좋습니다.

   가능한 인증 수준에 대한 자세한 내용은 Microsoft 설명서: HTTP로 트리거되는 함수 를 참조하십시오.

6. Add 라는 제목의 버튼을 클릭합니다.

   그러면 함수 이름과 그 아래에 Function 이라는 단어가 표시되는 화면으로 이동합니다.

7. 왼쪽 트리 메뉴에서 Code + Test 를 클릭합니다.

8. 기본 코드를 자체 코드로 바꿉니다.

   아래에 JavaScript 《echo》 함수의 샘플 코드가 제공됩니다.

   이 함수는 각 행을 읽은 다음, 해당 행을 출력(결과)에 복사합니다. 행 번호도 출력에 포함됩니다. 출력은 다단계 사전의 일부로 반환됩니다.

   이 함수는 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 을 클릭합니다.

   왼쪽 여백에 (Code + Test, Integration 등과 함께) Developer 메뉴가 표시되고 화면 하단에 스크롤 막대가 있는 경우, 스크롤 막대를 왼쪽으로 밀어 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 필드를 찾습니다.

    추적 워크시트의 Azure Function App AD Application ID 필드에 이 ID를 기록합니다.

    중요

    Azure AD 애플리케이션 이름이 아니라 ID를 복사해야 합니다. ID는 UUID를 포함해야 합니다.