V2 데이터셋 API
데이터셋(Dataset)은 Foundry에서 데이터를 저장하고 처리하며 온톨로지에 연결하는 리소스입니다. V2 API는 데이터셋 메타데이터, 표, 스키마, 운영 이력, 브랜치와 트랜잭션, 파일 및 뷰 구성을 다룹니다.
일반 데이터셋 엔드포인트는 제한 뷰(Restricted view)나 구체화하지 않은 뷰와 호환되지 않습니다. 뷰의 기반 데이터셋과 기본 키를 관리할 때는 별도의 View API를 사용합니다.
데이터셋과 스키마
| 작업 | 기능 |
|---|---|
| Create Dataset | 상위 폴더에 데이터셋을 만듭니다. |
| Get Dataset | 이름과 상위 폴더를 포함한 메타데이터를 조회합니다. |
| Read Table Dataset | 표를 ARROW 또는 CSV로 읽습니다. |
| Get Dataset Schema | 브랜치, 트랜잭션과 버전으로 스키마를 조회합니다. |
| Get Schema Datasets Batch | 최대 1,000개 데이터셋의 스키마를 한 번에 조회합니다. |
| Put Dataset Schema | 데이터셋에 스키마를 추가합니다. |
운영 정보
| 작업 | 기능 |
|---|---|
| Get Dataset Schedules | 데이터셋을 대상으로 하는 일정 RID를 조회합니다. |
| Get Dataset Health Checks | 구성된 상태 검사 RID를 조회합니다. |
| Get Dataset Health Check Reports | 상태 검사 보고서와 결과를 조회합니다. |
| Get Dataset Jobs | 시간 조건과 정렬로 실행 작업 RID를 조회합니다. |
| List Transactions of Dataset | 데이터셋의 트랜잭션 이력을 조회합니다. |
브랜치, 트랜잭션과 파일
- 브랜치 API: 생성, 조회, 목록, 삭제와 브랜치별 트랜잭션 이력을 다룹니다.
- 트랜잭션 API: 파일 변경을 묶어 생성, 커밋 또는 중단합니다.
- 파일 API: 파일 목록과 메타데이터, 업로드, 다운로드와 삭제를 다룹니다.
- View API: 기반 데이터셋을 조합하고 기본 키의 중복 해결 규칙을 관리합니다.
V1에서 옮길 때는 버전 경로만 바꾸지 말고 필드 이름과 필수 여부를 함께 확인합니다. V2는 여러 작업에서 branchName을 사용하며 브랜치 객체의 이름 필드는 name입니다. 트랜잭션 생성의 transactionType도 V2에서는 필수입니다.