Bagikan melalui

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

  • Artikel

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:

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:

  2. Cari ServiceNow dan pilih konektor ServiceNow.

    Cuplikan layar konektor ServiceNow.

  3. Konfigurasikan detail layanan, uji koneksi, dan buat layanan tertaut baru.

    Cuplikan layar konfigurasi layanan tertaut untuk ServiceNow.

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:

  1. Buat layanan tertaut baru dengan merujuk ke Properti layanan tertaut.
  2. 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.