Unterstützte Entitäten für synchrone Quelle Unterstützte Entitäten für asynchrone Quelle Partitionierung von Abfragen

Aus HubSpot Entitäten lesen

Voraussetzung

Ein HubSpot Objekt, aus dem Sie lesen möchten. Sie benötigen den Objektnamen wie Kontakt oder Aufgabe. Die folgenden Tabellen zeigen die unterstützten Entitäten für die synchrone Quelle.

Unterstützte Entitäten für synchrone Quelle

Entität	API-Version	Kann gefiltert werden	Unterstützt Limit	Unterstützt „Sortieren nach“	Unterstützt „* auswählen“	Unterstützt Partitionierung
Kampagnen	v1	Nein	Ja	Nein	Ja	Nein
Unternehmen	v3	Ja	Ja	Ja	Ja	Ja
Kontakte	v3	Ja	Ja	Ja	Ja	Ja
Kontaktlisten	v1	Nein	Ja	Nein	Ja	Nein
Angebote	v3	Ja	Ja	Ja	Ja	Ja
CRM-Pipeline (Angebots-Pipelines)	v1	Nein	Nein	Nein	Ja	Nein
E-Mail-Ereignisse	v1	Nein	Ja	Nein	Ja	Nein
Calls	v3	Ja	Ja	Ja	Ja	Ja
Hinweise	v3	Ja	Ja	Ja	Ja	Ja
E-Mails	v3	Ja	Ja	Ja	Ja	Ja
Meetings	v3	Ja	Ja	Ja	Ja	Ja
Aufgaben	v3	Ja	Ja	Ja	Ja	Ja
Briefe	v3	Ja	Ja	Ja	Ja	Ja
Benutzerdefinierte Objekte	v3	Ja	Ja	Ja	Ja	Ja
Formulare	v2	Nein	Nein	Nein	Ja	Nein
Eigentümer	v3	Nein	Ja	Nein	Ja	Nein
Produkte	v3	Ja	Ja	Ja	Ja	Ja
Tickets	v3	Ja	Ja	Ja	Ja	Ja
Arbeitsabläufe	v3	Nein	Nein	Nein	Ja	Nein
Zuordnungen	v4	Ja	Nein	Nein	Ja	Nein
Bezeichnung für Zuordnungen	v4	Nein	Nein	Nein	Ja	Nein

Beispiel:


hubspot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="hubspot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "contact",
        "API_VERSION": "v3"
    }

Unterstützte Entitäten für asynchrone Quelle

Entität	API-Version	Kann gefiltert werden	Unterstützt Limit	Unterstützt „Sortieren nach“	Unterstützt „* auswählen“	Unterstützt Partitionierung
Unternehmen	v3	Ja	Nein	Ja	Ja	Nein
Kontakte	v3	Ja	Nein	Ja	Ja	Nein
Angebote	v3	Ja	Nein	Ja	Ja	Nein
Calls	v3	Ja	Nein	Ja	Ja	Nein
Hinweise	v3	Ja	Nein	Ja	Ja	Nein
E-Mails	v3	Ja	Nein	Ja	Ja	Nein
Meetings	v3	Ja	Nein	Ja	Ja	Nein
Aufgaben	v3	Ja	Nein	Ja	Ja	Nein
Briefe	v3	Ja	Nein	Ja	Ja	Nein
Benutzerdefinierte Objekte	v3	Ja	Nein	Ja	Ja	Nein
Produkte	v3	Ja	Nein	Ja	Ja	Nein
Tickets	v3	Ja	Nein	Ja	Ja	Nein

Beispiel:


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 Entitäts- und Felddetails:

HubSpot API v4:

Entität	API-Version	Feld	Datentyp	Unterstützte Operatoren
Zuordnungsbezeichnung	v4	category	Zeichenfolge	–
		typeId	Ganzzahl	–
		Bezeichnung	Zeichenfolge	–
Zuordnungen		from	Struct	–
		id	Zeichenfolge	"="
		to	Auflisten	–

Anmerkung

Um Assoziationen zwischen zwei Objekten für das Associations Objekt abzurufen, müssen Sie beim Erstellen eines Jobs die Absender-ID (die ID des ersten Objekts) über einen obligatorischen Filter angeben. AWS Glue Wenn Sie in diesem Fall Assoziationen für mehrere abrufen möchten, müssen Sie IDs in der Klausel mehrere IDs angeben. where Beispiel: Zum Abrufen Associations der Kontakte IDs '1' und '151' müssen Sie einen Filter als angeben. where id=1 AND id=151

HubSpot API v3:

Entität	Feld	Datentyp	Unterstützte Operatoren
Eigentümer	firstName	Zeichenfolge	–
	lastName	Zeichenfolge	–
	createdAt	DateTime	–
	archived	Boolesch	–
	Teams	Auflisten	–
	id	Zeichenfolge	–
	userId	Ganzzahl	–
	E-Mail	Zeichenfolge	–
	updatedAt	DateTime	–
Workflow	Name	Zeichenfolge	–
	id	Ganzzahl	–
	type	Zeichenfolge	–
	aktiviert	Boolesch	–
	insertedAt	Long	–
	updatedAt	Long	–
	contactListIds	Struct	–
	personaTagIds	Auflisten	–

HubSpot Stellt für die folgenden Entitäten Endpunkte zum dynamischen Abrufen von Metadaten bereit, sodass die Operatorunterstützung für jede Entität auf Datentypebene erfasst wird.

Anmerkung

DML_STATUS ist ein virtuelles Feld, das jedem Datensatz zur Laufzeit hinzugefügt wird, um den Status (ERSTELLT/AKTUALISIERT) im synchronen Modus zu bestimmen. Der CONTAINS/LIKE-Operator wird im asynchronen Modus nicht unterstützt.

Entität	Datentyp	Unterstützte Operatoren
Kontakt	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Unternehmen	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Angebot	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Ticket	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Produkt	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Benutzerdefiniertes Objekt	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Rufen Sie	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Email	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Meeting	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Hinweis	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Aufgabe	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–
Brief	Ganzzahl	"=, !=, <, >, >=, <="
	Long	"=, !=, <, >, >=, <="
	Zeichenfolge	"=, !=, LIKE"
	Date	–
	DateTime	"between"
	Boolesch	"="
	Auflisten	–
	Struct	–

HubSpot API v2:

Entität	Feld	Datentyp	Unterstützte Operatoren
Formular	portalId	Ganzzahl	–
	guid	Zeichenfolge	–
	Name	Zeichenfolge	–
	Methode	Zeichenfolge	–
	cssClass	Zeichenfolge	–
	redirect	Zeichenfolge	–
	submitText	Zeichenfolge	–
	notifyRecipients	Zeichenfolge	–
	createdAt	Long	–
	updatedAt	Long	–
	ignoreCurrentValues	Boolesch	–
	deletable	Boolesch	–
	inlineMessage	Boolesch	–
	captchaEnabled	Boolesch	–
	cloneable	Boolesch	–
	formFieldGroups	Auflisten	–
	editable	Boolesch	–
	deletedAt	Ganzzahl	–
	themeName	Zeichenfolge	–
	parentId	Ganzzahl	–
	style	Zeichenfolge	–
	isPublished	Boolesch	–
	publishAt	Ganzzahl	–
	unpublishAt	Ganzzahl	–
	publishedAt	Ganzzahl	–
	kickbackEmailWorkflowID	Zeichenfolge	–
	kickbackEmailsJson	Ganzzahl	–
	customUid	Zeichenfolge	–
	createMarketableContact	Boolesch	–
	editVersion	Ganzzahl	–
	thankYouMessageJson	Zeichenfolge	–
	themeColor	Zeichenfolge	–
	alwaysCreateNewFirma	Boolesch	–
	internalUpdatedAt	Long	–
	businessUnitId	Ganzzahl	–
	portableKey	Zeichenfolge	–
	paymentSessionTemplateAusweise	Auflisten	–
	selectedExternalOptions	Auflisten	–

HubSpot API v1:

Entität	Feld	Datentyp	Unterstützte Operatoren
Kampagne	id	Ganzzahl	–
	appId	Ganzzahl	–
	appName	Zeichenfolge	–
	lastUpdatedTime	Long	–
Contact_List	dynamisch	Boolesch	–
	Name	Zeichenfolge	–
	portalId	Ganzzahl	–
	createdAt	Long	–
	listId	Ganzzahl	–
	updatedAt	Long	–
	ListType	Zeichenfolge	–
	-Filter	Auflisten	–
	authorId	Ganzzahl	–
	metaData	Struct	–
	archived	Boolesch	–
	ilsFilterBranch	Zeichenfolge	–
	filterIds	Auflisten	–
	limitExempt	Boolesch	–
	internal	Boolesch	–
	readOnly	Boolesch	–
	parentId	Ganzzahl	–
Email_Event	id	Zeichenfolge	–
	type	Zeichenfolge	–
	Empfänger	Zeichenfolge	–
	portalId	Ganzzahl	–
	appId	Ganzzahl	–
	appName	Zeichenfolge	–
	emailCampaignId	Long	–
	attempt	Ganzzahl	–
	created	Long	–
	sentBy	Struct	–
	smtpId	Zeichenfolge	–
	response	Zeichenfolge	–
	subject	Zeichenfolge	–
	cc	Auflisten	–
	bcc	Auflisten	–
	replyTo	Auflisten	–
	from	Zeichenfolge	–
	dropReason	Zeichenfolge	–
	dropMessage	Zeichenfolge	–
	Browser	Struct	–
	userAgent	Zeichenfolge	–
	duration	Long	–
	location	Struct	–
	filteredEvent	Boolesch	–
	deviceType	Zeichenfolge	–
	suppressedReason	Zeichenfolge	–
	suppressedMessage	Zeichenfolge	–
CRM_Pipeline	pipelineId	Zeichenfolge	–
	createdAt	Long	–
	updatedAt	Long	–
	objectType	Zeichenfolge	–
	Bezeichnung	Zeichenfolge	–
	displayOrder	Ganzzahl	–
	aktiv	Boolesch	–
	Stufen	Auflisten	–
	objectTypeId	Zeichenfolge	–
	default	Boolesch	–

Partitionierung von Abfragen

Sie können die zusätzlichen Spark-Optionen PARTITION_FIELD,LOWER_BOUND, UPPER_BOUND und NUM_PARTITIONS angeben, wenn Sie Parallelität in Spark nutzen möchten. Mit diesen Parametern wird die ursprüngliche Abfrage in NUM_PARTITIONS Unterabfragen aufgeteilt, die von Spark-Aufgaben gleichzeitig ausgeführt werden können.

PARTITION_FIELD: der Name des Feldes, das zur Partitionierung der Abfrage verwendet werden soll.
LOWER_BOUND: ein inklusiver Untergrenzwert des ausgewählten Partitionsfelds.

Für das DateTime Feld akzeptieren wir den Wert im ISO-Format.

Beispiele für gültigen Wert:
```
“2024-01-01T10:00:00.115Z" 
```
UPPER_BOUND: ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds.
NUM_PARTITIONS: die Anzahl der Partitionen.

In der folgenden Tabelle sind Details zur Unterstützung der Partitionierung von Entitäten beschrieben:

Entitätsname	Partitionieren von Feldern	Datentyp
contact	hs_object_id	Long
contact	createdate, lastmodifieddate	DateTime
company	hs_object_id	Long
company	createdate, hs_lastmodifieddate	DateTime
deal	hs_object_id	Long
deal	createdate, hs_createdate, hs_lastmodifieddate	DateTime
Fahrkarte	hs_object_id	Long
Fahrkarte	createdate, hs_lastmodifieddate	DateTime
product	hs_object_id	Long
product	createdate, hs_lastmodifieddate	DateTime
custom_object	hs_object_id	Long
custom_object	createdate, hs_lastmodifieddate	DateTime
call	hs_object_id	Long
call	createdate, hs_lastmodifieddate	DateTime
E-Mail	hs_object_id	Long
E-Mail	createdate, hs_lastmodifieddate	DateTime
meeting	hs_object_id	Long
meeting	createdate, hs_lastmodifieddate	DateTime
note	hs_object_id	Long
note	createdate, hs_lastmodifieddate	DateTime
Aufgabe	hs_object_id	Long
Aufgabe	createdate, hs_lastmodifieddate	DateTime
postal_mail	hs_object_id	Long
postal_mail	createdate, hs_lastmodifieddate	DateTime

Beispiel:


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

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

HubSpot Verbindungen konfigurieren

An HubSpot Entitäten schreiben