Menyalin data dari ServiceNow V2 menggunakan Azure Data Factory atau Synapse Analytics
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
Konektor ServiceNow V2 menyediakan dukungan ServiceNow asli yang ditingkatkan. Jika Anda menggunakan konektor ServiceNow V1 dalam solusi Anda, Anda disarankan untuk meningkatkan konektor ServiceNow anda dengan mudah. Lihat bagian ini untuk detail tentang perbedaan antara V2 dan V1.
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.
Silakan gunakan nilai aktual alih-alih nilai yang ditampilkan di ServiceNow.
Prasyarat
Untuk menggunakan konektor ini, Anda harus memiliki peran dengan setidaknya akses baca ke tabel sys_db_object dan sys_dictionary di ServiceNow.
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 diatur ke: ServiceNowV2 | 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. | Ya untuk autentikasi OAuth |
clientSecret | Rahasia klien untuk autentikasi OAuth2. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. | Ya untuk autentikasi OAuth |
grantType | Menentukan jenis alur OAuth2.0 yang digunakan aplikasi klien untuk mengakses token. Nilai defaultnya adalah kata sandi. | Ya untuk autentikasi OAuth |
Contoh:
{
"name": "ServiceNowLinkedService",
"properties": {
"type": "ServiceNowV2",
"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, atur properti jenis himpunan data ke ServiceNowV2Object. Berikut adalah properti yang didukung:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti jenis himpunan data harus diatur ke: ServiceNowV2Object | Ya |
tableName | Nama tabel. | Ya |
Contoh
{
"name": "ServiceNowDataset",
"properties": {
"type": "ServiceNowV2Object",
"typeProperties": {
"tableName": "<table name>"
},
"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, atur jenis sumber dalam aktivitas salin ke ServiceNowV2Source. Berikut ini properti yang didukung di bagian sumber aktivitas salin:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti jenis sumber aktivitas salin harus diatur ke: ServiceNowV2Source | Ya |
expression | Gunakan ekspresi untuk membaca data. Anda dapat mengonfigurasi ekspresi di Penyusun kueri. Ini memiliki penggunaan yang sama dengan pembangun kondisi di ServiceNow. Untuk petunjuk tentang cara menggunakannya, lihat artikel ini. Anda juga dapat menggunakan parameter ekspresi. | No |
Di bawah expression |
||
jenis | Jenis ekspresi. Nilai dapat berupa Konstanta (default), Unary, Binary, Field dan Nary. | No |
value | Nilai konstanta. | Ya ketika jenis ekspresi adalah Konstanta atau Bidang |
operator | Nilai operator. Untuk informasi selengkapnya tentang operator, lihat Operator yang tersedia untuk bidang pilihan yang berisi string di artikel ini. | Ya ketika jenis ekspresi adalah Unary atau Binary |
operan | Daftar ekspresi tempat operator diterapkan. | Ya ketika jenis ekspresi adalah Unary atau Binary |
Contoh:
"activities": [
{
"name": "CopyFromServiceNow",
"type": "Copy",
"inputs": [
{
"referenceName": "<ServiceNow input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "ServiceNowV2Source",
"expression": {
"type": "Nary",
"operators": [
"<"
],
"operands": [
{
"type": "Field",
"value": "u_founded"
},
{
"type": "Constant",
"value": "2000"
}
]
}
},
"sink": {
"type": "<sink type>"
}
}
}
]
Menggunakan parameter ekspresi
Anda dapat mengonfigurasi parameter ekspresi di Penyusun kueri dengan memilih Tambahkan konten dinamis. Jenis parameter harus Objek, dan nilainya harus mengikuti format yang ditunjukkan dalam contoh JSON di bawah ini:
{
"type": "Nary",
"operators": [
"="
],
"operands": [
{
"type": "Field",
"value": "col"
},
{
"type": "Constant",
"value": "val"
}
]
}
Berikut adalah contoh JSON sumber menggunakan parameter ekspresi:
"activities": [
{
"name": "CopyFromServiceNow",
"type": "Copy",
"inputs": [
{
"referenceName": "<ServiceNow input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "ServiceNowV2Source",
"expression": {
"type": "Expression",
"value": "@pipeline().parameters.expressionParameter"
}
},
"sink": {
"type": "<sink type>"
}
}
}
]
Properti aktivitas pencarian
Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.
Meningkatkan konektor ServiceNow
Berikut adalah langkah-langkah yang membantu Anda meningkatkan konektor ServiceNow Anda:
- Buat layanan tertaut baru dengan merujuk ke Properti layanan tertaut.
- Kueri dalam sumber ditingkatkan ke Penyusun Kueri, yang memiliki penggunaan yang sama dengan penyusun kondisi di ServiceNow. Pelajari cara mengonfigurasinya yang mengacu pada ServiceNow sebagai sumber.
Perbedaan antara ServiceNow V2 dan V1
Konektor ServiceNow V2 menawarkan fungsionalitas baru dan kompatibel dengan sebagian besar fitur konektor ServiceNow V1. Tabel di bawah ini memperlihatkan perbedaan fitur antara V2 dan V1.
ServiceNow V2 | ServiceNow V1 |
---|---|
useEncryptedEndpoints, useHostVerification, dan usePeerVerification tidak didukung dalam layanan tertaut. | Mendukung useEncryptedEndpoints, useHostVerification, dan usePeerVerification di layanan tertaut. |
Penyusun Kueri Dukungan di sumber. | Penyusun kueri tidak didukung di sumber. |
Kueri berbasis SQL tidak didukung. | Mendukung kueri berbasis SQL. |
kueri sortBy tidak didukung di Penyusun Kueri. | Mendukung kueri sortBy di Kueri. |
Anda dapat melihat skema dalam himpunan data. | Anda tidak dapat melihat skema dalam himpunan data. |
Konten terkait
Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink oleh aktivitas salin, lihat penyimpanan data yang didukung.