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 HubSpot entità
**Prerequisito**
Un HubSpot oggetto da cui vorresti leggere. È necessario il nome dell'oggetto, come contatto o attività. Nella tabella seguente sono illustrate le entità supportate per la fonte di sincronizzazione.
## Entità supportate per la fonte di sincronizzazione
| Entità | Versione API | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento |
| --- | --- | --- | --- | --- | --- | --- |
| Campagne | v1 | No | Sì | No | Sì | No |
| Aziende | v3 | Sì | Sì | Sì | Sì | Sì |
| Contatti | v3 | Sì | Sì | Sì | Sì | Sì |
| Elenchi di contatti | v1 | No | Sì | No | Sì | No |
| Offerte | v3 | Sì | Sì | Sì | Sì | Sì |
| Pipeline CRM (Pipeline delle offerte) | v1 | No | No | No | Sì | No |
| Eventi e-mail | v1 | No | Sì | No | Sì | No |
| Chiamate | v3 | Sì | Sì | Sì | Sì | Sì |
| Note | v3 | Sì | Sì | Sì | Sì | Sì |
| E-mail | v3 | Sì | Sì | Sì | Sì | Sì |
| Riunioni | v3 | Sì | Sì | Sì | Sì | Sì |
| Processi | v3 | Sì | Sì | Sì | Sì | Sì |
| Posta elettronica | v3 | Sì | Sì | Sì | Sì | Sì |
| Oggetti personalizzati | v3 | Sì | Sì | Sì | Sì | Sì |
| Moduli | v2 | No | No | No | Sì | No |
| Proprietari | v3 | No | Sì | No | Sì | No |
| Prodotti | v3 | Sì | Sì | Sì | Sì | Sì |
| Ticket | v3 | Sì | Sì | Sì | Sì | Sì |
| Flussi di lavoro | v3 | No | No | No | Sì | No |
| Associations | v4 | Sì | No | No | Sì | No |
| Etichette associazioni | v4 | No | No | No | Sì | No |
**Esempio**:
```
hubspot_read = glueContext.create_dynamic_frame.from_options(
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "contact",
"API_VERSION": "v3"
}
```
## Entità supportate come origine asincrona
| Entità | Versione API | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento |
| --- | --- | --- | --- | --- | --- | --- |
| Aziende | v3 | Sì | No | Sì | Sì | No |
| Contatti | v3 | Sì | No | Sì | Sì | No |
| Offerte | v3 | Sì | No | Sì | Sì | No |
| Chiamate | v3 | Sì | No | Sì | Sì | No |
| Note | v3 | Sì | No | Sì | Sì | No |
| E-mail | v3 | Sì | No | Sì | Sì | No |
| Riunioni | v3 | Sì | No | Sì | Sì | No |
| Processi | v3 | Sì | No | Sì | Sì | No |
| Posta elettronica | v3 | Sì | No | Sì | Sì | No |
| Oggetti personalizzati | v3 | Sì | No | Sì | Sì | No |
| Prodotti | v3 | Sì | No | Sì | Sì | No |
| Ticket | v3 | Sì | No | Sì | Sì | No |
**Esempio**:
```
hubspot_read = glueContext.create_dynamic_frame.from_options(
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "contact",
"API_VERSION": "v3",
"TRANSFER_MODE": "ASYNC"
}
```
**HubSpot dettagli dell'entità e del campo**:
**HubSpot API v4:**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/hubspot-reading-from-entities.html)
**Nota**
Per l'`Associations`oggetto, per recuperare le associazioni tra due oggetti, è necessario fornire il 'from Id' (l'ID del primo oggetto) tramite un filtro obbligatorio durante la creazione di un lavoro. AWS Glue Se si desidera recuperare associazioni multiple da IDs in quel caso, è necessario fornire più IDs associazioni nella clausola. `where` Ad esempio: `Associations` per recuperare i contatti IDs «1» e «151», è necessario fornire un filtro come. `where id=1 AND id=151`
**HubSpot API v3:**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/hubspot-reading-from-entities.html)
Per le seguenti entità, HubSpot fornisce endpoint per recuperare i metadati in modo dinamico, in modo che il supporto dell'operatore venga acquisito a livello di tipo di dati per ciascuna entità.
**Nota**
`DML_STATUS` è un campo virtuale aggiunto a ogni record al runtime per determinarne lo stato (CREATO/AGGIORNATO) in modalità sincrona. L'operatore `CONTAINS/LIKE` non è supportato nella modalità asincrona.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v2:**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v1:**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/hubspot-reading-from-entities.html)
## Query di partizionamento
Puoi fornire le opzioni Spark aggiuntive `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` e `NUM_PARTITIONS` se desideri utilizzare la concorrenza in Spark. 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 il DateTime campo, accettiamo il valore in formato ISO.
Esempi di valori validi:
```
“2024-01-01T10:00:00.115Z"
```
+ `UPPER_BOUND`: un valore limite superiore **esclusivo** del campo di partizione scelto.
+ `NUM_PARTITIONS`: il numero di partizioni.
Nella seguente tabella sono descritti i dettagli del campo di supporto del partizionamento delle entità:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/hubspot-reading-from-entities.html)
Esempio:
```
hubspot_read = glueContext.create_dynamic_frame.from_options(
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "company",
"API_VERSION": "v3",
"PARTITION_FIELD": "hs_object_id"
"LOWER_BOUND": "50"
"UPPER_BOUND": "16726619290"
"NUM_PARTITIONS": "10"
}
```