Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Lecture à partir d' HubSpot entités
**Prérequis**
Un HubSpot objet que vous aimeriez lire. Vous aurez besoin du nom de l’objet, comme contact ou task. Le tableau suivant présente les entités prises en charge pour la source de synchronisation.
## Entités prises en charge pour la source de synchronisation
| Entité | Version de l’API | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge |
| --- | --- | --- | --- | --- | --- | --- |
| Campagnes | v1 | Non | Oui | Non | Oui | Non |
| Companies | v3 | Oui | Oui | Oui | Oui | Oui |
| Contacts | v3 | Oui | Oui | Oui | Oui | Oui |
| Contact Lists | v1 | Non | Oui | Non | Oui | Non |
| Deals | v3 | Oui | Oui | Oui | Oui | Oui |
| CRM Pipeline (Deal Pipelines) | v1 | Non | Non | Non | Oui | Non |
| Événements d'e-mail | v1 | Non | Oui | Non | Oui | Non |
| Appels | v3 | Oui | Oui | Oui | Oui | Oui |
| Remarques | v3 | Oui | Oui | Oui | Oui | Oui |
| Emails | v3 | Oui | Oui | Oui | Oui | Oui |
| Meetings | v3 | Oui | Oui | Oui | Oui | Oui |
| Tâches | v3 | Oui | Oui | Oui | Oui | Oui |
| Postal Mails | v3 | Oui | Oui | Oui | Oui | Oui |
| Custom Objects | v3 | Oui | Oui | Oui | Oui | Oui |
| Forms | v2 | Non | Non | Non | Oui | Non |
| Owners | v3 | Non | Oui | Non | Oui | Non |
| Produits | v3 | Oui | Oui | Oui | Oui | Oui |
| Tickets | v3 | Oui | Oui | Oui | Oui | Oui |
| Flux de travail | v3 | Non | Non | Non | Oui | Non |
| Associations | v4 | Oui | Non | Non | Oui | Non |
| Associations Labels | v4 | Non | Non | Non | Oui | Non |
**Exemple :**
```
hubspot_read = glueContext.create_dynamic_frame.from_options(
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "contact",
"API_VERSION": "v3"
}
```
## Entités prises en charge pour la source asynchrone
| Entité | Version de l’API | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge |
| --- | --- | --- | --- | --- | --- | --- |
| Companies | v3 | Oui | Non | Oui | Oui | Non |
| Contacts | v3 | Oui | Non | Oui | Oui | Non |
| Deals | v3 | Oui | Non | Oui | Oui | Non |
| Appels | v3 | Oui | Non | Oui | Oui | Non |
| Remarques | v3 | Oui | Non | Oui | Oui | Non |
| Emails | v3 | Oui | Non | Oui | Oui | Non |
| Meetings | v3 | Oui | Non | Oui | Oui | Non |
| Tâches | v3 | Oui | Non | Oui | Oui | Non |
| Postal Mails | v3 | Oui | Non | Oui | Oui | Non |
| Custom Objects | v3 | Oui | Non | Oui | Oui | Non |
| Produits | v3 | Oui | Non | Oui | Oui | Non |
| Tickets | v3 | Oui | Non | Oui | Oui | Non |
**Exemple :**
```
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 détails de l'entité et du champ** :
**HubSpot API v4** :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/hubspot-reading-from-entities.html)
**Note**
Pour l'`Associations`objet, pour récupérer les associations entre deux objets, vous devez fournir le « from Id » (l'ID du premier objet) via un filtre obligatoire lors de la création d'une tâche. AWS Glue Si vous souhaitez récupérer des associations pour plusieurs IDs dans ce cas, vous devez en fournir plusieurs IDs dans la `where` clause. Par exemple : pour récupérer `Associations` les contacts IDs « 1 » et « 151 », vous devez fournir un filtre sous `where id=1 AND id=151` la forme.
**HubSpot API version 3** :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/hubspot-reading-from-entities.html)
Pour les entités suivantes, HubSpot fournit des points de terminaison permettant de récupérer les métadonnées de manière dynamique, afin que le support des opérateurs soit capturé au niveau du type de données pour chaque entité.
**Note**
`DML_STATUS` est un champ virtuel ajouté à chaque enregistrement lors de l’exécution afin de déterminer son état (CRÉÉ/MIS À JOUR) en mode de synchronisation. L’opérateur `CONTAINS/LIKE` n’est pas pris en charge en mode asynchrone.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v2** :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v1** :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/hubspot-reading-from-entities.html)
## Requêtes de partitionnement
Vous pouvez indiquer les options Spark supplémentaires `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` et `NUM_PARTITIONS` si vous souhaitez utiliser la simultanéité dans Spark. Avec ces paramètres, la requête d’origine serait divisée en `NUM_PARTITIONS` nombres de sous-requêtes pouvant être exécutées simultanément par les tâches Spark.
+ `PARTITION_FIELD` : le nom du champ à utiliser pour partitionner la requête.
+ `LOWER_BOUND` : une valeur limite inférieure **inclusive** du champ de partition choisi.
Pour le DateTime champ, nous acceptons la valeur au format ISO.
Exemples de valeurs valides :
```
“2024-01-01T10:00:00.115Z"
```
+ `UPPER_BOUND` : une valeur limite supérieure **exclusive** du champ de partition choisi.
+ `NUM_PARTITIONS` : le nombre de partitions.
Le tableau suivant décrit les détails de prise en charge dans les champs de partitionnement d’entités :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/hubspot-reading-from-entities.html)
Exemple :
```
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"
}
```