---
title: SendGrid
description: SendGridを接続して同期の動作を把握し、書き込まれるすべてのテーブルと列をクエリします。
species: reference
---
# SendGrid

API キーを使って SendGrid を接続します。このソースは `titan.sendgrid` に 6 個の固定テーブルを書き込みます。
```sql
select
  id,
  email,
  first_name
from titan.sendgrid.contacts
limit 10
```

## SendGridを接続する

1. **アプリ**を開き、**アプリを接続**を選択してから、**SendGrid**を選択します。
2. API キーを入力します。
3. テーブルを確認してからソースを保存します。
4. 初回の実行が完了するまで**同期履歴**を確認します。

認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。

## 同期の動作

コンタクト、リスト、キャンペーン、メールテンプレート、配信抑止、全体の配信停止をまとめて同期します。

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトの繰り返し間隔は 4 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルには[システム列](/docs/concepts/your-lake#システム列) `_synced_at` と `_deleted` もあります。以下の列リファレンスにはソースの列のみを記載しています。

## テーブルリファレンス

### `contacts`

`titan.sendgrid.contacts` には 9 個のソース列があります。

```columns table=sendgrid.contacts
id                                      string pk           ソースのフィールド `id`。
email                                   string              ソースのフィールド `email`。
first_name                              string              ソースのフィールド `firstName`。
last_name                               string              ソースのフィールド `lastName`。
city                                    string              ソースのフィールド `city`。
country                                 string              ソースのフィールド `country`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
custom_fields                           json                ソースのフィールド `customFields`。
```

### `lists`

`titan.sendgrid.lists` には 5 個のソース列があります。

```columns table=sendgrid.lists
id                                      string pk           ソースのフィールド `id`。
name                                    string              ソースのフィールド `name`。
contact_count                           integer             ソースのフィールド `contactCount`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `campaigns`

`titan.sendgrid.campaigns` には 6 個のソース列があります。

```columns table=sendgrid.campaigns
id                                      string pk           ソースのフィールド `id`。
name                                    string              ソースのフィールド `name`。
status                                  string              ソースのフィールド `status`。
send_at                                 datetime            ソースのフィールド `sendAt`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `templates`

`titan.sendgrid.templates` には 4 個のソース列があります。

```columns table=sendgrid.templates
id                                      string pk           ソースのフィールド `id`。
name                                    string              ソースのフィールド `name`。
generation                              string              ソースのフィールド `generation`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `suppressions`

`titan.sendgrid.suppressions` には 4 個のソース列があります。

```columns table=sendgrid.suppressions
email                                   string pk           ソースのフィールド `email`。
reason                                  string              ソースのフィールド `reason`。
status                                  string              ソースのフィールド `status`。
created_at                              datetime            ソースのフィールド `createdAt`。
```

### `global_unsubscribes`

`titan.sendgrid.global_unsubscribes` には 2 個のソース列があります。

```columns table=sendgrid.global_unsubscribes
email                                   string pk           ソースのフィールド `email`。
created                                 datetime            ソースのフィールド `created`。
```

## 削除と履歴

行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して `_deleted` を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには `where not _deleted` で絞り込んでください。