CensusでSnowflake上の顧客データをSendGridのContactsとして連携してみた

2025.09.02
さがらです。
CensusでSnowflake上の顧客データをSendGridのContactsとして連携してみたので、その内容について本記事でまとめてみます。
 検証環境Snowflake：Enterprise（AWS東京リージョン）
Census：Enterprise
SendGrid：Free Trial
 SnowflakeをSourceとして設定まず、SnowflakeをCensusのSourceとして設定する必要があります。
この設定に関しては以下の記事が参考になると思います。
https://dev.classmethod.jp/articles/census-set-source-snowflake/
 SnowflakeでSendGridに連携したいデータを定義SendGridに連携するためのデータを、Snowflake上でテーブルとして定義します。

					
			USE SCHEMA sagara_rawdata_db.sendgrid;

-- テーブルの定義
CREATE TABLE IF NOT EXISTS sendgrid_customers (
    "email" VARCHAR(255),
    "first_name" VARCHAR(255),
    "last_name" VARCHAR(255),
    "address_line_1" VARCHAR(255),
    "address_line_2" VARCHAR(255),
    "city" VARCHAR(255),
    "state_province_region" VARCHAR(255),
    "postal_code" VARCHAR(20),
    "country" VARCHAR(255),
    "phone_number_id" VARCHAR(20),
    "external_id" VARCHAR(255),
    "anonymous_id" VARCHAR(255)
);

-- 5レコードの日本仕様データを
INSERT INTO sendgrid_customers (
    "email",
    "first_name",
    "last_name",
    "address_line_1",
    "address_line_2",
    "city",
    "state_province_region",
    "postal_code",
    "country",
    "phone_number_id",
    "external_id",
    "anonymous_id"
) VALUES
('dummyuser1@example.com', '太郎', '山田', 'ダミー町1-2-3', 'ダミービル 101号室', 'ダミー市', 'ダミー県', '123-4567', 'Japan', '09012345671', 'ext_001', 'anon_001'),
('dummyuser2@example.com', '花子', '鈴木', '架空町4-5-6', '架空アパート 202', '架空市', 'ダミー県', '234-5678', 'Japan', '09012345672', 'ext_002', 'anon_002'),
('dummyuser3@example.com', '一郎', '佐藤', '見本町7-8-9', '見本マンション 303', '見本市', 'ダミー県', '345-6789', 'Japan', '09012345673', 'ext_003', 'anon_003'),
('dummyuser4@example.com', 'さくら', '高橋', 'テスト町10-11-12', 'テストハイツ 404', 'テスト市', 'ダミー県', '456-7890', 'Japan', '09012345674', 'ext_004', 'anon_004'),
('dummyuser5@example.com', '健太', '田中', 'サンプル町13-14-15', 'サンプルコーポ 505', 'サンプル市', 'ダミー県', '567-8901', 'Japan', '09012345675', 'ext_005', 'anon_005');

		
		
INSERT後にテーブルを確認すると、このようにデータが見えます。
 SendGridをDestinationとして設定次に、SendGridをCensusのDestinationとして設定していきます。
https://docs.getcensus.com/destinations/available-destinations/sendgrid
 SendGridのAPIキーを取得まず、SendGridのAPIキーを取得します。
左のメニューのSettingsからAPI Keysを押します。
右上のCreate API Keyを押します。
API Key Nameは任意のものを入れて、API Key PermissionsはFull Accessで、右下のCreate & Viewを押します。
APIキーが表示されるため、コピーして保持しておきます。（後のCensusの設定で利用します。）
 Destinationの設定Censusの左のメニューから、Destinationsを押します。
右上の+ New Destinationを押します。
SendGridを選択します。
Nameに任意の名称を入れて、API Tokenには先程SendGridで確認した内容を入れて、右下のConnectを押します。
次の画面で接続テストが行われます。問題なければ、右下のFinishを押します。
 Syncの設定SnowflakeからSendGridにデータを転送するための、Syncの設定を行います。
左のメニューからSyncsを押し、+ Create a syncを押します。
Select a Sourceでは、事前に作成したテーブルを選択します。（データベースなどが選択できるようになるまで、少し時間がかかるためご注意ください。）
Select a Destinationでは、先程Destinationとして作成したSendGridを設定し、ObjectはContactとします。
Select a Sync Behaviorは、Update or Createとします。
Select a Sync Keyでは、SendGridのContactのEmailとSyncさせるカラムを設定します。
Set Up SendGrid Field Mappingsでは、「Snowflakeのテーブルのカラム」と「SendGridのフィールド」をどうマッピングさせるか設定します。（下図は、Generate Mappingsで設定した内容です。）
Run a Test Syncでは、Run Testを押してテスト実行します。
テスト実行が問題なく終われば、下図のように表示されるため、Nextを押します。（ちなみにRun Testを行うと、画像2枚目のように、1件だけSendGridにデータがSyncされております。）
Select a Run Modeを必要なものに設定して、Createを押します。
 Syncを手動実行実際に作成したSyncを手動実行してみます。
作成したSyncのページに移動し、Run Nowを押します。
Syncが完了すると、下図のように表示されます。
この後、SendGridでContactsを確認すると、5レコード同期されていることが確認できました！
あるContactの詳細画面を見ると、下図のように表示されます。Snowflake上のデータが同期されていることがわかりますね。
 最後にCensusでSnowflake上の顧客データをSendGridのContactsとして連携してみました。
Censusを使うことで、SnowflakeからSendGridにとても簡単にデータを同期できますので、ぜひご活用ください！