Kontainer SSIS

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

Kontainer adalah objek dalam Layanan Integrasi SQL Server 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 berisi 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 bernilai false. Misalnya, paket dapat mengirim pesan email yang berbeda tujuh kali, satu kali untuk setiap hari dalam seminggu.

  • Kelompokkan tugas dan kontainer yang harus berhasil atau gagal sebagai satu kesatuan. 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
Wadah 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 Penangan Peristiwa 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 konfigurasi tugas yang dienkapsulasi oleh host tugas tersebut. Anda mengatur properti Host Tugas saat mengonfigurasi tugas.

Properti Deskripsi
DelayValidation Nilai Boolean yang menunjukkan apakah validasi kontainer ditunda hingga waktu proses. 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 Tipe data dari ForcedExecutionValue. Nilai default properti ini adalah Int32.
ForceExecutionResult Nilai yang menentukan hasil yang dipaksakan dari 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 diberikan 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 merujuk pada tugas di tingkat kontainer dan semua kontainer di dalam kontainer tersebut. Executable dapat menjadi salah satu tugas dan kontainer yang disediakan Integration Services atau tugas kustom. Untuk informasi selengkapnya, lihat Tugas Layanan Integrasi.

Batasan Urutan

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

Penangan peristiwa pada tingkat kontainer merespons peristiwa yang dipicu oleh kontainer atau objek yang dikandungnya. Untuk informasi selengkapnya, lihat Penangan Kejadian 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 di Integration Services (SSIS).

Titik Henti

Saat Anda menetapkan titik henti pada kontainer dan kondisinya adalah Berhenti ketika kontainer menerima peristiwa OnVariableValueChanged, tentukan variabel dalam cakupan kontainer.