¿Qué es Fabric Apps (versión preliminar)?

Fabric Apps (versión preliminar) le ayuda a crear aplicaciones controladas por datos en Microsoft Fabric mediante la combinación de modelos de datos, API generadas, autenticación y hospedaje en un flujo de trabajo de desarrollo. Los modelos de datos se definen en TypeScript y Fabric Apps los usa para generar las partes de back-end que necesita la aplicación. Fabric Apps admite TypeScript como lenguaje para modelos de datos, código de cliente y lógica de aplicación.

Características clave

Fabric Apps proporciona estas funcionalidades:

• Modelos de datos para API – Decora las clases de TypeScript con @entity(), @text(), @uuid() y otros decoradores. Fabric Apps genera automáticamente esquemas de base de datos y puntos de conexión de GraphQL.
• Clientes con seguridad de tipos – El SDK del cliente valida las consultas y las mutaciones antes de que lleguen al backend, detectando errores durante el desarrollo.
• Autenticación integrada : se incluyen la administración de sesiones, el control de tokens y los flujos de autenticación. Configure Fabric SSO para aplicaciones implementadas o use correo electrónico y contraseña durante el desarrollo local.
• Hospedaje estático : compile y sirva la aplicación de front-end junto con las API de back-end con un único comando de implementación.
• Desarrollo local: ejecute la pila completa localmente con Docker para una iteración rápida y, a continuación, implemente en Microsoft Fabric cuando esté listo para producción. Cree la estructura de proyectos, desarrolle con GitHub Copilot e implemente en Fabric con Rayfin CLI.

Prerequisites

Capacidad de Fabric

El área de trabajo debe tener asignada una capacidad de Fabric. Al crear un área de trabajo, seleccione una capacidad de Fabric para asociarla. Los servicios de Fabric Apps consumen unidades de capacidad de la capacidad asignada.

Configuración del administrador de inquilinos

Un administrador de inquilinos de Fabric debe habilitar la carga de trabajo Fabric Apps para que los usuarios puedan crear elementos.

1. Inicie sesión en el portal de administración de Fabric.
2. Vaya a Configuración del inquilino.
3. En Fabric Apps (versión preliminar), cambie la configuración a Enabled.
4. Elija si se va a habilitar para toda la organización o grupos de seguridad específicos.
5. Seleccione Aplicar.

Los cambios pueden tardar unos minutos en propagarse.

Cómo funciona

Una aplicación Fabric se ejecuta como un servicio administrado en Microsoft Fabric con conjunto de servicios que definen el back-end, como el hospedaje de aplicaciones, la base de datos, las API de GraphQL y la autenticación. Fabric administra el hospedaje, las redes y el escalado. La autenticación usa Fabric SSO (Microsoft Entra ID inicio de sesión único) exclusivamente; no hay otros proveedores de autenticación disponibles después de la implementación.

Al implementar la aplicación con rayfin up, Fabric crea servicios secundarios a partir de la configuración de rayfin.yml. Estos servicios secundarios se muestran como subelementos debajo de la aplicación Fabric en el portal de Fabric.

Dirección URL del back-end de la aplicación

Cada aplicación Fabric tiene un único punto de conexión que proporciona acceso a todos los servicios:

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

El punto de conexión expone una ruta de acceso para cada servicio:

Administración en el portal de Fabric

Después de la implementación, puede administrar la aplicación Fabric directamente en el portal de Fabric.

Ver las propiedades del elemento

Abra la aplicación Fabric en el portal para ver:

• Dirección URL del back-end de la aplicación: este punto de conexión se usa para todos los servicios de back-end que usa la aplicación.
• Dirección URL de la aplicación : dirección URL pública donde se hospeda el contenido estático. Fabric SSO es necesario para acceder a la aplicación.

Administrar elementos secundarios

Seleccione la aplicación Fabric para ver sus servicios secundarios:

• base de datos SQL en Fabric: abre el elemento Fabric SQL Database para ver el explorador de objetos. Puede ejecutar consultas de lectura en sus datos. Los cambios de esquema siempre deben realizarse en el código de la carpeta rayfin/data. Los conflictos de esquema pueden producirse si el esquema se cambia directamente en SQL Database y puede interrumpir la aplicación.

Permisos de elemento

Los roles del espacio de trabajo no sustituyen los permisos a nivel de elemento. Para compartir una aplicación con alguien de su organización, necesitan el permiso Ejecutar e interactuar (Leer y ejecutar) para ejecutar la aplicación e invocar las API de back-end.

Obtenga más información sobre los roles del área de trabajo.

Desarrollo con la CLI de Rayfin

La CLI genera la estructura de nuevos proyectos, inicia la infraestructura local, sincroniza los cambios de esquema y despliega en Fabric. Instálelo con npm create @microsoft/rayfin@latest.

Comandos de clave:

Para obtener una referencia de comandos completa, consulte Referencia de la CLI.

Decoradores de modelos de datos

Definir modelos de datos mediante decoradores de 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 analiza estos decoradores y genera:

• Definiciones de tabla de base de datos
• Puntos de conexión de GraphQL API
• Reglas de autorización de nivel de fila
• Métodos de cliente seguros para tipos

Cuándo usar aplicaciones de Fabric

Fabric Apps es ideal para:

• Creación rápida de prototipos : vaya desde la idea a la dirección URL activa en cuestión de minutos con la infraestructura preconfigurada.
• Herramientas internas y paneles de control – Cree interfaces de administración con autenticación sin escribir código repetitivo de backend.
• Exploración y visualización de datos – Consulta datos de Fabric a través de GraphQL y muéstralos en interfaces personalizadas.
• Aplicaciones de IA y de agentes – Proporcionar servicios de backend estructurados para agentes de IA que necesitan estado persistente.

es posible que Fabric Aplicaciones no sean adecuadas para:

• Aplicaciones que requieren transacciones complejas de varios pasos o procedimientos almacenados.
• Aplicaciones que requieren proveedores de autenticación personalizados más allá de Fabric SSO y correo electrónico o contraseña.

Responsabilidades de seguridad

Fabric proporciona: inicio de sesión único de Fabric (Microsoft Entra ID), seguridad de nivel de las filas mediante decoradores @role, HTTPS, PKCE y permisos del área de trabajo y del nivel de elemento.

Usted es responsable de:

• Mantener secretos, claves de API y datos confidenciales fuera del código, los recursos de front-end y el repositorio. El contenido estático se sirve desde una dirección URL pública.
• Lo que expone la aplicación a través de Fabric SSO controla el inicio de sesión, ya que el código controla lo que ven y hacen los usuarios autenticados.
• Conceder solo los permisos que los colaboradores necesitan implementar o administrar la aplicación.
• Responsabilidad legal y de cumplimiento de los datos que recopila la aplicación, procesa y almacena.

Pasos siguientes

• Crear el primer proyecto de Fabric Apps
• Definición de modelos de datos con decoradores
• Deploy to Microsoft Fabric
• Configurar la autenticación