Menyalin data dari ServiceNow menggunakan Azure Data Factory atau Synapse Analytics (warisan)
BERLAKU UNTUK: Azure Data Factory
Azure Synapse Analytics
Tip
Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!
Artikel ini menguraikan cara menggunakan Aktivitas Salin di alur Azure Data Factory dan Synapse Analytics untuk menyalin data dari ServiceNow. Artikel tersebut dibuat berdasarkan artikel gambaran umum aktivitas salin yang menyajikan gambaran umum aktivitas salin.
Penting
Layanan ini telah merilis konektor ServiceNow baru yang menyediakan dukungan ServiceNow asli yang lebih baik, lihat artikel konektor ServiceNow tentang detailnya.
Kemampuan yang didukung
Konektor ServiceNow ini didukung untuk kemampuan berikut:
Kemampuan yang didukung | IR |
---|---|
Aktivitas penyalinan (sumber/-) | (1) (2) |
Aktivitas pencarian | (1) (2) |
① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri
Untuk daftar penyimpanan data yang didukung sebagai sumber/sink, lihat tabel Penyimpanan data yang didukung.
Layanan ini menyediakan driver bawaan untuk mengaktifkan konektivitas. Oleh karena itu, Anda tidak perlu menginstal driver apa pun secara manual untuk menggunakan konektor ini.
Memulai
Untuk melakukan aktivitas Salin dengan alur, Anda dapat menggunakan salah satu alat atau SDK berikut:
- Alat Penyalinan Data
- Portal Microsoft Azure
- SDK .NET
- SDK Python
- Azure PowerShell
- REST API
- Templat Azure Resource Manager
Buat layanan tertaut ke ServiceNow menggunakan antarmuka pengguna
Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke ServiceNow di antarmuka pengguna portal Microsoft Azure.
Telusuri ke tab Kelola di ruang kerja Azure Data Factory atau Synapse Anda dan pilih Layanan Tertaut, lalu klik Baru:
Cari ServiceNow dan pilih konektor ServiceNow.
Konfigurasikan detail layanan, uji koneksi, dan buat layanan tertaut baru.
Detail konfigurasi konektor
Bagian berikut memberikan detail tentang properti yang digunakan untuk menentukan entitas Azure Data Factory khusus untuk konektor ServiceNow.
Properti layanan tertaut
Berikut adalah properti yang didukung untuk layanan tertaut ServiceNow:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti jenis harus ditetapkan ke: ServiceNow | Ya |
titik akhir | Titik akhir server ServiceNow (http://<instance>.service-now.com ). |
Ya |
authenticationType | Jenis autentikasi untuk digunakan. Nilai yang diizinkan: Dasar, OAuth2 |
Ya |
Nama pengguna | Nama pengguna yang digunakan untuk menyambungkan ke server ServiceNow untuk autentikasi Dasar dan OAuth2. | Ya |
kata sandi | Kata sandi yang sesuai dengan nama pengguna untuk autentikasi Dasar dan OAuth2. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. | Ya |
clientId | ID klien untuk autentikasi OAuth2. | No |
clientSecret | Rahasia klien untuk autentikasi OAuth2. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. | No |
useEncryptedEndpoints | Menentukan apakah titik akhir sumber data dienkripsi menggunakan HTTPS. Nilai defaultnya adalah true. | No |
useHostVerification | Menentukan apakah mewajibkan nama host di sertifikat server agar sesuai dengan nama host server saat menyambungkan melalui TLS. Nilai defaultnya adalah true. | No |
usePeerVerification | Menentukan apakah akan memverifikasi identitas server ketika menyambungkan melalui TLS. Nilai defaultnya adalah true. | No |
Contoh:
{
"name": "ServiceNowLinkedService",
"properties": {
"type": "ServiceNow",
"typeProperties": {
"endpoint" : "http://<instance>.service-now.com",
"authenticationType" : "Basic",
"username" : "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
}
}
}
Properti himpunan data
Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan himpunan data, lihat artikel himpunan data. Bagian ini menyediakan daftar properti yang didukung oleh himpunan data ServiceNow.
Untuk menyalin data dari ServiceNow, tetapkan properti jenis himpunan data ke ServiceNowObject. Berikut adalah properti yang didukung:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti jenis himpunan data harus ditetapkan ke: ServiceNowObject | Ya |
tableName | Nama tabel. | Tidak (jika "kueri" di sumber aktivitas ditentukan) |
Contoh
{
"name": "ServiceNowDataset",
"properties": {
"type": "ServiceNowObject",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<ServiceNow linked service name>",
"type": "LinkedServiceReference"
}
}
}
Properti aktivitas salin
Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat artikel Alur. Bagian ini menyediakan daftar properti yang didukung oleh sumber ServiceNow.
ServiceNow sebagai sumber
Untuk menyalin data dari ServiceNow, tetapkan jenis sumber di aktivitas salin ke ServiceNowSource. Berikut ini properti yang didukung di bagian sumber aktivitas salin:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti jenis sumber aktivitas salin harus ditetapkan ke: ServiceNowSource | Ya |
pertanyaan | Gunakan kueri SQL kustom untuk membaca data. Misalnya: "SELECT * FROM Actual.alm_asset" . |
Tidak (jika "tableName" di himpunan data ditentukan) |
Perhatikan hal berikut ketika menentukan skema dan kolom untuk ServiceNow dalam kueri, dan lihat Tips performa tentang implikasi performa salin.
- Skema: tentukan skema sebagai
Actual
atauDisplay
dalam kueri ServiceNow, yang dapat Anda anggap sebagai parametersysparm_display_value
sebagai true atau false saat memanggil ServiceNow REST API. - Kolom: nama kolom untuk nilai aktual di bawah skema
Actual
adalah[column name]_value
, sedangkan nilai tampilan di bawah skemaDisplay
adalah[column name]_display_value
. Perhatikan bahwa nama kolom harus memetakan ke skema yang digunakan dalam kueri.
Kueri sample:SELECT col_value FROM Actual.alm_asset
ATAU SELECT col_display_value FROM Display.alm_asset
Contoh:
"activities":[
{
"name": "CopyFromServiceNow",
"type": "Copy",
"inputs": [
{
"referenceName": "<ServiceNow input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "ServiceNowSource",
"query": "SELECT * FROM Actual.alm_asset"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Tips performa
Skema yang akan digunakan
ServiceNow memiliki 2 skema yang berbeda, satu adalah "Aktual" yang mengembalikan data aktual, yang lain adalah "Tampilan" yang mengembalikan nilai tampilan data.
Jika Anda memiliki filter dalam kueri Anda, gunakan skema "Aktual" yang memiliki performa salin yang lebih baik. Saat mengueri skema "Aktual", ServiceNow secara asli mendukung filter saat mengambil data untuk hanya mengembalikan kumpulan hasil yang difilter, sedangkan saat mengueri skema "Tampilan", Azure Data Factory mengambil semua data dan menerapkan filter secara internal.
Indeks
Indeks tabel ServiceNow dapat membantu meningkatkan performa kueri, lihat Membuat indeks tabel.
Properti aktivitas pencarian
Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.
Konten terkait
Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink oleh aktivitas salin, lihat penyimpanan data yang didukung.