Configuración de Dataverse en una actividad de copia

En este artículo se describe cómo usar la actividad de copia en una canalización para copiar datos desde y hacia Dataverse.

Prerrequisitos

Para usar este conector con la autenticación de entidad de servicio de Microsoft Entra, debe configurar la autenticación de servidor a servidor (S2S) en Dataverse. En primer lugar, registre el usuario de la aplicación (entidad de servicio) en Microsoft Entra. Para obtener más información, consulte Creación de una aplicación y una entidad de servicio de Microsoft Entra que pueden acceder a los recursos.

Durante el registro de la aplicación, deberá crear ese usuario en Dataverse y conceder permisos. Esos permisos se pueden conceder directa o indirectamente agregando el usuario de la aplicación a un equipo al que se han concedido permisos en Dataverse. Para obtener más información sobre cómo configurar un usuario de aplicación para autenticarse con Dataverse, consulte Uso de la autenticación de servidor a servidor de un solo inquilino.

Configuración admitida

Para la configuración de cada pestaña en la actividad de copia, vaya a las secciones siguientes respectivamente.

• General
• Fuente
• Destino
• Cartografía
• Settings

General

En Configuración de pestaña General, vaya a Configuración general.

Fuente

Vaya a la pestaña Origen para configurar el origen de la actividad de copia. Consulte el siguiente contenido para obtener la configuración detallada.

Las siguientes propiedades son obligatorias:

• Conexión: seleccione una conexión de Dataverse existente en la lista de conexiones. Si no existe ninguna conexión, cree una nueva conexión de Dataverse seleccionando Nuevo.
• Tipo de conexión: seleccione Dataverse.
• Usar consulta: especifique la manera en que se usan para leer datos. Puede elegir Nombre de la entidad para leer datos usando el nombre de la entidad o Consulta para leer los datos.

  • Nombre de entidad: seleccione el nombre de la entidad en la lista desplegable o seleccione Editar para escribirlo manualmente. Es el nombre lógico de la entidad que se va a recuperar.

  • Consulta: uso de FetchXML para leer datos de Dataverse. FetchXML es un lenguaje de consulta propietario que se usa en Dynamics online y en el entorno local. Consulte el ejemplo siguiente. Para más información, consulte Compilación de consultas con FetchXML.

    Consulta FetchXML de ejemplo:

    <fetch>
      <entity name="account">
        <attribute name="accountid" />
        <attribute name="name" />
        <attribute name="marketingonly" />
        <attribute name="modifiedon" />
        <order attribute="modifiedon" descending="false" />
        <filter type="and">
          <condition attribute ="modifiedon" operator="between">
            <value>2017-03-10 18:40:00z</value>
            <value>2017-03-12 20:40:00z</value>
          </condition>
        </filter>
      </entity>
    </fetch>
    

En Avanzado, puede especificar los campos siguientes:

• Columnas adicionales: agregue columnas de datos adicionales para almacenar la ruta de acceso relativa o el valor estático de los archivos de origen. La expresión se admite para este último. Para obtener más información, vaya a Agregar columnas adicionales durante la copia.

Destino

Vaya a la pestaña Destino para configurar el destino de la actividad de copia. Consulte el siguiente contenido para obtener la configuración detallada.

Las siguientes propiedades son obligatorias:

• Conexión: seleccione una conexión de Dataverse existente en la lista de conexiones. Si no existe ninguna conexión, cree una nueva conexión de Dataverse seleccionando Nuevo.
• Tipo de conexión: seleccione Dataverse.
• Nombre de entidad: especifique el nombre de la entidad para escribir datos. Seleccione el nombre de la entidad en la lista desplegable o seleccione Editar para escribirlo manualmente. Este es el nombre lógico de la entidad que se va a recuperar.

En Avanzado, puede especificar los campos siguientes:

• Comportamiento de escritura: el comportamiento de escritura de la operación. Esta propiedad es necesaria y debe seleccionar Upsert. Si usa Agregar contenido dinámico, especifique el valor en Upsert.
• Nombre de clave alternativo: especifique el nombre de clave alternativo que ha sido definido en su entidad para insertar o actualizar registros.
• Omitir valores NULL: indica si se omitirán los valores NULL de los datos de entrada durante la operación de escritura. Está seleccionado de forma predeterminada.
  • Cuando se selecciona: deje los datos en el objeto de destino sin cambios al realizar la operación upsert/update e inserte el valor predeterminado definido al realizar la operación de inserción.
  • Cuando no está seleccionado: actualice los datos del objeto de destino a NULL al realizar la operación upsert/update e inserte el valor NULL al realizar la operación de inserción.
• Escribir tamaño del lote: especifique el recuento de filas de los datos escritos en Dataverse en cada lote.
• Máximo de conexiones simultáneas: límite superior de conexiones simultáneas establecidas con el almacén de datos durante la ejecución de la actividad. Especifique un valor solo cuando quiera limitar las conexiones simultáneas.

Cartografía

En la configuración de la pestaña Asignación, vaya a Configurar sus asignaciones en la pestaña de asignación. Si elige Binario como formato de archivo, la asignación no será compatible.

Configuración

Para la configuración de la pestaña Configuración , vaya a Configuración de otras opciones en la pestaña Configuración.

Resumen de tabla

Consulte la tabla siguiente para obtener el resumen y más información sobre la actividad de copia de Dataverse.

Información de origen

Información de destino

Contenido relacionado

• Introducción al conector de Dataverse