OneLakeは、Fabric内のテーブルメタデータの扱いやテーブル行の読み取りのためのAPIを提供しています。 カタログメタデータAPIは、 Iceberg REST Catalog(IRC)APIオープンスタンダード または Unity Catalog APIオープンスタンダードと互換性のあるクライアントやライブラリと連携します。 一般的なREST APIは、テーブルや列の追加の説明およびタグの読み書きを行います。 フォーマットに依存しないテーブルリードAPIは、テーブル行をApache Arrowデータとして返しつつ、OneLakeのセキュリティを強制します。
テーブルメタデータの扱い
メタデータAPIを使ってスキーマ、テーブル、テーブルのメタデータを発見してください。 サポートされる読み書き操作はプロトコルによって異なります。
追加のテーブルメタデータAPI(プレビュー)を使って、フォーマット固有のカタログAPIを使わずにテーブルや列の説明やタグを読み書きできます。
| API | プロトコル | テーブルの形式 |
|---|---|---|
| IcebergメタデータAPI | Iceberg REST カタログ API | サポートされるOneLakeテーブルのIcebergメタデータ |
| デルタメタデータAPI | Unity カタログ互換REST API | デルタメタデータ |
テーブルデータの読み取り
テーブルリードAPIを使って、サポートされているOneLakeテーブルからセキュアな行を取得してください。
| API | プロトコルとワークフロー | テーブルの形式 |
|---|---|---|
| テーブルリードAPI(プレビュー) |
POST /readでストリームを割り当て、各ストリームを次の方法で取得しますGET /readStream/{streamId} |
有効なデルタ湖およびアパッチアイスバーグ表 |
[前提条件]
これらのAPIを使用する前に、いくつかの情報を特定し、お好みのMicrosoft Entra ID認証フローを選択してください。
基本的な情報を集めてください
次の情報を収集してください。
あなたのFabricテナントID。
テナントIDはGUIDです。 プロフィールカードかヘルプ>About Fabricで見つけてください。
最上位レベルのテーブルディレクトリを持つデータ項目（例：レイクハウス）のワークスペースと、データ項目のID。
これらの ID は GUID です。 これらは、OneLake 内の任意のテーブルの OneLake URL 内にあります。 または、Fabric でデータ項目を開いているときにブラウザーに表示される URL 内で見つけることができます。
アクセスしたいテーブルのスキーマ名とテーブル名です。 テーブルリードAPIの場合、テーブルは有効なDelta LakeまたはApache Icebergテーブルでなければなりません。
Microsoft Entra IDで、使用する操作に必要な権限を持つユーザーまたはサービスプリンシパルのアイデンティティ。
- 読み取り操作にはターゲットテーブルの読み取り許可が必要です。 テーブルリードAPIは、行や列を返す際にこのアイデンティティの権限およびデータセキュリティポリシーを使用します。
- 書き込み操作には、ターゲットデータ項目とOneLakeの場所への書き込みアクセスが必要です。 アイテムの種類やアクセスモデルに応じて、書き込みを許可するアイテムまたはワークスペースロールを付与するか、OneLakeのデータアクセスロールを通じて ReadWrite を付与します。 詳細については、「 OneLake セキュリティの概要」を参照してください。
認証準備
APIでどのように認証したいか計画を立ててください。
Microsoft Entra ID で認証して、選択した Microsoft Entra ID のアクセス トークンを取得する方法を決定します。
このガイドでは、Microsoft Entra ID を使用してアクセス トークンを取得するさまざまな方法について確認できます。 Microsoft では、 便利な認証ライブラリを複数の言語で提供しています。
ユーザーがスタンドアロン アプリケーションとしてサインインまたはサインインできるようにする新しいアプリケーションを開発する場合は、 Microsoft Entra ID でアプリケーションを登録します。
Azure Storage () トークンの対象ユーザーに対する
https://storage.azure.com/を Microsoft Entra ID アプリケーションに付与します。 このアクセス許可を付与することで、アプリケーションが OneLake テーブル エンドポイントで使用するトークンを取得できるようになります。注
OneLake テーブル API エンドポイントは、OneLake ファイルシステム エンドポイントと同じトークン対象ユーザーを受け入れます。
アプリケーションを開発している場合、Microsoft Entra IDで認証してOneLakeのファイルシステムREST APIとやり取りする方法をすでに知っているかもしれません。 もしそうなら、同じ方法でOneLakeのテーブルエンドポイントで認証できます。
関連コンテンツ
- 追加のテーブルメタデータについて詳しくはこちらをご覧ください。
- IcebergメタデータAPIについて詳しくはこちらをご覧ください。
- Delta metadata API の詳細をご確認ください。
- OneLakeのテーブルデータの読み方について詳しく学びましょう。
- Delta Lake から Iceberg 形式への自動変換を設定します。