perguntas frequentes sobre aplicativos Fabric

Este artigo responde a perguntas comuns sobre Fabric Apps.

General

O que é Fabric Apps?

Fabric Apps é uma plataforma de back-end que ajuda os desenvolvedores do TypeScript a criar e implantar aplicativos controlados por dados mais rapidamente. Você define modelos de dados usando decoradores TypeScript, e o Fabric Apps gera APIs GraphQL, esquemas de banco de dados e clientes com segurança de tipos automaticamente.

Quem deve usar Fabric Apps?

Fabric Apps é ideal para desenvolvedores que estão criando:

  • Ferramentas internas e painéis
  • Aplicativos de exploração e visualização de dados
  • Protótipos rápidos
  • Aplicativos de IA e agente que precisam de estado persistente

Quais bancos de dados têm suporte?

Fabric Apps dá suporte a SQL Server – padrão para implantações de Fabric.

Posso usar Fabric Aplicativos com bancos de dados existentes?

Não. Fabric Apps gerencia o esquema de banco de dados com base em seus modelos de dados TypeScript. Você não pode apontá-lo para um banco de dados existente com um esquema predefinido.

Desenvolvimento

Como instalar a CLI?

Você pode instalar a CLI do Rayfin com npm. Como é um pacote npm, você pode atualizar com npm update.

npm i @microsoft/rayfin-cli

Posso usar Fabric Aplicativos sem TypeScript?

Não. Os modelos de dados devem ser definidos usando decoradores TypeScript. O aplicativo front-end pode usar JavaScript, mas o back-end requer TypeScript para definições de modelo.

Quais estruturas de front-end têm suporte?

Fabric Apps funciona com qualquer estrutura de front-end que possa fazer solicitações HTTP:

  • React
  • Vue
  • Angular
  • Svelte
  • JavaScript/TypeScript puro

O SDK do cliente fornece APIs com segurança de tipos para todos os frameworks.

Authentication

Quais métodos de autenticação têm suporte?

Ambiente Métodos com suporte
Desenvolvimento local Microsoft Entra SSO e email/senha
Implantado no Fabric Microsoft Entra somente SSO

Note

A autenticação de email e senha não funciona após a implantação no Fabric. Você não pode implantar um aplicativo para Fabric a menos que a autenticação esteja habilitada.

Posso usar provedores de autenticação personalizados?

Não. Fabric Apps dá suporte apenas a Microsoft Entra SSO (logon único) e email/senha. Você não pode integrar outros provedores.

Deployment

Posso implantar um aplicativo sem autenticação habilitada?

Não. O Fabric requer que a autenticação do Fabric esteja habilitada antes de implantar um aplicativo do Fabric.

Posso implantar em vários ambientes (desenvolvimento, preparo, produção)?

Você pode gerenciar manualmente espaços de trabalho Fabric separados e implantar em itens diferentes.

Quanto tempo leva a implantação?

A implantação inicial normalmente leva de 2 a 5 minutos. As implantações subsequentes com npx rayfin up staticapp deploy (somente conteúdo estático) levam de 30 a 60 segundos.

Posso reverter uma implantação?

Reimplante a versão anterior fazendo checkout do commit anterior do Git e executando npx rayfin up.

Como depurar falhas de implantação?

  • Erros de build – executar npm run build antes da implantação. A falha de implantação mais comum é um build de produção ausente. Depois que o build for bem-sucedido, execute npx rayfin up.
  • Erros de capacidade ou de permissão — Verifique se o seu workspace tem capacidade do Fabric atribuída e se você tem permissão para criar ou modificar itens nesse workspace.
  • Erros de esquema de banco de dados – se o erro ocorrer durante a aplicação do esquema de banco de dados, examine as alterações de esquema feitas desde a última implantação bem-sucedida e resolva quaisquer conflitos.

Modelos de dados

Posso usar chaves primárias compostas?

Não. Cada entidade deve usar um único campo UUID nomeado id como a chave primária.

Há suporte para os relacionamentos muitos-para-muitos?

Não. Em vez disso, use uma entidade de junção explícita com dois @one() decoradores de navegação.

Posso escrever consultas SQL personalizadas?

Não existe suporte direto à consulta SQL. Todo o acesso a dados passa pelas APIs do GraphQL geradas.

Desempenho e escala

Quais são os limites de desempenho?

O desempenho depende da capacidade do Fabric. Entre em contato com o administrador do Fabric para obter limites específicos de capacidade.

Posso armazenar em cache os resultados da consulta?

Sim. Implemente o cache do lado do cliente em seu aplicativo de front-end. O back-end não fornece cache interno.

Como otimizar o desempenho da consulta?

  • Selecione apenas os campos de que você precisa
  • Usar paginação para conjuntos de resultados grandes
  • Incluir campos de entidade relacionados em uma única consulta em vez de fazer várias solicitações

Segurança

Como os dados são protegidos?

  • A autenticação é exigida por padrão (configurável por entidade)
  • Políticas de segurança em nível de linha filtram dados com base em declarações JWT
  • Toda a comunicação usa HTTPS em implantações de Fabric

Limitações

Quais são as limitações atuais?

  • count() não está disponível no cliente GraphQL Fluent
  • Não há suporte a relacionamentos muitos-para-muitos
  • Não há suporte para chaves primárias compostas
  • Não há suporte para provedores de autenticação personalizados
  • O gerenciamento de vários ambientes não está disponível nativamente

Consulte Troubleshoot Fabric Apps para obter soluções alternativas.

Posso exportar meus dados?

Sim. Você também pode se conectar diretamente ao banco de dados SQL se tiver o cadeia de conexão.

Conteúdo relacionado

  • Last updated on