Principais conceitos e características

O kit de ferramentas de extensibilidade apresenta um conjunto de recursos projetados para trazer seu aplicativo de dados para a malha da forma mais simples possível. Esses recursos permitem que os desenvolvedores criem experiências ricas e integradas com o mínimo de esforço. Com o Extensibility Toolkit, você pode acessar facilmente as APIs do Fabric diretamente do frontend, persistir a definição (estado) do item no Fabric, usar um fluxo de criação de item padronizado e aproveitar a segurança e a interoperabilidade aprimoradas por meio do relaxamento do iFrame e do suporte a APIs públicas. Além disso, simplifica o ciclo de vida do desenvolvimento com suporte integrado a CI/CD, facilitando a automação da implantação e dos testes. As seções a seguir fornecem uma visão geral das principais funcionalidades e orientações sobre como incorporá-las em suas cargas de trabalho.

Experiência de criação de itens padrão

A criação do item é padronizada por meio de um controle Fabric dedicado que orienta os usuários durante o processo. Esse controle permite que os usuários selecionem o espaço de trabalho onde o item é criado, atribuam rótulos de Sensibilidade e definam outras configurações relevantes. Ao usar essa experiência padronizada, você não precisa mais lidar com as complexidades da criação de itens por conta própria ou se preocupar com futuras mudanças no processo. Além disso, essa abordagem permite que a criação de itens seja exibida diretamente em sua página de carga de trabalho, proporcionando uma experiência de usuário perfeita e integrada.

Use o guia Como criar um item para entender como ele pode ser implementado.

Suporte a API Frontend

Com o Extensibility Toolkit, você pode obter um token Microsoft Entra On-Behalf-Of (OBO) diretamente em seu aplicativo frontend, permitindo o acesso seguro a qualquer API protegida por Entra. Esse recurso permite que você se integre profundamente aos serviços do Microsoft Fabric — por exemplo, você pode ler e armazenar dados no OneLake, criar e interagir com outros itens do Fabric ou usar o Spark como um mecanismo de processamento por meio das APIs Livey. Para obter mais informações, consulte a documentação do Microsoft Entra, a documentação do OneLake, as APIs REST do Fabric e o Spark in Fabric.

Use o guia Como adquirir o Microsoft Entra Token para entender como ele pode ser implementado. Use também o guia Como aceder às APIs do Fabric para entender como o utilizador pode interagir com o Fabric.

Armazenamento da definição de item (estado) no Fabric

Esse recurso permite que você armazene os metadados do item, como a configuração do item e outras informações relevantes, diretamente no OneLake dentro de uma pasta oculta que não está visível para os usuários finais. Os dados são armazenados usando o mesmo formato aplicado por APIs públicas e processos de CI/CD, garantindo consistência e interoperabilidade entre diferentes pontos de integração. Detalhes sobre o formato e seu uso com APIs públicas e CI/CD são discutidos nas seções a seguir.

Use a definição Como armazenar itens para entender como pode ser implementada.

O que armazenar na definição

Pense no estado como algo que contém todas as informações necessárias para restaurar um item se ele for excluído ou copiado em outro lugar. Isso não inclui os dados em si, que são armazenados no OneLake (consulte Armazenando dados de item no OneLake).

Eis alguns exemplos práticos:

• Item do bloco de anotações: o estado armazena o código do bloco de anotações, a ordem das células e os metadados, como qual mecanismo de execução (por exemplo, Spark, SQL) deve ser usado. Os dados reais processados pelo notebook não são armazenados no estado.
• Item do editor de arquivos: o estado não armazena o conteúdo do arquivo em si, mas armazena a configuração do editor, como esquema de cores, configurações de preenchimento automático, tamanho da fonte e outras preferências do usuário.
• Item do instalador ou do orquestrador: se o item instalar ou provisionar outros componentes (como bancos de dados ou recursos de computação), o estado deverá conter referências (IDs, URIs) aos itens criados. Isso permite que sua carga de trabalho verifique seu estado ou gerencie-os mais tarde.

Ao se concentrar na configuração, metadados e referências, você garante que o estado do item seja portátil, leve e fácil de restaurar ou migrar.

Armazenando dados de itens no OneLake

Cada item vem com sua própria pasta de itens Onelake, onde os desenvolvedores podem armazenar dados estruturados e não estruturados. Semelhante a um Lakehouse , o item tem uma pasta Table onde os dados podem ser armazenados no formato Delta ou Iceberg e uma pasta Files onde os dados não estruturados podem ser armazenados.

Use o Como armazenar dados no item para entender como ele pode ser implementado.

Dados de atalho

Como cada item tem a sua própria pasta Onelake, eles também podem trabalhar com atalhos. Ao utilizar a carga de trabalho da API de Atalho Público, os desenvolvedores podem criar diferentes tipos de Atalho a partir do ou para o seu item, para participar da promessa de cópia única do OneLake.

Use o Como criar atalhos para entender como ele pode ser implementado.

Suporte da API CRUD para itens

Os utilizadores podem criar, atualizar e excluir itens com conteúdo usando as APIs de Rest de Item Fabric padrão. Essa habilitação automática facilita muito a integração com itens de carga de trabalho da mesma forma que os itens principais do Fabric, simplificando a interoperabilidade e reduzindo o esforço necessário para criar integrações robustas.

Suporte a CI/CD

O suporte a CI/CD para todos os itens é uma das maiores solicitações dos clientes. Com este recurso, todos os itens participam do CICD já disponível, sem a necessidade de implementar qualquer lógica ou operações específicas. Isto significa que pode automatizar a implementação, testes e atualizações das suas cargas de trabalho usando os Azure Pipelines e ferramentas padrão. O formato do item e as APIs são projetados para serem totalmente compatíveis com os processos de CI/CD, garantindo uma experiência consistente e confiável em todos os ambientes. Para obter mais informações sobre a integração com CI/CD, consulte a documentação do Fabric CICD.

API de notificação CRUD do item

Há casos em que sua carga de trabalho precisa participar dos eventos CRUD do item. Como os itens são criados na plataforma diretamente por meio da UX, APIs públicas ou proprietários de carga de trabalho de CI/CD não estão no controle quando um novo item é criado sobre esses pontos de entrada. Por padrão, os itens armazenam seu estado no Fabric e não precisam ser informados sobre a alteração de seu item. No entanto, existem alguns casos em que as cargas de trabalho necessitam de participar no fluxo CRUD. Este é principalmente o caso se a infraestrutura para itens precisar ser provisionada ou configurada (por exemplo, bancos de dados). Para esses cenários, permitimos que os parceiros implementem uma API de notificação Crud que o Fabric chama em todos os eventos. Nesse cenário, o desenvolvedor de carga de trabalho precisa certificar-se de que sua API está acessível, caso contrário, as operações de malha falharão.

Planificador de Fabric

O Fabric oferece suporte ao agendamento de tarefas para cargas de trabalho. Esse recurso permite que os desenvolvedores criem cargas de trabalho que são notificadas mesmo que o utilizador não esteja em frente à interface do utilizador e ajam com base na tarefa que deve ser executada (por exemplo, copiar dados no Onelake). Os parceiros precisam implementar uma API e configurar sua carga de trabalho para participar dessa funcionalidade.

Relaxamento do iFrame

Os desenvolvedores podem solicitar mais atributos do iFrame para habilitar cenários avançados, como downloads de arquivos ou abertura de sites externos. Esse recurso permite que sua carga de trabalho solicite consentimento explícito aos usuários antes de executar ações que exigem recursos mais amplos do navegador, como iniciar downloads ou conectar usuários a APIs externas usando suas credenciais atuais do Fabric. Ao especificar esses requisitos em sua configuração de carga de trabalho, você garante que os usuários sejam informados e possam conceder as permissões necessárias, permitindo uma integração perfeita com sistemas externos, mantendo a segurança e a confiança do usuário.

Use o Como relaxar o iFrame para entender como ele pode ser implementado.

Limitações de funcionalidades

Link privado

Todas as cargas de trabalho são bloqueadas para consumo e desenvolvimento se o Private Link estiver habilitado no nível do locatário ou do espaço de trabalho.