델타용 OneLake 테이블 API

OneLake는 Microsoft Fabric의 테이블과 상호 작용하기 위한 REST API 엔드포인트를 제공합니다. 이 문서에서는 이 엔드포인트를 사용하여 메타데이터 읽기 작업을 위해 이 엔드포인트에서 사용할 수 있는 델타 API와 상호 작용하는 방법을 설명합니다. 이러한 작업은 Unity 카탈로그 API 개방형 표준과 호환됩니다.

전체 OneLake 테이블 API 지침 및 필수 구성 요소 지침은 OneLake 테이블 API 개요를 참조하세요.

자세한 API 설명서는 시작 가이드를 참조하세요.

델타 테이블 API 엔드포인트

OneLake 테이블 API 엔드포인트는 다음과 같습니다.

https://onelake.table.fabric.microsoft.com

OneLake 테이블 API 엔드포인트에서 델타 API는 다음 <BaseUrl>에서 사용할 수 있습니다.

https://onelake.table.fabric.microsoft.com/delta

델타 테이블 API 작업

현재 이 엔드포인트에서 지원되는 델타 API 작업은 다음과 같습니다. 이러한 작업에 대한 자세한 지침은 시작 가이드에서 확인할 수 있습니다.

• 스키마 나열

  GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/schemas?catalog_name=<ItemName or ItemID>

  이 작업은 작업 영역 ID 및 데이터 항목 ID(또는 특수 문자가 없는 경우 해당 이름)를 허용합니다.

  이 작업은 데이터 항목 내의 스키마 목록을 반환합니다. 데이터 항목이 스키마를 지원하지 않는 경우 명명 dbo 된 고정 스키마가 반환됩니다.

• 테이블 나열

  GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables?catalog_name=<ItemName or ItemID>&schema_name=<SchemaName>

  이 작업은 지정된 스키마 내에서 찾은 테이블 목록을 반환합니다.

• 테이블 가져오기

  GET <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables/<TableName>

  이 작업은 테이블을 찾은 경우 스키마 내의 테이블에 대한 메타데이터 세부 정보를 반환합니다.

• 스키마가 있음

  HEAD <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/schemas/<SchemaName>

  이 작업은 데이터 항목 내에 스키마가 있는지 확인하고 스키마가 발견되면 성공을 반환합니다.

• 테이블이 있음

  HEAD <BaseUrl>/<WorkspaceName or WorkspaceID>/<ItemName or ItemID>/api/2.1/unity-catalog/tables/<TableName>

  이 작업은 스키마 내에 테이블이 있는지 확인하고 스키마가 발견되면 성공을 반환합니다.

현재 제한 사항, 고려 사항

Delta용 OneLake 테이블 API를 사용하는 경우 다음과 같은 제한 사항 및 고려 사항이 적용됩니다.

• 특정 데이터 항목은 스키마를 지원하지 않을 수 있습니다.

  비 스키마 사용 패브릭 레이크하우스와 같이 사용하는 데이터 항목의 형식에 따라 Tables 디렉터리 내에 스키마가 없을 수 있습니다. 이러한 경우 API 클라이언트와의 호환성을 위해 OneLake 테이블 API는 데이터 항목 내의 모든 테이블을 포함하는 기본 고정 dbo 스키마(또는 네임스페이스)를 제공합니다.

• 스키마 이름 또는 테이블 이름에 점이 포함된 경우 필요한 추가 쿼리 문자열 매개 변수

  스키마 또는 테이블 이름에 점(.)이 포함되어 있고 URL에 포함된 경우 추가 쿼리 매개 변수도 제공해야 합니다. 예를 들어 스키마 이름에 점이 포함된 경우 catalog_name API 호출에 추가 쿼리 매개 변수로 포함하여 스키마가 있는지 확인합니다.

• 메타데이터 쓰기 작업, 기타 작업

  현재 델타 테이블 API 작업에 나열된 작업만 지원됩니다. 메타데이터 쓰기 작업을 처리하는 작업은 OneLake 테이블 Delta API 엔드포인트에서 아직 지원되지 않습니다.

관련 콘텐츠

• OneLake 테이블 API에 대해 자세히 알아봅니다.
• 자세한 지침 및 API 세부 정보를 참조하세요.