Référence du connecteur SendGrid

info

Bêta

This feature is in Beta. To use it, a workspace admin must turn on Lakeflow Connect for SendGrid from the Previews page. See Manage Databricks previews.

Cette page contient des informations de référence pour le connecteur géré SendGrid, y compris les tables sources prises en charge et les schémas de table de destination.

Tables sources prises en charge

Le connecteur SendGrid prend en charge les tables sources suivantes, toutes sous le schéma source default :

Table source	Clé primaire	Description	Mode de synchronisation
`subusers`	`id`	Les sous-utilisateurs sous le compte SendGrid parent, incluant le nom d'utilisateur, l'e-mail et l'état désactivé de chaque sous-utilisateur.	Full refresh uniquement
`recent_access_attempts`	`subuser`, `ip`	Tentatives récentes d’accès IP pour chaque sous-utilisateur, récupérées pour le compte du sous-utilisateur.	Full refresh uniquement
`parent_access_attempts`	`ip`	Tentatives d’accès IP récentes pour le compte parent lui-même.	Full refresh uniquement
`bounces`		Adresses e-mail figurant sur la liste de suppression pour cause de rebond, avec l’état et le motif du rebond.	Full refresh uniquement
`spam_reports`		Adresses e-mail figurant dans la liste de suppression des rapports de spam.	Full refresh uniquement
`global_suppressions`		Adresses e-mail qui se sont désabonnées de tous les e-mails.	Full refresh uniquement
`blocks`		Adresses e-mail figurant sur la liste de suppression des blocages, avec leur statut de blocage et leur motif.	Full refresh uniquement
`invalid_emails`		Adresses e-mail figurant sur la liste de suppression des adresses e-mail non valides, avec leur motif.	Full refresh uniquement
`suppression_group_members`	`group_id`, `email`	Adresses e-mail exclues d’un groupe de désabonnement, avec le groupe auquel elles appartiennent.	Full refresh uniquement
`suppression_groups`	`id`	Les groupes de désabonnement (désactivation) définis sur le compte.	Full refresh uniquement
`contacts`	`contact_id`	Contacts Marketing, y compris les champs personnalisés. Le connecteur lit la liste complète des contacts via l’export des contacts SendGrid.	Full refresh uniquement
`lists`	`id`	Listes de contacts Marketing, avec le nombre de contacts dans chaque liste.	Full refresh uniquement
`singlesends`	`id`	Les envois uniques Marketing, y compris leur état, leurs catégories et leurs paramètres de test A/B.	Full refresh uniquement
`templates`	`id`	Template d’e-mails transactionnels hérités et dynamiques, avec leurs versions.	Full refresh uniquement
`singlesend_stats`	`id`, `ab_phase`, `ab_variation`, `aggregation`	Statistiques d’engagement pour les envois uniques, avec une ligne par envoi unique, phase A/B, variante A/B et agrégation.	Full refresh uniquement
`automations_stats`	`id`, `step_id`, `aggregation`	Statistiques d’engagement pour les automatisations, avec une ligne par automatisation, étape et agrégation.	Full refresh uniquement
`segments`	`id`	Segments Marketing (Segmentation v2), avec le nombre de contacts et l’état de validation de la query.	Full refresh uniquement

Table source	Clé primaire	Description	Mode de synchronisation
`subusers`	`id`	Les sous-utilisateurs sous le compte SendGrid parent, incluant le nom d'utilisateur, l'e-mail et l'état désactivé de chaque sous-utilisateur.	Full refresh uniquement
`recent_access_attempts`	`subuser`, `ip`	Tentatives récentes d’accès IP pour chaque sous-utilisateur, récupérées pour le compte du sous-utilisateur.	Full refresh uniquement
`parent_access_attempts`	`ip`	Tentatives d’accès IP récentes pour le compte parent lui-même.	Full refresh uniquement
`bounces`		Adresses e-mail figurant sur la liste de suppression pour cause de rebond, avec l’état et le motif du rebond.	Full refresh uniquement
`spam_reports`		Adresses e-mail figurant dans la liste de suppression des rapports de spam.	Full refresh uniquement
`global_suppressions`		Adresses e-mail qui se sont désabonnées de tous les e-mails.	Full refresh uniquement
`blocks`		Adresses e-mail figurant sur la liste de suppression des blocages, avec leur statut de blocage et leur motif.	Full refresh uniquement
`invalid_emails`		Adresses e-mail figurant sur la liste de suppression des adresses e-mail non valides, avec leur motif.	Full refresh uniquement
`suppression_group_members`	`group_id`, `email`	Adresses e-mail exclues d’un groupe de désabonnement, avec le groupe auquel elles appartiennent.	Full refresh uniquement
`suppression_groups`	`id`	Les groupes de désabonnement (désactivation) définis sur le compte.	Full refresh uniquement
`contacts`	`contact_id`	Contacts Marketing, y compris les champs personnalisés. Le connecteur lit la liste complète des contacts via l’export des contacts SendGrid.	Full refresh uniquement
`lists`	`id`	Listes de contacts Marketing, avec le nombre de contacts dans chaque liste.	Full refresh uniquement
`singlesends`	`id`	Les envois uniques Marketing, y compris leur état, leurs catégories et leurs paramètres de test A/B.	Full refresh uniquement
`templates`	`id`	Template d’e-mails transactionnels hérités et dynamiques, avec leurs versions.	Full refresh uniquement
`singlesend_stats`	`id`, `ab_phase`, `ab_variation`, `aggregation`	Statistiques d’engagement pour les envois uniques, avec une ligne par envoi unique, phase A/B, variante A/B et agrégation.	Full refresh uniquement
`automations_stats`	`id`, `step_id`, `aggregation`	Statistiques d’engagement pour les automatisations, avec une ligne par automatisation, étape et agrégation.	Full refresh uniquement
`segments`	`id`	Segments Marketing (Segmentation v2), avec le nombre de contacts et l’état de validation de la query.	Full refresh uniquement

Options du connecteur

Le connecteur SendGrid ne dispose d’aucune option de configuration supplémentaire au-delà des paramètres de pipeline disponibles pour tous les connecteurs gérés. Voir Ingérer des données depuis SendGrid.

Schémas de table de destination

`subusers`

Clé principale : id Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`id`	`BIGINT`
`username`	`STRING`
`email`	`STRING`
`disabled`	`BOOLEAN`

`recent_access_attempts`

Clé principale : subuser, ip Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`subuser`	`STRING`
`allowed`	`BOOLEAN`
`auth_method`	`STRING`
`first_at`	`BIGINT`
`last_at`	`BIGINT`
`ip`	`STRING`
`location`	`STRING`

`parent_access_attempts`

Clé principale : ip Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`allowed`	`BOOLEAN`
`auth_method`	`STRING`
`first_at`	`BIGINT`
`last_at`	`BIGINT`
`ip`	`STRING`
`location`	`STRING`

`bounces`

Clé primaire : Aucune Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`email`	`STRING`
`created`	`BIGINT`
`status`	`STRING`
`reason`	`STRING`

`spam_reports`

Clé primaire : Aucune Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`email`	`STRING`
`created`	`BIGINT`
`ip`	`STRING`

`global_suppressions`

Clé primaire : Aucune Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`email`	`STRING`
`created`	`BIGINT`

`blocks`

Clé primaire : Aucune Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`email`	`STRING`
`created`	`BIGINT`
`status`	`STRING`
`reason`	`STRING`

`invalid_emails`

Clé primaire : Aucune Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`email`	`STRING`
`created`	`BIGINT`
`reason`	`STRING`

`suppression_group_members`

Clé principale : group_id, email Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`email`	`STRING`
`group_id`	`BIGINT`
`group_name`	`STRING`
`created_at`	`BIGINT`

`suppression_groups`

Clé principale : id Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`id`	`BIGINT`
`name`	`STRING`
`description`	`STRING`
`is_default`	`BOOLEAN`
`unsubscribes`	`BIGINT`

`contacts`

Clé principale : contact_id Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`contact_id`	`STRING`
`email`	`STRING`
`first_name`	`STRING`
`last_name`	`STRING`
`alternate_emails`	`ARRAY<STRING>`
`address_line_1`	`STRING`
`address_line_2`	`STRING`
`city`	`STRING`
`state_province_region`	`STRING`
`postal_code`	`STRING`
`country`	`STRING`
`phone_number`	`STRING`
`phone_number_id`	`STRING`
`whatsapp`	`STRING`
`line`	`STRING`
`facebook`	`STRING`
`unique_name`	`STRING`
`external_id`	`STRING`
`anonymous_id`	`STRING`
`custom_fields`	`VARIANT`
`created_at`	`STRING`
`updated_at`	`STRING`

Champ	Type de données
`contact_id`	`STRING`
`email`	`STRING`
`first_name`	`STRING`
`last_name`	`STRING`
`alternate_emails`	`ARRAY<STRING>`
`address_line_1`	`STRING`
`address_line_2`	`STRING`
`city`	`STRING`
`state_province_region`	`STRING`
`postal_code`	`STRING`
`country`	`STRING`
`phone_number`	`STRING`
`phone_number_id`	`STRING`
`whatsapp`	`STRING`
`line`	`STRING`
`facebook`	`STRING`
`unique_name`	`STRING`
`external_id`	`STRING`
`anonymous_id`	`STRING`
`custom_fields`	`VARIANT`
`created_at`	`STRING`
`updated_at`	`STRING`

remarque

Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.

`lists`

Clé principale : id Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`contact_count`	`BIGINT`
`_metadata`	`STRUCT<self: STRING>`

`singlesends`

Clé principale : id Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`status`	`STRING`
`categories`	`ARRAY<STRING>`
`send_at`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`is_abtest`	`BOOLEAN`
`abtest`	`STRUCT<type: STRING, winner_criteria: STRING, test_percentage: BIGINT, duration: STRING, winning_template_id: STRING, winner_selected_at: STRING, expiration_date: STRING>`

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`status`	`STRING`
`categories`	`ARRAY<STRING>`
`send_at`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`is_abtest`	`BOOLEAN`
`abtest`	`STRUCT<type: STRING, winner_criteria: STRING, test_percentage: BIGINT, duration: STRING, winning_template_id: STRING, winner_selected_at: STRING, expiration_date: STRING>`

`templates`

Clé principale : id Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`generation`	`STRING`
`updated_at`	`STRING`
`versions`	`ARRAY<STRUCT<id: STRING, template_id: STRING, active: BIGINT, name: STRING, subject: STRING, updated_at: STRING, generate_plain_content: BOOLEAN, editor: STRING, thumbnail_url: STRING>>`

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`generation`	`STRING`
`updated_at`	`STRING`
`versions`	`ARRAY<STRUCT<id: STRING, template_id: STRING, active: BIGINT, name: STRING, subject: STRING, updated_at: STRING, generate_plain_content: BOOLEAN, editor: STRING, thumbnail_url: STRING>>`

`singlesend_stats`

Clé principale : id, ab_phase, ab_variation, aggregation Mode de synchronisation : refresh complet uniquement

Champ	Type de données
`id`	`STRING`
`ab_phase`	`STRING`
`ab_variation`	`STRING`
`aggregation`	`STRING`
`stats`	`STRUCT<bounce_drops: BIGINT, bounces: BIGINT, clicks: BIGINT, delivered: BIGINT, invalid_emails: BIGINT, opens: BIGINT, requests: BIGINT, spam_report_drops: BIGINT, spam_reports: BIGINT, unique_clicks: BIGINT, unique_opens: BIGINT, unsubscribes: BIGINT>`

Champ	Type de données
`id`	`STRING`
`ab_phase`	`STRING`
`ab_variation`	`STRING`
`aggregation`	`STRING`
`stats`	`STRUCT<bounce_drops: BIGINT, bounces: BIGINT, clicks: BIGINT, delivered: BIGINT, invalid_emails: BIGINT, opens: BIGINT, requests: BIGINT, spam_report_drops: BIGINT, spam_reports: BIGINT, unique_clicks: BIGINT, unique_opens: BIGINT, unsubscribes: BIGINT>`

`automations_stats`

Clé principale : id, step_id, aggregation Mode de sync : Full refresh uniquement

Champ	Type de données
`id`	`STRING`
`aggregation`	`STRING`
`step_id`	`STRING`
`stats`	`STRUCT<bounce_drops: BIGINT, bounces: BIGINT, clicks: BIGINT, delivered: BIGINT, invalid_emails: BIGINT, opens: BIGINT, requests: BIGINT, spam_report_drops: BIGINT, spam_reports: BIGINT, unique_clicks: BIGINT, unique_opens: BIGINT, unsubscribes: BIGINT>`

Champ	Type de données
`id`	`STRING`
`aggregation`	`STRING`
`step_id`	`STRING`
`stats`	`STRUCT<bounce_drops: BIGINT, bounces: BIGINT, clicks: BIGINT, delivered: BIGINT, invalid_emails: BIGINT, opens: BIGINT, requests: BIGINT, spam_report_drops: BIGINT, spam_reports: BIGINT, unique_clicks: BIGINT, unique_opens: BIGINT, unsubscribes: BIGINT>`

`segments`

Clé principale : id Mode de synchronisation : Full refresh uniquement

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`query_version`	`STRING`
`contacts_count`	`BIGINT`
`parent_list_ids`	`ARRAY<STRING>`
`sample_updated_at`	`STRING`
`next_sample_update`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`status`	`STRUCT<query_validation: STRING, error_message: STRING>`

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`query_version`	`STRING`
`contacts_count`	`BIGINT`
`parent_list_ids`	`ARRAY<STRING>`
`sample_updated_at`	`STRING`
`next_sample_update`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`status`	`STRUCT<query_validation: STRING, error_message: STRING>`

Tables sources prises en charge​

Options du connecteur​

Schémas de table de destination​

subusers​

recent_access_attempts​

parent_access_attempts​

bounces​

spam_reports​

global_suppressions​

blocks​

invalid_emails​

suppression_group_members​

suppression_groups​

contacts​

lists​

singlesends​

templates​

singlesend_stats​

automations_stats​

segments​

Tables sources prises en charge

Options du connecteur

Schémas de table de destination

`subusers`

`recent_access_attempts`

`parent_access_attempts`

`bounces`

`spam_reports`

`global_suppressions`

`blocks`

`invalid_emails`

`suppression_group_members`

`suppression_groups`

`contacts`

`lists`

`singlesends`

`templates`

`singlesend_stats`

`automations_stats`

`segments`