Menjadwalkan transfer ServiceNow

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

Batasan

Transfer ServiceNow tunduk pada batasan berikut:

  • Menjalankan transfer serentak pada instance ServiceNow yang sama tidak direkomendasikan.
  • Waktu interval minimum antar-transfer berulang adalah 15 menit. Interval default untuk transfer berulang adalah 24 jam.

  • ServiceNow mentransfer tabel terkait bisnis dari tiga aplikasi: Pengadaan, Katalog Produk, dan Manajemen Kontrak. Tabel berikut dapat ditransfer:

    • ast_contract
    • clm_condition_check
    • clm_condition_checker
    • clm_contract_history
    • clm_m2m_contract_and_terms
    • clm_m2m_contract_asset
    • clm_m2m_contract_user
    • clm_m2m_rate_card_asset
    • clm_terms_and_conditions
    • pc_hardware_cat_item
    • pc_product_cat_item
    • pc_software_cat_item
    • pc_vendor_cat_item
    • proc_po
    • proc_po_item
    • proc_rec_slip
    • proc_rec_slip_item

Sebelum memulai

Sebelum Anda membuat transfer ServiceNow, buat konfigurasi berikut untuk ServiceNow dan BigQuery.

Prasyarat ServiceNow

Prasyarat BigQuery

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 ServiceNow

Transfer data ServiceNow dapat dibuat di Konsol Google Cloud atau alat command line bq.

Konsol

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Klik Transfer data > Buat transfer.

  3. Di bagian Source type, untuk Source, pilih ServiceNow.

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

  5. Di bagian Opsi jadwal, lakukan tindakan berikut:

    • 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 Destination settings, untuk Dataset, pilih set data yang Anda buat untuk menyimpan data.

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

    • Untuk ID Instance, masukkan ID instance ServiceNow. Anda bisa mendapatkannya dari URL ServiceNow, misalnya, https://INSTANCE_ID.service-now.com.
    • Untuk Username, masukkan nama pengguna ServiceNow yang akan digunakan untuk koneksi.
    • Untuk Password, masukkan sandi ServiceNow.
    • Untuk Client-ID, masukkan client ID dari kredensial OAuth Anda. Untuk membuat kredensial, lihat Membuat Kredensial OAuth.
    • Untuk Rahasia klien, masukkan rahasia klien dari kredensial OAuth Anda.
    • Untuk Jenis nilai, pilih salah satu opsi berikut:
      • Untuk mentransfer nilai yang tersimpan dalam database, pilih Aktual.
      • Untuk mentransfer nilai tampilan kolom, pilih Tampilan.

  8. Di menu Service Account, pilih service account dari 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 mengetahui 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=DISPLAY_NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Ganti kode berikut:

  • PROJECT_ID (opsional): Project ID Google Cloud Anda. Jika project ID tidak ditentukan, project default akan digunakan.
  • DATA_SOURCE: sumber data (misalnya, servicenow).
  • DISPLAY_NAME: nama tampilan untuk konfigurasi transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika 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 ServiceNow:

    Parameter ServiceNow Wajib diisi atau opsional Deskripsi
    connector.instanceId Diperlukan ID instance ServiceNow
    connector.authentication.username Diperlukan Nama pengguna kredensial
    connector.authentication.password Diperlukan Sandi kredensial
    connector.authentication.oauth.clientId Diperlukan Client ID OAuth yang dibuat
    connector.authentication.oauth.clientSecret Diperlukan Rahasia Klien dari OAuth yang dihasilkan
    connector.valueType Opsional Actual atau Display (default: Actual)

    Misalnya, perintah berikut akan membuat transfer ServiceNow di project default dengan semua parameter yang diperlukan:

      bq mk \
    --transfer_config \
    --target_dataset=mydataset \
    --data_source=servicenow \
    --display_name='My Transfer' \
    --params='{"connector.authentication.oauth.clientId": "1234567890",
        "connector.authentication.oauth.clientSecret":"ABC12345",
        "connector.authentication.username":"user1",
        "Connector.authentication.password":"abcdef1234",
        "connector.instanceId":"https://dev-instance.service-now.com"}'

API

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

Memecahkan masalah transfer

Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah konfigurasi transfer.

Transfer gagal karena pengaktifan ServiceNow

Terjadi masalah yang menyebabkan transfer gagal saat aplikasi Pengadaan, Katalog Produk, atau Pengelolaan Kontrak tidak diaktifkan di ServiceNow. Untuk memperbaikinya, aktifkan ketiga aplikasi tersebut. Misalnya, aktifkan Pengadaan.

Terjadi masalah selama proses transfer

Terjadi masalah yang menyebabkan proses transfer tidak dibuat sebagaimana mestinya. Untuk mengatasi masalah ini, lakukan langkah berikut:

  • Pastikan kredensial akun ServiceNow, seperti nilai Username, Password, Client ID, dan Client secret, adalah valid.
  • Pastikan ID Instance adalah ID yang valid dari instance ServiceNow Anda.

Harga

Transfer data ServiceNow ke BigQuery tidak dikenai biaya saat fitur ini berada dalam Pratinjau.

Langkah selanjutnya