Configurar autenticação para o 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 mostra como configurar o SendGrid para habilitar a autenticação a partir do Databricks para o conector do SendGrid. O conector do SendGrid usa uma key de API do SendGrid para ingerir dados no Databricks. Use as credenciais recuperadas a partir d os passos nesta página para criar uma conexão do Unity Catalog no Databricks.

Pré-requisitos

• Uma conta SendGrid em um plano de API de email Pro ou Premier , ou um plano Advanced Marketing Campaigns. Subusuários estão disponíveis apenas nestes planos. Para obter mais informações, consulte Subusuários na documentação do SendGrid.
• Acesso de administrador para criar uma key de API com acesso de leitura aos dados de Subusers, IP Access Management, Suppressions, Unsubscribe Groups, marketing e padrão.
• Para ingerir as tabelas contacts, lists, segments, singlesends, singlesend_stats e automations_stats, é necessária uma account do SendGrid com Campanhas de marketing habilitado.
• Se sua conta tiver o Gerenciamento de acesso por IP ativado, os endereços IP de saída serverless do Databricks deverão estar em sua lista de permissões. O SendGrid bloqueia o acesso à API de endereços IP que não estão na lista.

Configurar o SendGrid

Crie uma key de API do SendGrid com acesso de leitura às APIs das tabelas que você deseja ingerir. Para obter mais informações, consulte chaves de API na documentação do SendGrid.

1. Faça login no aplicativo SendGrid como administrador.

2. Na navegação à esquerda, selecione Configurações > Chaves de API .

3. Clique em Criar API key .

4. Insira um nome para a key e selecione Acesso personalizado .

5. Conceda acesso de leitura às seguintes permissões, de acordo com as tabelas que deseja ingerir. Para saber a qual escopo de key da API cada permissão corresponde, consulte permissões de key da API na documentação do SendGrid.

Permissão	Escopo da key de API	tabelas
Gerenciamento do acesso de IP	Acesso de leitura	recent_access_attempts, parent_access_attempts
Subusuários	Acesso de leitura	subusers, recent_access_attempts
Supressões	suppression.read	bounces, spam_reports, global_suppressions, blocks, invalid_emails
Cancelar assinatura de grupos	asm.groups.read	suppression_groups, suppression_group_members
Marketing	marketing.read	contacts, lists, segments, singlesends, singlesend_stats, automations_stats
Templates	templates.read	templates

Permissão	Escopo da key de API	tabelas
Gerenciamento do acesso de IP	Acesso de leitura	recent_access_attempts, parent_access_attempts
Subusuários	Acesso de leitura	subusers, recent_access_attempts
Supressões	suppression.read	bounces, spam_reports, global_suppressions, blocks, invalid_emails
Cancelar assinatura de grupos	asm.groups.read	suppression_groups, suppression_group_members
Marketing	marketing.read	contacts, lists, segments, singlesends, singlesend_stats, automations_stats
Templates	templates.read	templates

Mantenha cada categoria de permissão expandida enquanto fizer suas seleções. Recolher uma categoria pode causar o reset das seleções. 6. Clique em Criar & Visualizar , depois copie a chave gerada. O SendGrid mostra o valor da key apenas uma vez.

7. Armazene a key com segurança. Você insere esse valor como a key da API ao criar uma conexão no Databricks. Insira apenas o valor da key, sem um prefixo Bearer.

Observe a região de dados da sua account do SendGrid. As accounts de residência de dados na UE usam api.eu.sendgrid.com; todas as outras accounts usam o endpoint global api.sendgrid.com. Você seleciona esta região ao criar a conexão. As tabelas de campanhas de marketing (contacts, lists, segments, singlesends, singlesend_stats e automations_stats) estão disponíveis apenas para accounts da região dos EUA. Não os selecione em uma conexão que use a região eu.

A key de API lê dados somente para a account à qual pertence. Para fazer a ingestão de mais de uma account ou subusuário do SendGrid, crie uma key de API e uma conexão separadas para cada um.

Passos seguintes

Crie uma conexão do SendGrid no Databricks. Consulte Criar uma conexão do SendGrid.