Certificación del conector de Data Factory
Importante
Actualmente, el programa de certificación del conector está experimentando cambios y el registro de nuevas certificaciones del conector está en espera. Tenemos previsto reactivar este proceso de registro durante el primer trimestre del año natural 2025. Si tiene un conector certificado que desea actualizar, póngase en contacto con nuestro equipo en dataconnectors@microsoft.com para obtener instrucciones sobre cómo enviar una nueva versió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
- Datamart de Microsoft Power BI
- 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
Hoy puede aprovechar el SDK de Power Query para crear un conector que pueda certificarse a través del programa de certificación de conectores de Data Factory. Vaya a la introducción al SDK de Power Query para obtener más información sobre esta herramienta.
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 de código completo para una 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 de desarrollo de conectores personalizados de terceros, que son conocidos en el sector y que podrá contratar directamente, al margen 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 de forma directa para satisfacer la necesidad de un usuario o un escenario empresarial. Estos criterios se pueden cumplir mediante un programa de versión preliminar 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 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.
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.
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 archivoresources.resx
.
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?
- Es posible utilizar la función auxiliar de cumplimiento 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 deWeb.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()
y mucho más). - 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).
- Valide de dónde procede la expresión y de lo que es (es decir, puede construir dinámicamente llamadas a
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.