Desarrollo de un conector mediante el SDK de Power Query

  • Artículo

El SDK de Power Query es un conjunto de herramientas diseñadas para ayudarle a crear conectores de Power Query. Estos conectores se conocen a menudo como conectores personalizados o extensiones de Power Query.

Los conectores personalizados permiten crear nuevos orígenes de datos o personalizar y ampliar un origen actual. Entre los casos de uso comunes se incluye:

  • Crear una vista de una API REST fácil de usar para analistas de negocios.
  • Proporcionar personalización de marca para un origen que Power Query admite con un conector actual (como un servicio OData o un controlador ODBC).
  • Implementar el flujo de autenticación de OAuth v2 para una oferta de SaaS.
  • Exponer una vista limitada o filtrada sobre el origen de datos para mejorar la facilidad de uso.
  • Habilitar DirectQuery para un origen de datos mediante un controlador ODBC.

Instalación del SDK de Power Query

Instale el SDK de Power Query para Visual Studio Code desde la sección de Visual Studio Code en Visual Studio Marketplace. Seleccione Instalar para instalar el SDK.

Proceso de desarrollo del conector

En las siguientes secciones se describe, a grandes rasgos, el proceso más común para crear un conector de Power Query con el SDK.

Creación de una nueva extensión

Para crear una nueva área de trabajo (SDK de Power Query para Visual Studio Code), comience con los siguientes archivos principales:

  • Archivo de definición del conector (<connectorName.pq>)
  • Un archivo de consulta (<connectorName.query.pq>)
  • Un archivo de recursos de cadena (resources.resx)
  • Archivos PNG de varios tamaños que se usan para crear iconos

El archivo de definición del conector comienza con una descripción vacía del origen de datos. Puede obtener más información sobre un origen de datos en el contexto del SDK de Power Query en este artículo sobre el control del acceso a los datos.

Prueba

El SDK de Power Query proporciona funcionalidad básica de ejecución de consultas, lo que le permite probar la extensión sin tener que cambiar a otra aplicación cliente. Puede seguir probando el conector en una aplicación como:

Archivo de prueba de consulta

Además del archivo de extensión, los proyectos de conector de datos pueden tener un archivo de consulta (name.query.pq). Este archivo se puede usar para ejecutar consultas de prueba en Visual Studio Code. La evaluación de consultas incluye automáticamente el código de la extensión, sin tener que registrar el archivo.pqx, lo que permite llamar a funciones compartidas o probarlas en el código de la extensión.

El archivo de consulta puede contener una sola expresión (por ejemplo, HelloWorld.Contents()), una expresión let (por ejemplo, lo que generaría Power Query) o un documento de sección.

Compilación e implementación

Al compilar el proyecto se genera el archivo .mez o archivo de extensión. Las extensiones de Power Query se agrupan en un archivo ZIP y se les da la extensión de archivo .mez.

Las extensiones se definen en un documento de sección de 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 se importa desde Power Query suele requerir modificaciones para ajustarlo a un documento de sección, pero son cambios menores. Entre las diferencias de un documento de sección que debe tener en cuenta, se incluyen las siguientes:

  • Comienza con una declaración de sección (por ejemplo, section HelloWorld;).
  • Cada expresión termina con un punto y coma (por ejemplo, a = 1; o b = let c = 1 + 2 in c;).
  • Todas las funciones y variables son locales en el documento de sección, a menos que se marquen como compartidas. Las funciones compartidas se vuelven visibles para otras consultas o funciones, y se pueden considerar como exportaciones de la extensión (es decir, se pueden llamar desde Power Query).

Puede consultar más información sobre los documentos de sección de M en la especificación del lenguaje M.

Distribución de conectores de Power Query

Tiene dos rutas de acceso en las que puede distribuir el conector:

  • Autodistribución
  • Certificación de conector

Autodistribución

Un mecanismo de autoservicio en el que puede aplicar conectores personalizados de Power Query en experiencias de producto aplicables

Con el conector creado, puede enviar este archivo como desee a los usuarios y puede usar el conector en experiencias de producto aplicables, como Microsoft Power BI.

Microsoft Power BI

Puede usar su propio conector personalizado en Microsoft Power BI Desktop y el servicio Microsoft Power BI para modelos semánticos de actualización y conectividad en la nube.

Los conectores de Power Query se pueden cargar en tres experiencias:

  • Puerta de enlace de datos local: el conector se puede cargar a través de la puerta de enlace que se usará en Microsoft Fabric y Microsoft servicio Power BI
  • Power Query Online: en experiencias como Datamarts de Power BI, Fabric Dataflow Gen2 y muchos otros
  • Power Query Desktop: en experiencias como Power BI Desktop.

Puede obtener más información sobre cómo usar el conector personalizado para la distribución automática mediante los artículos siguientes:

Certificación de conector

El programa de certificación del conector de Data Factory le permite enviar el conector a Microsoft para su certificación, donde Microsoft se encarga de publicar y distribuir el conector tanto en Microsoft Fabric como en Microsoft Power BI para productos y experiencias aplicables:

  • Power Query Desktop: Microsoft Power BI Desktop.
  • Power Query Online: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 y otros
  • Puerta de enlace de datos local: para Microsoft Fabric y Microsoft Power BI que usan una puerta de enlace para la actualización autenticada o la conectividad.

Obtenga más información sobre el programa de certificación del conector de Data Factory.