Mengatur Properti Paket
Berlaku untuk:
SQL Server SSIS Integration Runtime di Azure Data Factory
Saat Anda membuat paket di SQL Server Data Tools (SSDT) dengan menggunakan antarmuka grafis yang disediakan Integration Services, Anda mengatur properti objek paket di jendela Properti.
Jendela Properti menyediakan daftar properti yang dikategorikan dan sesuai abjad. Untuk menyusun jendela Properti menurut kategori, klik ikon Dikategorikan.
Saat disusun menurut kategori, jendela Properti mengelompokkan properti dalam kategori berikut:
Untuk informasi tentang properti paket tambahan yang tidak dapat Anda atur di jendela Properti , lihat Package.
Untuk mengatur properti paket di jendela Properti
Properti berdasarkan Kategori
Tabel berikut mencantumkan properti paket menurut kategori.
Titik pemeriksaan
Anda dapat menggunakan properti dalam kategori ini untuk memulai ulang paket dari titik kegagalan dalam alur kontrol paket, alih-alih menjalankan ulang paket dari awal alur kontrolnya. Untuk informasi selengkapnya, lihat Memulai Ulang Paket dengan Menggunakan Titik Pemeriksaan.
| Properti | Deskripsi |
|---|---|
| CheckpointFileName | Nama file yang mengambil informasi titik pemeriksaan yang memungkinkan paket dimulai ulang. Ketika paket berhasil diselesaikan, file ini akan dihapus. |
| Titik PemeriksaanPenggunaan | Menentukan kapan paket dapat dimulai ulang. Nilainya adalah Never, IfExists, dan Always. Nilai default properti ini adalah Never, yang menunjukkan bahwa paket tidak dapat dimulai ulang. Untuk informasi selengkapnya, lihat DTSCheckpointUsage . |
| SaveCheckpoints | Menentukan apakah titik pemeriksaan ditulis ke file titik pemeriksaan saat paket berjalan. Nilai default properti ini adalah False. |
Catatan
Opsi /CheckPointing pada dtexec setara dengan mengatur properti SaveCheckpoints paket ke True, dan properti CheckpointUsage ke Always. Untuk informasi selengkapnya, lihat Utilitas dtexec.
Eksekusi
Properti dalam kategori ini mengonfigurasi perilaku run-time objek paket.
| Properti | Deskripsi |
|---|---|
| DelayValidation | Menunjukkan apakah validasi paket tertunda hingga paket berjalan. Nilai default untuk properti ini adalah False. |
| Nonaktifkan | Menunjukkan apakah paket dinonaktifkan. Nilai default properti ini adalah False. |
| DisableEventHandlers | Menentukan apakah penanganan aktivitas paket berjalan. Nilai default properti ini adalah False. |
| FailPackageOnFailure | Menentukan apakah paket gagal jika terjadi kesalahan dalam komponen paket. Satu-satunya nilai yang valid dari properti ini adalah False. |
| FailParentOnError | Menentukan apakah kontainer induk gagal jika terjadi kesalahan dalam kontainer turunan. Nilai default adalah properti ini adalah False. |
| MaxConcurrentExecutables | Jumlah file yang dapat dieksekusi yang dapat dijalankan paket secara bersamaan. Nilai default properti ini adalah -1, yang menunjukkan bahwa tidak ada batasan. |
| MaximumErrorCount | Jumlah maksimum kesalahan yang dapat terjadi sebelum paket berhenti berjalan. Nilai default properti ini adalah 1. |
| PackagePriorityClass | Kelas prioritas alur Win32 dari utas paket. Nilainya adalah Default, AboveNormal, Normal, BelowNormal, Idle. Nilai default properti ini adalah Default. Untuk informasi selengkapnya, lihat DTSPriorityClass . |
Nilai Eksekusi Paksa
Properti dalam kategori ini mengonfigurasi nilai eksekusi opsional untuk paket.
| Properti | Deskripsi |
|---|---|
| ForcedExecutionValue | Jika ForceExecutionValue diatur ke True, nilai yang menentukan nilai eksekusi opsional yang dikembalikan paket. Nilai default properti ini adalah 0. |
| ForcedExecutionValueType | Jenis data ForcedExecutionValue. Nilai default properti ini adalah Int32. |
| ForceExecutionValue | Nilai Boolean yang menentukan apakah nilai eksekusi opsional kontainer harus dipaksa untuk berisi nilai tertentu. Nilai default properti ini adalah False. |
Identifikasi
Properti dalam kategori ini memberikan informasi seperti pengidentifikasi unik dan nama paket.
| Properti | Deskripsi |
|---|---|
| CreationDate | Tanggal paket dibuat. |
| CreatorComputerName | Nama komputer tempat paket dibuat. |
| CreatorName | Nama orang yang membuat paket. |
| Keterangan | Deskripsi fungsionalitas paket. |
| ID | GUID paket, yang ditetapkan saat paket dibuat. Properti ini bersifat hanya baca. Untuk menghasilkan nilai acak baru untuk properti ID , pilih <Buat ID> Baru di daftar drop-down. |
| Nama | Nama paket. |
| PackageType | Jenis paket. Nilainya adalah Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMaint, dan SQLReplication. Nilai default properti ini adalah Default. Untuk informasi selengkapnya, lihat DTSPackageType . |
Lain-lain
Properti dalam kategori ini digunakan untuk mengakses konfigurasi dan ekspresi yang digunakan paket dan untuk memberikan informasi tentang mode lokal dan pengelogan paket. Untuk informasi selengkapnya, lihat Menggunakan Ekspresi Properti dalam Paket.
| Properti | Deskripsi |
|---|---|
| Konfigurasi | Kumpulan konfigurasi yang digunakan paket. Klik tombol telusuri (...) untuk melihat dan mengonfigurasi konfigurasi paket. |
| Expressions | Klik tombol telusuri (...) untuk membuat ekspresi untuk properti paket. Perhatikan bahwa Anda dapat membuat ekspresi properti untuk semua properti paket yang disertakan model objek, bukan hanya properti yang tercantum di jendela Properti. Untuk informasi selengkapnya, lihat Menggunakan Ekspresi Properti dalam Paket. Untuk melihat ekspresi properti yang ada, perluas Ekspresi. Klik tombol telusuri (...) dalam kotak teks ekspresi untuk mengubah dan mengevaluasi ekspresi. |
| ForceExecutionResult | Hasil eksekusi paket. Nilainya adalah None, Success, Failure, dan Completion. Nilai default properti ini adalah Tidak Ada. Untuk informasi selengkapnya, lihat T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult. |
| LocaleId | Lokal Microsoft Win32. Nilai default properti ini adalah lokal sistem operasi pada komputer lokal. |
| LoggingMode | Nilai yang menentukan perilaku pengelogan paket. Nilainya adalah Disabled, Enabled, dan UseParentSetting. Nilai default properti ini adalah UseParentSetting. Untuk informasi selengkapnya, lihat DTSLoggingMode . |
| OfflineMode | Menunjukkan apakah paket dalam mode offline. Properti ini bersifat hanya baca. Properti diatur pada tingkat proyek. Biasanya, SSIS Designer mencoba menyambungkan ke setiap sumber data yang digunakan oleh paket Anda untuk memvalidasi metadata yang terkait dengan sumber dan tujuan. Anda dapat mengaktifkan Bekerja Offline dari menu SSIS , bahkan sebelum membuka paket, untuk mencegah upaya koneksi ini dan kesalahan validasi yang dihasilkan saat sumber data tidak tersedia. Anda juga dapat mengaktifkan Work Offline untuk mempercepat operasi di perancang, dan menonaktifkannya hanya ketika Anda ingin paket Anda divalidasi. |
| SuppressConfigurationWarnings | Menunjukkan apakah peringatan yang dihasilkan oleh konfigurasi ditekan. Nilai default properti ini adalah False. |
| UpdateObjects | Menunjukkan apakah paket diperbarui untuk menggunakan versi objek yang lebih baru yang dikandungnya, jika versi yang lebih baru tersedia. Misalnya, jika properti ini diatur ke True, paket yang menyertakan tugas Sisipkan Massal diperbarui untuk menggunakan versi tugas Sisipkan Massal yang lebih baru yang disediakan Layanan Integrasi. Nilai default properti ini adalah False. |
Keamanan
Properti dalam kategori ini digunakan untuk mengatur tingkat perlindungan paket. Untuk informasi selengkapnya, lihat Kontrol Akses untuk Data Sensitif dalam Paket.
| Properti | Deskripsi |
|---|---|
| PackagePassword | Kata sandi untuk tingkat perlindungan paket (EncryptSensitiveWithPassword dan EncryptAllWithPassword) yang memerlukan kata sandi. |
| ProtectionLevel | Tingkat perlindungan paket. Nilainya adalah DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPassword, dan ServerStorage. Nilai default properti ini adalah EncryptSensitiveWithUserKey. Untuk informasi selengkapnya, lihat DTSProtectionLevel . |
Transaksi
Properti dalam kategori ini mengonfigurasi tingkat isolasi dan opsi transaksi paket. Untuk informasi selengkapnya, lihat Transaksi Layanan Integrasi.
| Properti | Deskripsi |
|---|---|
| IsolationLevel | Tingkat isolasi transaksi paket. Nilainya adalah Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable, dan Snapshot. Nilai default properti ini dapat diserialisasikan. Catatan: Nilai Rekam jepret properti IsolationLevel tidak kompatibel dengan transaksi paket. Oleh karena itu, Anda tidak dapat menggunakan properti IsolationLevel untuk mengatur tingkat isolasi transaksi paket ke Shapshot. Sebagai gantinya, gunakan kueri SQL untuk mengatur transaksi paket ke Snapshot. Untuk informasi selengkapnya, lihat MENGATUR TINGKAT ISOLASI TRANSAKSI (Transact-SQL). Sistem menerapkan properti IsolationLevel untuk transaksi paket hanya ketika nilai properti TransactionOption Diperlukan. Nilai properti IsolationLevel yang diminta oleh kontainer turunan diabaikan ketika kondisi berikut ini benar: Nilai properti TransactionOption kontainer turunan Didukung. Kontainer turunan bergabung dengan transaksi kontainer induk. Nilai properti IsolationLevel yang diminta oleh kontainer hanya dihormati ketika kontainer memulai transaksi baru. Kontainer memulai transaksi baru ketika kondisi berikut ini benar: Nilai properti TransactionOption kontainer diperlukan. Induk belum memulai transaksi. Untuk informasi selengkapnya, lihat IsolationLevel . |
| TransactionOption | Partisipasi transaksi dari paket. Nilainya tidak didukung, Didukung, Diperlukan. Nilai default properti ini Didukung. Untuk informasi selengkapnya, lihat DTSTransactionOption . |
Versi
Properti dalam kategori ini menyediakan informasi tentang versi objek paket.
| Properti | Deskripsi |
|---|---|
| VersionBuild | Nomor versi build paket. |
| VersionComments | Komentar tentang versi paket. |
| VersionGUID | GUID versi paket. Properti ini bersifat hanya baca. |
| VersionMajor | Versi utama paket terbaru. |
| VersionMinor | Versi minor terbaru dari paket. |
Mengatur properti paket di jendela Properti
Di SQL Server Data Tools (SSDT), buka proyek Integration Services yang berisi paket yang ingin Anda konfigurasi.
Di Penjelajah Solusi, klik dua kali paket untuk membukanya di SSIS Designer, atau klik kanan dan pilih Tampilkan Perancang.
Klik tab Alur Kontrol lalu lakukan salah satu hal berikut ini:
Klik kanan di mana saja di latar belakang permukaan desain alur kontrol, lalu klik Properti.
Pada menu Tampilan, pilih Jendela Properti.
Edit properti paket di jendela Properti .
Pada menu File , klik Simpan Item Terpilih untuk menyimpan paket yang diperbarui.