Pengantar transfer Salesforce

Anda dapat memuat data dari Salesforce Sales Cloud ke BigQuery menggunakan konektor BigQuery Data Transfer Service untuk Salesforce. Dengan BigQuery Data Transfer Service, Anda dapat menjadwalkan tugas transfer berulang yang menambahkan data terbaru dari Salesforce Sales Cloud ke BigQuery.

Untuk mempelajari cara menjadwalkan transfer Salesforce, lihat Memuat data Salesforce ke BigQuery.

Opsi penyerapan data

Bagian berikut memberikan informasi selengkapnya tentang opsi penyerapan data saat Anda menyiapkan transfer data Salesforce.

Transfer penuh atau inkremental

Anda dapat menentukan cara data dimuat ke BigQuery dengan memilih preferensi tulis Penuh atau Bertahap dalam konfigurasi transfer saat menyiapkan transfer Salesforce.

Anda dapat mengonfigurasi transfer data penuh untuk mentransfer semua data dari set data Salesforce Anda dengan setiap transfer data.

Atau, Anda dapat mengonfigurasi transfer data inkremental untuk hanya mentransfer data yang diubah sejak transfer data terakhir, bukan memuat seluruh set data dengan setiap transfer data. Jika memilih Bertahap untuk transfer data, Anda harus menentukan mode penulisan Tambahkan atau Upsert untuk menentukan cara data ditulis ke BigQuery selama transfer data bertahap. Bagian berikut menjelaskan mode penulisan yang tersedia.

Mode tulis tambahan

Mode penulisan penambahan hanya menyisipkan baris baru ke tabel tujuan Anda. Opsi ini menambahkan data yang ditransfer secara ketat tanpa memeriksa catatan yang ada, sehingga mode ini berpotensi menyebabkan duplikasi data dalam tabel tujuan.

Saat memilih mode penambahan, Anda harus memilih kolom watermark. Kolom tanda air diperlukan agar konektor Salesforce dapat melacak perubahan dalam tabel sumber.

Pilih kolom tanda air yang hanya diperbarui saat data dibuat, dan tidak akan berubah dengan pembaruan berikutnya—misalnya, kolom CreatedDate.

Mode penulisan upsert

Mode penulisan upsert memperbarui baris atau menyisipkan baris baru di tabel tujuan dengan memeriksa kunci utama. Anda dapat menentukan kunci utama agar konektor Salesforce dapat menentukan perubahan yang diperlukan untuk terus memperbarui tabel tujuan dengan tabel sumber. Jika kunci primer yang ditentukan ada di tabel BigQuery tujuan selama transfer data, konektor Salesforce akan memperbarui baris tersebut dengan data baru dari tabel sumber. Jika kunci utama tidak ada selama transfer data, konektor Salesforce akan menyisipkan baris baru.

Saat memilih mode upsert, Anda harus memilih kolom watermark dan kunci utama:

  • Kolom tanda air diperlukan agar konektor Salesforce dapat melacak perubahan dalam tabel sumber.

    Pilih kolom tanda air yang diperbarui setiap kali baris diubah. Sebaiknya gunakan kolom SystemModstamp atau LastModifiedDate.

  • Kunci utama dapat berupa satu atau beberapa kolom di tabel yang diperlukan agar konektor Salesforce dapat menentukan apakah perlu menyisipkan atau memperbarui baris.

    Pilih kolom yang berisi nilai non-null yang unik di semua baris tabel. Sebaiknya gunakan kolom yang menyertakan ID yang dibuat sistem, kode referensi unik (misalnya, ID yang bertambah otomatis), atau ID urutan berbasis waktu yang tidak dapat diubah.

    Untuk mencegah potensi hilangnya data atau kerusakan data, kolom kunci utama yang Anda pilih harus memiliki nilai unik. Jika Anda meragukan keunikan kolom kunci utama yang Anda pilih, sebaiknya gunakan mode penulisan penambahan.

Perilaku penyerapan inkremental

Saat Anda membuat perubahan pada skema tabel di sumber data, transfer data inkremental dari tabel tersebut akan tercermin di BigQuery dengan cara berikut:

Perubahan pada sumber data Perilaku penyerapan inkremental
Menambahkan kolom baru Kolom baru ditambahkan ke tabel BigQuery tujuan. Semua data sebelumnya untuk kolom ini akan memiliki nilai null.
Menghapus kolom Kolom yang dihapus tetap ada di tabel BigQuery tujuan. Entri baru ke kolom yang dihapus ini diisi dengan nilai null.
Mengubah jenis data dalam kolom Konektor hanya mendukung konversi jenis data yang didukung oleh pernyataan DDL ALTER COLUMN. Konversi jenis data lainnya akan menyebabkan transfer data gagal.

Jika Anda mengalami masalah, sebaiknya buat konfigurasi transfer baru.
Mengganti nama kolom Kolom asli tetap ada di tabel BigQuery tujuan seperti apa adanya, sementara kolom baru ditambahkan ke tabel tujuan dengan nama yang diperbarui.

Pemetaan jenis data

Tabel berikut memetakan jenis data Salesforce ke jenis data BigQuery yang sesuai:

Jenis data Salesforce Jenis data BigQuery
_bool BOOLEAN
_int INTEGER
_long INTEGER
_double FLOAT
currency FLOAT
percent FLOAT
geolocation (latitude) FLOAT
geolocation (longitude) FLOAT
date DATE
datetime TIMESTAMP
time TIME
picklist STRING
multipicklist STRING
combobox STRING
reference STRING
base64 STRING
textarea STRING
phone STRING
id STRING
url STRING
email STRING
encryptedstring STRING
datacategorygroupreference STRING
location STRING
address STRING
anyType STRING

Harga

Untuk mengetahui informasi harga tentang transfer Salesforce, lihat Harga Data Transfer Service.

Langkah berikutnya