Apache Polaris: The Definitive Guide

5장. 폴라리스 REST API

이 작품은 AI를 사용하여 번역되었습니다. 여러분의 피드백과 의견을 환영합니다: [e-mail]

이 장()에서는 카탈로그, 역할, 네임스페이스, 테이블 및 보기를 관리하기 위해 Apache Polaris에서 제공하는 REST API에 대해 자세히 설명합니다. Polaris REST API를 사용하면 데이터 레이크하우스의 카탈로그 계층과 원활하고 프로그래밍 방식으로 상호 작용할 수 있으므로 분산 환경 전반에서 복잡한 작업을 더 쉽게 조율할 수 있습니다.

새 카탈로그를 추가하든, 역할과 주체를 통해 액세스 제어를 정의하든, 세분화된 네임스페이스와 테이블 작업을 수행하든, Polaris REST API는 이러한 작업을 효율적으로 처리할 수 있는 유연성을 제공합니다. 이 API를 활용하면 팀은 카탈로그 관리 작업을 자동화하여 데이터 플랫폼 내에서 확장성, 일관성, 향상된 거버넌스를 보장할 수 있습니다.

각 엔드포인트를 세분화하여 그 용도를 살펴보고 cURL과 Python의 요청 라이브러리를 사용한 사용법을 보여드리겠습니다. 이 장이 끝나면 Polaris 배포를 프로그래밍 방식으로 관리하고 워크플로우에 통합하는 방법을 확실히 이해하게 될 것입니다.

다음 섹션에서는 Polaris 관리 REST API 엔드포인트를 기능별로 그룹화하여 구체적으로 살펴봅니다(이는 Apache Icicle REST 카탈로그 사양 및 엔드포인트와 다릅니다). 또한 사용자 정의 스크립트를 작성하거나 cURL, Postman 또는 Insomnia와 같은 HTTP 클라이언트를 사용하지 않고도 대부분의 작업을 실행하는 데 사용할 수 있는 Python CLI가 Polaris Repo에 내장되어 있습니다.

이 REST 사양의 최신 버전은 여기에서 언제든지 확인할 수 있습니다:

• https://github.com/apache/polaris/blob/main/spec/polaris-management-service.yml

5.1-5.3 섹션의 모든 엔드포인트 앞에는 /api/management/v1 이 붙습니다. 예를 들어 /catalogs 엔드포인트 는 /api/management/v1/catalogs 가 됩니다.

카탈로그 작업

Polaris REST API는 카탈로그에서 CRUD(만들기, 읽기, 업데이트 및 삭제) 작업을 수행하기 위한 엔드포인트를 제공합니다. 이러한 작업은 카탈로그 관리의 기초를 형성하여 프로그래밍 방식으로 카탈로그를 정의, 쿼리, 업데이트 및 제거할 수 있게 해줍니다.

목록 카탈로그

Polaris 배포의 모든 카탈로그 목록을 검색합니다.

엔드포인트:

GET /catalogs

샘플 cURL 요청:

curl -X GET https://polaris.example.com/api/management/v1/catalogs \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json"

샘플 Python 요청:

import ...