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.

1. Telusuri ke tab Kelola di ruang kerja Azure Data Factory atau Synapse Anda dan pilih Layanan Tertaut, lalu klik Baru:

   Azure Data Factory

   

   Azure Synapse

   

2. Cari ServiceNow dan pilih konektor ServiceNow.

   

3. 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 atau Display dalam kueri ServiceNow, yang dapat Anda anggap sebagai parameter sysparm_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 skema Display 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.