옵션 4: Azure Data Factory 템플릿을 사용하여 API 기반 가져오기로 데이터 보내기

아래 단계에 따라 Azure Data Factory 템플릿을 사용하여 데이터를 API 기반 가져오기로 보냅니다.

1. 새 Azure Data Factory 만들기

  1. 에 로그인합니다 https://adf.azure.com/en/datafactories.

  2. 새 데이터 팩터리를 만들거나 기존 데이터 팩터리를 사용합니다. 필드를 완료한 다음 만들기를 선택합니다.

    새 데이터 팩터리를 만들거나 기존 데이터 팩터리를 사용하는 방법을 보여 주는 스크린샷

2. 새 파이프라인 및 활동 만들기

  1. 새 파이프라인을 만들고 파이프라인의 이름을 입력합니다.

    새 파이프라인을 만드는 방법을 보여 주는 스크린샷

  2. 작업에서 데이터 복사를 추가합니다.

    복사 데이터를 추가하는 방법을 보여 주는 스크린샷

3. 데이터 활동 설정 복사: 일반

데이터 복사 작업을 선택한 다음, 일반을 선택하여 아래 지침을 사용하여 각 필드를 완료합니다.

데이터 활동 설정을 복사하는 방법을 보여 주는 스크린샷

  • 이름: 활동의 이름을 입력합니다.
  • 설명: 활동에 대한 설명을 입력합니다.
  • 활동 상태: 활성화를 선택합니다. 또는 비활성화를 선택하여 파이프라인 실행 및 유효성 검사에서 활동을 제외합니다.
  • 시간 제한: 활동을 실행할 수 있는 최대 시간입니다. 기본값은 12시간, 최소 시간은 10분, 허용되는 최대 시간은 7일입니다. 형식은 D.HH:MM:SS입니다.
  • 다시 시도: 최대 재시도 횟수입니다. 이 작업은 0으로 남겨둘 수 있습니다.
  • 다시 시도 간격(초): 최대 재시도 횟수입니다. 재시도 시도가 0으로 설정된 경우 30으로 남을 수 있습니다.
  • 보안 출력: 선택하면 작업의 출력이 로깅에 캡처되지 않습니다. 이 작업은 지워진 상태로 둘 수 있습니다.
  • 보안 입력: 선택하면 작업의 입력이 로깅에 캡처되지 않습니다. 이 작업은 지워진 상태로 둘 수 있습니다.

4. 데이터 활동 설정 복사: 원본

  1. 원본을 선택합니다.

  2. 기존 원본 데이터 세트를 선택하거나 +새로 만들기를 선택하여 새 원본 데이터 세트를 만듭니다. 예를 들어 새 데이터 세트에서Azure Blob Storage 선택한 다음, 데이터의 형식 형식을 선택합니다.

    새 원본 데이터 세트를 만드는 방법을 보여 주는 스크린샷

  3. .csv 파일의 속성을 설정합니다. 이름을 입력하고 연결된 서비스에서 기존 위치를 선택하거나 +새로 만들기를 선택합니다.

    csv 파일의 속성을 설정하는 방법을 보여 주는 스크린샷

  4. +새로 만들기를 선택한 경우 아래 지침을 사용하여 새 연결된 서비스에 대한 세부 정보를 입력합니다.

    새 연결된 서비스에 대한 세부 정보를 추가하는 방법을 보여 주는 스크린샷

  5. 원본 데이터 세트 옆에 있는 열기를 선택합니다.

    원본 데이터 세트를 여는 방법을 보여 주는 스크린샷

  6. 첫 번째 행을 머리글로 선택합니다.

    첫 번째 행을 헤더로 선택하는 방법을 보여 주는 스크린샷

5. 데이터 작업 설정 복사: 싱크

  1. 싱크를 선택합니다.

  2. +새로 만들기를 선택하여 API에 연결할 새 Rest 리소스를 구성합니다. "Rest"를 검색하고 계속을 선택합니다.

    API에 연결하도록 새 Rest 리소스를 구성하는 방법을 보여 주는 스크린샷

  3. 서비스 이름을 지정합니다. 연결된 서비스에서+새로 만들기를 선택합니다.

    서비스의 이름을 지정하고 새 연결된 서비스를 추가하는 방법을 보여 주는 스크린샷

  4. "Rest"를 검색하고 선택합니다.

    Rest 데이터 세트를 검색하는 방법을 보여 주는 스크린샷

  5. 아래 지침을 사용하여 필드를 입력합니다.

    데이터 세트의 필드를 입력하는 방법을 보여 주는 스크린샷

  • 이름: 새 연결된 서비스의 이름을 입력합니다.
  • 설명: 새 연결된 서비스에 대한 설명을 입력합니다.
  • 통합 런타임을 통해 연결: 기본 설정 메서드를 입력합니다.
  • 기본 URL: 아래 URL을 사용하고 {tenantid}를 테넌트 ID로 바꿉니다. https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion
  • 인증 유형: 인증 유형을 서비스 주체로 선택한 다음 비밀 또는 인증서를 선택합니다. 서비스 주체 예제:
    • 인라인: 선택합니다.

    • 서비스 주체 ID: API 커넥터에 대해 권한이 부여된 앱 ID를 입력합니다.

    • 서비스 주체 키: 키를 입력합니다.

      서비스 주체 키를 입력하는 방법을 보여 주는 스크린샷

    • 테넌트: 테넌트 ID를 입력합니다.

    • Microsoft Entra ID 리소스:https://api.orginsights.viva.office.com

    • Azure 클라우드 유형: Azure 클라우드 유형을 선택합니다.

    • 서버 인증서 유효성 검사: 사용을 선택합니다.

  1. 아래 지침을 사용하여 싱크 설정을 입력합니다.

    싱크 설정을 입력하는 방법을 보여 주는 스크린샷

  • 싱크 데이터 세트: 기존 데이터 세트 또는 새로 만든 데이터 세트를 선택합니다.
  • 요청 방법: POST를 선택합니다.
  • 요청 시간 제한: 기본값은 5분입니다.
  • 요청 간격(ms): 10이 기본값입니다.
  • 쓰기 일괄 처리 크기: 일괄 처리 크기는 파일의 최대 줄 수보다 높아야 합니다.
  • Http 압축 유형: 기본값은 없음입니다. 또는 GZip을 사용할 수 있습니다.
  • 추가 헤더: +새로 만들기를 선택합니다.
    • 상자 1: x-nova-scaleunit
    • : Microsoft 365의 조직 데이터 페이지(>설치>마이그레이션 및Microsoft 365 데이터 연결에서> 조직 데이터 가져오기>)의데이터 연결 페이지로 이동하여 값을 검색할 수 있습니다. 그런 다음 새 가져오기> 연결 유형 > 시작 API 기반 설정>API 기반 연결 설정 페이지를 선택합니다.

6. 데이터 작업 설정 복사: 매핑

  1. 매핑을 선택합니다.

  2. 부트스트랩 업로드의 경우 매핑(대상 이름)에 PersonId, ManagerId조직을 포함해야 합니다. 증분 업로드의 경우 대상 이름이 PersonId와 함께 이전 업로드의 이름과 일치하는지 확인합니다. 새 열을 사용하여 증분 업로드를 수행할 수 없으며 모든 업로드에는 PersonId 가 필요합니다.

    매핑에 대한 활동 설정을 입력하는 방법을 보여 주는 스크린샷

7. 데이터 활동 설정 복사: 설정 및 사용자 속성

설정 또는 사용자 속성에는 다른 사용자 지정이 필요하지 않습니다. 필요한 경우 대/소문자별로 이러한 설정을 편집할 수 있습니다.

8. 데이터 복사 작업: 트리거 설정(자동화)

자동화 설정에 트리거를 추가하려면 트리거 추가를 선택합니다. 권장되는 자동화는 매주입니다. 빈도를 사용자 지정할 수도 있습니다.

트리거를 설정하는 방법을 보여 주는 스크린샷