OneLake 테이블 API 개요

OneLake는 Microsoft Fabric의 테이블과 상호 작용하기 위한 REST API 엔드포인트를 제공합니다. 이 엔드포인트는 IRC(Iceberg REST Catalog) API 개방형 표준 또는 Unity 카탈로그 API 개방형 표준과 호환되는 클라이언트 및 라이브러리와 함께 사용할 수 있습니다.

필수 조건

몇 가지 정보를 식별하고 선호하는 Microsoft Entra ID 인증 흐름을 선택하면 이러한 API를 사용하는 것이 간단합니다.

기본 정보 수집

이러한 API를 사용하려면 먼저 다음 정보를 수집해야 합니다.

• 패브릭 테넌트 ID입니다.

  테넌트 ID는 GUID이며 프로필 카드 또는 **도움말, 패브릭 정보 (Fabric) 메뉴에서 찾을 수 있습니다.

• 최상위 테이블 디렉터리가 있는 데이터 항목(예: lakehouse)의 작업 영역 및 데이터 항목 ID입니다.

  이러한 ID는 GUID입니다. OneLake에 있는 테이블의 OneLake URL 내에서 찾을 수 있습니다. 또는 Fabric에서 데이터 항목이 열려 있는 경우 브라우저에서 볼 수 있는 URL 내에서 찾을 수 있습니다.

• 선택한 데이터 항목에서 테이블을 읽을 수 있는 권한이 있는 Microsoft Entra ID의 사용자 또는 서비스 주체 ID입니다.

인증 준비

1. 선택한 Microsoft Entra ID에 대한 액세스 토큰을 얻기 위해 Microsoft Entra ID로 인증하는 방법을 결정합니다.

   이 가이드를 확인하여 Microsoft Entra ID를 사용하여 액세스 토큰을 가져오는 다양한 방법에 대해 알아볼 수 있습니다. Microsoft는 여러 언어로 편리한 인증 라이브러리를 제공합니다.

2. 사용자가 독립 실행형 애플리케이션으로 로그인하거나 로그인할 수 있도록 하는 새 애플리케이션을 개발하는 경우 Microsoft Entra ID로 애플리케이션을 등록합니다.

3. Azure Storage() 토큰 대상 그룹에 대한 https://storage.azure.com/ Microsoft Entra ID 애플리케이션에 부여합니다. 이 권한을 부여하면 애플리케이션이 OneLake 테이블 엔드포인트에 사용할 토큰을 가져올 수 있습니다.

   비고

   OneLake 테이블 API 엔드포인트는 OneLake 파일 시스템 엔드포인트와 동일한 토큰 대상을 허용합니다.

   애플리케이션을 개발하는 경우 OneLake 파일 시스템 REST API와 상호 작용하기 위해 Microsoft Entra ID로 인증하는 방법을 이미 알고 있을 수 있습니다. 이 경우 동일한 방법을 사용하여 새 OneLake 테이블 엔드포인트로 인증할 수 있습니다.

OneLake에서 IRC(Iceberg REST 카탈로그) API 작업

OneLake 테이블 API 엔드포인트를 시작하여 OneLake에서 Iceberg 테이블과 상호 작용하는 방법을 알아봅니다. 처음에는 읽기 전용 메타데이터 테이블 작업이 지원되며 곧 더 많은 작업을 추가할 계획입니다.

OneLake의 Delta Lake REST API 작업

OneLake 테이블 API 엔드포인트를 시작하여 OneLake의 델타 테이블과 상호 작용하는 방법을 알아봅니다.

관련 콘텐츠

• Iceberg용 OneLake 테이블 API에 대해 자세히 알아봅니다.
• 델타용 OneLake 테이블 API에 대해 자세히 알아봅니다.
• Delta Lake에서 Iceberg 형식으로의 자동 변환을 설정합니다.