Instalación del SDK Power Query
Inicio rápido
Nota
Los pasos para habilitar las extensiones cambiaron en la versión de junio de 2017 de Power BI Desktop.
- Instale el SDK Power Query desde Visual Studio Marketplace.
- Cree un nuevo proyecto de conector de datos.
- Defina la lógica del conector.
- Compile el proyecto para generar un archivo de extensión.
- Copie el archivo de extensión en [Documentos]/Power BI Desktop/Conectores personalizados.
- Active la opción (No recomendado) Permitir que cualquier extensión se cargue sin validación ni advertencia en Power BI Desktop (en Archivo | Opciones y configuración | Opciones | Seguridad | Extensiones de datos).
- Reinicie Power BI Desktop.
Distribución de conectores de datos
Power BI Desktop usuarios pueden descargar archivos de extensión y colocarlos en un directorio conocido (pasos descritos anteriormente). Power BI Desktop cargará automáticamente las extensiones al reiniciar.
Vínculos y recursos adicionales
- Funciones de la biblioteca M
- Especificación del lenguaje M
- Power BI Centro para desarrolladores
- Tutorial del conector de datos
Paso a paso
Creación de una nueva extensión en Visual Studio
La instalación del SDK Power Query para Visual Studio creará una plantilla de proyecto de Data Connector en Visual Studio.
Esto crea un nuevo proyecto que contiene los siguientes archivos:
- Archivo de definición de conector ( <connectorName> .pq)
- Un archivo de prueba de consulta ( <connectorName> .query.pq)
- Un archivo de recursos de cadena (resources.resx)
- Archivos PNG de varios tamaños usados para crear iconos
El archivo de definición del conector comenzará con una descripción vacía del origen de datos. Consulte la sección Tipo de origen de datos más adelante en este documento para obtener más información.
Pruebas en Visual Studio
El SDK Power Query proporciona funcionalidades básicas de ejecución de consultas, lo que le permite probar la extensión sin tener que cambiar a Power BI Desktop. Consulte Archivo de consulta para obtener más detalles.
Compilación e implementación desde Visual Studio
La creación del proyecto producirá el archivo .pqx.
Los proyectos de Data Connector no admiten pasos posteriores a la compilación personalizados para copiar el archivo de extensión en el directorio [Documentos]\Microsoft Power BI Desktop\Conectores personalizados. Si esto es algo que quiere hacer, es posible que desee usar una extensión de Visual Studio de terceros, como La implementación automática.
Archivos de extensión
Power Query se agrupan en un archivo ZIP y se les da una extensión de archivo .mez. En tiempo de Power BI Desktop, cargará extensiones desde [Documentos]\Microsoft Power BI Desktop\Conectores personalizados.
Nota
En un próximo cambio, la extensión predeterminada cambiará de .mez a .pqx.
Formato de archivo de extensión
Las extensiones se definen en un documento de la sección M. Un documento de sección tiene un formato ligeramente diferente al de los documentos de consulta generados en Power Query. El código que importa Power Query normalmente requiere la modificación para ajustarse a un documento de sección, pero los cambios son menores. Entre las diferencias de documento de sección que debe tener en cuenta se incluyen:
- Comienzan con una declaración de sección (por ejemplo,
section HelloWorld;). - Cada expresión termina con un punto y coma (por ejemplo,
a = 1;ob = let c = 1 + 2 in c;). - Todas las funciones y variables son locales en el documento de sección, a menos que estén marcadas como compartidas. Las funciones compartidas se vuelven visibles para otras consultas o funciones y se pueden pensar como exportaciones de la extensión (es decir, se pueden llamar desde Power Query).
Puede encontrar más información sobre los documentos de la sección M en la especificación del lenguaje M.
Archivo de consulta
Además del archivo de extensión, los proyectos de Data Connector pueden tener un archivo de consulta (name.query.pq). Este archivo se puede usar para ejecutar consultas de prueba en Visual Studio. La evaluación de consultas incluirá automáticamente el código de extensión, sin tener que registrar el archivo .pqx, lo que le permite llamar o probar las funciones compartidas en el código de extensión.
El archivo de consulta puede contener una sola expresión (por ejemplo, ), una expresión (por ejemplo, HelloWorld.Contents() let lo Power Query generaría) o un documento de sección.