O que é Fabric Apps (versão prévia)?

Fabric Apps (versão prévia) ajuda você a criar aplicativos controlados por dados em Microsoft Fabric combinando modelos de dados, APIs geradas, autenticação e hospedagem em um fluxo de trabalho de desenvolvimento. Você define seus modelos de dados no TypeScript e Fabric Apps os usa para gerar as partes de back-end de que seu aplicativo precisa. Fabric Apps dá suporte a TypeScript como o idioma para modelos de dados, código do cliente e lógica do aplicativo.

Importante

Esse recurso está na versão prévia.

Características principais

Fabric Apps fornece estes recursos:

Modelos de dados para APIs – Decorar classes TypeScript com @entity(), @text()@uuid()e outros decoradores. Fabric Apps gera esquemas de banco de dados e endpoints do GraphQL automaticamente.
Clientes com tipagem segura – o SDK do cliente valida consultas e mutações antes de chegarem ao backend, detectando erros durante o desenvolvimento.
Autenticação integrada – Gerenciamento de sessão, gerenciamento de tokens e fluxos de autenticação estão incluídos. Configure Fabric SSO para aplicativos implantados ou use email e senha durante o desenvolvimento local.
Hospedagem estática – crie e sirva seu aplicativo de front-end junto com suas APIs de back-end com um único comando de implantação.
Desenvolvimento local – execute toda a pilha localmente com o Docker para iteração rápida e faça a implantação no Microsoft Fabric quando estiver pronto para produção. Estruturar projetos, desenvolver com GitHub Copilot e implantar em Fabric usando a CLI do Rayfin.

Pré-requisitos

Capacidade do Fabric

O workspace deve ter capacidade do Fabric atribuída. Ao criar um novo espaço de trabalho, selecione uma capacidade do Fabric para associá-la a ele. Os Serviços de Aplicativos do Fabric consomem unidades de capacidade da capacidade atribuída.

Configurações de administrador de locatário

Um administrador de locatário do Fabric deve habilitar a carga de trabalho Aplicativos do Fabric antes que os usuários possam criar itens.

Entre no portal de administração do Fabric.
Navegue até Configurações do locatário.
Em Fabric Apps (versão prévia), alterne a configuração para Enabled.
Escolha se deseja habilitar para toda a organização ou grupos de segurança específicos.
Selecione Aplicar.

As alterações podem levar alguns minutos para serem propagadas.

Como funciona

Um aplicativo Fabric é executado como um serviço gerenciado em Microsoft Fabric com conjunto de serviços que definem o back-end, como hospedagem de aplicativo, banco de dados, APIs do GraphQL e autenticação. Fabric gerencia a hospedagem, a rede e o dimensionamento. A autenticação usa Fabric SSO (Microsoft Entra ID logon único) exclusivamente — nenhum outro provedor de autenticação está disponível após a implantação.

Quando você implanta seu aplicativo com rayfin up, o Fabric cria serviços derivados com base na sua configuração rayfin.yml. Esses serviços secundários aparecem como itens secundários no aplicativo Fabric, no portal do Fabric.

Serviço secundário	O que ele fornece	Funcionalidades do portal
Banco de dados SQL no Fabric	Um banco de dados SQL gerenciado com seu esquema aplicado a partir dos decoradores do modelo de dados em TypeScript.	Ver o banco de dados, executar consultas com o editor de consultas, copiar string de conexão. O banco de dados é somente para leitura no portal — as alterações de esquema devem vir do seu código por meio de `rayfin up`.
Autenticação	Autenticação intermediada do Fabric usando o Microsoft Entra ID (SSO). Os usuários fazem login usando sua identidade existente do Fabric.	Exibir usuários autenticados no banco de dados SQL.
Conteúdo estático	Seus ativos de front-end internos (HTML, CSS, JS) servidos em uma URL pública usando o armazenamento do OneLake.	Exibir a URL de hospedagem. Os ativos são atualizados em cada implantação.

URL de back-end do aplicativo

Cada aplicativo Fabric tem um único ponto de extremidade que fornece acesso a todos os serviços:

https://<your-app>-app.rayfin.windows.net/

O ponto de extremidade expõe um caminho para cada serviço:

Caminho	Serviço
`/api/graphql`	API de dados (GraphQL) — usada por `RayfinClient` para operações de leitura e gravação
`/auth`	Serviço de autenticação
`/storage`	Armazenamento de arquivos

Gerenciamento no portal Fabric

Após a implantação, você pode gerenciar seu aplicativo Fabric diretamente no portal Fabric.

Exibir propriedades do item

Abra o aplicativo Fabric no portal para ver:

URL de back-end do aplicativo — este endpoint é usado por todos os serviços de back-end usados pelo aplicativo.
URL do aplicativo — A URL pública em que seu conteúdo estático está hospedado. Fabric SSO é necessário para acessar o aplicativo.

Gerenciar itens filho

Selecione o aplicativo Fabric para ver seus serviços filho:

SQL database in Fabric — Abre o item Fabric banco de dados SQL para exibir o pesquisador de objetos. Você pode executar consultas de leitura em seus dados. As alterações de esquema sempre devem ser feitas no código na rayfin/data pasta. Conflitos de esquema podem ocorrer se o esquema for alterado diretamente no banco de dados SQL e podem comprometer o aplicativo.

Permissões de item

As funções do espaço de trabalho não substituem permissões em nível de item. Para compartilhar um aplicativo com alguém em sua organização, ele precisa de permissão Executar e interagir (ler e executar) para executar o aplicativo e invocar as APIs de back-end.

Permissão	O que ele permite
Executar e interagir (padrão)	Abra e use o aplicativo implantado. Todos os membros do workspace recebem esse nível por padrão.
Editar (Escrita)	Modifique a aplicação do Fabric—implante código com `rayfin up`, aplique alterações no esquema, atualize as configurações e gerencie serviços filho.
Compartilhar novamente	Conceda a outros usuários acesso ao aplicativo Fabric. Requer a função de administrador no workspace.

Saiba mais sobre as funções do Workspace.

Desenvolvimento com a CLI do Rayfin

A CLI estrutura novos projetos, inicia a infraestrutura local, sincroniza as alterações de esquema e implanta em Fabric. Instale-o com npm create @microsoft/rayfin@latest.

Comandos de chave:

Comando	Purpose
`npm create @microsoft/rayfin@latest`	Crie um novo projeto a partir de um modelo.
`npx rayfin up`	Implante seu projeto para Fabric.
`npx rayfin up db apply`	Aplicar alterações de esquema de banco de dados.

Para obter uma referência de comando completa, consulte a referência da CLI.

Decoradores de modelo de dados

Definir modelos de dados usando decoradores TypeScript:

import {
  entity,
  role,
  text,
  boolean,
  date,
  uuid,
} from '@microsoft/rayfin-core';

@entity()
@role('authenticated', '*', {
  policy: (claims, item) => claims.sub.eq(item.user_id),
})
export class Todo {
  @uuid() id!: string;
  @text({ min: 1, max: 100 }) title!: string;
  @boolean() isCompleted!: boolean;
  @date() createdAt!: Date;
  @date({ optional: true }) dueDate?: Date;
  @text() user_id!: string;
}

Fabric Apps analisa esses decoradores e gera:

Definições de tabela de banco de dados
Pontos de extremidade da API do GraphQL
Regras de autorização em nível de linha
Métodos de cliente seguros em termos de tipo

Quando usar aplicativos Fabric

Fabric Apps é ideal para:

Prototipagem rápida – vá da ideia para a URL dinâmica em minutos com a infraestrutura pré-configurada.
Ferramentas internas e painéis – Crie interfaces administrativas autenticadas sem escrever código boilerplate de back-end.
Exploração e visualização de dados – Consultar dados do Fabric com GraphQL e exibi-los em front-ends personalizados.
Aplicativos de IA e agente – forneça serviços de back-end estruturados para agentes de IA que precisam de estado persistente.

Fabric Aplicativos podem não ser adequados para:

Aplicativos que exigem transações complexas de várias etapas ou procedimentos armazenados.
Aplicativos que exigem provedores de autenticação personalizados além Fabric SSO e email/senha.

Responsabilidades de segurança

Fabric fornece: logon único do Fabric (Microsoft Entra ID), segurança em nível de linha por meio de decoradores @role, HTTPS, PKCE e permissões no nível do workspace e do item.

Você é responsável por:

Manter segredos, chaves de API e dados confidenciais fora do código, ativos de front-end e repositório. O conteúdo estático é fornecido de uma URL pública.
O que seu aplicativo expõe por meio dos controles de SSO do Fabric controla o login, pois seu código controla o que os usuários autenticados veem e fazem.
Concedendo apenas as permissões que os colaboradores precisam para implantar ou gerenciar o aplicativo.
Responsabilidade legal e de conformidade para os dados que seu aplicativo coleta, processa e armazena.

Próximas Etapas

Comentários

Esta página foi útil?

Last updated on 2026-06-02