Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membaca dari HubSpot entitas
**Prasyarat**
HubSpot Objek yang ingin Anda baca. Anda akan memerlukan nama objek seperti kontak atau tugas. Tabel berikut menunjukkan entitas yang didukung untuk sumber Sync.
## Entitas yang didukung untuk sumber Sinkronisasi
| Entitas | Versi API | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih \$1 | Mendukung partioning |
| --- | --- | --- | --- | --- | --- | --- |
| Kampanye | v1 | Tidak | Ya | Tidak | Ya | Tidak |
| Perusahaan | v3 | Ya | Ya | Ya | Ya | Ya |
| Kontak | v3 | Ya | Ya | Ya | Ya | Ya |
| Daftar Kontak | v1 | Tidak | Ya | Tidak | Ya | Tidak |
| Penawaran | v3 | Ya | Ya | Ya | Ya | Ya |
| Pipa CRM (Saluran Pipa Kesepakatan) | v1 | Tidak | Tidak | Tidak | Ya | Tidak |
| Acara Email | v1 | Tidak | Ya | Tidak | Ya | Tidak |
| Panggilan | v3 | Ya | Ya | Ya | Ya | Ya |
| Catatan | v3 | Ya | Ya | Ya | Ya | Ya |
| Email | v3 | Ya | Ya | Ya | Ya | Ya |
| Rapat | v3 | Ya | Ya | Ya | Ya | Ya |
| Tugas | v3 | Ya | Ya | Ya | Ya | Ya |
| Surat Pos | v3 | Ya | Ya | Ya | Ya | Ya |
| Objek Kustom | v3 | Ya | Ya | Ya | Ya | Ya |
| Formulir | v2 | Tidak | Tidak | Tidak | Ya | Tidak |
| Pemilik | v3 | Tidak | Ya | Tidak | Ya | Tidak |
| Produk | v3 | Ya | Ya | Ya | Ya | Ya |
| Tiket | v3 | Ya | Ya | Ya | Ya | Ya |
| Alur kerja | v3 | Tidak | Tidak | Tidak | Ya | Tidak |
| Asosiasi | v4 | Ya | Tidak | Tidak | Ya | Tidak |
| Label Asosiasi | v4 | Tidak | Tidak | Tidak | Ya | Tidak |
**Contoh:**
```
hubspot_read = glueContext.create_dynamic_frame.from_options(
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "contact",
"API_VERSION": "v3"
}
```
## Entitas yang didukung untuk sumber Async
| Entitas | Versi API | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih \$1 | Mendukung partioning |
| --- | --- | --- | --- | --- | --- | --- |
| Perusahaan | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Kontak | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Penawaran | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Panggilan | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Catatan | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Email | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Rapat | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Tugas | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Surat Pos | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Objek Kustom | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Produk | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Tiket | v3 | Ya | Tidak | Ya | Ya | Tidak |
**Contoh:**
```
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 detail entitas dan bidang**:
**HubSpot API v4**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
**catatan**
Untuk `Associations` objek, untuk mengambil asosiasi antara dua objek, Anda perlu memberikan 'dari Id' (ID objek pertama) melalui filter wajib saat membuat pekerjaan. AWS Glue Jika Anda ingin mengambil asosiasi untuk beberapa dari IDs dalam kasus itu, Anda harus memberikan beberapa IDs dalam `where` klausa. Misalnya: untuk mengambil kontak `Associations` IDs '1' dan '151', Anda perlu memberikan filter sebagai. `where id=1 AND id=151`
**HubSpot API v3**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
Untuk entitas berikut, HubSpot sediakan titik akhir untuk mengambil metadata secara dinamis, sehingga dukungan operator ditangkap pada tingkat tipe data untuk setiap entitas.
**catatan**
`DML_STATUS`adalah bidang virtual yang ditambahkan pada setiap catatan saat runtime untuk menentukan statusnya (DIBUAT/DIPERBARUI) dalam mode Sinkronisasi. `CONTAINS/LIKE`Operator tidak didukung dalam mode Async.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v2**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v1:**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
## Mempartisi kueri
Anda dapat memberikan opsi Spark tambahan`PARTITION_FIELD`,, `LOWER_BOUND``UPPER_BOUND`, dan `NUM_PARTITIONS` jika Anda ingin memanfaatkan konkurensi di Spark. Dengan parameter ini, kueri asli akan dibagi menjadi `NUM_PARTITIONS` sejumlah sub-kueri yang dapat dijalankan oleh tugas Spark secara bersamaan.
+ `PARTITION_FIELD`: nama bidang yang akan digunakan untuk mempartisi kueri.
+ `LOWER_BOUND`: nilai batas bawah **inklusif** dari bidang partisi yang dipilih.
Untuk DateTime bidang, kami menerima nilai dalam format ISO.
Contoh nilai valid:
```
“2024-01-01T10:00:00.115Z"
```
+ `UPPER_BOUND`: nilai batas atas **eksklusif** dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`: jumlah partisi.
Tabel berikut menjelaskan rincian dukungan bidang partisi entitas:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
Contoh:
```
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"
}
```