Compartir vía

Carpeta del modelo semántico del proyecto de Power BI Desktop

  • Artículo

Importante

Los proyectos de Power BI Desktop se encuentran actualmente en versión preliminar.

En este artículo, se describen los archivos y las subcarpetas de una carpeta de modelo semántico de un proyecto de Microsoft Power BI Desktop. Estos archivos y subcarpetas representan un modelo semántico de Power BI. En función del proyecto, la carpeta del modelo semántico puede incluir:

1 - Este archivo es necesario.
2: este archivo es necesario al guardar con el formato TMSL.
3: este archivo es necesario al guardar con el formato TMDL.

No todas las carpetas del modelo semántico del proyecto incluyen todos los archivos y subcarpetas que se describen aquí.

Archivos del modelo semántico

.pbi\localSettings.json

Contiene la configuración del modelo semántico que solo se aplica al usuario y al equipo actuales. Debe incluirse en gitIgnore u otras exclusiones de control de código fuente. De forma predeterminada, Git omitirá este archivo.

Para obtener más información, consulte el documento de esquema localSettings.json.

.pbi\editorSettings.json

Contiene la configuración del editor del modelo semántico guardada como parte de la definición del conjunto de datos para su uso con usuarios y entornos.

Para obtener más información, consulte el documento de esquema editorSettings.json.

.pbi\cache.abf

Archivo de copia de seguridad de Analysis Services (ABF) que contiene una copia en caché local del modelo y los datos de la última vez que se editó. Debe incluirse en gitIgnore u otras exclusiones de control de código fuente. De forma predeterminada, Git omitirá este archivo.

Power BI Desktop puede abrir un proyecto sin un archivo cache.abf. En ese caso, abre el informe conectado a un modelo con toda su definición, pero sin datos. Si existe cache.abf, Power BI Desktop carga los datos y sobrescribe la definición del modelo con el contenido de model.bim.

.pbi\unappliedChanges.json

Power BI Desktop permite guardar los cambios realizados en el editor Transform Data (Power Query) sin aplicar primero esos cambios al modelo de datos.

Imagen que muestra el cuadro de diálogo Aplicar cambio de consulta.

Al seleccionar Aplicar más tarde, los cambios sin aplicar se guardan en el archivo unappliedChanges.json. Cuando los cambios pendientes están en el archivo unappliedChanges, Power BI Desktop le solicita que aplique o descarte esos cambios pendientes:

Imagen con aviso de cambios pendientes.

Si selecciona Aplicar cambios, Power BI Desktop sobrescribe las consultas en model.bim con las consultas de unappliedChanges.json. Si editó consultas en model.bim fuera de Power BI Desktop y existe un archivo anterior unappliedChanges.json, sus cambios se perderán y se sustituirán por las consultas de unappliedChanges.json cuando se apliquen dichos cambios.

El archivo unappliedChanges.json se incorpora automáticamente a la definición del modelo semántico y se guarda en Git de forma predeterminada. Esto le permite confirmar su trabajo en curso en la rama de desarrollo, lo que sirve como copia de seguridad y lo hace accesible a otros miembros del equipo. Sin embargo, puede excluir este archivo del seguimiento de Git, lo que evitará que el trabajo de consulta incompleto afecte a otros desarrolladores.

Para obtener más información, consulte el documento de esquema unappliedChanges.json.

definition.pbism

Contiene la definición general de un modelo semántico y la configuración principal.

Este archivo también especifica los formatos de definición de modelo semántico admitidos a través de la propiedad "version".

Versión Formatos compatibles
1.0 La definición del modelo semántico debe almacenarse como TMSL en el archivo model.bim.
4.0 o superior La definición del modelo semántico se puede almacenar como TMSL (archivo model.bim) o TMDL (carpeta \definition).

Para obtener más información, consulte el documento de esquema definition.pbism.

model.bim

Este archivo solo está disponible si el proyecto de Power BI se guarda con el formato TMSL. Contiene una definición de objeto de base de datos en lenguaje de scripting de modelos tabulares (TMSL) del modelo de proyecto.

Folder definition\

Esta carpeta solo está disponible si el proyecto de Power BI se guarda en formato TMDL. Reemplaza el archivo model.bim.

Este archivo contiene una definición de objeto base de datos en lenguaje de definición de modelos tabulares (TMDL) del proyecto del modelo.

diagramLayout.json

Contiene metadatos de diagrama que definen la estructura del modelo semántico asociado al informe. Durante la VERSIÓN PRELIMINAR, este archivo no admite la edición externa.

Luck!

Archivo de plataforma Fabric que contiene propiedades vitales para establecer y mantener la conexión entre elementos de Fabric y Git.

Para más información, vea Integración de Git generada automáticamente de archivos del sistema.

Formato TMDL

Con el objetivo de proporcionar un mejor control de código fuente y una experiencia de desarrollo conjunta, puede guardar los archivos del proyecto de Power BI (PBIP) mediante el lenguaje de definición de modelos tabulares (TMDL) como formato de archivo de modelo semántico.

A diferencia del lenguaje de scripting de modelos tabulares (TMSL), TMDL se ha diseñado desde el principio para ser fácil de usar, lo que facilita no solo la legibilidad, sino que también facilita la edición en cualquier editor de texto. Esto representa una mejora sustancial para el control de código fuente y las experiencias de desarrollo colaborativas.

Captura de pantalla de diferencias de TMDL amigables.

En lugar de un archivo JSON de gran tamaño, como en el lenguaje de scripting para modelos tabulares (TMSL), TMDL tiene una estructura de carpetas con archivos independientes para cada tabla, perspectiva, rol y referencia cultural. Esto facilita el trabajo con otros usuarios y la comprensión de la estructura del modelo semántico simplemente examinando la carpeta y los archivos. En última instancia, esto conduce a un excelente control de código fuente y experiencia de desarrollo conjunto cuando se abordan los conflictos de diferencias y combinaciones de Git.

Captura de pantalla de diferencias TMDL del modelo semántico.

Obtenga más información sobre TMDL aquí.

Habilitación de la característica en vista previa de TMDL

Guardar como un proyecto de Power BI Desktop está actualmente en versión preliminar. Antes de probarla, primero debe habilitarla en Características en vista previa:

Vaya a Archivo > Opciones y configuración > Opciones > Características en vista previa y marque la casilla junto a Guardar modelo semántico con el formato TMDL.

Guardar como un proyecto con el formato TMDL

Con la característica en vista previa TMDL habilitada, al guardar un proyecto, el modelo semántico se guarda como una carpeta TMDL denominada \definitionen la carpeta del modelo semántico:

Captura de pantalla de la carpeta de definición dentro de una carpeta de modelo semántico.

Obtenga más información sobre la estructura de carpetas de TMDL.

Conversión del PBIP existente a TMDL

Si ya tiene un PBIP con TMSL como formato de modelo semántico, puede convertirlo a TMDL de la siguiente manera:

  1. Abra el PBIP en Power BI Desktop.

  2. Asegúrese de que la característica en vista previa esté habilitada.

  3. Guarde el proyecto. Aparece un mensaje que le pide que actualice a TMDL.

  4. Seleccione Actualizar.

    Importante

    Una vez que actualice a TMDL, no podrá volver a TMSL. Si cree que es posible que desee volver a TMSL, guarde primero una copia de los archivos PBIP.

    Captura de pantalla de la solicitud para actualizar la carpeta del modelo semántico a TMDL.

El archivo existente del lenguaje de scripting de modelos tabulares (TMSL) (model.bim) se reemplaza por una carpeta \definition que contiene la representación TMDL del modelo semántico.

Captura de pantalla de proyectos de PBIP con carpetas TMSL y con carpetas TMDL.

Si selecciona Mantener el actual formato, Desktop no le pedirá otra vez que actualice.

Realizar cambios externos en los archivos TMDL

Para obtener una mejor experiencia de lectura y edición de los archivos TMDL, instale la extensión de TMDL de Visual Studio Marketplace de Microsoft VS Code.

Abra la carpeta PBIP mediante VS Code y vaya a la carpeta de definición del modelo semántico.

Captura de pantalla de una carpeta de definición de modelo semántico en VS Code.

Power BI Desktop no es consciente de los cambios realizados en los archivos de proyecto por otras herramientas. Por lo tanto, si realiza cualquier cambio en los archivos abiertos fuera de Power BI Desktop, deberá reiniciar para que esos cambios se reflejen en Power BI Desktop.

Consulte la información que se incluye aquí para ver las operaciones de escritura admitidas fuera de Power BI Desktop.

Errores de TMDL

Si se realizan modificaciones no válidas en los archivos TMDL, Power BI Desktop produce un error abierto, con la ubicación del error:

Captura de pantalla de un mensaje de error para un archivo no válido.

Consideraciones y limitaciones de TMDL

Durante la versión preliminar pública, la integración de Fabric Git seguirá exportando el modelo semántico mediante TMSL de forma predeterminada. Sin embargo, si el modelo semántico se importa en Fabric mediante Fabric Git Integration con formato TMDL, Fabric Git Integration usará el formato TMDL para exportar la definición del modelo semántico a Git si hay algún cambio de modelo semántico en el servicio.

Importante

Si importa el modelo semántico mediante cualquier otro método de importación, como Publicación de Power BI Desktop, la integración de Git de Fabric volverá al formato TMSL predeterminado.

Contenido relacionado