Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo descreve a arquitetura do Kit de Ferramentas de Extensibilidade do Microsoft Fabric e como as cargas de trabalho personalizadas se integram à plataforma Fabric. Ele explica os componentes de runtime, os fluxos entre o front-end do Fabric, sua carga de trabalho e os serviços do Fabric e como o manifesto e o modelo de item fazem com que as cargas de trabalho se sintam nativas no Fabric.
Componentes de arquitetura
Front-end do Fabric (servidor)
O front-end do Fabric é o ambiente do host. Ele renderiza sua carga de trabalho como um iFrame e expõe uma API de host segura para o iFrame para que a carga de trabalho possa interagir com o Fabric enquanto permanece isolada. O host é responsável por inicializar a carga de trabalho de acordo com seu manifesto (pontos de entrada, rotas e funcionalidades), gerenciar tokens de autenticação por meio da ID do Microsoft Entra e mediar chamadas da carga de trabalho para APIs públicas do Fabric e serviços de plataforma.
Aplicativo Web de carga de trabalho
Sua carga de trabalho é um aplicativo Web (por exemplo, React ou Angular) que você hospeda em sua nuvem. O Fabric o carrega em um iFrame e fornece APIs de host para integrar à plataforma. O aplicativo implementa as rotas e superfícies de interface do usuário declaradas em seu manifesto, usa tokens de ID do Microsoft Entra (fornecidos pelo host) para chamar APIs públicas do Fabric e, se necessário, seus próprios serviços de back-end e segue as diretrizes de UX do Fabric para que ele pareça e se comporte como uma experiência nativa.
Serviço do Fabric e APIs públicas
O serviço Fabric expõe APIs públicas para leitura e gravação de metadados e conteúdo, gerenciamento de itens e integração com recursos de plataforma. Os workloads chamam essas APIs usando tokens com escopo emitidos por meio da Microsoft Entra ID, por exemplo, para executar operações CRUD de item e ações de ciclo de vida, acessar dados e conteúdo armazenados no OneLake e participar de recursos de espaço de trabalho, como pesquisa e descoberta. Para informações sobre endpoints, escopos e diretrizes de identidade, consulte as APIs REST Públicas do Fabric.
Microsoft Entra (autenticação)
A autenticação e a autorização são tratadas pela ID do Microsoft Entra. O manifesto da carga de trabalho declara as permissões necessárias; o host do Fabric obtém os tokens apropriados e impõe o consentimento e o acesso de acordo com essas declarações.
Modelo e manifesto de carga de trabalho
As cargas de trabalho são definidas por um manifesto que descreve sua identidade, funcionalidades, rotas, pontos de entrada da interface do usuário e permissões necessárias. O manifesto é o contrato entre seu aplicativo Web e o Fabric. Para obter o esquema, os exemplos e as diretrizes de validação, consulte a Visão geral do manifesto.
Itens e participação nativa
Normalmente, as cargas de trabalho contribuem com um ou mais tipos de item. Os itens criados pela sua carga de trabalho aparecem em espaços de trabalho e se comportam como itens nativos do Fabric. Eles participam da colaboração e do compartilhamento, são detectáveis na pesquisa, seguem operações de ciclo de vida e governança e armazenam dados por meio do OneLake enquanto usam APIs públicas do Fabric para CRUD.
Fluxo de ponta a ponta
- Um usuário abre um espaço de trabalho e navega até um item ou ponto de entrada fornecido pela sua carga de trabalho.
- O front-end do Fabric carrega seu aplicativo Web em um iFrame com base no manifesto.
- O host adquire tokens do Microsoft Entra com os escopos exigidos pela carga de trabalho e expõe uma API de host ao iFrame.
- A carga de trabalho utiliza essas tokens para chamar APIs públicas do Fabric (e, se aplicável, seus próprios serviços).
- Os dados do item são armazenados no OneLake e os metadados de item são gerenciados por meio de APIs do Fabric para que se comportem como qualquer outro item do Fabric.
Próximas etapas
Para desenvolver localmente e publicar sua carga de trabalho, consulte Publicar sua carga de trabalho. Para obter diretrizes de esquema de manifesto e desenvolvimento local, consulte Visão geral do Manifesto, DevServer e DevGateway. Para obter endpoints de API, escopos e diretrizes de identidade, consulte as APIs REST Públicas do Fabric.