Sumber ADO NET
Berlaku untuk:
SQL Server SSIS Integration Runtime di Azure Data Factory
Sumber ADO NET mengonsumsi data dari penyedia .NET dan membuat data tersedia untuk aliran data.
Anda dapat menggunakan sumber ADO NET untuk menyambungkan ke Microsoft Azure SQL Database. Menyambungkan ke SQL Database dengan menggunakan OLE DB tidak didukung. Untuk informasi selengkapnya tentang SQL Database, lihat Panduan dan Batasan Umum (Azure SQL Database).
Dukungan jenis data
Sumber mengonversi jenis data apa pun yang tidak dipetakan ke jenis data Integration Services tertentu ke jenis data DT_NTEXT Integration Services. Konversi ini terjadi bahkan jika jenis data adalah System.Object.
Anda dapat mengubah jenis data DT_NTEXT ke jenis data DT_WSTR, atau mengubah DT_WSTR menjadi DT_NTEXT. Anda mengubah jenis data dengan mengatur properti DataType di kotak dialog Editor Lanjutan sumber ADO NET. Untuk informasi selengkapnya, lihat Properti Umum.
Jenis data DT_NTEXT juga dapat dikonversi ke jenis data DT_BYTES atau DT_STR dengan menggunakan transformasi Konversi Data setelah sumber ADO NET. Untuk informasi selengkapnya, lihat Transformasi Konversi Data.
Di Integration Services, jenis data tanggal, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2, dan DT_DBTIMESTAMPOFFSET, memetakan ke jenis data tanggal tertentu di SQL Server. Anda dapat mengonfigurasi sumber ADO NET untuk mengonversi jenis data tanggal dari yang digunakan SQL Server ke sumber yang digunakan Layanan Integrasi. Untuk mengonfigurasi sumber ADO NET untuk mengonversi jenis data tanggal ini, atur properti Tipe Versi Sistem dari pengelola koneksi ADO.NET ke Terbaru. (Properti Tipe Versi Sistem ada di halaman Semua kotak dialog Pengelola Sambungan. Untuk membuka kotak dialog Pengelola Sambungan, klik kanan pengelola koneksi ADO.NET, lalu klik Edit.)
Catatan
Jika properti Tipe Versi Sistem untuk pengelola koneksi ADO.NET diatur ke SQL Server 2005, sistem mengonversi jenis data tanggal SQL Server ke DT_WSTR.
Sistem mengonversi jenis data yang ditentukan pengguna (UDT) ke objek besar biner (BLOB) Layanan Integrasi ketika manajer koneksi ADO.NET menentukan penyedia sebagai Penyedia Data .NET untuk SQL Server (SqlClient). Sistem menerapkan aturan berikut saat mengonversi jenis data UDT:
Jika data adalah UDT non-besar, sistem mengonversi data menjadi DT_BYTES.
Jika data adalah UDT non-besar, dan properti Panjang kolom pada database diatur ke -1 atau nilai yang lebih besar dari 8.000 byte, sistem mengonversi data menjadi DT_IMAGE.
Jika data adalah UDT besar, sistem mengonversi data menjadi DT_IMAGE.
Catatan
Jika sumber ADO NET tidak dikonfigurasi untuk menggunakan output kesalahan, sistem mengalirkan data ke kolom DT_IMAGE dalam gugus 8.000 byte. Jika sumber ADO NET dikonfigurasi untuk menggunakan output kesalahan, sistem meneruskan seluruh array byte ke kolom DT_IMAGE. Untuk informasi selengkapnya tentang cara mengonfigurasi komponen untuk menggunakan output kesalahan, lihat Penanganan Kesalahan di Data.
Untuk informasi selengkapnya tentang jenis data Integration Services, konversi jenis data yang didukung, dan pemetaan jenis data di seluruh database tertentu termasuk SQL Server, lihat Tipe Data Layanan Integrasi.
Untuk informasi tentang pemetaan jenis data Integration Services ke jenis data terkelola, lihat Bekerja dengan Jenis Data di Aliran Data.
Pemecahan Masalah Sumber ADO NET
Anda dapat mencatat panggilan yang dilakukan sumber ADO NET ke penyedia data eksternal. Anda dapat menggunakan kemampuan pengelogan ini untuk memecahkan masalah pemuatan data dari sumber data eksternal yang dilakukan sumber ADO NET. Untuk mencatat panggilan yang dilakukan sumber ADO NET ke penyedia data eksternal, aktifkan pengelogan paket dan pilih peristiwa Diagnostik di tingkat paket. Untuk informasi selengkapnya, lihat Alat Pemecahan Masalah untuk Eksekusi Paket.
Konfigurasi Sumber ADO NET
Anda mengonfigurasi sumber ADO NET dengan memberikan pernyataan SQL yang menentukan tataan hasil. Misalnya, sumber ADO NET yang tersambung ke AdventureWorks2022 database dan menggunakan pernyataan SELECT * FROM Production.Product SQL mengekstrak semua baris dari tabel Production.Product dan menyediakan himpunan data ke komponen hilir.
Catatan
Saat Anda menggunakan pernyataan SQL untuk memanggil prosedur tersimpan yang mengembalikan hasil dari tabel sementara, gunakan opsi WITH RESULT SETS untuk menentukan metadata untuk kumpulan hasil.
Catatan
Jika Anda menggunakan pernyataan SQL untuk menjalankan prosedur tersimpan dan paket gagal dengan kesalahan berikut, Anda mungkin dapat mengatasi kesalahan dengan menambahkan pernyataan SET FMTONLY OFF sebelum pernyataan exec.
Kolom <column_name> tidak dapat ditemukan di sumber data.
Sumber ADO NET menggunakan pengelola koneksi ADO.NET untuk menyambungkan ke sumber data, dan manajer koneksi menentukan penyedia .NET. Untuk informasi selengkapnya, lihat ADO.NET Pengelola Sambungan.
Sumber ADO NET memiliki satu output reguler dan satu output kesalahan.
Anda dapat mengatur properti melalui SSIS Designer atau 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, lihat Mengatur Properti Komponen Aliran Data.
Editor Sumber ADO NET (Halaman Pengelola Sambungan)
Gunakan halaman Pengelola Sambungan kotak dialog Editor Sumber ADO NET untuk memilih pengelola koneksi ADO.NET untuk sumbernya. Halaman ini juga memungkinkan Anda memilih tabel atau tampilan dari database.
Untuk mempelajari selengkapnya tentang sumber ADO NET, lihat Sumber ADO NET.
Untuk membuka halaman Pengelola Sambungan
Di SQL Server Data Tools (SSDT), buka paket Layanan Integrasi yang memiliki sumber ADO NET.
Pada tab Aliran Data, klik dua kali sumber ADO NET.
Di Editor Sumber ADO NET, klik Pengelola Sambungan.
Opsi Statis
pengelola koneksi ADO.NET
Pilih manajer koneksi yang sudah ada dari daftar, atau buat koneksi baru dengan mengklik Baru.
Baru
Buat manajer koneksi baru dengan menggunakan kotak dialog Konfigurasikan ADO.NET Pengelola Sambungan.
Mode akses data
Tentukan metode untuk memilih data dari sumber.
| Opsi | Deskripsi |
|---|---|
| Tabel atau tampilan | Mengambil data dari tabel atau tampilan di sumber data ADO.NET. |
| Perintah SQL | Ambil data dari sumber data ADO.NET dengan menggunakan kueri SQL. |
Pratinjau
Pratinjau hasil dengan menggunakan kotak dialog Tampilan Data. Pratinjau dapat menampilkan hingga 200 baris.
Catatan
Saat Anda mempratinjau data, kolom dengan jenis yang ditentukan pengguna CLR tidak berisi data. Sebaliknya nilai <terlalu besar untuk ditampilkan> atau tampilan System.Byte[]. Yang pertama ditampilkan ketika sumber data diakses dengan menggunakan penyedia ADO.NET, yang terakhir saat menggunakan penyedia SQL Server Native Client.
Opsi Dinamis Mode Akses Data
Mode akses data = Tabel atau tampilan
Nama tabel atau tampilan
Pilih nama tabel atau tampilan dari daftar tabel yang tersedia di sumber data.
Mode akses data = perintah SQL
Teks perintah SQL
Masukkan teks kueri SQL, buat kueri dengan mengklik Buat Kueri, atau temukan file yang berisi teks kueri dengan mengklik Telusuri.
Membuat kueri
Gunakan kotak dialog Pembangun Kueri untuk membuat kueri SQL secara visual.
Ramban
Gunakan kotak dialog Buka untuk menemukan file yang berisi teks kueri SQL.
Editor Sumber ADO NET (Halaman Kolom)
Gunakan halaman Kolom dari kotak dialog ADO NET Source Editor untuk memetakan kolom output ke setiap kolom eksternal (sumber).
Untuk mempelajari selengkapnya tentang sumber ADO NET, lihat Sumber ADO NET.
Untuk membuka halaman Kolom
Di SQL Server Data Tools (SSDT), buka paket Layanan Integrasi yang memiliki sumber ADO NET.
Pada tab Aliran Data, klik dua kali sumber ADO NET.
Di Editor Sumber ADO NET, klik Kolom.
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
Lihat kolom eksternal (sumber) dalam urutan di mana Anda akan melihatnya saat mengonfigurasi komponen yang menggunakan data dari sumber ini.
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 Perancang SSIS.
Editor Sumber ADO NET (Halaman Output Kesalahan)
Gunakan halaman Output Kesalahan dari kotak dialog ADO NET Source Editor untuk memilih opsi penanganan kesalahan dan untuk mengatur properti pada kolom output kesalahan.
Untuk mempelajari selengkapnya tentang sumber ADO NET, lihat Sumber ADO NET.
Untuk membuka halaman Output Kesalahan
Di SQL Server Data Tools (SSDT), buka paket Layanan Integrasi yang memiliki sumber ADO NET.
Pada tab Aliran Data, klik dua kali sumber ADO NET.
Di Editor Sumber ADO NET, klik 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 ADO NET.
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.