Membaca dari HubSpot entitas

Prasyarat

HubSpot Objek yang ingin Anda baca. Anda akan memerlukan nama objek seperti kontak atau tugas. Tabel berikut ini menunjukkan entitas yang didukung.

Entitas yang didukung untuk sumber:

Entitas	APIversi	Dapat disaring	Mendukung limit	Mendukung Order by	Mendukung Pilih *	Mendukung pembagian
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
CRMPipeline (Deal Pipelines)	v1	Tidak	Tidak	Tidak	Ya	Tidak
Peristiwa 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
owner	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"
    }

HubSpot detail entitas dan bidang:

HubSpot APIv4:

Entitas	APIversi	Field	Tipe data	Operator yang didukung
Label Asosiasi	v4	kategori	String	N/A
		typeId	Bilangan Bulat	N/A
		label	String	N/A
Asosiasi		From	Struct	N/A
		id	String	"="
		kepada	Daftar	N/A

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 APIv3:

Entitas	Field	Tipe data	Operator yang didukung
owner	firstName	String	N/A
	lastName	String	N/A
	createdAt	DateTime	N/A
	Diarsipkan	Boolean	N/A
	tim	Daftar	N/A
	id	String	N/A
	userId	Bilangan Bulat	N/A
	Email	String	N/A
	updatedAt	DateTime	N/A
Alur kerja	name	String	N/A
	id	Bilangan Bulat	N/A
	jenis	String	N/A
	diaktifkan	Boolean	N/A
	insertedAt	Long	N/A
	updatedAt	Long	N/A
	contactListIds	Struct	N/A
	personaTagIds	Daftar	N/A

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_STATUSadalah bidang virtual yang ditambahkan pada setiap catatan saat runtime untuk menentukan statusnya (CREATED/UPDATED).

Entitas	Tipe data	Operator yang didukung
Kontak	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Perusahaan	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Kesepakatan	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Tiket	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Produk	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Objek Kustom	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
PANGGILAN	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Email	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Rapat	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Catatan	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Tugas	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A
Surat	Bilangan Bulat	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	String	"=, !=, LIKE"
	Tanggal	N/A
	DateTime	“antara”
	Boolean	"="
	Daftar	N/A
	Struct	N/A

HubSpot APIv2:

Entitas	Field	Tipe data	Operator yang didukung
Formulir	portalId	Bilangan Bulat	N/A
	panduan	String	N/A
	name	String	N/A
	metode	String	N/A
	cssClass	String	N/A
	menunjukkan kembali	String	N/A
	submitText	String	N/A
	notifyRecipients	String	N/A
	createdAt	Long	N/A
	updatedAt	Long	N/A
	ignoreCurrentValues	Boolean	N/A
	dihapus	Boolean	N/A
	inlineMessage	Boolean	N/A
	captchaEnabled	Boolean	N/A
	dapat dikloning	Boolean	N/A
	formFieldGroups	Daftar	N/A
	dapat diedit	Boolean	N/A
	deletedAt	Bilangan Bulat	N/A
	themeName	String	N/A
	parentId	Bilangan Bulat	N/A
	gaya	String	N/A
	isPublished	Boolean	N/A
	publishAt	Bilangan Bulat	N/A
	unpublishAt	Bilangan Bulat	N/A
	publishedAt	Bilangan Bulat	N/A
	kickbackEmailWorkflowId	String	N/A
	kickbackEmailsJson	Bilangan Bulat	N/A
	customUid	String	N/A
	createMarketableContact	Boolean	N/A
	editVersion	Bilangan Bulat	N/A
	thankYouMessageJson	String	N/A
	themeColor	String	N/A
	alwaysCreateNewPerusahaan	Boolean	N/A
	internalUpdatedAt	Long	N/A
	businessUnitId	Bilangan Bulat	N/A
	portableKey	String	N/A
	paymentSessionTemplateId	Daftar	N/A
	selectedExternalOptions	Daftar	N/A

HubSpot APIv1:

Entitas	Field	Tipe data	Operator yang didukung
Kampanye	id	Bilangan Bulat	N/A
	appId	Bilangan Bulat	N/A
	appName	String	N/A
	lastUpdatedTime	Long	N/A
Contact_List	dinamis	Boolean	N/A
	name	String	N/A
	portalId	Bilangan Bulat	N/A
	createdAt	Long	N/A
	listId	Bilangan Bulat	N/A
	updatedAt	Long	N/A
	ListType	String	N/A
	saringan	Daftar	N/A
	authorId	Bilangan Bulat	N/A
	metaData	Struct	N/A
	Diarsipkan	Boolean	N/A
	ilsFilterBranch	String	N/A
	filterIds	Daftar	N/A
	limitExempt	Boolean	N/A
	batin	Boolean	N/A
	readOnly	Boolean	N/A
	parentId	Bilangan Bulat	N/A
Email_Acara	id	String	N/A
	jenis	String	N/A
	penerima	String	N/A
	portalId	Bilangan Bulat	N/A
	appId	Bilangan Bulat	N/A
	appName	String	N/A
	emailCampaignId	Long	N/A
	mencoba	Bilangan Bulat	N/A
	dibuat	Long	N/A
	sentBy	Struct	N/A
	smtpId	String	N/A
	response	String	N/A
	subjek	String	N/A
	cc	Daftar	N/A
	bcc	Daftar	N/A
	replyTo	Daftar	N/A
	From	String	N/A
	dropReason	String	N/A
	dropMessage	String	N/A
	penjelajah	Struct	N/A
	userAgent	String	N/A
	durasi	Long	N/A
	lokasi	Struct	N/A
	filteredEvent	Boolean	N/A
	deviceType	String	N/A
	suppressedReason	String	N/A
	suppressedMessage	String	N/A
CRM_Pipa	pipelineId	String	N/A
	createdAt	Long	N/A
	updatedAt	Long	N/A
	objectType	String	N/A
	label	String	N/A
	displayOrder	Bilangan Bulat	N/A
	aktif	Boolean	N/A
	tahapan	Daftar	N/A
	objectTypeId	String	N/A
	default	Boolean	N/A

Mempartisi kueri

Anda dapat memberikan opsi Spark tambahanPARTITION_FIELD,, LOWER_BOUNDUPPER_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 ISO format.

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:

Nama entitas	Bidang partisi	Tipe data
kontak	hs_object_id	Long
kontak	createdate, lastmodifieddate	DateTime
perusahaan	hs_object_id	Long
perusahaan	createdate, hs_lastmodifieddate	DateTime
kesepakatan	hs_object_id	Long
kesepakatan	createdate, hs_createdate, hs_lastmodifieddate	DateTime
karcis	hs_object_id	Long
karcis	createdate, hs_lastmodifieddate	DateTime
produk	hs_object_id	Long
produk	createdate, hs_lastmodifieddate	DateTime
custom_objek	hs_object_id	Long
custom_objek	createdate, hs_lastmodifieddate	DateTime
panggilan	hs_object_id	Long
panggilan	createdate, hs_lastmodifieddate	DateTime
Email	hs_object_id	Long
Email	createdate, hs_lastmodifieddate	DateTime
rapat	hs_object_id	Long
rapat	createdate, hs_lastmodifieddate	DateTime
not	hs_object_id	Long
not	createdate, hs_lastmodifieddate	DateTime
tugas	hs_object_id	Long
tugas	createdate, hs_lastmodifieddate	DateTime
postal_mail	hs_object_id	Long
postal_mail	createdate, hs_lastmodifieddate	DateTime

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

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Mengkonfigurasi koneksi HubSpot

HubSpot opsi koneksi