Menjadwalkan transfer Salesforce

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Catatan: Untuk mendapatkan dukungan atau memberikan masukan terkait fitur ini, hubungi [e-mail].

BigQuery Data Transfer Service untuk Salesforce memungkinkan Anda menjadwalkan dan mengelola tugas pemuatan berulang secara otomatis dari Salesforce ke BigQuery.

Batasan

Transfer Salesforce tunduk pada batasan berikut:

• BigQuery Data Transfer Service untuk Salesforce hanya mendukung Salesforce Bulk API untuk terhubung ke instance Salesforce, dan hanya mendukung transfer entity yang didukung oleh Salesforce Bulk API. Untuk mengetahui informasi selengkapnya tentang entity yang didukung, lihat error'Entity is not supported by the Bulk API'.
• Waktu interval minimum antar-transfer berulang adalah 15 menit. Interval default untuk transfer berulang adalah 24 jam.
• BigQuery Data Transfer Service untuk Salesforce tidak mendukung koneksi ke lingkungan Salesforce Sandbox.

Sebelum memulai

Bagian berikut menjelaskan langkah-langkah yang perlu dilakukan sebelum melakukan transfer Salesforce.

Prasyarat Salesforce

Aktifkan Salesforce Bulk API untuk instance Salesforce.

Buat Aplikasi yang Terhubung ke Salesforce dengan konfigurasi berikut:

• Buat Token Keamanan untuk aplikasi.

• Izinkan nama pengguna dan sandi OAuth dengan melakukan hal berikut:

  1. Di aplikasi yang terhubung, klik Penyiapan.

  2. Di kolom Temukan cepat, telusuri Setelan OAuth dan OpenID Connect, lalu aktifkan.

     

• Aktifkan otorisasi mandiri bagi pengguna untuk aplikasi terhubung dengan melakukan hal berikut:

  1. Di aplikasi yang terhubung, klik Penyiapan.
  2. Di kolom Temukan cepat, telusuri Kelola aplikasi yang terhubung.
  3. Klik Edit di aplikasi terhubung yang Anda gunakan untuk proses transfer.

  4. Di bagian Kebijakan OAuth, klik menu Pengguna yang Diizinkan, lalu pilih Semua pengguna dapat memberikan otorisasi mandiri.

     

  5. Di bagian Relaxation IP, pilih Relax IP restrictions.

     

Anda juga harus memiliki informasi Salesforce berikut saat membuat transfer Salesforce:

Nama Parameter	Deskripsi
clientId	ClientId atau Kunci Konsumen dari aplikasi yang terhubung Salesforce.
clientSecret	Rahasia Klien OAuth atau Rahasia Konsumen dari aplikasi yang terhubung dengan Salesforce.
username	Nama pengguna akun Salesforce.
password	Sandi akun Salesforce.
securityToken	Token Keamanan akun Salesforce. Token keamanan ini adalah kode alfanumerik yang peka huruf besar/kecil yang ditambahkan ke sandi. Token keamanan diperlukan saat mengakses API Salesforce dari luar rentang IP Tepercaya konfigurasi Salesforce Anda.

Prasyarat BigQuery

• Pastikan Anda telah menyelesaikan semua tindakan yang diperlukan untuk mengaktifkan BigQuery Data Transfer Service.
• Buat set data BigQuery untuk menyimpan data Anda.
• Jika ingin menyiapkan notifikasi operasi transfer untuk Pub/Sub, pastikan Anda memiliki izin Identity and Access Management (IAM) pubsub.topics.setIamPolicy. Izin Pub/Sub tidak diperlukan jika Anda hanya menyiapkan notifikasi email. Untuk mengetahui informasi selengkapnya, lihat Notifikasi operasi BigQuery Data Transfer Service.

Peran BigQuery yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk membuat transfer, minta administrator untuk memberi Anda peran IAM BigQuery Admin (roles/bigquery.admin). Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditentukan ini berisi izin yang diperlukan untuk membuat transfer. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat transfer:

• bigquery.transfers.update pada pengguna
• bigquery.datasets.get di set data target
• bigquery.datasets.update di set data target

Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

Menyiapkan transfer data Salesforce

Untuk membuat transfer data Salesforce:

Konsol

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Klik Transfer data > Buat transfer.

3. Di bagian Jenis sumber, untuk Sumber, pilih Salesforce.

4. Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer.

5. Di bagian Schedule options:

   • Dalam daftar Repeat frekuensi, pilih opsi untuk menentukan seberapa sering transfer ini berjalan. Untuk menentukan frekuensi pengulangan kustom, pilih Kustom. Jika Anda memilih On-demand, transfer ini akan berjalan saat Anda memicu transfer secara manual.

   • Jika berlaku, pilih Start now atau Start at set time dan masukkan tanggal mulai dan waktu proses.

6. Di bagian Setelan tujuan, untuk Set data, pilih set data yang Anda buat untuk menyimpan data.

7. Di bagian Detail sumber data, lakukan hal berikut:

   • Untuk Domain Kustom, masukkan domain login kustom jika berlaku.
   • Untuk Username, masukkan nama pengguna akun Salesforce.
   • Untuk Sandi, masukkan sandi akun Salesforce.
   • Untuk Token keamanan, masukkan token keamanan akun Salesforce.
   • Untuk Client-ID, masukkan Kunci Konsumen aplikasi yang terhubung dari Salesforce.
   • Untuk Rahasia klien, masukkan Rahasia Konsumen aplikasi yang terhubung dengan Salesforce.

   • Untuk Objek Salesforce yang akan ditransfer, klik Browse untuk memilih objek yang akan ditransfer ke set data tujuan BigQuery.

     • Anda juga dapat memasukkan objek apa pun secara manual untuk disertakan dalam transfer di kolom ini.

     

8. Dalam daftar Service Account, pilih akun layanan yang terkait dengan project Google Cloud Anda. Akun layanan yang dipilih harus memiliki peran yang diperlukan untuk menjalankan transfer ini.

   Jika Anda login dengan identitas gabungan, akun layanan diperlukan untuk membuat transfer. Jika Anda login dengan Akun Google, akun layanan untuk transfer bersifat opsional.

   Untuk informasi selengkapnya tentang cara menggunakan akun layanan dengan transfer data, lihat Menggunakan akun layanan.

9. Opsional: Di bagian Opsi notifikasi, lakukan hal berikut:

   • Untuk mengaktifkan notifikasi email, klik tombol Notifikasi email. Jika Anda mengaktifkan opsi ini, administrator transfer akan menerima notifikasi email saat proses transfer gagal.
   • Guna mengaktifkan notifikasi run Pub/Sub untuk transfer ini, klik tombol Notifikasi Pub/Sub. Anda dapat memilih nama topic, atau mengklik Create a topic untuk membuatnya.

10. Klik Save.

bq

Masukkan perintah bq mk dan berikan tanda pembuatan transfer --transfer_config:

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Dengan keterangan:

• PROJECT_ID (opsional): project ID Google Cloud Anda. Jika --project_id tidak diberikan untuk menentukan project tertentu, project default akan digunakan.
• DATA_SOURCE: sumber data — salesforce.
• NAME: nama tampilan untuk konfigurasi transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika Anda perlu mengubahnya nanti.
• DATASET: set data target untuk konfigurasi transfer.

• PARAMETERS: parameter untuk konfigurasi transfer yang dibuat dalam format JSON. Contoh: --params='{"param":"param_value"}'. Berikut adalah parameter untuk transfer Salesforce:

  • connector.authentication.oauth.clientId: ClientId atau Kunci Konsumen dari aplikasi yang terhubung ke Salesforce.
  • connector.authentication.oauth.clientSecret: Rahasia Klien OAuth atau Rahasia Konsumen dari aplikasi yang terhubung dengan Salesforce.
  • connector.customDomainName (opsional): Domain Login Kustom Salesforce, jika berlaku. Biarkan kosong untuk menggunakan domain login default login.Salesforce.com.
  • connector.authentication.username: nama pengguna akun Salesforce.
  • connector.authentication.password: sandi akun Salesforce.
  • connector.authentication.securityToken: token keamanan akun Salesforce.
  • assets: jalur ke objek Salesforce yang akan ditransfer ke BigQuery.

Misalnya, perintah berikut akan membuat transfer Salesforce dalam project default dengan semua parameter yang diperlukan:

bq mk \
    --transfer_config \
    --target_dataset=mydataset \
    --data_source=salesforce \
    --display_name='My Transfer' \
    --params='{"assets":["Account"],
        "connector.authentication.oauth.clientId": "1234567890",
        "connector.authentication.oauth.clientSecret":"ABC12345",
        "connector.customDomainName":"MyDomainName",
        "connector.authentication.username":"[e-mail]",
        "Connector.authentication.password":"abcdef1234",
        "connector.authentication.securityToken":"a1hghbb44lnl465lbl75b",}'

API

Gunakan metode projects.locations.transferConfigs.create dan berikan instance resource TransferConfig.

Harga

Tidak ada biaya untuk mentransfer data Salesforce ke BigQuery saat fitur ini berada dalam Pratinjau.

Memecahkan masalah penyiapan transfer

Jika Anda mengalami masalah saat menyiapkan transfer, lihat Masalah transfer Salesforce.

Langkah selanjutnya

• Untuk ringkasan BigQuery Data Transfer Service, lihat Pengantar BigQuery Data Transfer Service.
• Untuk informasi cara menggunakan transfer, termasuk mendapatkan informasi tentang konfigurasi transfer, membuat listingan konfigurasi transfer, dan melihat histori pelaksanaan transfer, lihat Menangani transfer.
• Pelajari cara memuat data dengan operasi lintas-cloud.