SendGrid Core

SendGrid (now part of Twilio) is a cloud-based email delivery and marketing platform.

SendGrid Core integration replicates data using the SendGrid v3 API.

Im Abschnitt Schema finden Sie eine Liste der für die Replikation verfügbaren Objekte.

Ein Überblick über diesen Konnektor, einschließlich nützlicher Links und unterstützter Funktionen.

Funktion/Fähigkeit	Details zur Unterstützung
Unterstützte Qlik Talend Data Integration-Projekte	Nur Replikationsprojekte. Daten-Pipeline-Projekte werden nicht unterstützt.
Methoden zur Zielaktualisierung	Replikationsaufgaben: Änderungen anwenden Änderungen speichern Aufgaben zum Bereitstellen von Daten in einem Data Lake: Change Data Capture (CDC)
Verwalten von Metadaten	Die manuelle Erstellung von Metadaten ist nicht erforderlich.
Schemaentwicklung	Nur der Vorgang Spaltendatentyp ändern wird unterstützt.
Replikation von LOB-Spalten (NCLOB, CLOB und BLOB)	Nicht unterstützt.
Geplante CDC	Erforderlich. Auf diese Weise wird das Ziel mit den Änderungen an der Quelle aktualisiert gehalten. Für Replikationsaufgaben siehe Planen von Aufgaben Für Lake-Bereitstellungsaufgaben siehe Planen von CDC für Lake-Bereitstellungsaufgaben
Benachrichtigungen	Teilweise unterstützt Einrichten von Benachrichtigungen für Änderungen am Betrieb
Überwachung	Nur CDC, da vollständiges Laden für diesen Konnektor nicht relevant ist. Überwachen einer einzelnen Datenaufgabe
Automatisches Entschachteln von JSON-Spaltennutzlasten	Nicht unterstützt. JSON-Spaltennutzlasten in Quelldatensätzen werden im Ziel nicht automatisch entschachtelt.

Preparing for authentication

To access your data, you need to authenticate the connection with a SendGrid API key.

Vergewissern Sie sich, dass das verwendete Konto Lesezugriff auf die Tabellen hat, die Sie abrufen möchten.

To set up your SendGrid account, you need:

An active SendGrid account with API access enabled.
Permission to create API keys in your SendGrid account (Administrator role, or a Restricted Access role with the required permissions already assigned).

To create an API key:

Log into your SendGrid account.
Navigate to Settings > API Keys > Create API Key.
Enter a name for the key, for example QlikDataIntegration.
Select Restricted Access to limit the key to only the required permissions.
Expand the permission categories and grant Read Access to the following:
- Suppressions — required to replicate blocks, bounces, invalids, spam_reports, global_suppressions, groups_all, and groups_members.
- Marketing Campaigns — required to replicate contacts, lists_all, lists_members, segments_all, segments_members, and campaigns.
- Template Engine — required to replicate templates_all.
Click Create & View.
Copy and paste your API key into a secured file.

Creating the connection

Weitere Informationen finden Sie unter Herstellung einer Verbindung zu SaaS-Anwendungen.

Füllen Sie die erforderlichen Verbindungseigenschaften aus.
Geben Sie einen Namen für die Verbindung in Verbindungsname ein.
Wählen Sie Verbindungsmetadaten öffnen aus, um nach der Erstellung Metadaten für die Verbindung zu definieren.
Klicken Sie auf Erstellen.

Connection settings
Setting	Description
Data gateway	Wählen Sie ein Data Movement Gateway aus, wenn dies für Ihren Anwendungsfall erforderlich ist. Informationshinweis Dieses Feld ist für das Qlik Talend Cloud Starter-Abonnement nicht verfügbar, da dieses Abonnement Data Movement Gateway nicht unterstützt. Wenn Sie eine andere Abonnementstufe haben und Data Movement Gateway nicht verwenden möchten, wählen Sie Keine. Weitere Informationen zu den Vorteilen von Data Movement Gateway und den Anwendungsfällen, in denen es erforderlich ist, finden Sie unter Qlik Data Gateway – Datenbewegung.
Start Date	Geben Sie das Datum im Format `MM/DD/YYYY` ein, ab dem die Daten von der Quelle zum Ziel repliziert werden müssen.
API Key	API key.

Limitations and considerations

An API key cannot be granted greater permissions than your own account's current permissions. If you have a Restricted Access role in SendGrid, you can only include permissions already assigned to your account.
Custom contact fields defined in your SendGrid account appear as records inside the custom_fields array on each contact, not as separate top-level columns. Adding new custom contact fields does not require a destination schema reset.
The groups_members, lists_members, and segments_members streams use member_count as the replication key. Each sync fetches member data only for groups, lists, or segments whose member count has increased since the last run. Membership changes that leave the count unchanged (for example, one member removed and another added) are not detected.
The groups_members stream replicates suppressed (unsubscribed) email addresses for each unsubscribe group.
This connector uses the Legacy Marketing Campaigns API endpoints (/v3/contactdb/). Accounts that have only ever used the newer Twilio SendGrid Marketing Campaigns (Single Sends) may find these endpoints unavailable or empty.

Schema

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

Depending on your destination, table and column names may not appear as they are outlined below.

blocks

The blocks table contains information about email addresses that were blocked from receiving emails.

Replication Method	CDC
Primary Key	email
Replication Key	end_time
Useful links	SendGrid API reference

bounces

The bounces table contains information about email addresses that have bounced.

Replication Method	CDC
Primary Key	email
Replication Key	end_time
Useful links	SendGrid API reference

campaigns

The campaigns table contains information about email campaigns in your SendGrid account.

Replication Method	Full Table
Primary Key	id
Useful links	SendGrid API reference

contacts

The contacts table contains information about recipients in your SendGrid contact database.

Replication Method	CDC
Primary Key	id
Replication Key	created_at, updated_at
Useful links	SendGrid API reference

global_suppressions

The global_suppressions table contains email addresses that have globally unsubscribed from all emails.

Replication Method	CDC
Primary Key	email
Replication Key	end_time
Useful links	SendGrid API reference

groups_all

The groups_all table contains information about unsubscribe groups in your SendGrid account.

Replication Method	Full Table
Primary Key	id
Useful links	SendGrid API reference

groups_members

The groups_members table contains suppressed (unsubscribed) email addresses for each unsubscribe group.

Replication Method	CDC
Primary Key	email
Replication Key	member_count
Useful links	SendGrid API reference

invalids

The invalids table contains invalid email addresses that cannot receive mail.

Replication Method	CDC
Primary Key	email
Replication Key	end_time
Useful links	SendGrid API reference

lists_all

The lists_all table contains information about contact lists in your SendGrid account.

Replication Method	Full Table
Primary Key	id
Useful links	SendGrid API reference

lists_members

The lists_members table contains contact recipients that belong to a contact list.

Replication Method	CDC
Primary Key	id
Replication Key	member_count
Useful links	SendGrid API reference

segments_all

The segments_all table contains information about contact segments in your SendGrid account.

Replication Method	Full Table
Primary Key	id
Useful links	SendGrid API reference

segments_members

The segments_members table contains contact recipients that belong to a contact segment.

Replication Method	CDC
Primary Key	id
Replication Key	member_count
Useful links	SendGrid API reference

spam_reports

The spam_reports table contains email addresses that have marked your emails as spam.

Replication Method	CDC
Primary Key	email
Replication Key	end_time
Useful links	SendGrid API reference

templates_all

The templates_all table contains information about email templates in your SendGrid account.

Replication Method	Full Table
Primary Key	id
Useful links	SendGrid API reference

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!

Geben Sie hier Ihr Feedback ab