Transformasi Perintah DB OLE
Berlaku untuk:
Integration Runtime SSIS SQL Server di Azure Data Factory
Transformasi Perintah OLE DB menjalankan pernyataan SQL untuk setiap baris dalam aliran data. Misalnya, Anda dapat menjalankan pernyataan SQL yang menyisipkan, memperbarui, atau menghapus baris dalam tabel database.
Anda dapat mengonfigurasi Transformasi Perintah OLE DB dengan cara berikut:
Berikan pernyataan SQL bahwa transformasi berjalan untuk setiap baris.
Tentukan jumlah detik sebelum waktu pernyataan SQL habis.
Tentukan halaman kode default.
Biasanya, pernyataan SQL menyertakan parameter. Nilai parameter disimpan dalam kolom eksternal dalam input transformasi, dan memetakan kolom input ke kolom eksternal memetakan kolom input ke parameter. Misalnya, untuk menemukan baris dalam tabel DimProduct menurut nilai di kolom ProductKey-nya lalu menghapusnya, Anda dapat memetakan kolom eksternal bernama Param_0 ke kolom input bernama ProductKey, lalu menjalankan pernyataan DELETE FROM DimProduct WHERE ProductKey = ?SQL .. Transformasi Perintah OLE DB menyediakan nama parameter dan Anda tidak dapat mengubahnya. Nama parameter Param_0, Param_1, dan sebagainya.
Jika Anda mengonfigurasi transformasi Perintah OLE DB dengan menggunakan kotak dialog Editor Lanjutan, parameter dalam pernyataan SQL dapat dipetakan secara otomatis ke kolom eksternal dalam input transformasi, dan karakteristik setiap parameter yang ditentukan, dengan mengklik tombol Refresh. Namun, jika penyedia OLE DB yang digunakan transformasi Perintah OLE DB tidak mendukung penerimaan informasi parameter dari parameter, Anda harus mengonfigurasi kolom eksternal secara manual. Ini berarti Anda harus menambahkan kolom untuk setiap parameter ke input eksternal ke transformasi, memperbarui nama kolom untuk menggunakan nama seperti Param_0, menentukan nilai properti DBParamInfoFlags, dan memetakan kolom input yang berisi nilai parameter ke kolom eksternal.
Nilai DBParamInfoFlags mewakili karakteristik parameter. Misalnya, nilai 1 menentukan bahwa parameter adalah parameter input, dan nilai 65 menentukan bahwa parameter adalah parameter input dan mungkin berisi nilai null. Nilai harus cocok dengan nilai dalam enumerasi OLE DB DBPARAMFLAGSENUM. Untuk informasi selengkapnya, lihat dokumentasi referensi OLE DB.
Transformasi Perintah OLE DB mencakup properti kustom SQLCommand . Properti ini dapat diperbarui oleh ekspresi properti saat paket dimuat. Untuk informasi selengkapnya, lihat Ekspresi Integration Services (SSIS),Menggunakan Ekspresi Properti dalam Paket, dan Properti Kustom Transformasi.
Transformasi ini memiliki satu input, satu output reguler, dan satu output kesalahan.
Pembuatan Log
Anda dapat mencatat panggilan yang dilakukan transformasi Perintah OLE DB ke penyedia data eksternal. Anda dapat menggunakan kemampuan pengelogan ini untuk memecahkan masalah koneksi dan perintah ke sumber data eksternal yang dilakukan transformasi Perintah OLE DB. Untuk mencatat panggilan yang dilakukan transformasi Perintah OLE DB ke penyedia data eksternal, aktifkan pengelogan paket dan pilih peristiwa Diagnostik di tingkat paket. Untuk informasi selengkapnya, lihat Alat Pemecahan Masalah untuk Eksekusi Paket.
Tugas Terkait
Anda dapat mengonfigurasi transformasi dengan menggunakan SSIS Designer atau model objek. Lihat Panduan Pengembang untuk detail tentang mengonfigurasi transformasi ini secara terprogram.
Mengonfigurasi Transformasi Perintah OLE DB
Untuk menambahkan dan mengonfigurasi transformasi Perintah OLE DB, paket harus sudah menyertakan setidaknya satu tugas Aliran Data dan sumber seperti sumber File Datar atau sumber OLE DB. Transformasi ini biasanya digunakan untuk menjalankan kueri berparameter.
Untuk mengonfigurasi transformasi Perintah OLE DB
Di SQL Server Data Tools (SSDT), buka proyek Layanan Integrasi yang berisi paket yang Anda inginkan.
Di Penjelajah Solusi, klik dua kali paket untuk membukanya.
Klik tab Aliran Data , lalu, dari Kotak Alat, seret transformasi Perintah OLE DB ke permukaan desain.
Sambungkan transformasi Perintah OLE DB ke aliran data dengan menyeret panah hijau atau merah konektor dari sumber data atau transformasi sebelumnya ke transformasi Perintah OLE DB.
Klik kanan komponen dan pilih Edit atau Perlihatkan Editor Lanjutan.
Pada tab Pengelola Koneksi, pilih manajer koneksi OLE DB di daftar Pengelola Sambungan. Untuk informasi selengkapnya, lihat Pengelola Sambungan OLE DB.
Klik tab Properti Komponen dan klik tombol elipsis (...) di kotak SqlCommand .
Di Editor Nilai String, ketik pernyataan SQL berparameter menggunakan tanda tanya (?) sebagai penanda parameter untuk setiap parameter.
Klik Refresh. Saat Anda mengklik Refresh, transformasi membuat kolom untuk setiap parameter dalam koleksi Kolom Eksternal dan mengatur properti DBParamInfoFlags.
Klik tab Properti Input dan Output .
Perluas Input Perintah OLE DB, lalu perluas Kolom Eksternal.
Verifikasi bahwa Kolom Eksternal mencantumkan kolom untuk setiap parameter dalam pernyataan SQL. Nama kolom Param_0, Param_1, dan sebagainya.
Anda tidak boleh mengubah nama kolom. Jika Anda mengubah nama kolom, Layanan Integrasi menghasilkan kesalahan validasi untuk transformasi Perintah OLE DB.
Selain itu, Anda tidak boleh mengubah jenis data. Properti DataType dari setiap kolom diatur ke jenis data yang benar.
Jika Kolom Eksternal tidak mencantumkan kolom, Anda harus menambahkannya secara manual.
Klik Tambahkan Kolom satu kali untuk setiap parameter dalam pernyataan SQL.
Perbarui nama kolom menjadi Param_0, Param_1, dan sebagainya.
Tentukan nilai dalam properti DBParamInfoFlags. Nilai harus cocok dengan nilai dalam enumerasi OLE DB DBPARAMFLAGSENUM. Untuk informasi selengkapnya, lihat dokumentasi referensi OLE DB.
Tentukan jenis data kolom dan, bergantung pada jenis data, tentukan halaman kode, panjang, presisi, dan skala kolom.
Untuk menghapus parameter yang tidak digunakan, pilih parameter di Kolom Eksternal, lalu klik Hapus Kolom.
Klik Pemetaan Kolom dan kolom peta di daftar Kolom Input yang Tersedia ke parameter di daftar Kolom Tujuan yang Tersedia .
Klik OK.
Untuk menyimpan paket yang diperbarui, klik Simpan pada menu File .
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk