Bagikan melalui

Sumber OLE DB

  • Artikel

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

Sumber OLE DB mengekstrak data dari berbagai database relasional yang mematuhi OLE DB dengan menggunakan tabel database, tampilan, atau perintah SQL. Misalnya, sumber OLE DB dapat mengekstrak data dari tabel di database Microsoft Office Access atau 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 Koneksi ke Buku Kerja Excel.

Sumber OLE DB menyediakan empat mode akses data yang berbeda untuk mengekstrak data:

  • Tabel atau tampilan.

  • Tabel atau tampilan yang ditentukan dalam variabel.

  • Hasil pernyataan SQL. Kueri bisa menjadi kueri berparameter.

  • Hasil pernyataan SQL yang disimpan dalam variabel.

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.

Jika Anda menggunakan kueri berparameter, Anda dapat memetakan variabel ke parameter untuk menentukan nilai untuk parameter individual dalam pernyataan SQL.

Sumber 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 Integration Services juga menyediakan objek sumber data tempat Anda dapat membuat manajer koneksi OLE DB, membuat sumber data dan tampilan sumber data tersedia untuk sumber OLE DB.

Bergantung pada penyedia OLE DB, beberapa batasan berlaku untuk sumber OLE DB:

  • Penyedia Microsoft OLE DB untuk Oracle tidak mendukung jenis data Oracle BLOB, CLOB, NCLOB, BFILE, ATAU UROWID, dan sumber OLE DB tidak dapat mengekstrak data dari tabel yang berisi kolom dengan jenis data ini.

  • Penyedia IBM OLE DB DB2 dan penyedia Microsoft OLE DB DB2 tidak mendukung penggunaan perintah SQL yang memanggil prosedur tersimpan. Ketika perintah semacam ini digunakan, sumber OLE DB tidak dapat membuat metadata kolom dan, akibatnya, komponen aliran data yang mengikuti sumber OLE DB dalam aliran data tidak memiliki data kolom yang tersedia dan eksekusi aliran data gagal.

Sumber OLE DB memiliki satu output reguler dan satu output kesalahan.

Menggunakan Pernyataan SQL Berparameter

Sumber OLE DB dapat menggunakan pernyataan SQL untuk mengekstrak data. Pernyataan dapat berupa pernyataan SELECT atau EXEC.

Sumber OLE DB menggunakan manajer koneksi OLE DB untuk menyambungkan ke sumber data tempatnya mengekstrak data. Bergantung pada penyedia yang digunakan manajer koneksi OLE DB dan Sistem Manajemen Database Relasional (RDBMS) yang disambungkan manajer koneksi, aturan yang berbeda berlaku untuk penamaan dan daftar parameter. Jika nama parameter dikembalikan dari RDBMS, Anda dapat menggunakan nama parameter untuk memetakan parameter dalam daftar parameter ke parameter dalam pernyataan SQL; jika tidak, parameter dipetakan ke parameter dalam pernyataan SQL dengan posisi ordinalnya dalam daftar parameter. Jenis nama parameter yang didukung bervariasi menurut penyedia. Misalnya, beberapa penyedia mengharuskan Anda menggunakan nama variabel atau kolom, sedangkan beberapa penyedia mengharuskan Anda menggunakan nama simbolis seperti 0 atau Param0. Anda akan melihat dokumentasi khusus penyedia untuk informasi tentang nama parameter yang akan digunakan dalam pernyataan SQL.

Saat Anda menggunakan manajer koneksi OLE DB, Anda tidak dapat menggunakan subkueri berparameter, karena sumber OLE DB tidak dapat memperoleh informasi parameter melalui penyedia OLE DB. Namun, Anda dapat menggunakan ekspresi untuk menggabungkan nilai parameter ke dalam string kueri dan untuk mengatur properti SqlCommand sumber. Di SSIS Designer, Anda mengonfigurasi sumber OLE DB dengan menggunakan kotak dialog Editor Sumber OLE DB dan memetakan parameter ke variabel dalam kotak dialog Atur Parameter Kueri.

Menentukan Parameter dengan Menggunakan Posisi Ordinal

Jika tidak ada nama parameter yang dikembalikan, urutan parameter tercantum dalam daftar Parameter dalam kotak dialog Atur Parameter Kueri mengatur penanda parameter mana yang dipetakan pada waktu proses. Parameter pertama dalam daftar memetakan ke yang pertama? dalam pernyataan SQL, yang kedua hingga kedua ?, dan sebagainya.

Pernyataan SQL berikut memilih baris dari tabel Produk dalam AdventureWorks2022 database. Parameter pertama dalam daftar Pemetaan memetakan ke parameter pertama ke kolom Warna, parameter kedua ke kolom Ukuran.

SELECT * FROM Production.Product WHERE Color = ? AND Size = ?

Nama parameter tidak berpengaruh. Misalnya, jika parameter diberi nama yang sama dengan kolom yang diterapkannya, tetapi tidak dimasukkan ke dalam posisi ordinal yang benar dalam daftar Parameter , pemetaan parameter yang terjadi pada waktu proses akan menggunakan posisi ordinal parameter, bukan nama parameter.

Perintah EXEC biasanya mengharuskan Anda menggunakan nama variabel yang menyediakan nilai parameter dalam prosedur sebagai nama parameter.

Menentukan Parameter dengan Menggunakan Nama

Jika nama parameter aktual dikembalikan dari RDBMS, parameter yang digunakan oleh pernyataan SELECT dan EXEC dipetakan berdasarkan nama. Nama parameter harus cocok dengan nama yang diharapkan oleh prosedur tersimpan, yang dijalankan oleh pernyataan SELECT atau pernyataan EXEC.

Pernyataan SQL berikut menjalankan prosedur tersimpan uspGetWhereUsedProductID , yang tersedia dalam AdventureWorks2022 database.

EXEC uspGetWhereUsedProductID ?, ?

Prosedur tersimpan mengharapkan variabel, @StartProductID dan @CheckDate, untuk memberikan nilai parameter. Urutan di mana parameter muncul dalam daftar Pemetaan tidak relevan. Satu-satunya persyaratan adalah bahwa nama parameter cocok dengan nama variabel dalam prosedur tersimpan, termasuk tanda @.

Pemetaan Parameter ke Variabel

Parameter dipetakan ke variabel yang menyediakan nilai parameter pada waktu proses. Variabel biasanya merupakan variabel yang ditentukan pengguna, meskipun Anda juga dapat menggunakan variabel sistem yang disediakan Layanan Integrasi. Jika Anda menggunakan variabel yang ditentukan pengguna, pastikan Anda mengatur jenis data ke jenis yang kompatibel dengan jenis data kolom yang dipetakan referensi parameter. Untuk informasi selengkapnya, lihat Variabel Integration Services (SSIS).

Memecahkan masalah Sumber OLE DB

Anda dapat mencatat panggilan yang dilakukan sumber OLE DB ke penyedia data eksternal. Anda dapat menggunakan kemampuan pengelogan ini untuk memecahkan masalah pemuatan data dari sumber data eksternal yang dilakukan sumber OLE DB. Untuk mencatat panggilan yang dilakukan sumber 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 Sumber OLE DB

Anda dapat mengatur properti secara terprogram atau melalui SSIS Designer.

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:

Konten Terkait

SSIS dengan Oracle Koneksi ors

Editor Sumber OLE DB (Halaman Pengelola Sambungan)

Gunakan halaman Pengelola Sambungan kotak dialog Editor Sumber OLE DB untuk memilih manajer koneksi OLE DB untuk sumbernya. Halaman ini juga memungkinkan Anda memilih tabel atau tampilan dari database.

Catatan

Untuk memuat data dari sumber data yang menggunakan Microsoft Office Excel 2007, gunakan sumber OLE DB. Anda tidak dapat menggunakan sumber Excel untuk memuat data dari sumber data Excel 2007. Untuk informasi selengkapnya, lihat Mengonfigurasi Pengelola Sambungan OLE DB.

Untuk memuat data dari sumber data yang menggunakan Microsoft Office Excel 2003 atau yang lebih lama, gunakan sumber Excel. Untuk informasi selengkapnya, lihat Editor Sumber Excel (Halaman Pengelola Sambungan).

Catatan

Properti CommandTimeout dari sumber OLE DB tidak tersedia di Editor Sumber OLE DB, tetapi dapat diatur dengan menggunakan Editor Lanjutan. Untuk informasi selengkapnya tentang properti ini, lihat bagian Sumber Excel dari Properti Kustom OLE DB.

Buka Editor Sumber OLE DB (Halaman Pengelola Sambungan)

  1. Tambahkan sumber OLE DB ke paket Layanan Integrasi, di SQL Server Data Tools (SSDT).

  2. Klik kanan komponen sumber dan saat klik Edit.

  3. Klik Pengelola Sambungan.

Opsi Statis

Manajer koneksi OLE DB
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 Pengelola Sambungan OLE DB.

Mode akses data
Tentukan metode untuk memilih data dari sumber.

Opsi Deskripsi
Tabel atau tampilan Mengambil data dari tabel atau tampilan di sumber data OLE DB.
Nama tabel atau variabel nama tampilan Tentukan tabel atau nama tampilan dalam variabel.

Informasi terkait:Gunakan Variabel dalam Paket
Perintah SQL Ambil data dari sumber data OLE DB dengan menggunakan kueri SQL.
Perintah SQL dari variabel Tentukan teks kueri SQL dalam variabel.

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 menggunakan penyedia SQL OLE DB, 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 = Nama tabel atau variabel nama tampilan

Nama variabel
Pilih variabel yang berisi nama tabel atau tampilan.

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.

Parameter
Jika Anda telah memasukkan kueri berparameter dengan menggunakan ? sebagai tempat penampung parameter dalam teks kueri, gunakan kotak dialog Atur Parameter Kueri untuk memetakan parameter input kueri ke variabel paket.

Membuat kueri
Gunakan kotak dialog Pembangun Kueri untuk membuat kueri SQL secara visual.

People
Gunakan kotak dialog Buka untuk menemukan file yang berisi teks kueri SQL.

Mengurai kueri
Verifikasi sintaks teks kueri.

Mode akses data = perintah SQL dari variabel

Nama variabel
Pilih variabel yang berisi teks kueri SQL.

Editor Sumber OLE DB (Halaman Kolom)

Gunakan halaman Kolom dari kotak dialog Editor Sumber OLE DB untuk memetakan kolom output ke setiap 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
Lihat kolom eksternal (sumber) dalam urutan di mana Anda akan melihatnya saat mengonfigurasi komponen yang menggunakan data dari sumber ini. Anda dapat mengubah urutan ini dengan terlebih dahulu menghapus kolom yang dipilih dalam tabel, 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 Perancang SSIS.

Editor Sumber OLE DB (Halaman Output Kesalahan)

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

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.

Lihat Juga

Tujuan OLE DB
Variabel Integration Services (SSIS)
Aliran Data