Menyalin data dari ServiceNow V1 menggunakan Azure Data Factory atau Synapse Analytics

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

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.

Kemampuan yang didukung

Konektor ServiceNow ini didukung untuk kemampuan berikut:

① 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:

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:

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:

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.