Kontainer SSIS
Berlaku untuk:
SQL Server SSIS Integration Runtime di Azure Data Factory
Kontainer adalah objek dalam SQL Server Integration Services yang menyediakan struktur ke paket dan layanan untuk tugas. Mereka mendukung alur kontrol berulang dalam paket, dan mereka mengelompokkan tugas dan kontainer ke dalam unit kerja yang bermakna. Kontainer dapat menyertakan kontainer lain selain tugas.
Paket menggunakan kontainer untuk tujuan berikut:
Ulangi tugas untuk setiap elemen dalam koleksi, seperti file dalam folder, skema, atau objek SQL Server Management Objects (SMO). Misalnya, paket dapat menjalankan pernyataan Transact-SQL yang berada di beberapa file.
Ulangi tugas hingga ekspresi yang ditentukan mengevaluasi ke false. Misalnya, paket dapat mengirim pesan email yang berbeda tujuh kali, satu kali untuk setiap hari dalam seminggu.
Tugas grup dan kontainer yang harus berhasil atau gagal sebagai unit. Misalnya, paket dapat mengelompokkan tugas yang menghapus dan menambahkan baris dalam tabel database, lalu menerapkan atau mengembalikan semua tugas saat satu gagal.
Jenis Kontainer
Integration Services menyediakan empat jenis kontainer untuk membangun paket. Tabel berikut mencantumkan jenis kontainer.
| Kontainer | Deskripsi |
|---|---|
| Kontainer Perulangan Foreach | Menjalankan alur kontrol berulang kali dengan menggunakan enumerator. |
| Untuk Kontainer Perulangan | Menjalankan alur kontrol berulang kali dengan menguji kondisi. |
| Kontainer Urutan | Mengelompokkan tugas dan kontainer ke dalam alur kontrol yang merupakan subset alur kontrol paket. |
| Kontainer Host Tugas | Menyediakan layanan untuk satu tugas. |
Penangan paket dan peristiwa juga merupakan jenis kontainer. Untuk informasi, lihat Paket Integration Services (SSIS) dan Penanganan Aktivitas Integration Services (SSIS).
Ringkasan Properti Kontainer
Semua jenis kontainer memiliki sekumpulan properti yang sama. Jika Anda membuat paket menggunakan alat grafis yang disediakan Integration Services, jendela Properti mencantumkan properti berikut untuk kontainer Foreach Loop, For Loop, dan Sequence. Properti kontainer host tugas dikonfigurasi sebagai bagian dari mengonfigurasi tugas yang dienkapsulasi host tugas. Anda mengatur properti Host Tugas saat mengonfigurasi tugas.
| Properti | Deskripsi |
|---|---|
| DelayValidation | Nilai Boolean yang menunjukkan apakah validasi kontainer tertunda hingga durasi. Nilai default untuk properti ini adalah False. Untuk informasi selengkapnya, lihat DelayValidation . |
| Keterangan | Deskripsi kontainer. Properti berisi string, tetapi mungkin kosong. Untuk informasi selengkapnya, lihat Description . |
| Nonaktifkan | Nilai Boolean yang menunjukkan apakah kontainer berjalan. Nilai default untuk properti ini adalah False. Untuk informasi selengkapnya, lihat Disable . |
| DisableEventHandlers | Nilai Boolean yang menunjukkan apakah penanganan aktivitas yang terkait dengan kontainer berjalan. Nilai default untuk properti ini adalah False. |
| FailPackageOnFailure | Nilai Boolean yang menentukan apakah paket gagal jika terjadi kesalahan dalam kontainer. Nilai default untuk properti ini adalah False. Untuk informasi selengkapnya, lihat FailPackageOnFailure . |
| FailParentOnFailure | Nilai Boolean yang menentukan apakah kontainer induk gagal jika terjadi kesalahan dalam kontainer. Nilai default untuk properti ini adalah False. Untuk informasi selengkapnya, lihat FailParentOnFailure . |
| ForcedExecutionValue | Jika ForceExecutionValue diatur ke True, objek yang berisi nilai eksekusi opsional untuk kontainer. Nilai default properti ini adalah 0. Untuk informasi selengkapnya, lihat ForcedExecutionValue . |
| ForcedExecutionValueType | Jenis data ForcedExecutionValue. Nilai default properti ini adalah Int32. |
| ForceExecutionResult | Nilai yang menentukan hasil paksa menjalankan paket atau kontainer. Nilainya adalah None, Success, Failure, dan Completion. Nilai default untuk properti ini adalah Tidak Ada. Untuk informasi selengkapnya, lihat ForceExecutionResult . |
| ForceExecutionValue | Nilai Boolean yang menentukan apakah nilai eksekusi opsional kontainer harus dipaksa untuk berisi nilai tertentu. Nilai default properti ini adalah False. Untuk informasi selengkapnya, lihat ForceExecutionValue . |
| ID | GUID kontainer, yang ditetapkan saat paket dibuat. Properti ini bersifat hanya baca. ID. |
| IsolationLevel | Tingkat isolasi transaksi kontainer. Nilainya adalah Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable, dan Snapshot. Nilai default properti ini dapat diserialisasikan. Untuk informasi selengkapnya, lihat IsolationLevel . |
| LocaleID | Lokal Microsoft Win32. Nilai default properti ini adalah lokal sistem operasi pada komputer lokal. Untuk informasi selengkapnya, lihat LocaleID . |
| LoggingMode | Nilai yang menentukan perilaku pengelogan kontainer. Nilainya adalah Disabled, Enabled, dan UseParentSetting. Nilai default properti ini adalah UseParentSetting. Untuk informasi selengkapnya, lihat DTSLoggingMode . |
| MaximumErrorCount | Jumlah maksimum kesalahan yang dapat terjadi sebelum kontainer berhenti berjalan. Nilai default properti ini adalah 1. Untuk informasi selengkapnya, lihat MaximumErrorCount . |
| Nama | Nama kontainer. Untuk informasi selengkapnya, lihat Name . |
| TransactionOption | Partisipasi transaksi dari kontainer. Nilainya tidak didukung, Didukung, Diperlukan. Nilai default properti ini Didukung. Untuk informasi selengkapnya, lihat DTSTransactionOption . |
Untuk mempelajari tentang semua properti yang tersedia untuk kontainer Foreach Loop, For Loop, Sequence, dan Task Host saat mengonfigurasinya secara terprogram, lihat topik API Integration Services berikut:
T:Microsoft.SqlServer.Dts.Runtime.ForEachLoop
T:Microsoft.SqlServer.Dts.Runtime.ForLoop
T:Microsoft.SqlServer.Dts.Runtime.Sequence
T:Microsoft.SqlServer.Dts.Runtime.TaskHost
Objek yang Memperluas Fungsionalitas Kontainer
Kontainer mencakup alur kontrol yang terdiri dari executable dan batasan prioritas, dan dapat menggunakan penanganan aktivitas, dan variabel. Kontainer host tugas adalah pengecualian: karena kontainer host tugas merangkum satu tugas, kontainer tidak menggunakan batasan prioritas.
Dapat dijalankan
Executable mengacu pada tugas tingkat kontainer dan kontainer apa pun dalam kontainer. Executable dapat menjadi salah satu tugas dan kontainer yang disediakan Integration Services atau tugas kustom. Untuk informasi selengkapnya, lihat Tugas Layanan Integrasi.
Batasan Prioritas
Batasan prioritas menautkan kontainer dan tugas dalam kontainer induk yang sama ke dalam alur kontrol yang diurutkan. Untuk informasi selengkapnya, lihat Batasan Prioritas.
Penanganan Aktivitas
Penanganan aktivitas di tingkat kontainer merespons peristiwa yang diangkat oleh kontainer atau objek yang disertakannya. Untuk informasi selengkapnya, lihat Penanganan Aktivitas Integration Services (SSIS).
Variabel
Variabel yang digunakan dalam kontainer mencakup variabel sistem tingkat kontainer yang disediakan Integration Services dan variabel yang ditentukan pengguna yang digunakan kontainer. Untuk informasi selengkapnya, lihat Variabel Integration Services (SSIS).
Titik Henti
Saat Anda mengatur titik henti pada kontainer dan kondisi jeda adalah Putus saat kontainer mengembangkan ulang peristiwa OnVariableValueChanged, tentukan variabel dalam cakupan kontainer.