Bersiap untuk menerapkan ekstensi pemrosesan data
Sebelum menerapkan ekstensi pemrosesan data SQL Server Reporting Services, Anda harus menentukan antarmuka yang akan diterapkan. Anda mungkin ingin menyediakan implementasi khusus ekstensi dari seluruh set antarmuka, atau Anda mungkin ingin memfokuskan implementasi Anda pada subset, seperti IDataReader antarmuka dan IDbCommand di mana klien akan berinteraksi terutama dengan hasil yang ditetapkan sebagai objek DataReader dan akan menggunakan ekstensi pemrosesan data SSRS Anda sebagai jembatan antara tataan hasil dan sumber data Anda.
Anda dapat menerapkan ekstensi pemrosesan data dengan salah satu dari dua cara:
Kelas ekstensi pemrosesan data Anda dapat menerapkan antarmuka penyedia data Microsoft .NET Framework dan secara opsional antarmuka ekstensi pemrosesan data yang diperluas yang disediakan oleh Reporting Services.
Kelas ekstensi pemrosesan data Anda dapat menerapkan antarmuka ekstensi pemrosesan data yang disediakan oleh Reporting Services dan secara opsional antarmuka ekstensi pemrosesan data yang diperluas.
Jika ekstensi pemrosesan data Reporting Services Anda tidak mendukung properti atau metode tertentu, terapkan properti atau metode sebagai tanpa operasi. Jika klien mengharapkan perilaku tertentu, berikan pengecualian NotSupportedException .
Catatan
Implementasi tanpa operasi properti atau metode hanya berlaku untuk properti dan metode antarmuka yang Anda pilih untuk diterapkan. Antarmuka opsional yang Anda pilih untuk tidak diterapkan harus dibiarkan keluar dari perakitan ekstensi pemrosesan data Anda. Untuk informasi selengkapnya tentang apakah antarmuka diperlukan atau opsional, lihat tabel nanti di bagian ini.
Fungsionalitas ekstensi yang diperlukan
Setiap ekstensi pemrosesan data Reporting Services harus menyediakan fungsionalitas berikut:
Buka koneksi ke sumber data.
Analisis kueri dan kembalikan daftar nama bidang untuk kumpulan hasil.
Jalankan kueri terhadap sumber data dan kembalikan kumpulan baris.
Teruskan parameter bernilai tunggal ke kueri.
Iterasi baris dalam kumpulan baris dan ambil data.
Setiap ekstensi pemrosesan data dapat diperluas untuk menyertakan fungsionalitas berikut:
Analisis kueri dan kembalikan daftar nama parameter yang digunakan dalam kueri.
Analisis kueri dan kembalikan daftar bidang tempat kueri dikelompokkan.
Analisis kueri dan kembalikan daftar bidang tempat kueri diurutkan.
Berikan nama pengguna dan kata sandi untuk menyambungkan ke sumber data yang independen dari string koneksi.
Iterasi baris dalam kumpulan baris dan ambil metadata tambahan tentang nilai data.
Agregat data di server.
Antarmuka ekstensi yang tersedia
Tabel berikut menjelaskan antarmuka yang tersedia dan apakah implementasi diperlukan atau opsional.
Antarmuka | Deskripsi | implementasi |
---|---|---|
IDb Koneksi ion | Mewakili sesi unik dengan sumber data. Dalam sistem database klien/server, sesi mungkin setara dengan koneksi jaringan ke server. | Wajib |
IDb Koneksi ionExtension | Mewakili lebih banyak properti koneksi yang dapat diimplementasikan oleh ekstensi pemrosesan data SSRS mengenai keamanan dan autentikasi. | Opsional |
IDbTransaction | Mewakili transaksi lokal. | Wajib |
IDbTransactionExtension | Mewakili lebih banyak properti transaksi yang dapat diimplementasikan oleh ekstensi pemrosesan data SSRS. | Opsional |
IDbCommand | Mewakili kueri atau perintah yang digunakan saat tersambung ke sumber data. | Wajib |
IDbCommandAnalysis | Mewakili informasi perintah lainnya untuk menganalisis kueri dan mengembalikan daftar nama parameter yang digunakan dalam kueri. | Opsional |
IDataParameter | Mewakili parameter atau pasangan nama/nilai yang diteruskan ke perintah atau kueri. | Wajib |
IDataParameterCollection | Mewakili kumpulan semua parameter yang relevan dengan perintah atau kueri. | Wajib |
IDataReader | Menyediakan metode membaca aliran data hanya-terusan dan baca-saja dari sumber data Anda. | Wajib |
IDataReaderExtension | Menyediakan metode membaca satu atau beberapa aliran set hasil khusus ke depan, yang diperoleh dengan menjalankan perintah di sumber data. Antarmuka ini memberikan dukungan yang lebih besar untuk agregat bidang. | Opsional |
IExtension | Menyediakan kelas dasar untuk ekstensi pemrosesan data Reporting Services. Juga memungkinkan pelaksana untuk menyertakan nama yang dilokalkan untuk ekstensi dan meneruskan pengaturan konfigurasi dari file konfigurasi ke ekstensi. | Wajib |
Antarmuka ekstensi pemrosesan data identik dengan subset antarmuka, metode, dan properti penyedia data .NET Framework jika memungkinkan. Untuk informasi selengkapnya tentang menerapkan penyedia data .NET Framework lengkap, lihat "Menerapkan Penyedia Data .NET Framework" dalam dokumentasi .NET Framework Software Development Kit (SDK) Anda.
Konten terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk