M365Con 2027 – conferencia online gratuita · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Microsoft Fabric Apps: qué son y cómo usarlas

Por ·

Fabric Apps (versión preliminar) permite a los desarrolladores crear aplicaciones basadas en datos sobre Microsoft Fabric con TypeScript. En esta guía explicamos qué es la función, el interruptor de administración, cómo crear e implementar una aplicación, los permisos y los límites actuales.

Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés

Fabric Apps es una función de Microsoft Fabric, actualmente en versión preliminar, para crear aplicaciones basadas en datos. Los desarrolladores escriben los modelos de datos en TypeScript, y Fabric genera el esquema de la base de datos, las API de GraphQL, el inicio de sesión y el hospedaje. Está dirigida a desarrolladores, no a autores de informes, y es independiente de las aplicaciones de Power BI.

Puntos clave

  • Fabric Apps es una función en versión preliminar basada en el SDK de Rayfin. Los desarrolladores definen modelos de datos en TypeScript, y Fabric genera la base de datos, la API de GraphQL, la autenticación y el hospedaje.
  • Primero, un administrador del inquilino debe habilitar Fabric Apps (versión preliminar) en Configuración del inquilino, en el portal de administración de Fabric, para toda la organización o para grupos de seguridad específicos.
  • El área de trabajo necesita tener asignada capacidad de Fabric. Los servicios de Fabric Apps consumen unidades de capacidad de ella.
  • Después de la implementación, el inicio de sesión se realiza únicamente mediante el inicio de sesión único de Fabric a través de Microsoft Entra ID. El correo electrónico y la contraseña solo funcionan para el desarrollo local.
  • Microsoft enumera límites como la ausencia de relaciones muchos a muchos, de claves compuestas, de ALM y de compatibilidad con Private Link, así que revísalos antes de comprometerte con un diseño.

Qué hace Fabric Apps

Microsoft Learn describe Fabric Apps como una función basada en el SDK de Rayfin. Decoras clases de TypeScript, por ejemplo con @entity(), @text() o @uuid(). A partir de ese modelo, Fabric genera:

  • tablas de base de datos, con una base de datos SQL en Fabric como almacén administrado
  • un punto de conexión de GraphQL en /api/graphql bajo la URL del backend de la aplicación
  • reglas de autorización a nivel de fila mediante decoradores @role
  • métodos de cliente con tipos seguros
  • hospedaje estático para el frontend

Al implementar con rayfin up, Fabric crea elementos secundarios bajo la aplicación: una base de datos SQL en Fabric, Authentication y Static Content. Cada aplicación tiene un punto de conexión de backend con el formato https://<your-app>-app.rayfin.windows.net/, con las rutas /api/graphql para los datos y /auth para la autenticación.

Otras capacidades documentadas incluyen conectores tipados a un lakehouse, un almacén de datos, una base de datos SQL en Fabric o un modelo semántico, y almacenamiento de archivos tipado con directivas de acceso.

Cuándo encaja

Microsoft indica que son buenas opciones: el prototipado rápido, las herramientas internas y los paneles, la exploración de datos con conectores de Fabric, y las aplicaciones de IA o de agentes que necesitan estado persistente. También indica que podrían no ser una buena opción: las aplicaciones que requieren transacciones complejas de varios pasos o procedimientos almacenados, y las que necesitan proveedores de autenticación personalizados.

Paso 1: habilitar la configuración del inquilino

Es una tarea de administración y debe realizarse antes de que los usuarios puedan crear el elemento.

  1. Inicia sesión en el portal de administración de Fabric.
  2. Abre Configuración del inquilino.
  3. En Fabric Apps (versión preliminar), cambia el conmutador a Habilitado.
  4. Elige toda la organización o grupos de seguridad específicos.
  5. Selecciona Aplicar.

Los cambios pueden tardar unos minutos en aplicarse.

Paso 2: preparar el área de trabajo

El espacio de trabajo debe tener una capacidad de Fabric asignada. Elige una capacidad al crear el espacio de trabajo. Para crear una aplicación necesitas permisos de Colaborador o Administrador en él. Para el trabajo en local, instala Node.js 20 o posterior.

Paso 3: Crear el elemento de aplicación

  1. En el panel de navegación de la izquierda, selecciona Espacios de trabajo y abre tu espacio de trabajo.
  2. Selecciona Nuevo elemento, busca App y selecciónala.
  3. Escribe un nombre y selecciona Crear.

El portal muestra entonces un comando para descargar un proyecto en local. Tiene esta forma:

npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>

Paso 4: Desarrollar e implementar

Edita el proyecto o trabaja con GitHub Copilot, y después prueba contra el backend de Fabric con npm run dev. Implementa con npx rayfin up. Para implementar en otro espacio de trabajo, añade --workspace <workspacename>. Confirma el backend con npx rayfin up status.

El comentario del ejemplo de las preguntas frecuentes indica que una implementación solo de contenido estático con npx rayfin up staticapp deploy tarda de 30 a 60 segundos tras la implementación inicial. Las páginas que he revisado no indican ningún tiempo para la primera implementación. Una implementación solo estática no puede crear la aplicación remota inicial, así que ejecuta primero npx rayfin up una vez. Para revertir, cambia al commit anterior de git y vuelve a ejecutar npx rayfin up.

Lo que ves en el portal de Fabric

Después de rayfin up, el elemento de aplicación muestra los elementos secundarios que Fabric creó a partir de la configuración de tu rayfin.yml:

  • Base de datos SQL en Fabric: la base de datos administrada con el esquema de tus decoradores. Es de solo lectura en el portal, así que cambia el esquema mediante código.
  • Autenticación: inicio de sesión gestionado por Fabric a través de Microsoft Entra ID. Puedes ver los usuarios autenticados en la base de datos SQL.
  • Static Content: los recursos compilados del frontend, servidos desde una URL de hospedaje y actualizados en cada implementación. La descripción general indica que el hospedaje estático puede requerir acceso al elemento de Fabric o permitir el acceso anónimo.

Autenticación y permisos

Learn enumera el SSO de Fabric para las aplicaciones implementadas y el correo electrónico con contraseña para el desarrollo local. El inicio de sesión con correo electrónico y contraseña no funciona después de la implementación, y para implementar se requiere tener habilitada la autenticación de Fabric.

Los permisos de elemento son independientes de los roles del espacio de trabajo:

| Permiso | Permite | |---|---| | Ejecutar e interactuar | Abrir y usar la aplicación y llamar a sus API de backend. Todos los miembros del espacio de trabajo lo tienen de forma predeterminada. | | Editar (Write) | Implementar, cambiar el esquema, actualizar la configuración, administrar los servicios secundarios | | Volver a compartir | Conceder acceso a otros. Requiere el rol de administrador en el espacio de trabajo. |

Un administrador de Fabric puede bloquear temporalmente a otros usuarios la carga de una aplicación, mientras que el propietario sigue pudiendo abrirla.

La seguridad sigue siendo en parte responsabilidad tuya. Microsoft recomienda mantener los secretos fuera del código y de los recursos del frontend, y que tu código decida qué ven y qué hacen los usuarios que han iniciado sesión.

Límites que conviene revisar primero

Las preguntas frecuentes enumeran estas limitaciones actuales:

  • no hay relaciones de muchos a muchos ni claves primarias compuestas (cada entidad necesita un único campo UUID llamado id)
  • no hay proveedores de autenticación personalizados
  • no hay gestión de varios entornos de serie
  • no hay protección de acceso saliente en el espacio de trabajo
  • no hay vínculos privados a nivel de inquilino ni de espacio de trabajo
  • no hay gestión del ciclo de vida de las aplicaciones (ALM)
  • count() no está disponible en el cliente GraphQL fluido

Los modelos de datos se escriben en TypeScript con decoradores.

Problemas habituales

Microsoft señala la falta de una compilación de producción como la causa más común de los errores de compilación, así que ejecuta primero npm run build. Para errores de capacidad o de permisos, confirma que el espacio de trabajo tiene capacidad y que puedes crear o modificar elementos en él. Para errores de esquema, revisa los cambios desde la última implementación correcta. La página de solución de problemas indica que el código de la aplicación es la fuente de verdad. No cambies el esquema remoto desde el portal de Fabric ni desde herramientas de SQL, porque eliminar o alterar una columna existente puede romper la aplicación y su implementación. Realiza los cambios de esquema en el código y aplícalos con npx rayfin up db apply.

Relacionado

Fuentes

Preguntas frecuentes

¿Fabric Apps está disponible con carácter general?

No. Microsoft Learn indica que Fabric Apps es una función en versión preliminar y que todavía no está disponible en todas las regiones. Las páginas consultadas para este artículo no describen una fecha de disponibilidad general.

¿Quién puede crear una aplicación de Fabric?

Según Microsoft Learn, necesitas permisos de Colaborador o de Administrador en un área de trabajo de Fabric que tenga capacidad de Fabric asignada, y un administrador del inquilino debe haber habilitado la configuración del inquilino Fabric Apps (versión preliminar). Para el desarrollo local se requiere Node.js 20 o posterior.

¿Qué métodos de inicio de sesión admiten las aplicaciones de Fabric implementadas?

Microsoft Learn indica que las aplicaciones implementadas usan exclusivamente el inicio de sesión único de Fabric, es decir, el inicio de sesión único de Microsoft Entra. El inicio de sesión con correo electrónico y contraseña solo está disponible para el desarrollo local, y no puedes implementar una aplicación sin la autenticación habilitada.

¿Puede una aplicación de Fabric usar una base de datos existente?

No. Las preguntas frecuentes de Microsoft Learn indican que Fabric Apps administra el esquema a partir de tus modelos de TypeScript y no puede apuntar a una base de datos con un esquema predefinido. Para acceder a un almacén de lakehouse, a un almacén de datos o a una base de datos SQL existente en Fabric, debes agregar un conector.

¿Las páginas de Microsoft explican los precios de Fabric Apps?

No. Las páginas consultadas no incluyen precios. La información general solo indica que el área de trabajo necesita capacidad de Fabric y que los servicios de Fabric Apps consumen unidades de capacidad de ella, y las preguntas frecuentes señalan que el rendimiento depende de tu capacidad de Fabric.

Entidades en este artículo

Temas de este artículo:

Microsoft Fabric Apps – Herramienta de análisis y BI de Microsoft Microsoft Fabric – Herramienta de análisis y BI de Microsoft Fabric capacity – Concepto Fabric tenant settings – Concepto

Artículos relacionados

Más artículos sobre Microsoft Fabric:

RSS