Preguntas frecuentes (FAQ) de Fabric Apps

En este artículo se responden preguntas comunes sobre Microsoft Fabric Apps.

General

¿Qué es Fabric Apps?

Fabric Apps es una plataforma de back-end que ayuda a los desarrolladores de TypeScript a compilar e implementar aplicaciones controladas por datos más rápido. Defines modelos de datos mediante decoradores de TypeScript, y Fabric Apps genera automáticamente API de GraphQL, esquemas de base de datos y clientes con tipado seguro.

¿Quién debe usar Fabric Apps?

Fabric Apps es ideal para desarrolladores que crean:

  • Herramientas y paneles internos
  • Aplicaciones de exploración y visualización de datos
  • Prototipos rápidos
  • Aplicaciones de inteligencia artificial y agente que necesitan un estado persistente

¿Qué bases de datos se admiten?

Fabric Apps admite SQL Server: valor predeterminado para implementaciones de Fabric.

¿Puedo usar Fabric Apps con bases de datos existentes?

N.º Fabric Apps administra el esquema de la base de datos en función de los modelos de datos de TypeScript. No se puede dirigir a una base de datos existente con un esquema predefinido.

Desarrollo

¿Cómo se instala la CLI?

Puede instalar la CLI de Rayfin con npm. Puesto que es un paquete de npm, puede actualizar con npm update.

npm i @microsoft/rayfin-cli

¿Puedo usar Fabric Apps sin TypeScript?

N.º Los modelos de datos deben definirse mediante decoradores TypeScript. La aplicación de front-end puede usar JavaScript, pero el back-end requiere TypeScript para las definiciones de modelo.

¿Qué marcos de front-end se admiten?

Fabric Apps funciona con cualquier marco de front-end que pueda realizar solicitudes HTTP:

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

El SDK de cliente proporciona API seguras para tipos para todos los marcos.

Autenticación

¿Qué métodos de autenticación se admiten?

Medio ambiente Métodos soportados
Desarrollo local Microsoft Entra SSO y correo electrónico/contraseña
Implementado en Fabric solo SSO de Microsoft Entra

Note

La autenticación de correo electrónico y contraseña no funciona después de realizar la implementación en Fabric. No se puede implementar una aplicación en Fabric a menos que la autenticación esté habilitada.

¿Puedo usar proveedores de autenticación personalizados?

N.º Fabric Apps solo admite Microsoft Entra inicio de sesión único (SSO) y correo electrónico o contraseña. No se pueden integrar otros proveedores.

Deployment

¿Puedo implementar una aplicación sin autenticación habilitada?

N.º Fabric requiere que la autenticación de Fabric esté habilitada antes de desplegar una aplicación de Fabric.

¿Puedo implementar en varios entornos (desarrollo, ensayo, producción)?

Puede administrar manualmente áreas de trabajo de Fabric separadas e implementarlas en distintos elementos.

¿Cuánto tarda la implementación?

La implementación inicial suele tardar entre 2 y 5 minutos. Las implementaciones posteriores con npx rayfin up staticapp deploy (solo contenido estático) tardan entre 30 y 60 segundos.

¿Puedo revertir una implementación?

Vuelva a implementar la versión anterior comprobando la confirmación de Git anterior y ejecutando npx rayfin up.

¿Cómo se depuran los errores de implementación?

  • Errores de compilación : ejecute npm run build antes de la implementación. El fallo de despliegue más común es la falta de una build de producción. Después de que la compilación se realice correctamente, ejecute npx rayfin up.
  • Errores de capacidad o de permisos — Compruebe que el área de trabajo tiene asignada una capacidad de Fabric y que tiene permisos para crear o modificar elementos en el área de trabajo.
  • Errores de esquema de base de datos : si se produce el error al aplicar el esquema de la base de datos, revise los cambios de esquema realizados desde la última implementación correcta y resuelva los conflictos.

Modelos de datos

¿Puedo usar claves principales compuestas?

N.º Cada entidad debe usar un único campo UUID denominado id como clave principal.

¿Se admiten relaciones de muchos a muchos?

N.º Use una entidad de combinación explícita con dos @one() decoradores de navegación en su lugar.

¿Puedo escribir consultas SQL personalizadas?

No existe compatibilidad directa con consultas SQL. Todo el acceso a los datos pasa por las API de GraphQL generadas.

Rendimiento y escala

¿Cuáles son los límites de rendimiento?

El rendimiento depende de la capacidad de Fabric. Póngase en contacto con el administrador de Fabric para conocer los límites específicos de la capacidad.

¿Puedo almacenar en caché los resultados de la consulta?

Yes. Implemente el almacenamiento en caché del lado cliente en la aplicación front-end. El back-end no proporciona almacenamiento en caché integrado.

¿Cómo se optimiza el rendimiento de las consultas?

  • Seleccione solo los campos que necesita.
  • Uso de la paginación para conjuntos de resultados grandes
  • Incluir campos de entidad relacionados en una sola consulta en lugar de realizar varias solicitudes

Seguridad

¿Cómo se protegen los datos?

  • La autenticación es necesaria de forma predeterminada (configurable por entidad)
  • Las directivas de seguridad de nivel de fila filtran los datos en función de las notificaciones de JWT
  • Toda la comunicación usa HTTPS en implementaciones de Fabric

Limitaciones

¿Cuáles son las limitaciones actuales?

  • count() no está disponible en el cliente fluent GraphQL
  • No se admiten relaciones de muchos a muchos
  • No se admiten claves principales compuestas
  • No se admiten proveedores de autenticación personalizados
  • La administración de varios entornos no está disponible de forma predeterminada

Consulte Troubleshoot Fabric Apps para obtener soluciones alternativas.

¿Puedo exportar mis datos?

Yes. También puede conectarse directamente a la base de datos SQL si tiene la cadena de conexión.

Contenido relacionado

  • Last updated on