Bersiap untuk menerapkan ekstensi pemrosesan data

  • Artikel

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