Sumber XML

  • Artikel

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

Sumber XML membaca file data XML dan mengisi kolom dalam output sumber dengan data.

Data dalam file XML sering menyertakan hubungan hierarkis. Misalnya, file data XML dapat mewakili katalog dan item dalam katalog. Sebelum data dapat memasukkan aliran data, hubungan elemen dalam file data XML harus ditentukan, dan output harus dihasilkan untuk setiap elemen dalam file.

Skema

Sumber XML menggunakan skema untuk menginterpretasikan data XML. Sumber XML mendukung penggunaan file Definisi Skema XML (XSD) atau skema sebaris untuk menerjemahkan data XML ke dalam format tabular. Jika Anda mengonfigurasi sumber XML dengan menggunakan kotak dialog Editor Sumber XML, antarmuka pengguna dapat menghasilkan XSD dari file data XML yang ditentukan.

Catatan

DTD tidak didukung.

Skema hanya dapat mendukung satu namespace; mereka tidak mendukung koleksi skema.

Catatan

Sumber XML tidak memvalidasi data dalam file XML terhadap XSD.

Editor Sumber XML

Data dalam file XML sering menyertakan hubungan hierarkis. Kotak dialog Editor Sumber XML menggunakan skema yang ditentukan untuk menghasilkan output sumber XML. Anda dapat menentukan file XSD, menggunakan skema sebaris, atau membuat XSD dari file data XML yang ditentukan. Skema harus tersedia pada waktu desain.

Sumber XML menghasilkan struktur tabular dari data XML dengan membuat output untuk setiap elemen yang berisi elemen lain dalam file XML. Misalnya, jika data XML mewakili katalog dan item dalam katalog, sumber XML membuat output untuk katalog dan output untuk setiap jenis item yang dimuat katalog. Output setiap item akan berisi kolom output untuk atribut item tersebut.

Untuk memberikan informasi tentang hubungan hierarkis data dalam output, sumber XML menambahkan kolom dalam output yang mengidentifikasi elemen induk untuk setiap elemen turunan. Dengan menggunakan contoh katalog dengan jenis item yang berbeda, setiap item akan memiliki nilai kolom yang mengidentifikasi katalog tempatnya berada.

Sumber XML membuat output untuk setiap elemen, tetapi tidak diperlukan agar Anda menggunakan semua output. Anda dapat menghapus output apa pun yang tidak ingin Anda gunakan, atau hanya tidak menyambungkannya ke komponen hilir.

Sumber XML juga menghasilkan nama output, untuk memastikan bahwa nama tersebut tidak ambigu. Nama-nama ini mungkin panjang dan mungkin tidak mengidentifikasi output dengan cara yang berguna bagi Anda. Anda dapat mengganti nama output, selama namanya tetap unik. Anda juga dapat mengubah jenis data dan panjang kolom output.

Untuk setiap output, sumber XML menambahkan output kesalahan. Secara default kolom dalam output kesalahan memiliki jenis data string Unicode (DT_WSTR) dengan panjang 255, tetapi Anda dapat mengonfigurasi kolom dalam output kesalahan dengan memodifikasi jenis dan panjang datanya.

Jika file data XML berisi elemen yang tidak ada di XSD, elemen-elemen ini diabaikan dan tidak ada output yang dihasilkan untuk mereka. Di sisi lain, jika file data XML kehilangan elemen yang diwakili dalam XSD, output akan berisi kolom dengan nilai null.

Saat data diekstrak dari file data XML, data tersebut dikonversi ke jenis data Integration Services. Namun, sumber XML tidak dapat mengonversi data XML ke jenis data DT_TIME2 atau DT_DBTIMESTAMP2 karena sumber tidak mendukung jenis data ini. Untuk informasi selengkapnya, lihat Jenis Data Integration Services.

Skema XSD atau sebaris dapat menentukan jenis data untuk elemen, tetapi jika tidak, kotak dialog Editor Sumber XML menetapkan tipe data string Unicode (DT_WSTR) ke kolom dalam output yang berisi elemen, dan mengatur panjang kolom menjadi 255 karakter.

Jika skema menentukan panjang maksimum elemen, panjang kolom output diatur ke nilai ini. Jika panjang maksimum lebih besar dari panjang yang didukung oleh jenis data Layanan Integrasi tempat elemen dikonversi, maka data dipotong ke panjang maksimum jenis data. Misalnya, jika string memiliki panjang 5000, string dipotong menjadi 4000 karakter karena panjang maksimum jenis data DT_WSTR adalah 4000 karakter; demikian juga, data byte dipotong menjadi 8000 karakter, panjang maksimum jenis data DT_BYTES. Jika skema tidak menentukan panjang maksimum, panjang kolom default dengan salah satu jenis data diatur ke 255. Pemotongan data di sumber XML ditangani dengan cara yang sama seperti pemotongan di komponen aliran data lainnya. Untuk informasi selengkapnya, lihat Penanganan Kesalahan dalam Data.

Anda dapat mengubah jenis data dan panjang kolom. Untuk informasi selengkapnya, lihat Jenis Data Integration Services.

Konfigurasi Sumber XML

Sumber XML mendukung tiga mode akses data yang berbeda. Anda dapat menentukan lokasi file file data XML, variabel yang berisi lokasi file, atau variabel yang berisi data XML.

Sumber XML menyertakan properti kustom XMLData dan XMLSchemaDefinition yang dapat diperbarui oleh ekspresi properti saat paket dimuat. Untuk informasi selengkapnya, lihat Ekspresi Integration Services (SSIS), Gunakan Ekspresi Properti dalam Paket, dan Properti Kustom Sumber XML.

Sumber XML mendukung beberapa output reguler dan beberapa output kesalahan.

SQL Server Integration Services menyertakan kotak dialog XML Source Editor untuk mengonfigurasi sumber XML. Kotak dialog ini tersedia di SSIS Designer.

Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram.

Kotak dialog Editor Lanjutan mencerminkan properti yang dapat diatur secara terprogram. Untuk informasi selengkapnya tentang properti yang bisa Anda atur dalam kotak dialog Editor Lanjutan atau secara terprogram, klik salah satu topik berikut ini:

Untuk informasi selengkapnya tentang cara mengatur properti, klik salah satu topik berikut:

Editor Sumber XML (Halaman Pengelola Sambungan)

Gunakan halaman Pengelola Sambungan Editor Sumber XML untuk menentukan file XML dan XSD yang mengubah data XML.

Opsi Statis

Mode akses data
Tentukan metode untuk memilih data dari sumber.

Nilai Deskripsi
Lokasi file XML Mengambil data dari file XML.
File XML dari variabel Tentukan nama file XML dalam variabel.

Informasi terkait: Menggunakan Variabel dalam Paket
Data XML dari variabel Mengambil data XML dari variabel.

Gunakan skema sebaris
Tentukan apakah data sumber XML itu sendiri berisi skema XSD yang menentukan dan memvalidasi struktur dan datanya.

Lokasi XSD
Ketik jalur dan nama file file skema XSD, atau temukan file dengan mengklik Telusuri.

People
Gunakan kotak dialog Buka untuk menemukan file skema XSD.

Hasilkan XSD
Gunakan kotak dialog Simpan Sebagai untuk memilih lokasi untuk file skema XSD yang dibuat secara otomatis. Editor menyimpulkan skema dari struktur data XML.

Opsi Dinamis Mode Akses Data

Mode akses data = Lokasi file XML

Lokasi XML
Ketik jalur dan nama file file data XML, atau temukan file dengan mengklik Telusuri.

People
Gunakan kotak dialog Buka untuk menemukan file data XML.

Mode akses data = File XML dari variabel

Nama variabel
Pilih variabel yang berisi jalur dan nama file file XML.

Mode akses data = Data XML dari variabel

Nama variabel
Pilih variabel yang berisi data XML.

Editor Sumber XML (Halaman Kolom)

Gunakan simpul Kolom dari kotak dialog Editor Sumber XML untuk memetakan kolom output ke kolom eksternal (sumber).

Opsi

Kolom Eksternal yang Tersedia
Tampilkan daftar kolom eksternal yang tersedia di sumber data. Anda tidak dapat menggunakan tabel ini untuk menambahkan atau menghapus kolom.

Kolom Eksternal
Tampilkan kolom eksternal (sumber) dalam urutan tugas akan membacanya. Anda dapat mengubah urutan ini dengan terlebih dahulu menghapus kolom yang dipilih dalam tabel yang ditampilkan di editor, lalu memilih kolom eksternal dari daftar dalam urutan yang berbeda.

Kolom Output
Berikan nama unik untuk setiap kolom output. Defaultnya adalah nama kolom eksternal (sumber) yang dipilih; namun, Anda dapat memilih nama deskriptif yang unik. Nama yang disediakan akan ditampilkan dalam SSIS Designer.

Editor Sumber XML (Halaman Output Kesalahan)

Gunakan halaman Output Kesalahan dari kotak dialog Editor Sumber XML 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 EditorSumber XML.

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

Topik Terkait:Penanganan Kesalahan dalam Data

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

Keterangan
Lihat deskripsi kesalahan.

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

Terapkan
Terapkan opsi penanganan kesalahan ke sel terpilih.

Mengekstrak Data dengan Menggunakan Sumber XML