Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verbindung herstellen zu SendGrid
SendGrid ist eine Kundenkommunikationsplattform für Transaktions- und Marketing-E-Mails.
+ SendGrid Connector hilft bei der Erstellung und Verwaltung von Kontaktlisten sowie bei der Erstellung von E-Mail-Marketingkampagnen.
+ SendGrid ermöglicht es Online-Unternehmen, gemeinnützigen Organisationen und anderen Online-Organisationen, Marketing-E-Mails zu erstellen und an ein großes Publikum zu senden und die Interaktion mit diesen E-Mails zu überwachen.
**Topics**
+ [AWS Glue Unterstützung für SendGrid](sendgrid-support.md)
+ [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](sendgrid-configuring-iam-permissions.md)
+ [Konfiguration SendGrid](sendgrid-configuring.md)
+ [SendGrid Verbindungen konfigurieren](sendgrid-configuring-connections.md)
+ [Aus SendGrid Entitäten lesen](sendgrid-reading-from-entities.md)
+ [SendGrid Verbindungsoptionen](sendgrid-connection-options.md)
+ [SendGrid Einschränkungen](sendgrid-limitations.md)
# AWS Glue Unterstützung für SendGrid
AWS Glue unterstützt SendGrid wie folgt:
**Als Quelle unterstützt?**
Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten von abzufragen SendGrid.
**Als Ziel unterstützt?**
Nein.
**Unterstützte SendGrid API-Versionen**
Die folgenden SendGrid API-Versionen werden unterstützt:
+ v3
# Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten
Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS IAM-Berechtigungen für das Erstellen und Verwenden von Verbindungen. Wenn Sie eine neue Rolle erstellen, erstellen Sie eine Richtlinie, die Folgendes enthält:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Wenn Sie die oben genannte Methode nicht verwenden möchten, verwenden Sie alternativ die folgenden verwalteten IAM-Richtlinien:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Gewährt Zugriff auf Ressourcen, die verschiedene AWS Glue Prozesse benötigen, um in Ihrem Namen ausgeführt zu werden. Zu diesen Ressourcen gehören AWS Glue Amazon S3, IAM, CloudWatch Logs und Amazon EC2. Wenn Sie die in dieser Richtlinie angegebene Benennungskonvention für Ressourcen einhalten, verfügen AWS Glue Prozesse über die erforderlichen Berechtigungen. Diese Richtlinie wird typischerweise mit Rollen verknüpft, die bei der Definition von Crawlern, Aufträgen und Entwicklungsendpunkten angegeben werden.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Gewährt vollen Zugriff auf AWS Glue Ressourcen, wenn eine Identität, der die Richtlinie zugeordnet ist, die AWS Managementkonsole verwendet. Wenn Sie die Namenskonvention für Ressourcen befolgen, die in dieser Richtlinie angegeben sind, haben Benutzer alle Konsolenfunktionalitäten. Diese Richtlinie wird normalerweise Benutzern der AWS Glue Konsole zugewiesen.
# Konfiguration SendGrid
Bevor Sie Daten von AWS Glue übertragen können SendGrid, müssen Sie die folgenden Anforderungen erfüllen:
## Mindestanforderungen
Die folgenden Anforderungen sind Mindestanforderungen:
+ Sie haben ein SendGrid Konto mit einem API-Schlüssel.
+ Ihr SendGrid Konto hat API-Zugriff mit einer gültigen Lizenz.
Wenn Sie diese Anforderungen erfüllen, können Sie eine Verbindung AWS Glue zu Ihrem SendGrid Konto herstellen. Für typische Verbindungen müssen Sie nichts weiter tun SendGrid.
# SendGrid Verbindungen konfigurieren
SendGrid unterstützt benutzerdefinierte Authentifizierung.
Öffentliche SendGrid Dokumentation zur Generierung der erforderlichen API-Schlüssel für die benutzerdefinierte Authentifizierung finden Sie unter [Authentifizierung](https://www.twilio.com/docs/sendgrid/api-reference/how-to-use-the-sendgrid-v3-api/authentication).
So konfigurieren Sie eine SendGrid Verbindung:
1. Erstellen Sie in AWS Secrets Manager ein Secret mit den folgenden Details:
1. Für die kundenseitig verwaltete verbundene App muss das Geheimnis das Verbrauchergeheimnis der verbundenen App mit `api_key` als Schlüssel enthalten.
1. Hinweis: Sie müssen ein Geheimnis für Ihre Verbindungen in erstellen AWS Glue.
1. Erstellen Sie in AWS Glue Glue Studio eine Verbindung unter **Datenverbindungen**, indem Sie die folgenden Schritte ausführen:
1. Wählen Sie bei der Auswahl eines **Verbindungstyps** SendGrid.
1. Geben Sie die SendGrid Instanz `INSTANCE_URL` an, zu der Sie eine Verbindung herstellen möchten.
1. Wählen Sie die AWS IAM-Rolle aus, die die folgenden Aktionen übernehmen AWS Glue kann und über Berechtigungen verfügt:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Wählen Sie `secretName` die aus, in die Sie für diese Verbindung die Token einfügen AWS Glue möchten.
1. Wählen Sie die Netzwerkoptionen aus, wenn Sie Ihr Netzwerk verwenden möchten.
1. Erteilen Sie der mit Ihrem AWS Glue Job verknüpften IAM-Rolle `secretName` Leserechte.
# Aus SendGrid Entitäten lesen
**Voraussetzung**
Ein SendGrid Objekt, aus dem Sie lesen möchten. Sie benötigen den Objektnamen, z. B. `lists`, `singlesends` oder `segments`.
**Unterstützte Entitäten für Quelle**:
| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung |
| --- | --- | --- | --- | --- | --- |
| Listen | Nein | Ja | Nein | Ja | Nein |
| Einzelne Sendungen | Ja | Ja | Nein | Ja | Nein |
| Statistiken zu Marketingkampagnen – Automatisierungen | Ja | Ja | Nein | Ja | Nein |
| Statistiken zu Marketingkampagnen – Einzelne Sendungen | Ja | Ja | Nein | Ja | Nein |
| Segmente | Ja | Nein | Nein | Ja | Nein |
| Kontakte | Ja | Nein | Nein | Ja | Nein |
| Kategorie | Nein | Nein | Nein | Ja | Nein |
| Statistiken | Ja | Nein | Nein | Ja | Nein |
| Gruppen abmelden | Ja | Nein | Nein | Ja | Nein |
**Beispiel:**
```
sendgrid_read = glueContext.create_dynamic_frame.from_options(
connection_type="sendgrid",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "lists",
"API_VERSION": "v3",
"INSTANCE_URL": "instanceUrl"
}
```
**SendGrid Entitäts- und Felddetails**:
Entitäten mit statischen Metadaten:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/sendgrid-reading-from-entities.html)
**Anmerkung**
Die Datentypen Struct und List werden in den Datentyp String konvertiert, und der DateTime Datentyp wird in der Antwort der Konnektoren in Timestamp konvertiert.
## Partitionierung von Abfragen
SendGrid unterstützt keine filterbasierte Partitionierung oder datensatzbasierte Partitionierung.
# SendGrid Verbindungsoptionen
Im Folgenden finden Sie Verbindungsoptionen für SendGrid:
+ `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Der Name Ihres Objekts in SendGrid.
+ `API_VERSION`(Zeichenfolge) — (Erforderlich) Wird zum Lesen verwendet. SendGrid Rest-API-Version, die Sie verwenden möchten.
+ `INSTANCE_URL` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Eine gültige SendGrid Instanz-URL.
+ `SELECTED_FIELDS` (Liste) – Standard: leer(SELECT \$1). Zum Lesen verwendet. Spalten, die Sie für das Objekt auswählen möchten.
+ `FILTER_PREDICATE`(Zeichenfolge) – Standard: leer. Zum Lesen verwendet. Muss das Spark-SQL-Format aufweisen.
+ `QUERY`(Zeichenfolge) – Standard: leer Zum Lesen verwendet. Vollständige Spark-SQL-Abfrage.
# SendGrid Einschränkungen
Im Folgenden finden Sie Einschränkungen oder Hinweise für SendGrid:
+ Der inkrementelle Abruf wird nur von der Stats-Entität für das `start_date`-Feld und von der Contact-Entität für das Feld `event_timestamp` unterstützt.
+ Paginierung wird nur von den Entitäten „Statistiken zu Marketingkampagnen (Automatisierungen)“, „Statistiken zu Marketingkampagnen (Einzelne Sendungen)“, „Einzelne Sendungen“ und „Listen“ unterstützt.
+ Für die Stats-Entität ist `start_date` ein obligatorischer Filterparameter.
+ Ein API-Schlüssel mit eingeschränktem Zugriff kann keinen Lesezugriff für die E-Mail-API- und Statistik-Entitäten unterstützen. Verwenden Sie einen API-Schlüssel mit Vollzugriff. Weitere Informationen finden Sie unter [API-Übersicht](https://www.twilio.com/docs/sendgrid/api-reference/api-keys/create-api-keys#api-overview).