자습서: 매니페스트 기반 파일 수집 수행

  • 아티클

매니페스트 수집은 Azure Data Manager for Energy 인스턴스에 매니페스트를 수집하는 기능을 제공합니다.

이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.

  • 수집 샘플은 Postman을 사용하여 Azure Data Manager for Energy 인스턴스로 매니페스트됩니다.
  • Postman을 사용하여 매니페스트 수집 중에 만들어진 스토리지 메타데이터 레코드를 검색합니다.

필수 조건

이 자습서를 시작하기 전에 다음 필수 구성 요소를 완료해야 합니다.

Azure Data Manager for Energy 인스턴스에 대한 세부 정보 가져오기

  • Azure Data Manager for Energy 인스턴스가 필요합니다. 아직 없는 경우 빠른 시작: Azure Data Manager for Energy 인스턴스 만들기의 단계를 따라 하나를 만듭니다.

  • 이 자습서에서는 다음 매개 변수가 필요합니다.

    매개 변수 사용할 값 예시 이 값을 찾을 수 있는 위치
    CLIENT_ID 애플리케이션(클라이언트) ID 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Microsoft ID 플랫폼에 애플리케이션을 등록할 때 이 앱 또는 클라이언트 ID를 사용합니다. 애플리케이션 등록을 참조하세요.
    CLIENT_SECRET 클라이언트 암호 _fl****************** 애플리케이션 암호라고도 하는 클라이언트 암호는 앱에서 ID 자체에 대한 인증서 대신 사용할 수 있는 문자열 값입니다. 클라이언트 비밀 추가를 참조하세요.
    TENANT_ID 디렉터리(테넌트) ID 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Azure Portal에서 계정 이름을 마우스로 가리켜 디렉터리 또는 테넌트 ID를 가져옵니다. 또는 Azure Portal에서 Microsoft Entra ID>속성>테넌트 ID를 검색하여 선택합니다.
    SCOPE 애플리케이션(클라이언트) ID 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx 이 값은 앞에서 언급한 앱 또는 클라이언트 ID와 동일합니다.
    refresh_token 새로 고침 토큰 값 0.ATcA01-XWHdJ0ES-qDevC6r........... 인증 토큰 만들기 방법에 따라 새로 고침 토큰을 만들고 저장합니다. 이 새로 고침 토큰은 나중에 사용자 토큰을 생성하는 데 필요합니다.
    DNS URI <instance>.energy.Azure.com Azure Data Manager for Energy 인스턴스의 개요 페이지에서 이 값을 찾습니다.
    data-partition-id 데이터 파티션 <instance>-<data-partition-name> Azure Data Manager for Energy 인스턴스의 개요 페이지에서 이 값을 찾습니다.

사용자 관리 가이드에 따라 이 자습서를 실행하는 사용자에게 적절한 권한을 추가합니다.

Postman 설정 및 요청 실행

  1. Postman 데스크톱 앱을 다운로드하고 설치합니다.

  2. 다음 파일을 Postman으로 가져옵니다.

    Postman 컬렉션 및 환경 변수를 가져오려면 Postman으로 데이터 가져오기의 단계를 따릅니다.

  3. Azure Data Manager for Energy 인스턴스의 세부 정보에서 얻은 정보로 Postman 환경의 CURRENT_VALUE를 업데이트합니다.

  4. 매니페스트 수집을 위한 Postman 컬렉션에는 순차적으로 실행해야 하는 여러 요청이 포함되어 있습니다.

    Postman 컬렉션을 트리거하기 전에 수집 워크플로 환경을 선택해야 합니다.

    Screenshot of the Postman environment.

  5. 보내기 단추를 선택하여 각 요청을 트리거합니다.

    모든 요청에서 Postman은 예상된 응답 코드에 대해 실제 API 응답 코드의 유효성을 검사합니다. 일치하지 않는 경우 테스트 섹션은 실패를 나타냅니다.

성공적인 Postman 요청의 예는 다음과 같습니다.

Screenshot of a successful Postman call.

실패한 Postman 요청의 예는 다음과 같습니다.

Screenshot of a failed Postman call.

Postman을 사용하여 샘플 매니페스트 수집

Postman 컬렉션을 사용하여 Azure Data Manager for Energy 인스턴스에 샘플 매니페스트를 수집하려면 다음 단계를 완료합니다.

  1. 사용자 액세스 토큰 가져오기: 추가 API 호출을 인증하는 데 사용할 사용자 토큰을 생성합니다.

  2. 법적 태그 만들기: 데이터 준수를 위해 매니페스트 데이터에 추가될 법적 태그를 만듭니다.

  3. 파일 업로드를 위한 서명된 URL 가져오기: 매니페스트 파일이 업로드될 서명된 URL 경로를 가져옵니다.

  4. 파일 업로드: Wellbore.csv 샘플을 로컬 컴퓨터에 다운로드합니다. CSV, LAS, JSON 등 모든 파일 형식이 가능합니다. 파일 선택 단추를 클릭하여 Postman에서 이 파일을 선택합니다.

    Screenshot of uploading a manifest file.

  5. 파일 메타데이터 업로드: 파일 위치 및 기타 관련 필드와 같은 파일 메타데이터 정보 업로드합니다.

  6. 파일 메타데이터 가져오기: 메타데이터가 성공적으로 만들어졌는지 유효성을 검사하기 위해 호출합니다.

  7. 마스터, 참조 및 WPC(작업 산출물 구성 요소) 데이터 수집 - 마스터, 참조 및 WPC(작업 산출물 구성 요소) 매니페스트 메타데이터를 수집합니다.

  8. 매니페스트 수집 워크플로 상태 가져오기: 워크플로가 시작되고 실행 중 상태입니다. 상태가 완료(일반적으로 20~30초)로 변경될 때까지 계속 쿼리합니다.

Postman을 사용하여 수집된 데이터 검색

Postman 컬렉션을 사용하여 매니페스트 수집 중에 만들어진 스토리지 메타데이터 레코드를 검색하려면 다음 단계를 완료합니다.

  1. 작업 산출물 검색: 검색 서비스를 호출하여 작업 산출물 메타데이터 레코드를 검색합니다.
  2. 작업 산출물 구성 요소 검색: 검색 서비스를 호출하여 WPC 메타데이터 레코드를 검색합니다.
  3. 데이터 세트 검색: 검색 서비스를 호출하여 데이터 세트 메타데이터 레코드를 검색합니다.
  4. 마스터 데이터 검색: 검색 서비스를 호출하여 마스터 메타데이터 레코드를 검색합니다.
  5. 참조 데이터 검색: 검색 서비스를 호출하여 참조 메타데이터 레코드를 검색합니다.

다음 단계

다음 자습서를 진행합니다.

자습서: sdutil을 사용하여 Seismic Store에 데이터 로드

매니페스트 수집에 대한 자세한 내용은 OSDU 운영자 데이터 로드 빠른 시작 가이드를 참조하세요.