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
<a name="microsoft-dynamics-365-reading-from-entities"></a>

 **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
<a name="microsoft-dynamics-365-entity-and-field-details"></a>

 **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.

<a name="microsoft-dynamics-365-metadata-table"></a>

- **Entità dinamica**
  - **Tipo di dati:** DateTime / **Operatori supportati:**  =, <, <=, >, >=, BETWEEN
  - **Tipo di dati:** Data / **Operatori supportati:**  =, <, <=, >, >=
  - **Tipo di dati:** Stringa / **Operatori supportati:**  =, \!=
  - **Tipo di dati:** Double / **Operatori supportati:**  =, <, <=, >, >=
  - **Tipo di dati:** Numero intero / **Operatori supportati:**  =, <, <=, >, >=
  - **Tipo di dati:** Decimale / **Operatori supportati:**  =, <, <=, >, >=
  - **Tipo di dati:** Long / **Operatori supportati:**  =, <, <=, >, >=
  - **Tipo di dati:** BigInteger / **Operatori supportati:**  =, <, <=, >, >=
  - **Tipo di dati:** List / **Operatori supportati:** N/A
  - **Tipo di dati:** Struct / **Operatori supportati:** N/A
  - **Tipo di dati:** Eseguire la mappatura / **Operatori supportati:** 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) |  DateTime Campi dinamici interrogabili | 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"
    }
```