Microsoft Fabric Apps: o que são e como usá-los
By Mirko Peters ·
O Fabric Apps (prévia) permite que desenvolvedores criem aplicativos orientados a dados no Microsoft Fabric usando TypeScript. Este guia explica o que é o recurso, a chave de ativação para administradores, como criar e implantar um aplicativo, as permissões e os limites atuais.
Automatically translated with AI from the original post. Read the English original
O Fabric Apps é um recurso do Microsoft Fabric, atualmente em prévia, para criar aplicativos orientados a dados. Os desenvolvedores escrevem os modelos de dados em TypeScript, e o Fabric gera o esquema do banco de dados, as APIs GraphQL, a autenticação e a hospedagem. O recurso é voltado para desenvolvedores, não para criadores de relatórios, e é separado dos aplicativos do Power BI.
Pontos-chave
- O Fabric Apps é um recurso em prévia baseado no SDK Rayfin. Os desenvolvedores definem modelos de dados em TypeScript, e o Fabric gera o banco de dados, a API GraphQL, a autenticação e a hospedagem.
- Um administrador de locatário precisa primeiro habilitar o Fabric Apps (prévia) em Configurações do locatário, no portal de administração do Fabric, para toda a organização ou para grupos de segurança específicos.
- O workspace precisa ter capacidade do Fabric atribuída. Os serviços dos Fabric Apps consomem unidades de capacidade dela.
- Após a implantação, a entrada é feita exclusivamente pelo SSO do Fabric por meio do Microsoft Entra ID. E-mail e senha funcionam apenas para o desenvolvimento local.
- A Microsoft lista limites como ausência de relações muitos-para-muitos, ausência de chaves compostas, ausência de ALM e ausência de suporte a Private Link. Verifique-os antes de se comprometer com um design.
O que os Fabric Apps fazem
O Microsoft Learn descreve os Fabric Apps como baseados no SDK Rayfin. Você decora classes TypeScript, por exemplo com @entity(), @text() ou @uuid(). A partir desse modelo, o Fabric produz:
- tabelas de banco de dados, com um banco de dados SQL do Fabric como armazenamento gerenciado
- um endpoint GraphQL em
/api/graphqlna URL do backend do aplicativo - regras de autorização em nível de linha por meio dos decoradores
@role - métodos de cliente com tipagem forte
- hospedagem estática para o frontend
Ao implantar com rayfin up, o Fabric cria itens filhos sob o aplicativo: um banco de dados SQL do Fabric, Autenticação e Conteúdo estático. Cada aplicativo tem um endpoint de backend no formato https://<seu-app>-app.rayfin.windows.net/, com os caminhos /api/graphql para dados e /auth para autenticação.
Outros recursos documentados incluem conectores tipados para um lakehouse, um warehouse, um banco de dados SQL do Fabric ou um modelo semântico, além de armazenamento de arquivos tipado com políticas de acesso.
Onde se encaixa
A Microsoft indica estes como bons casos de uso: prototipagem rápida, ferramentas internas e painéis, exploração de dados com conectores do Fabric, e aplicativos de IA ou de agentes que precisam de estado persistente. Ela indica como possíveis casos ruins: aplicativos que exigem transações complexas em várias etapas ou procedimentos armazenados, e aplicativos que precisam de provedores de autenticação personalizados.
Etapa 1: habilitar a configuração de locatário
Esta é uma tarefa do administrador e precisa acontecer antes que os usuários possam criar o item.
- Entre no portal de administração do Fabric.
- Abra Configurações do locatário.
- Em Fabric Apps (prévia), defina a chave como Habilitado.
- Escolha toda a organização ou grupos de segurança específicos.
- Selecione Aplicar.
As alterações podem levar alguns minutos para serem propagadas.
Etapa 2: preparar o workspace
O workspace precisa ter capacidade do Fabric atribuída. Escolha uma capacidade ao criar o workspace. Para criar um app, você precisa de permissões de Colaborador ou Administrador nele. Para trabalho local, instale o Node.js 20 ou posterior.
Etapa 3: criar o item de app
- No menu de navegação à esquerda, selecione Workspaces e abra o seu workspace.
- Selecione Novo item, pesquise por App e selecione-o.
- Digite um nome e selecione Criar.
O portal então mostra um comando para baixar um projeto localmente. Ele tem este formato:
npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
Etapa 4: desenvolver e implantar
Edite o projeto ou trabalhe com o GitHub Copilot e, em seguida, teste com o backend do Fabric usando npm run dev. Implante com npx rayfin up. Para implantar em outro workspace, adicione --workspace <workspacename>. Confirme o backend com npx rayfin up status.
O comentário de exemplo nas Perguntas frequentes diz que uma implantação somente de conteúdo estático com npx rayfin up staticapp deploy leva de 30 a 60 segundos após a implantação inicial. As páginas consultadas não informam o tempo da primeira implantação. Uma implantação somente estática não consegue criar o app remoto inicial, então execute npx rayfin up uma vez antes. Para reverter, faça checkout do commit anterior do git e execute npx rayfin up novamente.
O que você vê no portal do Fabric
Depois do rayfin up, o item de app mostra itens filhos que o Fabric criou a partir da sua configuração rayfin.yml:
- Banco de dados SQL no Fabric: o banco de dados gerenciado com o esquema definido pelos seus decoradores. Ele é somente leitura no portal, então altere o esquema pelo código.
- Autenticação: login intermediado pelo Fabric por meio do Microsoft Entra ID. Você pode ver os usuários autenticados no banco de dados SQL.
- Conteúdo estático: os recursos de frontend compilados, servidos a partir de uma URL de hospedagem e atualizados a cada implantação. A visão geral informa que a hospedagem estática pode exigir acesso ao item do Fabric ou permitir acesso anônimo.
Autenticação e permissões
O Microsoft Learn lista o SSO do Fabric para apps implantados e e-mail e senha para desenvolvimento local. O login com e-mail e senha não funciona após a implantação, e para implantar é necessário habilitar a autenticação do Fabric.
As permissões de item são separadas das funções do workspace:
| Permissão | Permite | |---|---| | Executar e interagir | Abrir e usar o app e chamar suas APIs de backend. Todos os membros do workspace recebem por padrão. | | Editar (Write) | Implantar, alterar o esquema, atualizar configurações, gerenciar serviços filhos | | Recompartilhar | Conceder acesso a outras pessoas. Requer a função de administrador no workspace. |
Um administrador do Fabric pode bloquear temporariamente o carregamento de um app por outros usuários, enquanto o proprietário ainda pode abri-lo.
A segurança fica parcialmente sob sua responsabilidade. A Microsoft recomenda manter segredos fora do código e dos recursos de frontend, e que o seu código decida o que os usuários conectados veem e podem fazer.
Limitações a verificar primeiro
As Perguntas frequentes listam estas limitações atuais:
- sem relacionamentos muitos-para-muitos e sem chaves primárias compostas (cada entidade precisa de um único campo UUID chamado
id) - sem provedores de autenticação personalizados
- sem gerenciamento de múltiplos ambientes por padrão
- sem proteção de acesso de saída no workspace
- sem links privados no nível do locatário ou do workspace
- sem gerenciamento do ciclo de vida da aplicação (ALM)
count()não está disponível no cliente GraphQL fluent
Os modelos de dados são escritos em TypeScript com decoradores.
Problemas comuns
A Microsoft aponta a falta de um build de produção como a causa mais comum de erros de build, então execute npm run build primeiro. Para erros de capacidade ou permissão, confirme que o workspace tem capacidade e que você pode criar ou alterar itens nele. Para erros de esquema, revise as alterações desde a última implantação bem-sucedida. A página de solução de problemas diz que o código do app é a fonte de verdade. Não altere o esquema remoto pelo portal do Fabric nem por ferramentas SQL, pois remover ou alterar uma coluna existente pode quebrar o app e a sua implantação. Faça as alterações de esquema no código e aplique-as com npx rayfin up db apply.
Relacionados
Fontes
- Visão geral do Fabric Apps (prévia)
- Crie seu primeiro projeto do Fabric Apps
- Perguntas frequentes sobre o Fabric Apps
- Solucionar problemas do Fabric Apps
Perguntas frequentes
Os Fabric Apps já estão disponíveis para uso geral?
Não. O Microsoft Learn classifica os Fabric Apps como um recurso em prévia e informa que ainda não estão disponíveis em todas as regiões. As páginas consultadas para este artigo não mencionam uma data de disponibilidade geral.
Quem pode criar um aplicativo do Fabric?
De acordo com o Microsoft Learn, você precisa das permissões de Colaborador ou Administrador em um workspace do Fabric que tenha capacidade do Fabric atribuída, e um administrador de locatário precisa ter habilitado a configuração de locatário Fabric Apps (prévia). Para o desenvolvimento local, é necessário o Node.js 20 ou uma versão posterior.
Quais métodos de entrada são compatíveis com os Fabric Apps implantados?
O Microsoft Learn informa que os aplicativos implantados usam exclusivamente o SSO do Fabric, que é o logon único do Microsoft Entra. A entrada com e-mail e senha está disponível apenas para o desenvolvimento local, e não é possível implantar sem a autenticação habilitada.
Um aplicativo do Fabric pode usar um banco de dados existente?
Não. As perguntas frequentes do Microsoft Learn informam que os Fabric Apps gerenciam o esquema a partir dos seus modelos em TypeScript e não podem apontar para um banco de dados com esquema predefinido. Para acessar um lakehouse, um warehouse ou um banco de dados SQL existente no Fabric, você adiciona um conector.
As páginas da Microsoft explicam o preço dos Fabric Apps?
Não. As páginas consultadas não trazem informações de preço. A visão geral apenas informa que o workspace precisa de capacidade do Fabric e que os serviços dos Fabric Apps consomem unidades de capacidade dela. As perguntas frequentes indicam que o desempenho depende da sua capacidade do Fabric.