Tugas Jalankan Proses
Berlaku untuk:
SQL Server SSIS Integration Runtime di Azure Data Factory
Tugas Jalankan Proses menjalankan aplikasi atau file batch sebagai bagian dari alur kerja paket SQL Server Integration Services. Meskipun Anda dapat menggunakan tugas Jalankan Proses untuk membuka aplikasi standar apa pun, seperti Microsoft Excel atau Microsoft Word, Anda biasanya menggunakannya untuk menjalankan aplikasi bisnis atau file batch yang berfungsi terhadap sumber data. Misalnya, Anda dapat menggunakan tugas Jalankan Proses untuk memperluas file teks terkompresi. Kemudian paket dapat menggunakan file teks sebagai sumber data untuk aliran data dalam paket. Sebagai contoh lain, Anda dapat menggunakan tugas Jalankan Proses untuk menjalankan aplikasi Visual Basic kustom yang menghasilkan laporan penjualan harian. Kemudian Anda bisa melampirkan laporan ke tugas Kirim Email dan meneruskan laporan ke daftar distribusi.
Layanan Integrasi mencakup tugas lain yang melakukan operasi alur kerja seperti menjalankan paket. Untuk informasi selengkapnya, lihat Menjalankan Tugas Paket.
Entri log kustom tersedia pada tugas Jalankan Proses
Tabel berikut mencantumkan entri log kustom untuk tugas Jalankan Proses. Untuk informasi selengkapnya, lihat Pengelogan Integration Services (SSIS).
| Entri log | Deskripsi |
|---|---|
| ExecuteProcessExecutingProcess | Menyediakan informasi tentang proses yang dikonfigurasi tugas untuk dijalankan. Dua entri log ditulis. Satu berisi informasi tentang nama dan lokasi yang dapat dieksekusi yang dijalankan tugas, dan entri lainnya merekam keluar dari executable. |
| ExecuteProcessVariableRouting | Menyediakan informasi tentang variabel mana yang dirutekan ke input dan output dari executable. Entri log ditulis untuk stdin (input), stdout (output), dan stderr (output kesalahan). |
Konfigurasi tugas Jalankan Proses
Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram.
Untuk informasi selengkapnya tentang cara mengatur properti ini di SSIS Designer, lihat Menambahkan atau Menghapus Tugas atau Kontainer dalam Alur Kontrol.
Pengaturan properti
Saat tugas Jalankan Proses menjalankan aplikasi kustom, tugas menyediakan input ke aplikasi melalui salah satu atau kedua metode berikut:
Variabel yang Anda tentukan dalam pengaturan properti StandardInputVariable . Untuk informasi selengkapnya tentang variabel, lihat Variabel Integration Services (SSIS) dan Variabel Integration Services (SSIS).
Argumen yang Anda tentukan dalam pengaturan properti Argumen . (Misalnya, jika tugas membuka dokumen di Word, argumen dapat memberi nama file .doc.)
Untuk meneruskan beberapa argumen ke aplikasi kustom dalam satu tugas Jalankan Proses, gunakan spasi untuk memisahkan argumen. Argumen tidak dapat menyertakan spasi; jika tidak, tugas tidak berjalan. Anda dapat menggunakan ekspresi untuk meneruskan nilai variabel sebagai argumen. Dalam contoh berikut, ekspresi meneruskan dua nilai variabel sebagai argumen, dan menggunakan spasi untuk memisahkan argumen:
@variable1 + " " + @variable2
Anda dapat menggunakan ekspresi untuk mengatur berbagai properti tugas Jalankan Proses.
Saat Anda menggunakan properti StandardInputVariable untuk mengonfigurasi tugas Jalankan Proses untuk memberikan input, panggil metode Console.ReadLine dari aplikasi untuk membaca input. Untuk informasi selengkapnya, lihat Metode Console.ReadLine.
Saat Anda menggunakan properti Argumen untuk mengonfigurasi tugas Jalankan Proses untuk memberikan input, lakukan salah satu langkah berikut untuk mendapatkan argumen:
Jika Anda menggunakan Microsoft Visual Basic untuk menulis aplikasi, atur properti My.Application.CommandLineArgs . Contoh berikut mengatur properti My.Application.CommandLineArgs adalah mengambil dua argumen:
Dim variable1 As String = My.Application.CommandLineArgs.Item(0) Dim variable2 As String = My.Application.CommandLineArgs.Item(1)Untuk informasi selengkapnya, lihat Properti ConsoleApplicationBase.CommandLineArgs.
Jika Anda menggunakan Microsoft Visual C# untuk menulis aplikasi, gunakan metode Utama .
Untuk informasi selengkapnya, lihat Argumen Baris Perintah (Panduan Pemrograman C#).
Tugas Jalankan Proses juga mencakup properti StandardOutputVariable dan StandardErrorVariable untuk menentukan variabel yang masing-masing menggunakan output standar dan output kesalahan aplikasi.
Selain itu, Anda dapat mengonfigurasi tugas Jalankan Proses untuk menentukan direktori kerja, periode waktu habis, atau nilai untuk menunjukkan bahwa eksekusi berhasil dijalankan. Tugas juga dapat dikonfigurasi untuk gagal, jika kode pengembalian dari executable tidak cocok dengan nilai yang menunjukkan keberhasilan, atau jika executable tidak ditemukan di lokasi yang ditentukan.
Konfigurasi terprogram dari tugas Jalankan Proses
Untuk informasi selengkapnya tentang mengatur properti ini secara terprogram, lihat ExecuteProcess.
Jalankan Editor Tugas Proses (halaman Umum)
Gunakan halaman Umum kotak dialog Jalankan Editor Tugas Proses untuk memberi nama dan menjelaskan tugas Jalankan Proses.
Opsi
Nama
Berikan nama unik untuk tugas Jalankan Proses. Nama ini digunakan sebagai label dalam ikon tugas.
Catatan
Nama tugas harus unik dalam paket.
Keterangan
Ketik deskripsi tugas Jalankan Proses.
Jalankan Editor Tugas Proses (halaman Proses)
Gunakan halaman Proses dari kotak dialog Jalankan Editor Tugas Proses untuk mengonfigurasi opsi yang menjalankan proses. Opsi ini mencakup executable untuk dijalankan, lokasinya, argumen prompt perintah, dan variabel yang menyediakan input dan menangkap output.
Opsi
RequireFullFileName
Tunjukkan apakah tugas harus gagal jika executable tidak ditemukan di lokasi yang ditentukan.
Eksekusi
Ketik nama executable yang akan dijalankan.
Argumen
Berikan argumen prompt perintah.
WorkingDirectory
Ketik jalur folder yang berisi file yang dapat dieksekusi, atau pilih tombol telusuri (...) dan temukan folder.
StandardInputVariable
Pilih variabel untuk memberikan input ke proses, atau pilih <Variabel baru...> untuk membuat variabel baru:
Topik Terkait: Variabel Integration Services (SSIS)
StandardOutputVariable
Pilih variabel untuk mengambil output proses, atau pilih <Variabel baru...> untuk membuat variabel baru.
StandardErrorVariable
Pilih variabel untuk menangkap output kesalahan prosesor, atau pilih <Variabel baru...> untuk membuat variabel baru.
FailTaskIfReturnCodeIsNotSuccessValue
Tunjukkan apakah tugas gagal jika kode keluar proses berbeda dari nilai yang ditentukan dalam SuccessValue.
SuccessValue
Tentukan nilai yang dikembalikan oleh executable untuk menunjukkan keberhasilan. Secara default nilai ini diatur ke 0.
Timeout
Tentukan jumlah detik yang dapat dijalankan proses. Nilai 0 menunjukkan bahwa tidak ada nilai waktu habis yang digunakan, dan proses berjalan sampai selesai atau sampai kesalahan terjadi.
TerminateProcessAfterTimeOut
Tunjukkan apakah proses dipaksa berakhir setelah periode waktu habis yang ditentukan oleh opsi TimeOut . Opsi ini hanya tersedia jika TimeOut tidak 0.
WindowStyle
Tentukan gaya jendela untuk menjalankan proses.