Compartir a través de

Extensibilidad de los conectores en Power BI

Los conectores personalizados de Power BI amplían la conectividad para que pueda usar datos de cientos de orígenes. En este artículo se tratan las funcionalidades de extensibilidad del conector, los conectores certificados y no certificados, la configuración de seguridad y las opciones de firma para ayudarle a crear, implementar y usar conectores personalizados de forma segura en Power BI Desktop.

Power BI se conecta a datos a través de conectores existentes y orígenes genéricos como ODBC, OData, OLE DB, Web, CSV, XML y JSON. Los desarrolladores agregan nuevos orígenes mediante extensiones de datos personalizadas denominadas conectores personalizados. Microsoft certifica y distribuye algunos conectores personalizados como conectores certificados.

Sugerencia

¿Planea crear un conector? Comience con el SDK de Power Query para Visual Studio Code. Las mejoras tienen como destino este SDK, no la extensión heredada de Visual Studio.

Desarrollo de conectores personalizados (SDK de Power Query)

Use el SDK de Power Query en Visual Studio Code para crear, validar y empaquetar conectores personalizados:

  • Instale desde Visual Studio Marketplace: SDK de Power Query para Visual Studio Code.
  • Explore ejemplos y patrones avanzados en el repositorio de GitHub: microsoft/DataConnectors en GitHub.
  • Use el SDK para:
    • Creación y edición de archivos de origen .pq y .m con coloración de sintaxis y validación de esquemas
    • Compilación de un .mez paquete (agrupación de conectores comprimidos)
    • Ejecución de consultas de prueba mediante el ejecutor de consultas integrado
    • Validación de tablas de navegación, flujos de autenticación y tipos de origen de datos

Nota:

El SDK de Power Query heredado para Visual Studio está en modo de mantenimiento. Nuevas características, como la validación de esquemas mejorada, los flujos de autenticación actualizados y los diagnósticos mejorados, se presentan primero —o únicamente— en el SDK de VS Code.

Para usar un conector personalizado no certificados que desarrolle usted o otra persona, ajuste la configuración de seguridad de Power BI Desktop para permitir que las extensiones se carguen sin validación ni advertencia. Estas extensiones pueden omitir los niveles de privacidad y gestionar las credenciales, y pueden enviarlos a través de HTTP, por lo que habilite ésta configuración, solo cuando confíe completamente en los conectores personalizados.

Como alternativa, el desarrollador puede firmar el conector con un certificado y proporcionarle los detalles que necesita usar sin cambiar la configuración de seguridad. Para obtener más información, vea Conectores de terceros de confianza.

Conectores personalizados

Los conectores personalizados no certificados van desde APIs pequeñas críticas para el negocio hasta servicios grandes y específicos del sector que aún no tienen un conector de Microsoft. Los proveedores distribuyen muchos conectores. Si necesita un conector específico del sector o del negocio, póngase en contacto con el proveedor.

La configuración de seguridad predeterminada de la extensión de datos de Power BI Desktop es permitir que solo se carguen las extensiones de terceros certificadas por Microsoft y otras de confianza. Con esta configuración, si los conectores personalizados no certificados están en el sistema, el cuadro de diálogo Conectores no certificados aparece en el inicio y enumera los conectores que no se pueden cargar. Por ejemplo:

Captura de pantalla del cuadro de diálogo Conectores no certificados que muestra conectores personalizados bloqueados.

Si no necesita estos conectores en esta sesión, seleccione Aceptar para descartar el error.

Para evitar el error de conectores no certificados, cambie la configuración de seguridad extensiones de datos o quite los conectores no certificados de la carpeta Conectores personalizados .

Importante

Use solo un origen de datos de conector personalizado en modo DirectQuery. Varios orígenes de datos de conector personalizados no funcionan con DirectQuery.

Permitir conectores personalizados no certificados

Para usar un conector personalizado no certificado:

  1. Copie el archivo del conector (.pq, .pqx, .m, o .mez) en la carpeta de conectores personalizados con el ámbito de documentos de usuario.

    [Documents]\Microsoft Power BI Desktop\Custom Connectors

    Si la carpeta no existe, créela.

    Nota:

    Si su organización habilita la sincronización de OneDrive o el movimiento de carpetas conocidas, es posible que se redirija la ruta efectiva de los documentos. Por ejemplo: C:\Users\<user>\OneDrive - Fabrikam\Documents.

    No suponga %USERPROFILE%\Documents. Para buscar de forma confiable la carpeta correcta en PowerShell:

    [Environment]::GetFolderPath('MyDocuments')
Join-Path ([Environment]::GetFolderPath('MyDocuments')) 'Microsoft Power BI Desktop\Custom Connectors'

    Coloque los archivos del conector allí y reinicie Power BI Desktop.

  2. En Power BI Desktop, vaya a Opciones de archivo>y configuración>Opciones>seguridad para ajustar la configuración de seguridad de la extensión de datos.

  3. En Extensiones de datos, seleccione (no recomendado) Permitir que cualquier extensión se cargue sin validación o advertencia y, a continuación, seleccione Aceptar.

    Captura de pantalla de las opciones de seguridad de extensión de datos que muestran la configuración para permitir conectores personalizados no certificados.

  4. Reinicie Power BI Desktop.

Firmar conectores personalizados

Si usted firma un paquete mediante un .mez certificado de firma de código de confianza, los usuarios pueden cargar el conector sin habilitar la configuración de extensión de datos permitir cualquier extensión.

Un conector firmado correctamente desde un editor de confianza se carga bajo la configuración de seguridad recomendada. Los conectores sin firmar o autofirmados desencadenan el cuadro de diálogo no certificado a menos que la configuración permisiva esté habilitada.

Para más información sobre la firma de conectores, consulte Control de la firma de conectores de Power Query.

Para conocer los requisitos de confianza de certificados y los casos perimetrales (almacén raíz, cadenas intermedias, revocación), consulte Conectores de terceros de confianza.

Conectores certificados

Microsoft certifica un conjunto limitado de extensiones de datos personalizadas. Microsoft distribuye estos conectores, pero no es responsable de su rendimiento ni de su funcionalidad continua. El desarrollador de terceros mantiene y soporta el conector.

En Power BI Desktop, los conectores de terceros certificados aparecen en el cuadro de diálogo Obtener datos con conectores genéricos y comunes. No es necesario cambiar la configuración de seguridad para usar conectores certificados.

Solución de problemas de conectores personalizados

En la tabla siguiente se enumeran los problemas comunes que puede surgir al trabajar con conectores personalizados y se proporcionan instrucciones para resolverlos.

Síntoma Causa probable Resolución
El conector no aparece en Obtener datos Archivo en una carpeta incorrecta o bloqueada Compruebe la ruta de acceso mediante [Environment]::GetFolderPath('MyDocuments'). Abra las propiedades del archivo: seleccione el archivo y, a continuación, seleccione Propiedades. Seleccione Desbloquear si aparece. Reinicie Power BI Desktop.
El cuadro de diálogo "No certificado" aparece cada vez que se inicia. Conector sin firmar con el modo de seguridad recomendado habilitado Firme el conector o cambie Extensiones de datos al modo permisivo (solo si confía en el origen).
El aviso de seguridad nunca aparece Ya está habilitado el modo de confianza (firmado) o permisivo Compruebe la firma: abra las propiedades del archivo y, a continuación, seleccione la pestaña Firmas digitales.
Se produce un error en el conector de forma silenciosa Error de script M o desajuste del tipo de autenticación Active el seguimiento (Archivo > Opciones > Diagnóstico). Compruebe los registros en %LOCALAPPDATA%\Microsoft\Power BI Desktop\Traces.
Error de carga después de actualizar el conector Versión anterior almacenada en caché Reinicie Power BI Desktop. Borrar la memoria caché en Opciones > de Archivo > Carga de Datos si es necesario.
Error de conexión de DirectQuery con varios orígenes personalizados Escenario no admitido Use solo un conector personalizado con DirectQuery. Cambie los orígenes secundarios al modo de importación.
Bucles de diálogo de credenciales Tipo de autenticación no admitido o sección incorrecta Authentication Compruebe el valor de AuthenticationKind. Compárelo con ejemplos en el repositorio del SDK.

Sugerencia

Para obtener más diagnósticos, abra la carpeta más reciente del área de trabajo temporal de Analysis Services en %LOCALAPPDATA%\Microsoft\Power BI Desktop\AnalysisServicesWorkspaces\. Compruebe DataMashupTrace y los registros específicos del conector.

Contenido relacionado

  • Last updated on