Lectura de entidades de Microsoft Dynamics 365 CRM

Requisitos previos

• Un objeto de Microsoft Dynamics 365 CRM desde el que desea leer. Necesitará el nombre del objeto, como contactos o cuentas. En la siguiente tabla se muestran las entidades admitidas.

Entidades compatibles

Entidad	Se puede filtrar	Admite límite	Admite Ordenar por	Admite Seleccionar *	Admite Partición
Entidad dinámica	Sí	Sí	Sí	Sí	Sí

Ejemplo

dynamics365_read = glueContext.create_dynamic_frame.from_options(
    connection_type="microsoftdynamics365crm",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "dynamic_entity",
        "API_VERSION": "v9.2",
        "INSTANCE_URL": "https://{tenantID}.api.crm.dynamics.com"
    }

Detalles de entidades y campos de Microsoft Dynamics 365 CRM

Entidades con metadatos dinámicos:

Microsoft Dynamics 365 CRM proporciona puntos de conexión para obtener metadatos de forma dinámica. Por lo tanto, para las entidades dinámicas, la compatibilidad del operador se captura según el tipo de datos.

Entidad	Tipo de datos	Operadores admitidos
Entidad dinámica	DateTime	=, >, >=, <, <=, BETWEEN
	Date	=, <, <=, >, >=
	Cadena	=, !=
	Doble	=, <, <=, >, >=
	Entero	=, <, <=, >, >=
	Decimal	=, <, <=, >, >=
	Largo	=, <, <=, >, >=
	BigInteger	=, <, <=, >, >=
	Enumeración	N/D
	Struct	N/D
	Asignación	N/D

Consultas de partición

Microsoft Dynamics 365 CRM solo admite la partición basada en campos.

Puede proporcionar las opciones adicionales de Spark PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND y NUM_PARTITIONS si quiere usar la simultaneidad en Spark. Con estos parámetros, la consulta original se dividiría en un número NUM_PARTITIONS de subconsultas que las tareas de Spark pueden ejecutar simultáneamente.

• PARTITION_FIELD: el nombre del campo que se usará para particionar la consulta.

• LOWER_BOUND: un valor de límite inferior inclusivo del campo de partición elegido.

  En DateTime, aceptamos el formato de marca de tiempo de Spark que se utiliza en las consultas de Spark SQL. Ejemplos de valores válidos: "2024-01-30T06:47:51.000Z".

• UPPER_BOUND: un valor límite superior exclusivo del campo de partición elegido.

• NUM_PARTITIONS: el número de particiones.

Los detalles de compatibilidad del campo de partición por entidad se muestran en la siguiente tabla:

Nombre de la entidad	Campos de partición	DataType
Entidad dinámica (entidad estándar)	Campos de DateTime dinámicos que se pueden consultar	createdon, modifiedon
Entidad dinámica (entidad personalizada)	createdon, modifiedon	createdon, modifiedon

Ejemplo

dynamics365_read = glueContext.create_dynamic_frame.from_options(
    connection_type="microsoftdynamics365crm",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "dynamic_entity",
        "API_VERSION": "v9.2",
        "instanceUrl": "https://{tenantID}.api.crm.dynamics.com"
        "PARTITION_FIELD": "createdon"
        "LOWER_BOUND": "2024-01-30T06:47:51.000Z"
        "UPPER_BOUND": "2024-06-30T06:47:51.000Z"
        "NUM_PARTITIONS": "10"
    }