Configuración de la conexión de Dataverse

En este artículo se describen los pasos para crear una conexión de Dataverse.

Tipos de autenticación que se admiten

El conector de Dataverse admite los siguientes tipos de autenticación para la copia y Dataflow Gen2, respectivamente.

Tipo de autenticación Copiar Flujo de datos Gen2
Cuenta organizativa
Entidad de servicio

Configuración de la conexión para Dataflow Gen2

Puede conectar Dataflow Gen2 a Dataverse en Microsoft Fabric mediante conectores de Power Query. Siga estos pasos para crear la conexión:

  1. Compruebe las funcionalidades, las limitaciones y las consideraciones para asegurarse de que se admite el escenario.
  2. Complete los requisitos previos de Dataverse.
  3. Obtener datos en Fabric.
  4. Busque la dirección URL del entorno de Dataverse.
  5. Conéctese a Dataverse.

Capabilities

  • Dirección URL del servidor
  • Import
  • DirectQuery (modelos semánticos de Power BI)
  • Opciones avanzadas
    • Incluir columnas de datos de relación

Prerrequisitos

Debe tener un entorno de Dataverse.

Debe tener permisos de lectura para acceder a los datos de las tablas.

Para usar el conector de Dataverse, debe tener habilitada la opción Punto de conexión TDS en su entorno. Más información: Administración de la configuración de características y Solución de problemas de conexión mediante SQL para consultar datos

Para usar el conector de Dataverse, uno de los puertos TCP 1433 o 5558 debe estar abierto para la conexión. Automáticamente se usa el puerto 1433. Sin embargo, si el puerto 1433 está bloqueado, puede usar el puerto 5558 en su lugar. Para habilitar el puerto 5558, debe agregar ese número de puerto a la dirección URL del entorno de Dataverse; por ejemplo, idDeSuEntorno.crm.dynamics.com,5558. Más información: SQL Server problema de conexión debido a puertos cerrados

Nota:

Si usa Power BI Desktop y necesita usar el puerto 5558, debe crear un origen con la dirección URL del entorno de Dataverse, como yourenvironmentid.crm.dynamics.com,5558, en Power Query M. Más información: Encontrar la dirección URL del entorno de Dataverse

Obtención de datos

Para obtener datos en Data Factory:

  1. En el lado izquierdo de Data Factory, seleccione Áreas de trabajo.

  2. En el área de trabajo de Data Factory, seleccione Nuevo>Dataflow Gen2 para crear un nuevo flujo de datos.

    Captura de pantalla que muestra el área de trabajo donde decide crear un nuevo flujo de datos.

  3. En Power Query, seleccione Obtener datos en la cinta de opciones o seleccione Obtener datos de otro origen en la vista actual.

    Captura de pantalla que muestra el área de trabajo de Power Query con la opción Obtener datos resaltada.

  4. En la página Elegir origen de datos, use Buscar para buscar el nombre del conector o seleccione Ver más a la derecha junto al conector para ver una lista de todos los conectores disponibles en el servicio Power BI.

    Captura de pantalla de la página Seleccionar origen de datos de Data Factory con el cuadro de búsqueda y la selección para ver más resaltada.

  5. Si decide ver más conectores, puede seguir usando Buscar para buscar el nombre del conector o elegir una categoría para ver una lista de conectores asociados a esa categoría.

    Captura de pantalla de la página de Data Factory para elegir el origen de datos que se muestra al seleccionar ver más, con la lista de conectores.

Búsqueda de la dirección URL del entorno de Dataverse

Si necesita usar el puerto 5558 para conectarse a Dataverse, tiene que buscar la dirección URL del entorno de Dataverse. Abra Power Apps. En la esquina superior derecha de la página de Power Apps, seleccione el entorno al que se va a conectar. Seleccione el icono de Configuración y, a continuación, seleccione Configuración avanzada.

En la nueva pestaña del explorador que se abre, copie la raíz de la dirección URL. Esta URL raíz es la dirección URL única de su entorno. La dirección URL tiene el formato https://<idDeSuEntorno>.crm.dynamics.com/. Asegúrese de quitar https:// y la barra final de la dirección URL antes de pegarla para conectarse al entorno. Anexe el puerto 5558 al final de la dirección URL del entorno; por ejemplo, idDeSuEntorno.crm.dyamics.com,5558.

Ubicación de la dirección URL del entorno de Dataverse.

Conectar con Dataverse

Para conectarse a Dataverse desde Power Query Online:

  1. Seleccione la opción Dataverse en la página Elegir origen de datos. Más información: Dónde obtener datos

  2. En la página Conectarse a un origen de datos, deje en blanco la dirección URL del servidor. Si deja en blanco la dirección, se muestran todos los entornos disponibles a los que tiene permiso para acceder en la ventana Navegador de Power Query.

    Captura de pantalla de

    Nota:

    Si necesita usar el puerto 5558 para acceder a los datos, deberá cargar un entorno específico con el puerto 5558 anexado al final de la dirección URL del servidor. En este caso, vaya a Búsqueda de la dirección URL del entorno de Dataverse para obtener instrucciones sobre cómo obtener la dirección URL correcta del servidor.

  3. Si es necesario, especifique una puerta de enlace de datos local si va a usar datos del entorno local. Por ejemplo, si va a combinar datos de Dataverse y una base de datos de SQL Server local.

  4. Inicia sesión en tu cuenta organizacional.

  5. Cuando haya iniciado sesión correctamente, seleccione Siguiente.

  6. En la página de navegación, seleccione los datos que necesita y, a continuación, seleccione Transformar datos.

    Captura de pantalla de la página de navegación abierta con los datos de usuario de la aplicación seleccionados.

Limitaciones y consideraciones

Específico del host de Excel

El conector de Power Query Dataverse dentro de Excel no admite actualmente clústeres de nube soberana (por ejemplo, China, Alemania, EE. UU.).

Límites de rendimiento y restricciones de Dataverse

Para obtener información sobre los límites de rendimiento y las restricciones de las conexiones a Dataverse, vaya a Límites y asignaciones de solicitudes. Estas limitaciones se aplican tanto al conector de Dataverse como al conector de fuente OData cuando se accede al mismo punto de conexión.

Velocidad de recuperación de tablas

Como norma, la mayoría de las tablas predeterminadas se recuperan a una velocidad aproximada de 500 filas por segundo con el conector de Dataverse. Tenga en cuenta esta velocidad al decidir si desea conectarse a Dataverse o exportar a Data Lake. Si necesita velocidades de recuperación más rápidas, considere la posibilidad de usar la función Exportar a un lago de datos o el endpoint de Tabular Data Stream (TDS). Para obtener más información, vaya a Conexiones a Dataverse alternativas.

Conexiones alternativas de Dataverse

Hay varias formas alternativas de extraer y migrar datos de Dataverse:

Nota:

Tanto el conector de Dataverse como las API de OData están diseñados para escenarios analíticos en los que los volúmenes de datos son relativamente pequeños. El enfoque recomendado para la extracción masiva de datos es "Azure Synapse Link".

SQL Server problema de conexión debido a puertos cerrados

Al conectarse con el conector de Dataverse, es posible que encuentre un error Unable para conectarse que indica que se produjo un error específico de una red o instancia al establecer una conexión a SQL Server. Es probable que este error se deba a que los puertos TCP 1433 o 5558 estaban bloqueados durante la conexión. Para solucionar el error de puertos bloqueados, vaya a Puertos bloqueados.

Uso de consultas de base de datos nativas con Dataverse

Puede conectarse a Dataverse usando una instrucción SQL personalizada o una consulta de base de datos nativa. Aunque no hay ninguna interfaz de usuario para esta experiencia, puede escribir la consulta mediante el Power Query Advanced Editor. Para usar una consulta de base de datos nativa, debe especificar Base de datos como origen.

Source = CommonDataService.Database([DATABASE URL])

Una vez definido el origen de base de datos, puede especificar una consulta nativa con la función Value.NativeQuery.

myQuery = Value.NativeQuery(Source, [QUERY], null, [EnableFolding=true])

En conjunto, la consulta tiene el siguiente aspecto:

let
    Source = CommonDataService.Database("[DATABASE]"),
    myQuery = Value.NativeQuery(Source, "[QUERY]", null, [EnableFolding=true])
in
    myQuery

Un nombre de columna mal escrito podría ocasionar un mensaje de error relacionado con el plegado de consultas en lugar de un mensaje indicando que falta una columna.

Acceso a grandes cantidades de datos de Dataverse

Las consultas en tablas de Dataverse pueden devolver grandes cantidades de datos. Si usa el conector de Power Query Dataverse, cualquier consulta específica que tenga acceso al modelo tiene un tiempo de espera fijo de cinco (5) minutos independientemente del tamaño de los datos. Para más información, consulte las limitaciones. Por tanto, es posible que tenga que consultar los datos varias veces para acceder a todos los datos del modelo. El uso de varias consultas puede tardar una cantidad considerable de tiempo en devolver todos los datos.

Si está utilizando el conector Common Data Service (Legacy), puede emplear una única consulta para acceder a todos los datos. Este conector funciona de forma diferente y devuelve el resultado en "páginas" de 5.000 registros. Aunque el conector de Common Data Service (Legacy) es más eficaz para devolver grandes cantidades de datos, aún puede llevar bastante tiempo devolver el resultado.

En lugar de usar estos conectores para acceder a grandes cantidades de datos de Dataverse, se recomienda usar Azure Synapse Link para acceder a modelos grandes. El uso de Azure Synapse Link es incluso más eficiente que los conectores de Power Query Dataverse o Common Data Service (Legacy) y está diseñado específicamente para escenarios de integración de datos.

Los errores de vista previa pueden producirse debido a una limitación conocida cuando la característica Propiedades de navegación está habilitada en Dataverse.

Puede ver un mensaje como este, por ejemplo: Preview.Error: The type of the current preview value is too complex to display.

Para resolver este problema, similar al conector de SQL Server, hay una opción disponible para deshabilitar las propiedades de navegación (columnas de relación) en el conector de Dataverse para mejorar el rendimiento. Esta opción se puede establecer en las opciones vanced disponibles en Power Query Online, o bien se puede establecer mediante el parámetro CreateNavigationProperties=false en la función del conector de Dataverse.

 Source = CommonDataService.Database("{crminstance}.crm.dynamics.com",[CreateNavigationProperties=false]),