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.

Consultare la sezione Schema per un elenco di oggetti disponibili per la replica.

Immagine di alto livello di questo connettore, inclusi collegamenti utili e funzionalità supportate.

Funzionalità/Capacità	Dettagli del supporto
Progetti Qlik Talend Data Integration supportati	Solo i progetti di replica. I progetti delle pipeline di dati non sono supportati.
Metodi di aggiornamento della destinazione	Attività di replica: Applica modifiche Archivia modifiche Trasferimento dei dati nelle attività di un data lake: Change Data Capture (CDC)
Gestione dei metadati	La generazione manuale dei metadati non è richiesta.
Evoluzione dello schema	È supportata solo l'operazione Cambia tipo di dati colonne.
Replica delle colonne LOB (NCLOB, CLOB e BLOB)	Operazione non supportata.
CDC pianificato	Operazione richiesta. In questo modo la destinazione viene aggiornata con le modifiche apportate alla sorgente. Per le attività di replica, vedere Pianificazione delle attività Per le attività di trasferimento su data lake, vedere Pianificazione CDC per le attività di trasferimento nel data lake
Notifiche	Operazione parzialmente supportata Impostare notifiche quando vengono apportate modifiche al funzionamento
Monitoraggio	Solo attività CDC, in quanto il caricamento completo non è rilevante per questo connettore. Monitoraggio di un singolo task di dati
Annullamento automatico della nidificazione dei payload nelle colonne JSON	Operazione non supportata. La nidificazione per i payload della colonna JSON nei set di dati di origine non viene annullata automaticamente nella destinazione.

Preparing for authentication

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

Assicurarsi che l'account utilizzata disponga di accesso di lettura per le tabelle che si desidera recuperare.

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

Per ulteriori informazioni, vedere Connessione alle applicazioni SaaS.

Inserire le proprietà di connessione richieste.
Fornire un nome per la connessione in Nome connessione.
Selezionare Apri metadati di connessione per definire i metadati della connessione al momento della creazione.
Fare clic su Crea.

Connection settings
Setting	Description
Data gateway	Selezionare un Gateway Data Movement se richiesto dal proprio caso di utilizzo. Nota informatica Questo campo non è disponibile con la sottoscrizione a Avvio Qlik Talend Cloud, poiché non supporta il Gateway Data Movement. Se si dispone di un altro livello di sottoscrizione e non si desidera utilizzare il Gateway Data Movement, selezionare Nessuno. Per informazioni sui vantaggi del Gateway Data Movement e quando è richiesto, vedere Qlik Data Gateway - Movimento dati.
Start Date	Inserire la data, nel formato `MM/DD/YYYY`, a partire dalla quale i dati devono essere replicati dalla sorgente alla destinazione.
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

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – ti pregiamo di farcelo sapere!

Lascia qui il tuo feedback