Referência do conector SendGrid

info

Beta

Esse recurso está em Beta. Para usá-lo, o administrador do workspace deve ativar o Lakeflow Connect for SendGrid na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Esta página contém informações de referência para o conector SendGrid gerenciado, incluindo tabelas de origem compatíveis e esquemas de tabela de destino.

Tabelas de origem compatíveis

O conector SendGrid oferece suporte às seguintes tabelas de origem, todas sob o esquema de origem default:

Tabela de origem	Chave primária	Descrição	Modo de sincronização	Campo do cursor
subusers	id	Os subusuários sob a conta pai do SendGrid, incluindo o nome de usuário, email e estado desativado de cada subusuário.	Apenas refresh completo
recent_access_attempts	subuser, ip	Tentativas recentes de acesso de IP para cada subusuário, recuperadas em nome do subusuário.	Apenas refresh completo
parent_access_attempts	ip	Tentativas recentes de acesso IP para a account pai propriamente dita.	Apenas refresh completo
bounces		Endereços de email na lista de supressão de rejeições, com o status e o motivo da rejeição.	Apenas refresh completo
spam_reports		Endereços de email na lista de supressão de relatório de spam.	Apenas refresh completo
global_suppressions		Endereços de email que cancelaram a assinatura de todos os emails.	Apenas refresh completo
blocks		Endereços de email na lista de supressão de bloqueios, com o status e o motivo do bloqueio.	Apenas refresh completo
invalid_emails		Endereços de email na lista de supressão de endereços de email inválidos, com o motivo.	Apenas refresh completo
suppression_group_members	group_id, email	Endereços de email suprimidos de um grupo de cancelamento de assinatura, com o grupo ao qual pertencem.	Apenas refresh completo
suppression_groups	id	Os grupos de cancelamento de assinatura (supressão) definidos na account.	Apenas refresh completo
contacts	contact_id	Contatos de marketing, incluindo campos personalizados. O conector lê a lista completa de contatos por meio da exportação de contatos do SendGrid.	Apenas refresh completo
lists	id	Listas de contatos de marketing, com o número de contatos em cada lista.	Apenas refresh completo
singlesends	id	Envios únicos de marketing, incluindo status, categorias e configurações de testes A/B.	Apenas refresh completo
templates	id	Padrões de email transacionais legados e dinâmicos, com suas versões.	Apenas refresh completo
singlesend_stats	id, ab_phase, ab_variation, aggregation	Estatísticas de engajamento para Single Sends, uma linha por Single Send, fase A/B, variação A/B e agregação.	Apenas refresh completo
automations_stats	id, step_id, aggregation	Estatísticas de engajamento das automações, uma linha por automação, o passo e agregação.	Apenas refresh completo
segments	id	Segmentos de marketing (Segmentation v2), com contagens de contatos e status de validação da query.	Apenas refresh completo

Tabela de origem	Chave primária	Descrição	Modo de sincronização	Campo do cursor
subusers	id	Os subusuários sob a conta pai do SendGrid, incluindo o nome de usuário, email e estado desativado de cada subusuário.	Apenas refresh completo
recent_access_attempts	subuser, ip	Tentativas recentes de acesso de IP para cada subusuário, recuperadas em nome do subusuário.	Apenas refresh completo
parent_access_attempts	ip	Tentativas recentes de acesso IP para a account pai propriamente dita.	Apenas refresh completo
bounces		Endereços de email na lista de supressão de rejeições, com o status e o motivo da rejeição.	Apenas refresh completo
spam_reports		Endereços de email na lista de supressão de relatório de spam.	Apenas refresh completo
global_suppressions		Endereços de email que cancelaram a assinatura de todos os emails.	Apenas refresh completo
blocks		Endereços de email na lista de supressão de bloqueios, com o status e o motivo do bloqueio.	Apenas refresh completo
invalid_emails		Endereços de email na lista de supressão de endereços de email inválidos, com o motivo.	Apenas refresh completo
suppression_group_members	group_id, email	Endereços de email suprimidos de um grupo de cancelamento de assinatura, com o grupo ao qual pertencem.	Apenas refresh completo
suppression_groups	id	Os grupos de cancelamento de assinatura (supressão) definidos na account.	Apenas refresh completo
contacts	contact_id	Contatos de marketing, incluindo campos personalizados. O conector lê a lista completa de contatos por meio da exportação de contatos do SendGrid.	Apenas refresh completo
lists	id	Listas de contatos de marketing, com o número de contatos em cada lista.	Apenas refresh completo
singlesends	id	Envios únicos de marketing, incluindo status, categorias e configurações de testes A/B.	Apenas refresh completo
templates	id	Padrões de email transacionais legados e dinâmicos, com suas versões.	Apenas refresh completo
singlesend_stats	id, ab_phase, ab_variation, aggregation	Estatísticas de engajamento para Single Sends, uma linha por Single Send, fase A/B, variação A/B e agregação.	Apenas refresh completo
automations_stats	id, step_id, aggregation	Estatísticas de engajamento das automações, uma linha por automação, o passo e agregação.	Apenas refresh completo
segments	id	Segmentos de marketing (Segmentation v2), com contagens de contatos e status de validação da query.	Apenas refresh completo

Opções de conector

O conector SendGrid não possui opções de configuração adicionais além das configurações de pipeline disponíveis para todos os conectores gerenciados. Consulte Ingerir dados do SendGrid.

Esquemas de tabela de destino

subusers

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	BIGINT
username	STRING
email	STRING
disabled	BOOLEAN

campo	Tipo de dados
id	BIGINT
username	STRING
email	STRING
disabled	BOOLEAN

recent_access_attempts

Chave primária: subuser, ip Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
subuser	STRING
allowed	BOOLEAN
auth_method	STRING
first_at	BIGINT
last_at	BIGINT
ip	STRING
location	STRING

campo	Tipo de dados
subuser	STRING
allowed	BOOLEAN
auth_method	STRING
first_at	BIGINT
last_at	BIGINT
ip	STRING
location	STRING

parent_access_attempts

Chave primária: ip Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
allowed	BOOLEAN
auth_method	STRING
first_at	BIGINT
last_at	BIGINT
ip	STRING
location	STRING

campo	Tipo de dados
allowed	BOOLEAN
auth_method	STRING
first_at	BIGINT
last_at	BIGINT
ip	STRING
location	STRING

bounces

Chave key: Nenhuma Modo de sincronização: Somente refresh completo

campo	Tipo de dados
email	STRING
created	BIGINT
status	STRING
reason	STRING

campo	Tipo de dados
email	STRING
created	BIGINT
status	STRING
reason	STRING

spam_reports

Chave key: Nenhuma Modo de sincronização: Somente refresh completo

campo	Tipo de dados
email	STRING
created	BIGINT
ip	STRING

campo	Tipo de dados
email	STRING
created	BIGINT
ip	STRING

global_suppressions

Chave key: Nenhuma Modo de sincronização: Somente refresh completo

campo	Tipo de dados
email	STRING
created	BIGINT

campo	Tipo de dados
email	STRING
created	BIGINT

blocks

Chave key: Nenhuma Modo de sincronização: Somente refresh completo

campo	Tipo de dados
email	STRING
created	BIGINT
status	STRING
reason	STRING

campo	Tipo de dados
email	STRING
created	BIGINT
status	STRING
reason	STRING

invalid_emails

Chave key: Nenhuma Modo de sincronização: Somente refresh completo

campo	Tipo de dados
email	STRING
created	BIGINT
reason	STRING

campo	Tipo de dados
email	STRING
created	BIGINT
reason	STRING

suppression_group_members

Chave primária: group_id, email Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
email	STRING
group_id	BIGINT
group_name	STRING
created_at	BIGINT

campo	Tipo de dados
email	STRING
group_id	BIGINT
group_name	STRING
created_at	BIGINT

suppression_groups

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	BIGINT
name	STRING
description	STRING
is_default	BOOLEAN
unsubscribes	BIGINT

campo	Tipo de dados
id	BIGINT
name	STRING
description	STRING
is_default	BOOLEAN
unsubscribes	BIGINT

contacts

Chave primária: contact_id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
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

campo	Tipo de dados
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

nota

Esta tabela não oferece suporte ao SCD tipo 2 porque contém colunas VARIANT.

lists

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
name	STRING
contact_count	BIGINT
_metadata	STRUCT<self: STRING>

campo	Tipo de dados
id	STRING
name	STRING
contact_count	BIGINT
_metadata	STRUCT<self: STRING>

singlesends

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
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>

campo	Tipo de dados
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

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
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>>

campo	Tipo de dados
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

Chave key: id, ab_phase, ab_variation, aggregation Modo de sincronização: Somente refresh completo

campo	Tipo de dados
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>

campo	Tipo de dados
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

Chave key: id, step_id, aggregation Modo de sincronização: Somente refresh completo

campo	Tipo de dados
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>

campo	Tipo de dados
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

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
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>

campo	Tipo de dados
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>