Parameter Integration Services (SSIS)
Parameter Integration Services (SSIS) memungkinkan Anda menetapkan nilai ke properti dalam paket pada saat eksekusi paket. Anda dapat membuat parameter proyek di tingkat proyek dan parameter paket di tingkat paket. Parameter proyek digunakan untuk menyediakan input eksternal yang diterima proyek ke satu atau beberapa paket dalam proyek. Parameter paket memungkinkan Anda memodifikasi eksekusi paket tanpa harus mengedit dan menyebarkan ulang paket.
Di SQL Server Data Tools Anda membuat, memodifikasi, atau menghapus parameter proyek dengan menggunakan jendela Project.params. Anda membuat, memodifikasi, dan menghapus parameter paket dengan menggunakan tab Parameter di Designer SSIS. Anda mengaitkan parameter baru atau yang sudah ada dengan properti tugas dengan menggunakan kotak dialog Parameterisasi . Untuk informasi selengkapnya tentang menggunakan jendela Project.params dan tab Parameter , lihat Membuat Parameter. Untuk informasi selengkapnya tentang kotak dialog Parameterisasi , lihat Kotak Dialog Parameterisasi.
Parameter dan Model Penyebaran Paket
Secara umum, jika Anda menyebarkan paket menggunakan model penyebaran paket, Anda harus menggunakan konfigurasi alih-alih parameter.
Saat Anda menyebarkan paket yang berisi parameter menggunakan model penyebaran paket lalu menjalankan paket, parameter tidak dipanggil selama eksekusi. Jika paket berisi parameter dan ekspresi paket dalam paket, gunakan parameter, nilai yang dihasilkan diterapkan saat runtime. Jika paket berisi parameter proyek, eksekusi paket mungkin gagal.
Parameter dan Model Penyebaran Proyek
Saat Anda menyebarkan proyek ke server Integration Services, Anda menggunakan tampilan, prosedur tersimpan, dan antarmuka pengguna SQL Server Management Studio untuk mengelola parameter proyek dan paket. Untuk informasi selengkapnya, lihat topik berikut.
Nilai Parameter
Anda dapat menetapkan hingga tiga jenis nilai yang berbeda ke parameter. Ketika eksekusi paket dimulai, satu nilai digunakan untuk parameter , dan parameter diselesaikan ke nilai harfiah akhirnya.
Tabel berikut ini mencantumkan tipe nilai.
| Nama Nilai | Deskripsi | Jenis nilai |
|---|---|---|
| Nilai Eksekusi | Nilai yang ditetapkan ke instans eksekusi paket tertentu. Penugasan ini mengambil alih semua nilai lainnya, tetapi hanya berlaku untuk satu instans eksekusi paket. | Harfiah |
| Nilai Server | Nilai yang ditetapkan ke parameter dalam cakupan proyek, setelah proyek disebarkan ke server Layanan Integrasi. Nilai ini mengambil alih default desain. | Referensi Variabel Literal atau Lingkungan |
| Nilai Desain | Nilai yang ditetapkan ke parameter saat proyek dibuat atau diedit dalam SQL Server Data Tools. Nilai ini bertahan dengan proyek. | Harfiah |
Anda dapat menggunakan satu parameter untuk menetapkan nilai ke beberapa properti paket. Properti paket tunggal hanya dapat diberi nilai dari satu parameter.
Eksekusi dan Nilai Parameter
Eksekusi adalah objek yang mewakili satu instans eksekusi paket. Saat membuat eksekusi, Anda menentukan semua detail yang diperlukan untuk menjalankan paket seperti nilai parameter eksekusi. Anda juga dapat mengubah nilai parameter untuk eksekusi yang ada.
Ketika Anda secara eksplisit menetapkan nilai parameter eksekusi, nilai hanya berlaku untuk instans eksekusi tertentu. Nilai eksekusi digunakan alih-alih nilai server atau nilai desain. Jika Anda tidak secara eksplisit menetapkan nilai eksekusi, dan nilai server telah ditentukan, nilai server akan digunakan.
Ketika parameter ditandai sebagai diperlukan, nilai server atau nilai eksekusi harus ditentukan untuk parameter tersebut. Jika tidak, paket yang sesuai tidak dijalankan. Meskipun parameter memiliki nilai default pada waktu desain, parameter tidak akan pernah digunakan setelah proyek disebarkan.
Variabel Lingkungan
Jika parameter mereferensikan variabel lingkungan, nilai harfiah dari variabel tersebut diselesaikan melalui referensi lingkungan yang ditentukan dan diterapkan ke parameter . Nilai parameter literal akhir yang digunakan untuk eksekusi paket disebut sebagai nilai parameter eksekusi. Anda menentukan referensi lingkungan untuk eksekusi dengan menggunakan kotak dialog Jalankan
Jika parameter proyek mereferensikan variabel lingkungan dan nilai harfiah dari variabel tidak dapat diselesaikan saat eksekusi, nilai desain digunakan. Nilai server tidak digunakan.
Untuk melihat variabel lingkungan yang ditetapkan ke nilai parameter, kueri tampilan catalog.object_parameters. Untuk informasi selengkapnya, lihat catalog.object_parameters (Database SSISDB).
Menentukan Nilai Parameter Eksekusi
Tampilan T-SQL berikut dan prosedur tersimpan dapat digunakan untuk menampilkan dan mengatur nilai parameter.
catalog.execution_parameter_values (Database SSISDB)(tampilan)
Memperlihatkan nilai parameter aktual yang akan digunakan oleh eksekusi tertentu
catalog.get_parameter_values (Database SSISDB) (prosedur tersimpan)
Mengatasi dan memperlihatkan nilai aktual untuk paket dan referensi lingkungan yang ditentukan
catalog.object_parameters (Database SSISDB) (tampilan)
Menampilkan parameter dan properti untuk semua paket dan proyek dalam katalog Layanan Integrasi, termasuk default desain dan nilai default server.
catalog.set_execution_parameter_value (Database SSISDB)
Mengatur nilai parameter untuk instans eksekusi di katalog Layanan Integrasi.
Anda juga dapat menggunakan kotak dialog Jalankan Paket di SQL Server Data Tools (SSDT) mengubah nilai parameter. Untuk informasi selengkapnya, lihat Kotak Dialog Jalankan Paket.
Anda juga dapat menggunakan opsi dtexec /Parameter untuk mengubah nilai parameter. Untuk informasi selengkapnya, lihat Utilitas dtexec.
Validasi Parameter
Jika nilai parameter tidak dapat diselesaikan, eksekusi paket yang sesuai akan gagal. Untuk membantu menghindari kegagalan, Anda dapat memvalidasi proyek dan paket dengan menggunakan kotak dialog Validasi di SQL Server Data Tools (SSDT). Validasi memungkinkan Anda mengonfirmasi bahwa semua parameter memiliki nilai yang diperlukan atau dapat menyelesaikan nilai yang diperlukan dengan referensi lingkungan tertentu. Validasi juga memeriksa masalah paket umum lainnya.
Untuk informasi selengkapnya, lihat Memvalidasi Kotak Dialog.
Contoh Parameter
Contoh ini menjelaskan parameter bernama pkgOptions yang digunakan untuk menentukan opsi untuk paket tempatnya berada.
Selama waktu desain, ketika parameter dibuat di SQL Server Data Tools, nilai default 1 ditetapkan ke parameter . Nilai default ini disebut sebagai default desain. Jika proyek disebarkan ke katalog SSISDB dan tidak ada nilai lain yang ditetapkan ke parameter ini, properti paket yang sesuai dengan parameter pkgOptions akan diberi nilai 1 selama eksekusi paket. Default desain tetap ada pada proyek sepanjang siklus hidupnya.
Saat menyiapkan instans eksekusi paket tertentu, nilai 5 ditetapkan ke parameter pkgOptions . Nilai ini disebut sebagai nilai eksekusi karena berlaku untuk parameter hanya untuk instans eksekusi tertentu. Saat eksekusi dimulai, properti paket yang sesuai dengan parameter pkgOptions diberi nilai 5.
Tugas Terkait
Atur Nilai Parameter Setelah Proyek Disebarkan
Konten terkait
Entri blog, Tip Cepat SSIS: Parameter yang Diperlukan, pada mattmasson.com.