Share via

Sumber OData

  • Artikel

Berlaku untuk: Integration Runtime SSIS SQL Server di Azure Data Factory

Gunakan komponen Sumber OData dalam paket SSIS untuk menggunakan data dari layanan Open Data Protocol (OData).

Protokol dan format data yang didukung

Komponen ini mendukung protokol OData v3 dan v4.

  • Untuk protokol OData V3, komponen mendukung format data ATOM dan JSON.

  • Untuk protokol OData V4, komponen mendukung format data JSON.

Sumber data yang didukung

Sumber OData menyertakan dukungan untuk sumber data berikut:

  • Microsoft Dynamics AX Online dan Microsoft Dynamics CRM Online
  • Daftar SharePoint. Untuk melihat semua daftar di server SharePoint, gunakan URL berikut: https://<server>/_vti_bin/ListData.svc. Untuk informasi selengkapnya tentang konvensi URL SharePoint, lihat Antarmuka REST SharePoint Foundation.

Tipe data yang didukung

Sumber OData mendukung jenis data sederhana berikut: int, byte[], bool, byte, DateTime, DateTimeOffset, decimal, double, Guid, Int16, Int32, Int64, sbyte, float, string, dan TimeSpan.

Untuk menemukan jenis data kolom di sumber data Anda, periksa https://<OData feed endpoint>/$metadata halaman.

Untuk jenis data Desimal , presisi dan skala ditentukan oleh metadata sumber. Jika metadata sumber tidak menentukan properti Presisi dan Skala , data dapat dipotong.

Penting

Komponen Sumber OData tidak mendukung tipe kompleks, seperti item pilihan ganda, dalam daftar SharePoint.

Catatan

Jika sumber hanya mengizinkan koneksi TLS 1.2, Anda perlu memberlakukan TLS 1.2 pada komputer Anda melalui pengaturan registri. Dalam prompt perintah yang ditingkatkan, jalankan perintah berikut:

reg add HKLM\SOFTWARE\Microsoft.NETFramework\v4.0.30319 /v SchUseStrongCrypto /t REG_DWORD /d 1 /reg:64

reg add HKLM\SOFTWARE\Microsoft.NETFramework\v4.0.30319 /v SchUseStrongCrypto /t REG_DWORD /d 1 /reg:32

Format dan Performa OData

Sebagian besar layanan OData dapat mengembalikan hasil dalam beberapa format. Anda bisa menentukan format tataan hasil dengan menggunakan $format opsi kueri. Format seperti JSON dan JSON Light lebih efisien daripada ATOM atau XML, dan dapat memberi Anda performa yang lebih baik saat mentransfer data dalam jumlah besar. Tabel berikut ini menyediakan hasil dari pengujian sampel. Seperti yang Anda lihat, ada peningkatan performa 30-53% saat beralih dari ATOM ke JSON dan perolehan performa 67% saat beralih dari ATOM ke format lampu JSON baru (tersedia dalam WCF Data Services 5.1).

Baris ATOM JSON JSON (Terang)
10000 113 detik 74 detik 68 detik
1000000 1110 detik 853 detik 665 detik

Editor Sumber OData (Halaman Koneksi)

Gunakan halaman Koneksi dari kotak dialog Editor Sumber OData untuk memilih manajer koneksi OData untuk sumber OData. Halaman ini juga memungkinkan Anda menentukan kumpulan atau jalur sumber daya dan opsi kueri apa pun untuk menunjukkan data apa yang perlu diambil dari sumber OData.

Opsi Statis

Manajer koneksi OData
Pilih pengelola koneksi yang sudah ada dari daftar, atau buat koneksi baru dengan mengklik Baru.

Setelah Anda memilih atau membuat pengelola koneksi, kotak dialog menampilkan versi protokol OData yang digunakan manajer koneksi.

Baru
Buat manajer koneksi baru dengan menggunakan kotak dialog OData Pengelola Sambungan Editor.

Menggunakan jalur pengumpulan atau sumber daya
Tentukan metode untuk memilih data dari sumber.

Opsi Deskripsi
Koleksi Ambil data dari sumber OData dengan menggunakan nama koleksi.
Jalur Sumber Daya Ambil data dari sumber OData dengan menggunakan jalur sumber daya.

Opsi kueri
Tentukan opsi untuk kueri. Misalnya: $top=5

Url umpan
Menampilkan URL umpan baca-saja berdasarkan opsi yang Anda pilih pada kotak dialog ini.

Pratinjau
Pratinjau hasil dengan menggunakan kotak dialog Pratinjau . Pratinjau dapat menampilkan hingga 20 baris.

Opsi Dinamis

Gunakan jalur koleksi atau sumber daya = Koleksi

Koleksi
Pilih koleksi dari daftar drop-down.

Menggunakan jalur koleksi atau sumber daya = Jalur Sumber Daya

Jalur sumber daya
Ketik jalur sumber daya. Misalnya: Karyawan

Editor Sumber OData (Halaman Kolom)

Gunakan halaman Kolom dari kotak dialog Editor Sumber OData untuk memilih kolom eksternal (sumber) yang akan disertakan dalam output dan memetakannya ke kolom output.

Opsi

Kolom Eksternal yang Tersedia
Tampilkan daftar kolom sumber yang tersedia di sumber data. Gunakan kotak centang dalam daftar untuk menambahkan atau menghapus kolom ke tabel di bagian bawah halaman. Kolom yang dipilih ditambahkan ke output.

Kolom Eksternal
Lihat kolom sumber yang Anda pilih untuk disertakan dalam output.

Kolom Output
Berikan nama unik untuk setiap kolom output. Defaultnya adalah nama kolom eksternal (sumber) yang dipilih; namun, Anda dapat memilih nama yang unik dan deskriptif.

Editor Sumber OData (Halaman Output Kesalahan)

Gunakan halaman Output Kesalahan dari kotak dialog Editor Sumber OData untuk memilih opsi penanganan kesalahan dan untuk mengatur properti pada kolom output kesalahan.

Opsi

Input/Output
Lihat nama sumber data.

Kolom
Tampilkan kolom eksternal (sumber) yang Anda pilih di halaman Pengelola Sambungan kotak dialog Editor Sumber OData.

Kesalahan
Tentukan apa yang harus terjadi ketika terjadi kesalahan: abaikan kegagalan, alihkan baris, atau gagalkan komponen.

Topik Terkait:Penanganan Kesalahan dalam Data

Pemotongan
Tentukan apa yang harus terjadi ketika pemotokan terjadi: abaikan kegagalan, alihkan baris, atau gagalkan komponen.

Deskripsi
Lihat deskripsi kesalahan.

Atur nilai ini ke sel terpilih
Tentukan apa yang harus terjadi pada semua sel yang dipilih ketika terjadi kesalahan atau pemotokan: abaikan kegagalan, alihkan baris, atau gagalkan komponen.

Terapkan
Terapkan opsi penanganan kesalahan ke sel terpilih.

Lihat juga

Pengelola Sambungan OData