Lettura da entità Microsoft Dynamics 365 CRM - AWS Glue
Dettagli dell'entità e del campo di Microsoft Dynamics 365 CRM

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lettura da entità Microsoft Dynamics 365 CRM

Prerequisiti

  • Un oggetto Microsoft Dynamics 365 CRM da cui si desidera leggere. È necessario il nome dell'oggetto, come contatti o account. Nella tabella seguente sono illustrate le entità supportate.

Entità supportate

Entità Può essere filtrato Supporta limite Supporta Ordina per Supporta Seleziona * Supporta Partizionamento
Entità dinamica Sì Sì Sì Sì Sì

Esempio 

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"
    }

Dettagli dell'entità e del campo di Microsoft Dynamics 365 CRM

Entità con metadati dinamici:

Microsoft Dynamics 365 CRM fornisce endpoint per recuperare i metadati in modo dinamico. Pertanto, per le entità dinamiche, il supporto dell'operatore viene acquisito a livello di tipo di dati.

Entità Tipo di dati Operatori supportati
Entità dinamica DateTime =, <, <=, >, >=, BETWEEN
Data =, <, <=, >, >=
Stringa =, !=
Double =, <, <=, >, >=
Numero intero =, <, <=, >, >=
Decimale =, <, <=, >, >=
Long =, <, <=, >, >=
BigInteger =, <, <=, >, >=
Elenco N/A
Struct N/A
Eseguire la mappatura N/A

Query di partizionamento

Microsoft Dynamics 365 CRM supporta solo il partizionamento basato sul campo.

Se desideri utilizzare la concorrenza in Spark, possono essere fornite le opzioni aggiuntive PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND e NUM_PARTITIONS. Con questi parametri, la query originale viene suddivisa in NUM_PARTITIONS query secondarie che possono essere eseguite contemporaneamente dalle attività Spark.

  • PARTITION_FIELD: il nome del campo da utilizzare per partizionare la query.

  • LOWER_BOUND: un valore limite inferiore inclusivo del campo di partizione scelto.

    Per Datetime, accettiamo il formato di timestamp Spark utilizzato nelle query SQL di Spark. Esempio di valori validi: "2024-01-30T06:47:51.000Z".

  • UPPER_BOUND: un valore limite superiore esclusivo del campo di partizione scelto.

  • NUM_PARTITIONS: numero di partizioni.

I dettagli di supporto del campo di partizionamento per entità sono riportati nella tabella di seguito:

Nome entità Campi di partizionamento DataType
Entità dinamica (entità standard) Campi dinamici DateTime su cui è possibile eseguire query createdon, modifiedon
Entità dinamica (entità personalizzata) createdon, modifiedon createdon, modifiedon

Esempio 

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"
    }