Conceptos y características clave

El kit de herramientas de extensibilidad presenta un conjunto de funcionalidades diseñadas para llevar la aplicación de datos a la plataforma de la manera más sencilla posible. Estas características permiten a los desarrolladores crear experiencias enriquecidas e integradas con un esfuerzo mínimo. Con el Kit de herramientas de extensibilidad, puede acceder fácilmente a las API de Fabric directamente desde el front-end, conservar la definición de elemento (estado) dentro de Fabric, usar un flujo de creación de elementos estandarizado y aprovechar la seguridad y la interoperabilidad mejoradas mediante la relajación de iFrame y la compatibilidad con la API pública. Además, simplifica el ciclo de vida de desarrollo con compatibilidad integrada con CI/CD, lo que facilita la automatización de la implementación y las pruebas. En las secciones siguientes se proporciona información general sobre la funcionalidad principal y las instrucciones sobre cómo incorporarlas a las cargas de trabajo.

Experiencia de creación de elementos estándar

La creación de elementos se normaliza a través de un control de Fabric dedicado que guía a los usuarios a través del proceso. Este control permite a los usuarios seleccionar el área de trabajo donde se crea el elemento, asignar etiquetas de confidencialidad y configurar otras opciones pertinentes. Al usar esta experiencia estandarizada, ya no es necesario controlar las complejidades de la creación de elementos usted mismo o preocuparse por los cambios futuros en el proceso. Además, este enfoque permite que la creación de elementos se muestre directamente dentro de la página de la carga de trabajo, lo que proporciona una experiencia de usuario perfecta e integrada.

Use la guía How to create an Item (Cómo crear una guía de elementos ) para comprender cómo se puede implementar.

Compatibilidad con la API de front-end

Con el Kit de herramientas de extensibilidad, puede obtener un token de Microsoft Entra On-Behalf-Of (OBO) directamente dentro de la aplicación de front-end, lo que permite el acceso seguro a cualquier API protegida por Entra. Esta funcionalidad le permite integrar profundamente con los servicios de Microsoft Fabric; por ejemplo, puede leer y almacenar datos en OneLake, crear e interactuar con otros elementos de Fabric o usar Spark como motor de procesamiento a través de las API de Livey. Para obtener más información, consulte la documentación de Microsoft Entra, la documentación de OneLake, las API rest de Fabric y Spark en Fabric.

Use la guía Cómo adquirir Microsoft Entra Token para comprender cómo se puede implementar. Use también la guía How to access Fabric APIs (Cómo acceder a las API de Fabric ) para comprender cómo puede interactuar con Fabric.

Almacenamiento de la definición de elemento (estado) en Fabric

Esta característica permite almacenar los metadatos del elemento(como la configuración de elementos y otra información relevante) directamente en OneLake dentro de una carpeta oculta que no es visible para los usuarios finales. Los datos se almacenan con el mismo formato aplicado por las API públicas y los procesos de CI/CD, lo que garantiza la coherencia y la interoperabilidad en distintos puntos de integración. En las secciones siguientes se describen los detalles sobre el formato y su uso con las API públicas y CI/CD.

Use la How to store Item definition para comprender cómo se puede implementar.

Qué almacenar en la definición

Piense en el estado como algo que contiene toda la información necesaria para restaurar un elemento si se elimina o copia en otro lugar. Esto no incluye los datos en sí, que se almacenan en OneLake (consulte Almacenamiento de datos de elementos en OneLake).

Estos son algunos ejemplos prácticos:

• Elemento de cuaderno: el estado almacena el código, el orden de celda y los metadatos del cuaderno, como el motor de ejecución (por ejemplo, Spark, SQL) que se debe usar. Los datos reales procesados por el notebook no se almacenan en el estado.
• Elemento del editor de archivos: el estado no almacena el contenido del archivo en sí, sino que almacena la configuración del editor, como la combinación de colores, la configuración de autocompletar, el tamaño de fuente y otras preferencias del usuario.
• Instalador o elemento de orquestador: si el elemento instala u aprovisiona otros componentes (como bases de datos o recursos de proceso), el estado debe contener referencias (identificadores, URI) a los elementos que creó. Esto permite a su carga de trabajo comprobar su estado o administrarlo más adelante.

Al centrarse en la configuración, los metadatos y las referencias, se garantiza que el estado del elemento sea portátil, ligero y fácil de restaurar o migrar.

Almacenar datos de elementos en OneLake

Cada elemento incluye su propia carpeta de elementos Onelake, donde los desarrolladores pueden almacenar datos estructurados y no estructurados. De forma similar a una instancia de Lakehouse, el elemento tiene una carpeta Table donde los datos se pueden almacenar en formato Delta o Iceberg y una carpeta Files donde se pueden almacenar datos no estructurados.

Utilice How to store data in Item para comprender cómo se puede implementar.

Datos de acceso directo

Como cada elemento tiene su propia carpeta Onelake, ellos también pueden trabajar con accesos directos. A través del workload de la Shortcut API pública, los desarrolladores pueden crear diferentes tipos de Shortcuts desde o hacia su elemento para participar en la promesa de copia única de OneLake.

Utiliza el Cómo crear accesos directos para comprender cómo se puede implementar.

Compatibilidad con la API de elementos CRUD

Los usuarios pueden crear, actualizar y eliminar elementos de contenido mediante las API REST de Fabric estándar. Esta habilitación automática facilita la integración con elementos de carga de trabajo de la misma manera que los elementos principales de Fabric, lo que simplifica la interoperabilidad y reduce el esfuerzo necesario para crear integraciones sólidas.

Compatibilidad con CI/CD

La compatibilidad con CI/CD para todos los elementos es una de las solicitudes más frecuentes de los clientes. Con esta característica, todos los elementos participan en CICD de fábrica, sin necesidad de implementar ninguna lógica o operaciones específicas. Esto significa que puede automatizar la implementación, las pruebas y las actualizaciones de las cargas de trabajo mediante azure Pipelines y herramientas estándar. El formato de elemento y las API están diseñados para ser totalmente compatibles con los procesos de CI/CD, lo que garantiza una experiencia coherente y confiable en todos los entornos. Para obtener más información sobre la integración con CI/CD, consulte la documentación de Fabric CICD.

API de notificación CRUD de elemento

Hay casos en los que la carga de trabajo debe participar en los eventos CRUD de elemento. A medida que los elementos se crean en la plataforma directamente a través de la experiencia de usuario, las API públicas o los propietarios de cargas de trabajo de CI/CD no están en control cuando se crea un nuevo elemento a través de esos puntos de entrada. De forma predeterminada, los elementos almacenan su estado en Fabric y no es necesario informarse sobre el cambio de su elemento. Sin embargo, hay algunos casos en los que las cargas de trabajo tienen que participar en el flujo CRUD. Este es principalmente el caso si la infraestructura de los elementos debe aprovisionarse o configurarse (por ejemplo, Bases de datos). En estos escenarios, permitimos que los asociados implementen una API de notificación CRUD que Fabric invoca en cada evento. En este escenario, el desarrollador de cargas de trabajo debe asegurarse de que su API sea accesible, ya que, en caso contrario, se produce un error en las operaciones de Fabric.

Programador de tejido

Fabric admite la planificación de tareas para cargas de trabajo. Esta característica permite a los desarrolladores crear cargas de trabajo que reciben notificaciones incluso si el usuario no está delante de la experiencia de usuario y actuar en función del trabajo que se debe ejecutar (por ejemplo, copiar datos en Onelake). Los asociados deben implementar una API y configurar su carga de trabajo para participar en esta funcionalidad.

Relajación de iFrame

Los desarrolladores pueden solicitar más atributos iFrame para habilitar escenarios avanzados, como descargas de archivos o abrir sitios web externos. Esta característica permite que la carga de trabajo solicite a los usuarios consentimiento explícito antes de realizar acciones que requieran funcionalidades más amplias del explorador, como iniciar descargas o conectar usuarios a api externas mediante sus credenciales de Fabric actuales. Al especificar estos requisitos en la configuración de la carga de trabajo, asegúrese de que los usuarios estén informados y pueda conceder los permisos necesarios, lo que permite la integración sin problemas con los sistemas externos al tiempo que mantiene la seguridad y la confianza del usuario.

Utiliza Cómo relajar el iFrame para comprender cómo se puede implementar.

Limitaciones de características

Private Link

Todas las cargas de trabajo se bloquean para el consumo y el desarrollo si Private Link está habilitado a nivel de tenant o área de trabajo.