Ejemplo de operaciones paralelas de API web con componentes de flujo de datos TPL (C#)

En este ejemplo de .NET 6.0 se muestra cómo realizar operaciones de datos paralelas mediante la API web de Dataverse con componentes de flujo de datos de biblioteca paralela de tareas (TPL). Más información: Flujo de datos (biblioteca paralela de tareas).

Esta muestra utiliza el código auxiliar común de la biblioteca de clases WebAPIService (C#).

Requisitos previos

• Microsoft Visual Studio 2022.
• Acceso a Dataverse con privilegios para realizar operaciones de datos.

Cómo ejecutar esta muestra

1. Clonar o descargar el repositorio de ejemplos de PowerApps.

2. Localizar la carpeta /dataverse/webapi/C#-NETx/TPLDataFlowParallelOperations/.

3. Abra el archivo TPLDataFlowParallelOperations.sln mediante Visual Studio 2022

4. Editar el archivo para establecer los siguientes valores de propiedad:

   Propiedad	Instrucciones
   Url	La URL de su entorno. Reemplace el valor del marcador de posición con el valor para su entorno. Consulte los recursos para desarrolladores para encontrar la URL de su entorno.
   UserPrincipalName	Reemplazar el valor de marcador de posición con el valor de UPN que usa para acceder al entorno.
   Password	Reemplace el valor del marcador de posición con la contraseña que utiliza.

5. Guarde el archivo

6. Presione F5 para ejecutar el ejemplo.

Código

El código para este ejemplo está aquí: PowerApps-Samples/dataverse/webapi/C#-NETx/TPLDataFlowParallelOperations/Program.cs

Demostraciones

Esta muestra incluye configuraciones que puede aplicar para optimizar su conexión.

Esta muestra primero envía una solicitud simplemente para acceder al valor del encabezado de respuesta para determinar los grados recomendados de paralelismo para este entorno. Cuando el grado máximo de paralelismo se establece igual al valor del encabezado de respuesta, debe lograr un estado estable en el que el rendimiento se optimice con un mínimo de errores de límite de protección de servicio devueltos.

Para alcanzar los límites de protección del servicio con este ejemplo, debe aumentar la variable a más de 10.000 o lo necesario para que el ejemplo funcione durante más de 5 minutos. También debe cambiar el código para configurar el valor del encabezado de respuesta a uno que sea significativamente mayor. Luego, al usar Fiddler, debería poder observar cómo WebAPIService vuelve a intentar las solicitudes que devuelven este error.

Esta muestra simplemente crea un número configurable de registros de cuenta, que después eliminará. Este ejemplo utiliza componentes de flujo de datos para procesar los registros y transformar los resultados de la operación de creación en la siguiente fase que elimina estos registros. Debido a la naturaleza de este flujo de datos, las operaciones de eliminación de registros creados anteriormente comenzarán antes de que finalicen todos los registros a crear.

Es posible que desee comparar este ejemplo con el Ejemplo de operaciones paralelas de API web CDSWebApiService (C#).

Limpiar

De forma predeterminada, esta muestra elimina todos los registros creados en ella. Si desea ver los registros creados después de completar la muestra, cambie la variable a y se le pedirá que decida si desea eliminar los registros.

Consulte también

Usar la API web de Dataverse
Biblioteca de clases WebAPIService (C#)
Crear una fila de tabla usando la API web
Actualizar y eliminar filas de tablas usando la API web
Límites de la API de protección de servicio
Ejemplos de la API web
Ejemplo de operaciones básicas de la API web (C#)
Ejemplo de datos de consulta de API web (C#)
Ejemplo de operaciones condicionales de la API web (C#)
Ejemplo de funciones y acciones de la API web (C#)
Ejemplo de operaciones de esquema de tabla de API web (C#)
Ejemplo de operaciones en paralelo de la API web WebApiService (C#)