Archivos en OneLake
Novedad en 1.1.0.12
Un archivo guardado en un lakehouse de Microsoft Fabric se puede usar en cualquier lugar en el que Icon Map Slicer acepte un vínculo a un archivo o una imagen, igual que los objetos visuales propios de Power BI aceptan archivos de OneLake. Pegue la URL de OneLake del archivo o elíjalo con Elegir de OneLake. Cada lector lee el archivo directamente de OneLake, con su propio acceso.
Dónde funcionan los archivos de OneLake
| Dónde | Qué puede usar |
|---|---|
| Capas de referencia de Archivos y fuentes | Un archivo GeoJSON, TopoJSON, KML, KMZ o CSV, mediante un vínculo. Cualquier archivo que acepte la ventana de carga, como copia importada. |
| Formas desde archivos | Un archivo GeoJSON mediante un vínculo. Cualquier archivo que acepte la ventana de carga, incluidos los archivos PMTiles, como copia importada. |
| Imágenes e iconos, las imágenes de Formas desde datos y de Líneas, y las imágenes de punto de las capas de referencia | Una URL de imagen en sus datos o en el panel Formato. |
| Teselas vectoriales | Un archivo PMTiles, con Usar PMTiles activado. |
| Modelos 3D | Un archivo .glb, elegido en el selector de modelos o indicado como vínculo a un modelo en sus datos. |
Solo se pueden usar los archivos de la sección Files de un lakehouse, y solo archivos de mapa, imágenes y modelos .glb.
Antes de empezar
Los archivos de OneLake necesitan algunos requisitos previos. Los administradores los configuran una vez para toda la organización.
| Qué | Quién | Dónde |
|---|---|---|
| OneLake permite que el objeto visual lea archivos con un vínculo firmado | Administrador de Fabric | Portal de administración > Configuración de inquilinos > Configuración de OneLake > Authenticate with OneLake user-delegated SAS tokens. El cambio puede tardar 15 minutos en aplicarse. |
| Los objetos visuales personalizados pueden iniciar sesión en nombre del lector | Administrador de Power BI | La configuración de inquilino de objetos visuales de Power BI. |
| La organización ha aprobado el acceso de la aplicación Icon Map a OneLake | Administrador de Microsoft Entra | El consentimiento del administrador para la aplicación Icon Map. Las organizaciones que usan Icon Map for Fabric normalmente ya lo tienen. |
| Cada lector puede leer el archivo | Propietario del lakehouse | Acceso de Lectura al lakehouse y a la carpeta que contiene el archivo. No es necesario para una copia importada. |
El objeto visual solo pide a un lector que inicie sesión cuando el mapa carga un archivo de OneLake o cuando se selecciona Elegir de OneLake. Un informe sin archivos de OneLake nunca lo pide.
Usar una URL de OneLake
- En Fabric, abra el lakehouse, busque el archivo en Files y abra su panel Propiedades.
- Copie la URL. Tiene este aspecto:
https://onelake.dfs.fabric.microsoft.com/<workspace-id>/<lakehouse-id>/Files/<folder>/<file>. - Péguela donde el objeto visual acepte un vínculo: el vínculo de una capa en el Administrador de capas o en el panel Formato, una URL de imagen en sus datos o la pestaña Desde un vínculo del selector de modelos.
También funcionan la forma con nombres, https://onelake.dfs.fabric.microsoft.com/<workspace name>/<lakehouse name>.Lakehouse/Files/..., el host onelake.blob.fabric.microsoft.com, los hosts regionales de OneLake y las rutas abfss://.
El Administrador de capas no lee un vínculo de OneLake al añadirlo. Su comprobación del vínculo indica "Un archivo en OneLake" y que el archivo se lee cuando se carga el mapa.
Elegir de OneLake
La ventana de carga de Archivos y fuentes, de Formas desde archivos y de las formas personalizadas de Celdas tiene un botón Elegir de OneLake debajo del área para soltar archivos.
- Seleccione Elegir de OneLake. La primera vez, la ventana se cierra mientras inicia sesión y, después, se vuelve a abrir en el explorador de OneLake.
- Elija un área de trabajo, un lakehouse y, después, una carpeta. Solo se enumeran las áreas de trabajo que tienen un lakehouse. Solo se enumeran los archivos que la capa puede usar, y Filtrar acorta una lista larga.
- Seleccione un archivo y, después, Vincular a este archivo o Importar una copia.
| Opción | Qué hace |
|---|---|
| Vincular a este archivo | Los lectores cargan el archivo desde OneLake con su propio acceso, de modo que los cambios en el archivo se reflejan en el informe. |
| Importar una copia | El archivo se lee una vez y se guarda en el informe, exactamente igual que un archivo cargado desde su equipo. Los lectores no necesitan acceso a OneLake. |
Vincular a este archivo se ofrece para los formatos que la capa lee desde un vínculo: GeoJSON, TopoJSON, KML y KMZ para las capas de referencia, y GeoJSON para Formas desde archivos. Las formas personalizadas solo se pueden importar. Volver a la carga vuelve al área para soltar archivos.
Imágenes en el panel Formato
Debajo de los campos de URL de imagen del panel Formato, un conmutador Elegir de OneLake abre el explorador de OneLake para imágenes. Elija un área de trabajo, un lakehouse, una carpeta y una imagen, y después Vincular a este archivo: su URL de OneLake se escribe en el campo y cada espectador carga la imagen con su propio acceso. El conmutador se vuelve a desactivar solo, y Cancelar deja el campo como estaba.
Los campos son URL de la imagen en Imágenes e iconos, URL de la imagen al inicio y URL de la imagen al final en Líneas, URL de la imagen, URL de la imagen al inicio de la polilínea y URL de la imagen al final de la polilínea en Formas desde datos, y la URL de la imagen de los puntos de cada capa de referencia. Una imagen elegida es un valor fijo, por lo que reemplaza el formato condicional de ese campo.
Modelos 3D desde OneLake
En el selector de modelos, seleccione Añadir modelos y, después, Desde un vínculo. Pegue la URL de OneLake de un archivo .glb, o seleccione Elegir de OneLake, en Un archivo .glb en un lakehouse de Fabric, para buscar uno. Cada lector carga el modelo desde OneLake con su propio acceso al lakehouse. Un vínculo a un modelo en sus datos, mediante formato condicional en Modelo, también puede ser una URL de OneLake.
Solo funcionan los archivos .glb autónomos. Un archivo .gltf carga sus demás partes sin el acceso del lector, así que empaquételo antes en un archivo .glb. Consulte Modelos 3D.
Cómo se lee el archivo
- El servicio de Icon Map firma para el lector un vínculo de solo lectura al archivo, válido durante aproximadamente una hora, con el propio inicio de sesión del lector. Después, el explorador lee el archivo directamente de OneLake.
- El archivo nunca pasa por los servidores de Icon Map. OneLake comprueba el acceso de cada lector, de modo que un lector que no puede abrir el lakehouse no puede cargar el archivo.
- Los vínculos se vuelven a firmar antes de que caduquen. Un archivo PMTiles se firma en cada lectura, de modo que sigue funcionando por mucho tiempo que el informe permanezca abierto.
Cuando un archivo no se carga
El panel de mensajes del mapa explica una sola vez un archivo de OneLake que no se ha podido cargar:
| Mensaje | Qué hacer |
|---|---|
| OneLake no permitió que este objeto visual leyera el archivo | Un administrador de Fabric activa Authenticate with OneLake user-delegated SAS tokens (Portal de administración > Configuración de inquilinos > Configuración de OneLake). Puede tardar 15 minutos en aplicarse. |
| No tiene permiso para leer el archivo | Pida al propietario del lakehouse acceso de lectura al lakehouse y a la carpeta que contiene el archivo. |
| No se encontró el archivo en OneLake, o no puede abrir su área de trabajo o lakehouse | Compruebe la URL y que puede abrir el área de trabajo. |
| Su organización aún no ha aprobado el acceso de Icon Map a OneLake | Un administrador de Microsoft Entra concede el consentimiento a la aplicación Icon Map. |
| Su administrador de Power BI ha desactivado el inicio de sesión para objetos visuales personalizados | Se permite en la configuración de inquilino de objetos visuales de Power BI. |
| El inicio de sesión no está disponible aquí | El inicio de sesión no funciona en todas partes, por ejemplo en Publicar en la web. En su lugar, importe una copia del archivo. |
| El archivo no se puede cargar desde OneLake | Use un archivo de mapa, una imagen o un modelo .glb de la sección Files de un lakehouse, con la URL de su panel Propiedades. |
Qué no se admite
Las URL de OneLake no se leen para:
- Las imágenes de las tarjetas de etiquetas de datos.
- Los vínculos de mapas base, estilos y terreno.
Para estos casos, use un archivo de un servidor web.