Principais conceitos e recursos

O kit de ferramentas de extensibilidade apresenta um conjunto de recursos projetado para levar seu Aplicativo de Dados à plataforma da forma mais simples possível. Esses recursos permitem que os desenvolvedores criem experiências avançadas e integradas com o mínimo de esforço. Com o Kit de Ferramentas de Extensibilidade, você pode acessar facilmente as APIs do Fabric diretamente do front-end, persistir a definição de item (estado) 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 à API pública. Além disso, simplifica seu ciclo de vida de desenvolvimento com suporte interno de CI/CD, facilitando a automatização da implantação e do teste. As seções a seguir fornecem uma visão geral das principais funcionalidades e diretrizes sobre como incorporá-las em suas cargas de trabalho.

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

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

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

Suporte à API de front-end

Com o Kit de Ferramentas de Extensibilidade, você pode obter um token OBO (Microsoft Entra On-Behalf-Of) diretamente em seu aplicativo de front-end, permitindo o acesso seguro a qualquer API protegida pelo Entra. Essa funcionalidade 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 do 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 Token do Microsoft Entra para entender como ele pode ser implementado. Use também o guia Como acessar APIs do Fabric para entender como você pode interagir com o Fabric.

Armazenando definição de item (estado) no Fabric

Esse recurso permite que você armazene os metadados do item, como configuração de 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 em 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 de como armazenar item para entender como a definição 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).

Aqui estão alguns exemplos práticos:

• Item do notebook: o estado armazena o código, a ordem das células e os metadados do notebook, 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 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 que ele criou. Isso permite que sua carga de trabalho verifique o estado ou gerencie-as posteriormente.

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

Armazenando dados de item no OneLake

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

Use o guia Como armazenar dados no Item para entender como isso pode ser implementado.

Dados de atalho

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

Use o Como criar atalhos para entender como eles podem ser implementados.

Suporte à API de item CRUD

Os usuários podem criar, atualizar e excluir itens com conteúdo usando as APIs REST padrão do Fabric Item. Essa habilitação automática facilita muito a integração com itens de carga de trabalho da mesma forma que os principais itens 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 solicitações mais altas dos clientes. Com este recurso, todos os itens participam do CICD de forma imediata, sem a necessidade de implementar qualquer lógica ou operação específica. Isso significa que você pode automatizar a implantação, o teste e as atualizações para suas cargas de trabalho usando o Azure Pipelines e ferramentas padrão. O formato de item e as APIs foram projetados para serem totalmente compatíveis com processos de CI/CD, garantindo uma experiência consistente e confiável em todos os ambientes. Para obter mais informações sobre como integrar 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. À medida que os itens são criados na plataforma diretamente por meio do UX, das APIs públicas ou do fluxo de trabalho de CI/CD, os proprietários das cargas de trabalho não têm controle sobre quando um novo item é criado por 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, há alguns casos em que as cargas de trabalho precisam participar do fluxo CRUD. Esse é 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 cada evento. Nesse cenário, o desenvolvedor de carga de trabalho precisa garantir que sua API seja acessível, caso contrário, as operações do Fabric falharão.

Agendador de rede

Fabric dá suporte ao agendamento de tarefas para cargas de trabalho. Esse recurso permite que os desenvolvedores criem cargas de trabalho que sejam notificadas mesmo que o usuário não esteja na frente da experiência de usuário e atuem com base no trabalho que deve ser executado (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 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 exijam 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 a 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 workloads estão bloqueadas para consumo e desenvolvimento se o Link Privado estiver habilitado no nível do locatário ou da área de trabalho.