Tujuan OLE DB
Berlaku untuk:
Integration Runtime SSIS SQL Server di Azure Data Factory
Tujuan OLE DB memuat data ke dalam berbagai database yang mematuhi OLE DB menggunakan tabel database atau tampilan atau perintah SQL. Misalnya, sumber OLE DB dapat memuat data ke dalam tabel di Microsoft Office Access dan database SQL Server.
Catatan
Jika sumber data adalah Microsoft Office Excel 2007, sumber data memerlukan manajer koneksi yang berbeda dari versi Excel sebelumnya. Untuk informasi selengkapnya, lihat Menyambungkan ke Buku Kerja Excel.
Tujuan OLE DB menyediakan lima mode akses data yang berbeda untuk memuat data:
Tabel atau tampilan. Anda bisa menentukan tabel atau tampilan yang sudah ada, atau Anda membuat tabel baru.
Tabel atau tampilan menggunakan opsi pemuatan cepat. Anda bisa menentukan tabel yang sudah ada atau membuat tabel baru.
Tabel atau tampilan yang ditentukan dalam variabel.
Tabel atau tampilan yang ditentukan dalam variabel menggunakan opsi pemuatan cepat.
Hasil pernyataan SQL.
Catatan
Tujuan OLE DB tidak mendukung parameter. Jika Anda perlu menjalankan pernyataan INSERT berparameter, pertimbangkan transformasi Perintah OLE DB. Untuk informasi selengkapnya, lihat Transformasi Perintah OLE DB.
Ketika tujuan OLE DB memuat data yang menggunakan kumpulan karakter byte ganda (DBCS), data mungkin rusak jika mode akses data tidak menggunakan opsi beban cepat dan jika manajer koneksi OLE DB menggunakan Penyedia Microsoft OLE DB untuk SQL Server (SQLOLEDB). Untuk memastikan integritas data DBCS, Anda harus mengonfigurasi manajer koneksi OLE DB untuk menggunakan SQL Server Native Client, atau menggunakan salah satu mode akses beban cepat: Tabel atau tampilan - beban cepat atau Nama tabel atau variabel nama tampilan - beban cepat. Kedua opsi tersedia dari kotak dialog Editor Tujuan OLE DB . Saat memprogram model objek SSIS, Anda harus mengatur properti AccessMode ke OpenRowset Menggunakan FastLoad, atau OpenRowset Menggunakan FastLoad From Variable.
Catatan
Jika Anda menggunakan kotak dialog Editor Tujuan OLE DB di Perancang SSIS untuk membuat tabel tujuan tempat tujuan OLE DB menyisipkan data, Anda mungkin harus memilih tabel yang baru dibuat secara manual. Kebutuhan akan pemilihan manual terjadi ketika penyedia OLE DB, seperti penyedia OLE DB untuk DB2, secara otomatis menambahkan pengidentifikasi skema ke nama tabel.
Catatan
Pernyataan CREATE TABLE yang dihasilkan kotak dialog Editor Tujuan OLE DB mungkin memerlukan modifikasi tergantung pada jenis tujuan. Misalnya, beberapa tujuan tidak mendukung jenis data yang digunakan pernyataan CREATE TABLE.
Tujuan ini menggunakan manajer koneksi OLE DB untuk menyambungkan ke sumber data dan manajer koneksi menentukan penyedia OLE DB untuk digunakan. Untuk informasi selengkapnya, lihat Pengelola Sambungan OLE DB.
Proyek Layanan Integrasi juga menyediakan objek sumber data tempat Anda dapat membuat manajer koneksi OLE DB, untuk membuat sumber data dan tampilan sumber data tersedia untuk tujuan OLE DB.
Tujuan OLE DB mencakup pemetaan antara kolom input dan kolom di sumber data tujuan. Anda tidak perlu memetakan kolom input ke semua kolom tujuan, tetapi bergantung pada properti kolom tujuan, kesalahan dapat terjadi jika tidak ada kolom input yang dipetakan ke kolom tujuan. Misalnya, jika kolom tujuan tidak mengizinkan nilai null, kolom input harus dipetakan ke kolom tersebut. Selain itu, jenis data kolom yang dipetakan harus kompatibel. Misalnya, Anda tidak dapat memetakan kolom input dengan jenis data string ke kolom tujuan dengan jenis data numerik.
Tujuan OLE DB memiliki satu input reguler dan satu output kesalahan.
Untuk informasi selengkapnya tentang jenis data, lihat Jenis Data Integration Services.
Opsi Pemuatan Cepat
Jika tujuan OLE DB menggunakan mode akses data pemuatan cepat, Anda dapat menentukan opsi pemuatan cepat berikut di antarmuka pengguna, Editor Tujuan OLE DB, untuk tujuan:
Pertahankan nilai identitas dari file data yang diimpor atau gunakan nilai unik yang ditetapkan oleh SQL Server.
Pertahankan nilai null selama operasi pemuatan massal.
Periksa batasan pada tabel target atau tampilan selama operasi impor massal.
Dapatkan kunci tingkat tabel selama durasi operasi pemuatan massal.
Tentukan jumlah baris dalam batch dan ukuran penerapan.
Beberapa opsi beban cepat disimpan dalam properti tertentu dari tujuan OLE DB. Misalnya, FastLoadKeepIdentity menentukan apakah akan tetap mengidentifikasi nilai, FastLoadKeepNulls menentukan apakah akan menyimpan nilai null, dan FastLoadMaxInsertCommitSize menentukan jumlah baris yang akan diterapkan sebagai batch. Opsi beban cepat lainnya disimpan dalam daftar yang dipisahkan koma di properti FastLoadOptions. Jika tujuan OLE DB menggunakan semua opsi pemuatan cepat yang disimpan di FastLoadOptions dan tercantum dalam kotak dialog Editor Tujuan OLE DB , nilai properti diatur ke TABLOCK, CHECK_CONSTRAINTS, ROWS_PER_BATCH=1000. Nilai 1000 menunjukkan bahwa tujuan dikonfigurasi untuk menggunakan batch 1000 baris.
Catatan
Kegagalan batasan apa pun di tujuan menyebabkan seluruh batch baris yang ditentukan oleh FastLoadMaxInsertCommitSize gagal.
Selain opsi beban cepat yang diekspos dalam kotak dialog Editor Tujuan OLE DB, Anda dapat mengonfigurasi tujuan OLE DB untuk menggunakan opsi beban massal berikut dengan mengetik opsi di properti FastLoadOptions dalam kotak dialog Editor Lanjutan.
| Opsi muat cepat | Deskripsi |
|---|---|
| KILOBYTES_PER_BATCH | Menentukan ukuran dalam kilobyte untuk disisipkan. Opsi ini memiliki formulir KILOBYTES_PER_BATCH = <nilai> bilangan bulat positif. |
| FIRE_TRIGGERS | Menentukan apakah pemicu diaktifkan pada tabel sisipan. Opsi ini memiliki FIRE_TRIGGERS formulir. Kehadiran opsi menunjukkan bahwa memicu kebakaran. |
| ORDER | Menentukan bagaimana data input diurutkan. Opsi ini memiliki nama> kolom ORDER <FORMULIR ASC| DESC. Sejumlah kolom dapat dicantumkan dan opsional untuk menyertakan urutan pengurutan. Jika urutan pengurutan dihilangkan, operasi sisipkan mengasumsikan data tidak diurutkan. Catatan: Performa dapat ditingkatkan jika Anda menggunakan opsi ORDER untuk mengurutkan data input sesuai dengan indeks terkluster pada tabel. |
Kata kunci Transact-SQL secara tradisional diketik menggunakan huruf besar, tetapi kata kuncinya tidak peka huruf besar/kecil.
Untuk mempelajari selengkapnya tentang opsi pemuatan cepat, lihat SISIPAN MASSAL (Transact-SQL).
Pemecahan masalah Tujuan OLE DB
Anda dapat mencatat panggilan yang dilakukan tujuan OLE DB ke penyedia data eksternal. Anda dapat menggunakan kemampuan pengelogan ini untuk memecahkan masalah penyimpanan data ke sumber data eksternal yang dilakukan tujuan OLE DB. Untuk mencatat panggilan yang dilakukan tujuan 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.
Mengonfigurasi Tujuan OLE DB
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 Tujuan OLE DB (Halaman Pengelola Sambungan)
Gunakan halaman Pengelola Sambungan kotak dialog Editor Tujuan OLE DB untuk memilih koneksi OLE DB untuk tujuan. Halaman ini juga memungkinkan Anda memilih tabel atau tampilan dari database.
Catatan
Jika sumber data adalah Microsoft Office Excel 2007, sumber data memerlukan manajer koneksi yang berbeda dari versi Excel sebelumnya. Untuk informasi selengkapnya, lihat Menyambungkan ke Buku Kerja Excel.
Catatan
Properti CommandTimeout tujuan OLE DB tidak tersedia di Editor Tujuan OLE DB, tetapi dapat diatur dengan menggunakan Editor Lanjutan. Selain itu, opsi beban cepat tertentu hanya tersedia di Editor Lanjutan. Untuk informasi selengkapnya tentang properti ini, lihat bagian Tujuan OLE DB dari Properti Kustom OLE DB.
Properti CommandTimeout hanya berlaku ketika mode akses data adalah perintah SQL.
Opsi Statis
Manajer koneksi OLE DB
Pilih pengelola koneksi yang sudah ada dari daftar, atau buat koneksi baru dengan mengklik Baru.
Baru
Buat manajer koneksi baru dengan menggunakan kotak dialog Konfigurasikan Pengelola Sambungan OLE DB.
Mode akses data
Tentukan metode untuk memuat data ke tujuan. Memuat data kumpulan karakter byte ganda (DBCS) memerlukan penggunaan salah satu opsi pemuatan cepat. Untuk informasi selengkapnya tentang mode akses data beban cepat, yang dioptimalkan untuk sisipan massal, lihat Tujuan OLE DB.
| Opsi | Deskripsi |
|---|---|
| Tabel atau tampilan | Muat data ke dalam tabel atau tampilan di tujuan OLE DB. |
| Tabel atau tampilan - beban cepat | Muat data ke dalam tabel atau tampilan di tujuan OLE DB dan gunakan opsi muat cepat. Untuk informasi selengkapnya tentang mode akses data beban cepat, yang dioptimalkan untuk sisipan massal, lihat Tujuan OLE DB. |
| Nama tabel atau variabel nama tampilan | Tentukan tabel atau nama tampilan dalam variabel. Informasi terkait: Menggunakan Variabel dalam Paket |
| Variabel nama tabel atau nama tampilan - beban cepat | Tentukan nama tabel atau tampilan dalam variabel, dan gunakan opsi muat cepat untuk memuat data. Untuk informasi selengkapnya tentang mode akses data beban cepat, yang dioptimalkan untuk sisipan massal, lihat Tujuan OLE DB. |
| Perintah SQL | Muat data ke tujuan OLE DB dengan menggunakan kueri SQL. |
Pratinjau
Pratinjau hasil dengan menggunakan kotak dialog Hasil Kueri Pratinjau . Pratinjau dapat menampilkan hingga 200 baris.
Opsi Dinamis Mode Akses Data
Setiap pengaturan untuk mode Akses data menampilkan sekumpulan opsi dinamis khusus untuk pengaturan tersebut. Bagian berikut menjelaskan masing-masing opsi dinamis yang tersedia untuk setiap pengaturan 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.
Baru
Buat tabel baru dengan menggunakan kotak dialog Buat Tabel .
Catatan
Saat Anda mengklik Baru, Integration Services menghasilkan pernyataan CREATE TABLE default berdasarkan sumber data yang tersambung. Pernyataan CREATE TABLE default ini tidak akan menyertakan atribut FILESTREAM meskipun tabel sumber menyertakan kolom dengan atribut FILESTREAM yang dideklarasikan. Untuk menjalankan komponen Layanan Integrasi dengan atribut FILESTREAM, pertama-tama terapkan penyimpanan FILESTREAM pada database tujuan. Kemudian, tambahkan atribut FILESTREAM ke pernyataan CREATE TABLE dalam kotak dialog Buat Tabel . Untuk informasi selengkapnya, lihat Data Objek Besar Biner (Blob) (SQL Server).
Mode akses data = Tabel atau tampilan - beban cepat
Nama tabel atau tampilan
Pilih tabel atau tampilan dari database dengan menggunakan daftar ini, atau buat tabel baru dengan mengklik Baru.
Baru
Buat tabel baru dengan menggunakan kotak dialog Buat Tabel .
Catatan
Saat Anda mengklik Baru, Integration Services menghasilkan pernyataan CREATE TABLE default berdasarkan sumber data yang tersambung. Pernyataan CREATE TABLE default ini tidak akan menyertakan atribut FILESTREAM meskipun tabel sumber menyertakan kolom dengan atribut FILESTREAM yang dideklarasikan. Untuk menjalankan komponen Layanan Integrasi dengan atribut FILESTREAM, pertama-tama terapkan penyimpanan FILESTREAM pada database tujuan. Kemudian, tambahkan atribut FILESTREAM ke pernyataan CREATE TABLE dalam kotak dialog Buat Tabel . Untuk informasi selengkapnya, lihat Data Objek Besar Biner (Blob) (SQL Server).
Pertahankan identitas
Tentukan apakah akan menyalin nilai identitas saat data dimuat. Properti ini hanya tersedia dengan opsi beban cepat. Nilai default properti ini adalah false.
Pertahankan null
Tentukan apakah akan menyalin nilai null saat data dimuat. Properti ini hanya tersedia dengan opsi beban cepat. Nilai default properti ini adalah false.
Kunci tabel
Tentukan apakah tabel dikunci selama pemuatan. Nilai default properti ini adalah true.
Periksa batasan
Tentukan apakah tujuan memeriksa batasan saat memuat data. Nilai default properti ini adalah true.
Baris per batch
Tentukan jumlah baris dalam batch. Nilai default properti ini adalah -1, yang menunjukkan bahwa tidak ada nilai yang ditetapkan.
Catatan
Kosongkan kotak teks di Editor Tujuan OLE DB untuk menunjukkan bahwa Anda tidak ingin menetapkan nilai kustom untuk properti ini.
Ukuran penerapan sisipan maksimum
Tentukan ukuran batch yang coba dilakukan tujuan OLE DB selama operasi pemuatan cepat. Nilai 0 menunjukkan bahwa semua data diterapkan dalam satu batch setelah semua baris diproses.
Catatan
Nilai 0 dapat menyebabkan paket yang sedang berjalan berhenti merespons jika tujuan OLE DB dan komponen aliran data lain memperbarui tabel sumber yang sama. Untuk mencegah paket berhenti, atur opsi Ukuran penerapan sisipan maksimum ke 2147483647.
Jika Anda memberikan nilai untuk properti ini, tujuan menerapkan baris dalam batch yang lebih kecil dari (a) Ukuran penerapan sisipan maksimum, atau (b) baris yang tersisa dalam buffer yang saat ini sedang diproses.
Catatan
Kegagalan batasan apa pun di tujuan menyebabkan seluruh batch baris yang ditentukan oleh Ukuran penerapan sisipan maksimum gagal.
Mode akses data = Nama tabel atau variabel nama tampilan
Nama variabel
Pilih variabel yang berisi nama tabel atau tampilan.
Mode Akses Data = Nama tabel atau variabel nama tampilan - beban cepat)
Nama variabel
Pilih variabel yang berisi nama tabel atau tampilan.
Baru
Buat tabel baru dengan menggunakan kotak dialog Buat Tabel .
Catatan
Saat Anda mengklik Baru, Integration Services menghasilkan pernyataan CREATE TABLE default berdasarkan sumber data yang tersambung. Pernyataan CREATE TABLE default ini tidak akan menyertakan atribut FILESTREAM meskipun tabel sumber menyertakan kolom dengan atribut FILESTREAM yang dideklarasikan. Untuk menjalankan komponen Layanan Integrasi dengan atribut FILESTREAM, pertama-tama terapkan penyimpanan FILESTREAM pada database tujuan. Kemudian, tambahkan atribut FILESTREAM ke pernyataan CREATE TABLE dalam kotak dialog Buat Tabel . Untuk informasi selengkapnya, lihat Data Objek Besar Biner (Blob) (SQL Server).
Pertahankan identitas
Tentukan apakah akan menyalin nilai identitas saat data dimuat. Properti ini hanya tersedia dengan opsi beban cepat. Nilai default properti ini adalah false.
Pertahankan null
Tentukan apakah akan menyalin nilai null saat data dimuat. Properti ini hanya tersedia dengan opsi beban cepat. Nilai default properti ini adalah false.
Kunci tabel
Tentukan apakah tabel terkunci selama pemuatan. Nilai default properti ini adalah false.
Periksa batasan
Tentukan apakah tugas memeriksa batasan. Nilai default properti ini adalah false.
Baris per batch
Tentukan jumlah baris dalam batch. Nilai default properti ini adalah -1, yang menunjukkan bahwa tidak ada nilai yang ditetapkan.
Catatan
Kosongkan kotak teks di Editor Tujuan OLE DB untuk menunjukkan bahwa Anda tidak ingin menetapkan nilai kustom untuk properti ini.
Ukuran penerapan sisipan maksimum
Tentukan ukuran batch yang coba dilakukan tujuan OLE DB selama operasi pemuatan cepat. Nilai default 2147483647 menunjukkan bahwa semua data dilakukan dalam satu batch setelah semua baris diproses.
Catatan
Nilai 0 dapat menyebabkan paket yang sedang berjalan berhenti merespons jika tujuan OLE DB dan komponen aliran data lain memperbarui tabel sumber yang sama. Untuk mencegah paket berhenti, atur opsi Ukuran penerapan sisipan maksimum ke 2147483647.
Mode akses data = perintah SQL
Teks perintah SQL
Masukkan teks kueri SQL, buat kueri dengan mengklik Bangun Kueri, atau temukan file yang berisi teks kueri dengan mengklik Telusuri.
Catatan
Tujuan OLE DB tidak mendukung parameter. Jika Anda perlu menjalankan pernyataan INSERT berparameter, pertimbangkan transformasi Perintah OLE DB. Untuk informasi selengkapnya, lihat Transformasi Perintah OLE DB.
Menyusun kueri
Gunakan kotak dialog Pembangun Kueri untuk membuat kueri SQL secara visual.
Telusuri
Gunakan kotak dialog Buka untuk menemukan file yang berisi teks kueri SQL.
Mengurai kueri
Verifikasi sintaks teks kueri.
Editor Tujuan OLE DB (Halaman Pemetaan)
Gunakan halaman Pemetaan dari kotak dialog Editor Tujuan OLE DB untuk memetakan kolom input ke kolom tujuan.
Opsi
Kolom Input yang Tersedia
Lihat daftar kolom input yang tersedia. Gunakan operasi seret dan letakkan untuk memetakan kolom input yang tersedia dalam tabel ke kolom tujuan.
Kolom Tujuan yang Tersedia
Menampilkan daftar kolom tujuan yang tersedia. Gunakan operasi seret dan letakkan untuk memetakan kolom tujuan yang tersedia dalam tabel ke kolom input.
Kolom Input
Lihat kolom input yang Anda pilih. Anda dapat menghapus pemetaan dengan memilih <abaikan> untuk mengecualikan kolom dari output.
Kolom Tujuan
Tampilkan setiap kolom tujuan yang tersedia, terlepas dari apakah kolom tersebut dipetakan atau tidak.
Editor Tujuan OLE DB (Halaman Output Kesalahan)
Gunakan halaman Output Kesalahan dari kotak dialog Editor Tujuan OLE DB untuk menentukan opsi penanganan kesalahan.
Opsi
Input/Output
Lihat nama input.
Kolom
Tidak digunakan.
Kesalahan
Tentukan apa yang harus terjadi ketika terjadi kesalahan: abaikan kegagalan, alihkan baris, atau gagalkan komponen.
Topik Terkait:Penanganan Kesalahan dalam Data
Pemotongan
Tidak digunakan.
Deskripsi
Lihat deskripsi operasi.
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.
Konten terkait
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