Visão geral das APIs de tabela do OneLake

OneLake oferece um endpoint de API REST para interagir com tabelas em Microsoft Fabric. Esse ponto de extremidade pode ser usado com clientes e bibliotecas compatíveis com o padrão aberto da API do Iceberg REST Catalog (IRC) ou com o padrão aberto da API do Unity Catalog..

Importante

Este recurso está em pré-visualização.

Pré-requisitos

O uso dessas APIs é simples depois que você identifica algumas informações e seleciona seu fluxo de autenticação preferido do Microsoft Entra ID.

Para usar essas APIs, primeiro você precisa reunir as seguintes informações:

O seu ID de inquilino do Fabric.

O ID do tenant é um GUID e pode ser encontrado no cartão Perfil ou no menu **Ajuda, Sobre Fabric no Fabric.
O espaço de trabalho e o ID do item de dados (como um lakehouse) com um diretório Tables no nível superior.

Esses IDs são GUIDs (Identificadores Globais Universais). Podem ser encontrados no URL de qualquer tabela dentro do OneLake. Como alternativa, eles podem ser encontrados dentro da URL vista em seu navegador quando você tem um item de dados aberto no Fabric.
A identidade do usuário ou da entidade de serviço na ID do Microsoft Entra que tem permissões para ler tabelas no item de dados escolhido.

Decida como você gostaria de se autenticar com o ID do Microsoft Entra para obter um token de acesso para a identidade do Microsoft Entra escolhida.

Você pode verificar este guia para saber mais sobre as diferentes maneiras de obter um token de acesso com o Microsoft Entra ID. A Microsoft oferece bibliotecas de autenticação convenientes em vários idiomas.
Se você estiver desenvolvendo um novo aplicativo que permitirá que os usuários entrem ou entrem como um aplicativo autônomo, registre seu aplicativo com o Microsoft Entra ID.
Conceda permissão de API para o destinatário de token do Azure Storage (https://storage.azure.com/) na sua aplicação Microsoft Entra ID. Conceder esta permissão garante que a sua aplicação possa obter tokens para utilização com o endpoint da tabela OneLake.

Observação

O ponto de extremidade da API da tabela OneLake aceita o mesmo destinatário de token que os pontos de extremidade do sistema de ficheiros OneLake.

Se você estiver desenvolvendo um aplicativo, talvez já saiba como autenticar com o Microsoft Entra ID para interagir com as APIs REST do sistema de arquivos OneLake. Em caso afirmativo, pode usar a mesma abordagem para autenticar-se com o novo endpoint da tabela OneLake.

Saiba como começar a interagir com as tabelas Iceberg do OneLake através do endpoint da API de tabelas do OneLake. Inicialmente, há suporte para operações de tabela de metadados de apenas leitura e pretendemos adicionar mais operações em breve.

Observação

Antes de usar as APIs do Iceberg, verifique se a conversão de metadados Delta Lake para Iceberg está habilitada para seu locatário ou espaço de trabalho. Reveja as instruções para saber como ativar a conversão automática do formato de tabela Delta Lake para Iceberg.

Esta página foi útil?