Compartir a través de

Certificación del conector de Data Factory

  • Artículo

Nota:

En este artículo se describen los requisitos y el proceso para enviar un conector de Data Factory para la certificación. Lea detenidamente el artículo completo antes de iniciar el proceso de certificación.

Es posible que los propietarios de orígenes de datos que desarrollan un conector personalizado para su origen de datos quieran distribuir su conector personalizado de forma más amplia a los usuarios de Data Factory. Una vez creado, utilizado y validado por los usuarios finales un conector personalizado, el propietario del origen de datos puede enviarlo para la certificación de Microsoft.

La certificación de un conector de Data Factory hace que el conector esté disponible públicamente, de fábrica, Microsoft Fabric Data Factory y Microsoft Power BI en las siguientes experiencias:

  • Flujo de datos de Microsoft Fabric Gen2
  • Flujo de datos de Microsoft Power BI Gen1
  • Microsoft Power BI Datamart
  • Modelo semántico de Microsoft Power BI (en el servicio Power BI)
  • Microsoft Power BI Desktop
  • Puerta de enlace de datos local para Microsoft Fabric y Microsoft Power BI

Los conectores certificados:

  • Son mantenidos por el desarrollador del partner

  • Son compatibles con el desarrollador del partner

  • Están certificados por Microsoft

  • Son distribuidos por Microsoft

Trabajamos con asociados para intentar asegurarse de que tienen soporte técnico en mantenimiento, pero los problemas del cliente con el propio conector se dirigen al desarrollador del asociado.

Nota:

En la actualidad, puede aprovechar el SDK de Power Query para crear un conector que se pueda certificar mediante el programa de certificación del conector de Data Factory. Vaya a la introducción al SDK de Power Query para obtener más información sobre esta herramienta.

Información general sobre certificaciones

Requisitos previos

Para garantizar la mejor experiencia para los clientes, solo se tendrán en cuenta los conectores que cumplan un conjunto de requisitos previos para la certificación:

  • El conector debe ser para un producto público.

  • El conector debe considerarse código completo para una versión de versión inicial. El programa permite iteraciones y actualizaciones frecuentes. Microsoft no ofrece asistencia técnica ni consultoría de desarrollo de conectores personalizados. Se recomienda utilizar los recursos públicos, como la documentación de SDK y el repositorio de ejemplos. Si necesita más ayuda, podemos compartir una lista de consultores conocidos de desarrollo de conectores personalizados del sector de terceros que puede querer interactuar directamente, aparte de cualquier programa o asociación de Microsoft. Microsoft no está afiliado a ninguno de estos consultores y no es responsable del uso de sus servicios. Microsoft proporciona la lista para comodidad del cliente y sin garantías ni recomendaciones. Para obtener más información, póngase en contacto con el contacto de certificación de Microsoft.

  • El desarrollador debe proporcionar una estimación para el uso actual y futuro.

  • El conector ya debe estar disponible para los clientes directamente para satisfacer la necesidad de un usuario o un escenario empresarial. Este criterio se puede cumplir mediante un programa de versión preliminar privada mediante la distribución del conector completado directamente a los usuarios finales y a las organizaciones. Se recomienda que los desarrolladores de conectores usen un mecanismo de distribución automática y ejecuten pruebas internas de sus propios conectores para iterar sobre sus conectores en un grupo controlado. Cada usuario u organización debe ser capaz de brindar comentarios y validar la existencia de una necesidad empresarial del conector y que este funcione correctamente para cumplir los requisitos empresariales.

  • El conector debe funcionar correctamente en un nivel previsto de uso por parte de los clientes.

  • Debe haber un subproceso en el foro de Ideas de Fabric impulsado por los clientes para indicar la demanda de hacer que el conector esté disponible públicamente en Data Factory o Power BI. No hay ningún umbral establecido de involucración. No obstante, a mayor involucración, más fuerte será la petición evidenciada del conector.

Estos requisitos previos existen para asegurarse de que los conectores sometidos a la certificación tienen un cliente y una empresa importantes que deben usarse y admitirse después de la certificación.

Procesos y escalas de tiempo

Los conectores certificados se lanzan con las versiones mensuales de Power BI Desktop, por lo que los plazos para cada versión se remontan a la fecha del lanzamiento de Power BI Desktop. La duración esperada del proceso de certificación desde el registro hasta el lanzamiento varía en función de la calidad y la complejidad del envío del conector. Microsoft no proporciona ninguna garantía de escala de tiempo específica con respecto a las revisiones y aprobaciones del conector. Las fechas límite para cada revisión del conector se describen en los pasos a continuación, pero Microsoft no garantiza el cumplimiento de dichas escalas de tiempo.

  • Registro: notificación de intención de certificar el conector personalizado. Este registro debe producirse el día 15 del mes, dos meses antes del lanzamiento de Power BI Desktop.

    • Por ejemplo, para la versión de abril de Power BI Desktop, la fecha límite sería el 15 de febrero.

  • Envío: envío de archivos de conector para revisión de Microsoft. El envío debe producirse el primer día del mes antes del lanzamiento de Power BI Desktop.

    • Por ejemplo, para la versión de abril de Power BI Desktop, la fecha límite sería el 1 de marzo.

  • Revisión técnica: finalización de los archivos del conector, posterior a la revisión y la certificación de Microsoft. La revisión debe producirse hasta el día 15 del mes antes del lanzamiento de Power BI Desktop.

    • Por ejemplo, para la versión de abril de Power BI Desktop, la fecha límite sería el 15 de marzo.

Debido a la complejidad de las revisiones técnicas y posibles retrasos, rediseño y problemas con las pruebas, se recomienda enviar con una antelación de largo plazo para la versión inicial y la certificación.

Requisitos de certificación

Tenemos un conjunto de requisitos establecidos para la certificación. Reconocemos que no todos los desarrolladores pueden cumplir dichos requisitos y esperamos introducir en breve un conjunto de características que controle las necesidades del desarrollador.

Archivos de envío (artefactos)

Asegúrese de que los siguientes archivos de conector se incluyen en el envío:

  • Archivo (.mez) de conector

    • El archivo .mez debe seguir los criterios de estilo y tener un nombre similar a aquel del producto o servicio. No debe incluir palabras como "Fabric", "Power BI", "Connector" o "API".
    • Asigne al archivo .mez el nombre: ProductName.mez

  • Archivo de Power BI Desktop (.pbix) para pruebas

    • Es necesario un informe de Power BI de ejemplo (.pbix) con el que probar el conector.
    • El informe debe incluir al menos una consulta para probar cada elemento de la tabla de navegación.
    • Si no hay ningún esquema establecido (por ejemplo, bases de datos), el informe debe incluir una consulta para cada "tipo" de tabla que el conector pueda controlar.

  • Prueba de la cuenta en el origen de datos

    • Se utilizará la cuenta de prueba para probar y solucionar problemas del conector.
    • Proporcione una cuenta de prueba que sea persistente, a fin de que podamos utilizarla para certificar las actualizaciones futuras.

  • Instrucciones de prueba

    • Proporcione cualquier documentación sobre el uso del conector y pruebe la funcionalidad del mismo.

  • Vínculos a dependencias externas (por ejemplo, controladores ODBC)

Características y estilo

El conector debe seguir un conjunto de reglas de características y estilo para cumplir unos criterios de facilidad de uso coherentes con otros conectores certificados.

  • El conector DEBE:

    • Utilizar el formato del documento de sección.
    • Incluir un encabezado o elemento gráfico de versión encima del documento de sección.
    • Ofrecer metadatos de documentación de funciones.
    • Tener controlador de TestConnection.
    • Seguir las convenciones de nomenclatura (por ejemplo, DataSourceKind.FunctionName). No debe incluir palabras como "Fabric", "Power BI", "Connector" o "API".
    • Devuelve datos en formato tabular, organizados en tablas con columnas, como para un origen de datos relacional. No se admiten formatos multidimensionales basados en cubos, dimensiones y medidas.
    • Se comporta igual en el modo Importar y DirectQuery, devolviendo resultados idénticos.
    • Tener la marca Beta configurada en True en la versión inicial.

  • El FunctionName debe tener sentido para el dominio (por ejemplo, "Contenido", "Tablas", "Documento", "Bases de datos", etc.).

  • El conector DEBE:

    • Tener iconos.
    • Ofrecer una tabla de navegación.
    • Colocar las cadenas en un archivo resources.resx. Las direcciones URL y los valores deben codificarse en el código del conector y no se deben colocar en el archivo resources.resx.

Seguridad

Existen consideraciones de seguridad específicas que el conector debe controlar.

  • Si se utiliza Extension.CurrentCredentials():

    • ¿Es necesario el uso? Si es así, ¿hacia dónde se envían las credenciales?
    • ¿Se garantiza que las solicitudes se realicen a través de HTTPS?
    • Si las credenciales se envían mediante Web.Contents() a través de GET:
      • ¿Se puede convertir en un POST?
      • Si es necesario GET, el conector DEBE utilizar el registro CredentialQueryString en el registro de opciones de Web.Contents() para pasar credenciales confidenciales.

  • Si se utilizan funciones Diagnostics.*:

    • Valide lo que se rastrea; los datos no deben contener PII ni grandes cantidades de datos innecesarios.
    • Si se implementó un seguimiento significativo en el desarrollo, se debe implementar una variable o una marca de característica que determine si el seguimiento debe activarse. Este seguimiento debe estar desconectado antes del envío para la certificación.

  • Si se utiliza Expression.Evaluate():

    • Valide de dónde procede la expresión y de lo que es (es decir, puede construir dinámicamente llamadas a Extension.CurrentCredentials(), etc.).
    • El Expression no debe facilitarlo el usuario ni tomar la entrada de usuario.
    • El Expression no debe ser dinámico (es decir, recuperado de una llamada web).

Registro para certificación

Si está interesado en realizar la certificación del conector personalizado, asegúrese de que el escenario y el conector cumplan los prerrequisitos y requisitos que se detallan en este artículo. Si no lo hace, se producirán retrasos en la certificación, ya que nuestro equipo le solicita que corrija los problemas o incoherencias antes de avanzar con la certificación.

Asegúrese de que el conector está completo y que se ha probado en la creación en Power BI Desktop y en la actualización y el consumo en servicio Power BI. Asegúrese de haber probado la actualización completa en el servicio Power BI a través del uso de una puerta de enlace de datos local.

Para empezar, rellene nuestro formulario de registro y un contacto de Microsoft se pondrá en contacto para comenzar el proceso.

Después de la certificación

Una vez certificado y liberado el conector a través de las experiencias de Microsoft Fabric y Microsoft Power BI, hay algunas cosas que debe hacer para asegurarse de que puede usar correctamente el conector certificado disponible públicamente implementado por producción.

  • Usted y los usuarios finales deben usar la versión del conector certificado incluida en entornos anteriores a la certificación (como Power BI Desktop y Data Gateway) y quitar los archivos .mez o .pqx existentes (conectores personalizados) usados antes de la certificación. Si no lo hace, es posible que Power Query use accidentalmente el conector personalizado de prueba en lugar del conector recién certificado.
  • Los conectores personalizados solo se deben usar para probar las nuevas versiones del conector.
  • Al trabajar con los usuarios finales y los clientes, asegúrese de que comprenden que la versión del conector personalizada que se usa en las pruebas anteriores a la certificación debe eliminarse una vez completada la prueba y la nueva versión del conector certificado está disponible.