Penanganan Aktivitas Integration Services (SSIS)

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

Pada run time, executable (paket dan Foreach Loop, For Loop, Sequence, dan kontainer host tugas) meningkatkan peristiwa. Misalnya, peristiwa OnError dimunculkan saat kesalahan terjadi. Anda dapat membuat penanganan aktivitas kustom untuk peristiwa ini untuk memperluas fungsionalitas paket dan membuat paket lebih mudah dikelola pada durasi. Penanganan aktivitas dapat melakukan tugas seperti berikut ini:

• Bersihkan penyimpanan data sementara saat paket atau tugas selesai berjalan.

• Ambil informasi sistem untuk menilai ketersediaan sumber daya sebelum paket berjalan.

• Refresh data dalam tabel saat pencarian dalam tabel referensi gagal.

• Kirim pesan email ketika terjadi kesalahan atau peringatan atau ketika tugas gagal.

Jika peristiwa tidak memiliki penanganan aktivitas, peristiwa dinaikkan ke kontainer berikutnya ke hierarki kontainer dalam paket. Jika kontainer ini memiliki penanganan aktivitas, penanganan aktivitas berjalan sebagai respons terhadap peristiwa. Jika tidak, peristiwa dinaikkan ke kontainer berikutnya ke hierarki kontainer.

Diagram berikut menunjukkan paket sederhana yang memiliki kontainer For Loop yang berisi satu tugas Jalankan SQL.

Hanya paket yang memiliki penanganan aktivitas, untuk peristiwa OnError-nya . Jika terjadi kesalahan saat tugas Jalankan SQL berjalan, penanganan aktivitas OnError untuk paket berjalan. Diagram berikut menunjukkan urutan panggilan yang menyebabkan penanganan aktivitas OnError untuk paket dijalankan.

Penanganan aktivitas adalah anggota koleksi penanganan aktivitas, dan semua kontainer menyertakan koleksi ini. Jika Anda membuat paket menggunakan SSIS Designer, Anda dapat melihat anggota koleksi penanganan aktivitas di folder Penanganan Aktivitas pada tab Penjelajah Paket SSIS Designer.

Anda dapat mengonfigurasi kontainer penanganan aktivitas dengan cara berikut:

• Tentukan nama dan deskripsi untuk penanganan aktivitas.

• Menunjukkan apakah penanganan aktivitas berjalan, apakah paket gagal jika penanganan aktivitas gagal, dan jumlah kesalahan yang dapat terjadi sebelum penanganan aktivitas gagal.

• Tentukan hasil eksekusi untuk dikembalikan alih-alih hasil eksekusi aktual yang dikembalikan penanganan aktivitas pada durasi.

• Tentukan opsi transaksi untuk penanganan aktivitas.

• Tentukan mode pengelogan yang digunakan penanganan aktivitas.

Isi Penanganan Aktivitas

Membuat penanganan aktivitas mirip dengan membangun paket; penanganan aktivitas memiliki tugas dan kontainer, yang diurutkan ke dalam alur kontrol, dan penanganan aktivitas juga dapat menyertakan aliran data. Perancang SSIS menyertakan tab Penanganan Aktivitas untuk membuat penanganan aktivitas kustom.

Anda juga dapat membuat penanganan aktivitas secara terprogram. Untuk informasi selengkapnya, lihat Menangani Peristiwa Secara Terprogram.

Peristiwa Run-Time

Tabel berikut mencantumkan penanganan aktivitas yang disediakan Integration Services, dan menjelaskan peristiwa run-time yang menyebabkan penanganan aktivitas berjalan.

Handler acara	Kejadian
OnError	Penanganan aktivitas untuk peristiwa OnError . Kejadian ini dinaikkan oleh executable ketika terjadi kesalahan.
OnExecStatusChanged	Penanganan aktivitas untuk peristiwa OnExecStatusChanged . Kejadian ini dinaikkan oleh executable ketika status eksekusinya berubah.
OnInformation	Penanganan aktivitas untuk peristiwa OnInformation . Kejadian ini dinaikkan selama validasi dan eksekusi executable untuk melaporkan informasi. Kejadian ini hanya menyampaikan informasi, tidak ada kesalahan atau peringatan.
OnPostExecute	Penanganan aktivitas untuk peristiwa OnPostExecute . Kejadian ini dinaikkan oleh executable segera setelah selesai berjalan.
OnPostValidate	Penanganan aktivitas untuk peristiwa OnPostValidate . Kejadian ini dinaikkan oleh executable ketika validasinya selesai.
OnPreExecute	Penanganan aktivitas untuk peristiwa OnPreExecute . Kejadian ini dinaikkan oleh executable segera sebelum dijalankan.
OnPreValidate	Penanganan aktivitas untuk peristiwa OnPreValidate . Kejadian ini dinaikkan oleh executable ketika validasinya dimulai.
OnProgress	Penanganan aktivitas untuk peristiwa OnProgress . Kejadian ini dinaikkan oleh executable ketika kemajuan terukur dibuat oleh executable.
OnQueryCancel	Penanganan aktivitas untuk peristiwa OnQueryCancel . Kejadian ini dinaikkan oleh executable untuk menentukan apakah kejadian tersebut harus berhenti berjalan.
OnTaskFailed	Penanganan aktivitas untuk peristiwa OnTaskFailed . Kejadian ini dinaikkan oleh tugas ketika gagal.
OnVariableValueChanged	Penanganan aktivitas untuk peristiwa OnVariableValueChanged . Kejadian ini dinaikkan oleh executable ketika nilai variabel berubah. Peristiwa dinaikkan oleh executable tempat variabel ditentukan. Kejadian ini tidak dinaikkan jika Anda mengatur properti RaiseChangeEvent untuk variabel ke False. Untuk informasi selengkapnya, lihat Variabel Integration Services (SSIS).
OnWarning	Penanganan aktivitas untuk peristiwa OnWarning . Kejadian ini dinaikkan oleh executable ketika peringatan terjadi.

Menambahkan penanganan aktivitas ke paket

Pada durasi, kontainer dan tugas meningkatkan peristiwa. Anda dapat membuat penanganan aktivitas kustom yang merespons peristiwa ini dengan menjalankan alur kerja saat peristiwa dinaikkan. Misalnya, Anda dapat membuat penanganan aktivitas yang mengirim pesan email saat tugas gagal.

Penanganan aktivitas mirip dengan paket. Seperti paket, penanganan aktivitas dapat menyediakan cakupan untuk variabel, dan menyertakan alur kontrol dan aliran data opsional. Anda dapat membangun penanganan aktivitas untuk paket, kontainer Foreach Loop, kontainer For Loop, kontainer Urutan, dan semua tugas.

Anda membuat penanganan aktivitas dengan menggunakan permukaan desain tab Penanganan Aktivitas di SSIS Designer.

Saat tab Penanganan Aktivitas aktif, simpul Item Alur Kontrol dan Tugas Rencana Pemeliharaan kotak Alat di SSIS Designer berisi tugas dan kontainer untuk membangun alur kontrol di penanganan aktivitas. Simpul Sumber Aliran Data, Transformasi, dan Tujuan Aliran Data berisi sumber data, transformasi, dan tujuan untuk membangun aliran data di penanganan aktivitas. Untuk informasi selengkapnya, lihat Alur Kontrol dan Aliran Data.

Tab Penanganan Aktivitas juga menyertakan area Pengelola Koneksi tempat Anda dapat membuat dan memodifikasi manajer koneksi yang digunakan penanganan aktivitas untuk menyambungkan ke server dan sumber data. Untuk informasi selengkapnya, lihat Membuat Pengelola Koneksi.

Menambahkan penanganan aktivitas pada tab Penanganan Aktivitas

1. Di SQL Server Data Tools (SSDT), buka proyek Integration Services yang berisi paket yang Anda inginkan.

2. Di Penjelajah Solusi, klik dua kali paket untuk membukanya.

3. Klik tab Penanganan Aktivitas .

   

   Membuat aliran kontrol dan aliran data dalam penanganan aktivitas mirip dengan membuat alur kontrol dan aliran data dalam paket. Untuk informasi selengkapnya, lihat Alur Kontrol dan Aliran Data.

4. Di daftar Dapat Dieksekusi , pilih executable yang ingin Anda buat penanganan aktivitasnya.

5. Di daftar Penanganan aktivitas, pilih penanganan aktivitas yang ingin Anda buat.

6. Klik tautan pada permukaan desain tab Penanganan Aktivitas .

7. Tambahkan item alur kontrol ke penanganan aktivitas, dan sambungkan item menggunakan batasan prioritas dengan menyeret batasan dari satu item alur kontrol ke item lainnya. Untuk informasi selengkapnya, lihat Alur Kontrol.

8. Secara opsional, tambahkan tugas Aliran Data, dan pada permukaan desain tab Aliran Data , buat aliran data untuk penanganan aktivitas. Untuk informasi selengkapnya, lihat Aliran Data.

9. Pada menu File , klik Simpan Item Terpilih untuk menyimpan paket.

Mengatur properti penanganan aktivitas

Anda dapat mengatur properti di jendela Properti SQL Server Data Tools (SSDT) atau secara terprogram.

Untuk informasi tentang cara mengatur properti ini di SQL Server Data Tools (SSDT), lihat Mengatur Properti Tugas atau Kontainer.

Untuk informasi tentang mengatur properti ini secara terprogram, lihat DtsEventHandler.

Tugas Terkait

Untuk informasi tentang cara menambahkan penanganan aktivitas ke paket, lihat Menambahkan Penanganan Aktivitas ke Paket.