자습서: CSV 파서 수집 수행

아티클
02/16/2024

CSV(쉼표로 구분된 값) 파서 수집은 CSV 파일을 Azure Data Manager for Energy 인스턴스로 수집하는 기능을 제공합니다.

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

Postman을 사용하여 샘플 유정 데이터 CSV 파일을 Azure Data Manager for Energy 인스턴스에 수집합니다.
Postman을 사용하여 CSV 수집 중에 만들어진 스토리지 메타데이터 레코드를 검색합니다.

필수 조건

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

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 설정 및 요청 실행

Postman 데스크톱 앱을 다운로드하고 설치합니다.
다음 파일을 Postman으로 가져옵니다.
- CSV 워크플로 Postman 컬렉션
- CSV 워크플로 Postman 환경
Postman 컬렉션 및 환경 변수를 가져오려면 Postman으로 데이터 가져오기의 단계를 따릅니다.
Azure Data Manager for Energy 인스턴스의 세부 정보에서 얻은 정보로 Postman 환경의 CURRENT_VALUE를 업데이트합니다.
CSV 파서 수집에 대한 Postman 컬렉션에는 순차적으로 실행해야 하는 10개의 요청이 포함되어 있습니다.

Postman 컬렉션을 트리거하기 전에 수집 워크플로 환경을 선택해야 합니다.
보내기 단추를 선택하여 각 요청을 트리거합니다.

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

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

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

Postman을 사용하여 유정 데이터 수집

Postman 컬렉션을 사용하여 샘플 유정 데이터 CSV 파일을 Azure Data Manager for Energy 인스턴스로 수집하려면 다음 단계를 완료합니다.

사용자 액세스 토큰 가져오기: 추가 API 호출을 인증하는 데 사용할 사용자 토큰을 생성합니다.
스키마 만들기: CSV 파일에 있는 열을 준수하는 스키마를 만듭니다.
스키마 세부 정보 가져오기: 이전 단계에서 만든 스키마를 가져와서 유효성 검사합니다.
법적 태그 만들기: 데이터 규정 준수를 위해 CSV 데이터에 추가할 법적 태그를 만듭니다.
CSV 파일 업로드를 위한 서명된 URL 가져오기: CSV 파일이 업로드될 서명된 URL 경로를 가져옵니다.
CSV 파일 업로드: Wellbore.csv 샘플을 로컬 컴퓨터에 다운로드하고 파일 선택 단추를 클릭하여 Postman에서 이 파일을 선택합니다.
CSV 파일 메타데이터 업로드: 파일 위치 및 기타 관련 필드와 같은 파일 메타데이터 정보 업로드합니다.
CSV 파서 수집 워크플로 만들기: CSV 파서 수집 워크플로에 대한 DAG(방향성 비순환 그래프)를 만듭니다.
CSV 파서 수집 워크플로 트리거: CSV 파서 수집 워크플로에 대한 DAG를 트리거합니다.
CSV 파서 수집 워크플로 상태 검색: CSV 파서의 Dag 실행 상태를 가져옵니다.