Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo responde a perguntas comuns sobre as Microsoft Fabric Apps.
General
O que é o Fabric Apps?
A Fabric Apps é uma plataforma de backend que ajuda os programadores TypeScript a construir e implementar aplicações orientadas a dados de forma mais rápida. Define modelos de dados com decoradores de TypeScript, e o Fabric Apps gera automaticamente APIs GraphQL, esquemas de base de dados e clientes com segurança de tipos.
Quem deve usar o Fabric Apps?
O Fabric Apps é ideal para desenvolvedores que estão a construir:
- Ferramentas internas e painéis
- Aplicações de exploração e visualização de dados
- Protótipos rápidos
- IA e aplicações de agentes que necessitam de estado persistente
Que bases de dados são suportadas?
Fabric Apps suporta SQL Server – Padrão para implementações Fabric.
Posso usar aplicações Fabric com bases de dados existentes?
No. O Fabric Apps gere o esquema da base de dados com base nos seus modelos de dados TypeScript. Não podes apontar para uma base de dados existente com um esquema pré-definido.
Desenvolvimento
Como instalo a interface de linha de comandos?
Pode instalar o CLI do Rayfin com npm. Como é um pacote npm, podes atualizar com npm update.
npm i @microsoft/rayfin-cli
Posso usar o Fabric Apps sem o TypeScript?
No. Os modelos de dados devem ser definidos usando decoradores TypeScript. A aplicação frontend pode usar JavaScript, mas o backend requer TypeScript para definições de modelos.
Que frameworks frontend são suportados?
O Fabric Apps funciona com qualquer framework frontend que possa fazer pedidos HTTP:
- React
- Vue
- Angular
- Svelte
- Vanilla JavaScript/TypeScript
O SDK do cliente fornece APIs com segurança de tipos para todos os frameworks.
Authentication
Que métodos de autenticação são suportados?
| Ambiente | Métodos suportados |
|---|---|
| Desenvolvimento local | Microsoft Entra SSO e Email/palavra-passe |
| Implementado no Fabric | Microsoft Entra SSO apenas |
Observação
A autenticação por email e palavra-passe não funciona depois de serem implementados no Fabric. Não podes implementar uma aplicação no Fabric a menos que a autenticação esteja ativada.
Posso usar fornecedores de autenticação personalizados?
No. O Fabric Apps suporta login único (SSO) do Microsoft Entra e apenas email/palavra-passe. Não podes integrar outros prestadores.
Deployment
Posso implementar uma aplicação sem autenticação ativada?
No. O Fabric requer que a autenticação do Fabric esteja ativada antes de implementar uma aplicação do Fabric.
Posso fazer deploy em múltiplos ambientes (desenvolvimento, teste, produção)?
Pode gerir manualmente áreas de trabalho do Fabric separadas e implementar em diferentes itens.
Quanto tempo demora a implantação?
O desdobramento inicial normalmente demora entre 2 a 5 minutos. Implementações subsequentes com npx rayfin up staticapp deploy (apenas conteúdo estático) demoram entre 30 a 60 segundos.
Posso reverter uma implantação?
Redistribua a versão anterior verificando o commit git anterior e executando npx rayfin up.
Como faço para depurar falhas de implementação?
-
Erros de compilação — Executar
npm run buildantes de implementar. A falha de implementação mais comum é a ausência de uma versão em produção. Depois de a build ser bem-sucedida, executanpx rayfin up. - Erros de capacidade ou de permissões — Verifique se o seu espaço de trabalho tem capacidade do Fabric atribuída e se tem permissão para criar ou modificar itens no espaço de trabalho.
- Erros no esquema da base de dados — Se o erro ocorrer durante a aplicação do esquema da base de dados, reveja as alterações no esquema feitas desde a última implementação bem-sucedida e resolva quaisquer conflitos.
Modelos de dados
Posso usar chaves primárias compostas?
No. Cada entidade deve usar um único campo UUID nomeado id como chave primária.
As relações muitas-para-muitas são apoiadas?
No. Utilize, em vez disso, uma entidade de associação explícita com dois decoradores de navegação @one().
Posso escrever consultas SQL personalizadas?
Não existe suporte direto para consultas SQL. Todo o acesso aos dados passa pelas APIs GraphQL geradas.
Desempenho e dimensionamento
Quais são os limites de desempenho?
O desempenho depende da capacidade do Fabric. Contacte o seu administrador Fabric para os limites específicos de capacidade.
Posso guardar em cache os resultados da consulta?
Yes. Implemente cache do lado do cliente na sua aplicação frontend. O backend não fornece cache incorporado.
Como posso otimizar o desempenho das consultas?
- Selecione apenas os campos de que precisa
- Usar paginação para conjuntos de resultados grandes
- Incluir campos de entidades relacionadas numa única consulta em vez de fazer múltiplos pedidos
Segurança
Como é que os dados são protegidos?
- A autenticação é necessária por defeito (configurável por entidade)
- As políticas de segurança ao nível da linha filtram dados com base nas reivindicações do JWT
- Toda a comunicação utiliza HTTPS nas implementações de Fabric
Limitations
Quais são as limitações atuais?
-
count()não está disponível no cliente Fluent para GraphQL - Relações muitos-para-muitos não são apoiadas
- As chaves primárias compostas não são suportadas
- Os fornecedores de autenticação personalizada não são suportados
- A gestão de múltiplos ambientes não está disponível logo de início
Veja Troubleshoot Fabric Apps para soluções alternativas.
Posso exportar os meus dados?
Yes. Também podes ligar-te diretamente à base de dados SQL se tiveres a cadeia de ligação.