Tugas Antrean Pesan
Berlaku untuk:
SQL Server SSIS Integration Runtime di Azure Data Factory
Tugas Antrean Pesan memungkinkan Anda menggunakan Antrean Pesan (juga dikenal sebagai MSMQ) untuk mengirim dan menerima pesan antara paket SQL Server Integration Services, atau mengirim pesan ke antrean aplikasi yang diproses oleh aplikasi kustom. Pesan-pesan ini dapat berbentuk teks, file, atau variabel sederhana dan nilainya.
Dengan menggunakan tugas Antrean Pesan, Anda dapat mengoordinasikan operasi di seluruh perusahaan Anda. Pesan dapat diantrekan dan dikirimkan nanti jika tujuan tidak tersedia atau sibuk; misalnya, tugas dapat mengantre pesan untuk komputer laptop offline perwakilan penjualan, yang menerima pesan mereka ketika mereka terhubung ke jaringan. Anda dapat menggunakan tugas Antrean Pesan untuk tujuan berikut:
Menunda eksekusi tugas hingga paket lain masuk. Misalnya, setelah pemeliharaan malam hari di setiap situs ritel Anda, tugas Antrean Pesan mengirimkan pesan ke komputer perusahaan Anda. Paket yang berjalan di komputer perusahaan berisi tugas Antrean Pesan, masing-masing menunggu pesan dari situs ritel tertentu. Saat pesan dari situs tiba, tugas mengunggah data dari situs tersebut. Setelah semua situs check in, paket menghitung total ringkasan.
Mengirim file data ke komputer yang memprosesnya. Misalnya, output dari kasir restoran dapat dikirim dalam pesan file data ke sistem penggajian perusahaan, di mana data tentang setiap tips pelayan diekstraksi.
Mendistribusikan file di seluruh perusahaan Anda. Misalnya, paket dapat menggunakan tugas Antrean Pesan untuk mengirim file paket ke komputer lain. Paket yang berjalan di komputer tujuan kemudian menggunakan tugas Antrean Pesan untuk mengambil dan menyimpan paket secara lokal.
Saat mengirim atau menerima pesan, tugas Antrean Pesan menggunakan salah satu dari empat jenis pesan: file data, string, pesan string ke variabel, atau variabel. Pesan string ke jenis pesan variabel hanya dapat digunakan saat menerima pesan.
Tugas ini menggunakan pengelola koneksi MSMQ untuk menyambungkan ke antrean pesan. Untuk informasi selengkapnya, lihat Pengelola Sambungan MSMQ. Untuk informasi selengkapnya tentang Antrean Pesan, lihat Pustaka MSDN.
Tugas Antrean Pesan mengharuskan layanan Layanan Integrasi diinstal. Beberapa komponen SQL Server yang dapat Anda pilih untuk penginstalan pada halaman Komponen untuk Diinstal atau halaman Pemilihan Fitur wizard Penginstalan SQL Server menginstal subset parsial komponen Layanan Integrasi. Komponen-komponen ini berguna untuk tugas tertentu, tetapi fungsionalitas Layanan Integrasi akan dibatasi. Misalnya, opsi SQL Server Data Tools (SSDT) menginstal komponen Layanan Integrasi yang diperlukan untuk merancang paket, tetapi layanan Layanan Integrasi tidak diinstal, dan oleh karena itu tugas Antrean Pesan tidak berfungsi. Untuk memastikan penginstalan lengkap Layanan Integrasi, Anda harus memilih Layanan Integrasi di halaman Komponen untuk Menginstal . Untuk informasi selengkapnya tentang menginstal dan menjalankan tugas Antrean Pesan, lihat Menginstal Layanan Integrasi.
Catatan
Tugas Antrean Pesan gagal mematuhi Standar Pemrosesan Informasi Federal (FIPS) 140-2 saat sistem operasi komputer dikonfigurasi dalam mode FIPS dan tugas menggunakan enkripsi. Jika tugas Antrean Pesan tidak menggunakan enkripsi, tugas dapat berjalan dengan sukses.
Jenis pesan
Anda dapat mengonfigurasi jenis pesan yang disediakan tugas Antrean Pesan dengan cara berikut:
Pesan file data menentukan bahwa file berisi pesan. Saat menerima pesan, Anda dapat mengonfigurasi tugas untuk menyimpan file, menimpa file yang ada, dan menentukan paket tempat tugas dapat menerima pesan.
Pesan string menentukan pesan sebagai string. Saat menerima pesan, Anda dapat mengonfigurasi tugas untuk membandingkan string yang diterima dengan string yang ditentukan pengguna dan mengambil tindakan tergantung pada perbandingan. Perbandingan string dapat tepat, peka huruf besar/kecil atau tidak peka huruf besar/kecil, atau menggunakan substring.
Pesan string ke variabel menentukan pesan sumber sebagai string yang dikirim ke variabel tujuan. Anda dapat mengonfigurasi tugas untuk membandingkan string yang diterima dengan string yang ditentukan pengguna menggunakan perbandingan yang tepat, tidak peka huruf besar/kecil, atau substring. Tipe pesan ini hanya tersedia ketika tugas menerima pesan.
Variabel menentukan bahwa pesan berisi satu atau beberapa variabel. Anda dapat mengonfigurasi tugas untuk menentukan nama variabel yang disertakan dalam pesan. Saat menerima pesan, Anda dapat mengonfigurasi tugas untuk menentukan paket tempatnya dapat menerima pesan dan variabel yang merupakan tujuan pesan.
Mengirim Pesan
Saat mengonfigurasi tugas Antrean Pesan untuk mengirim pesan, Anda dapat menggunakan salah satu algoritma enkripsi yang saat ini didukung oleh teknologi Antrean Pesan, RC2 dan RC4, untuk mengenkripsi pesan. Kedua algoritma enkripsi ini sekarang dianggap lemah secara kriptografis dibandingkan dengan algoritma yang lebih baru, yang belum didukung teknologi Antrean Pesan. Oleh karena itu, Anda harus mempertimbangkan kebutuhan kriptografi Anda dengan hati-hati saat mengirim pesan menggunakan tugas Antrean Pesan.
Menerima Pesan
Saat menerima pesan, tugas Antrean Pesan dapat dikonfigurasi dengan cara berikut:
Melewati pesan, atau menghapus pesan dari antrean.
Menentukan waktu habis.
Gagal jika waktu habis terjadi.
Menimpa file yang sudah ada, jika pesan disimpan dalam file Data.
Menyimpan file pesan ke nama file yang berbeda, jika pesan menggunakan jenis pesan File data.
Pesan Pengelogan Kustom Tersedia pada Tugas Antrean Pesan
Tabel berikut mencantumkan entri log kustom untuk tugas Antrean Pesan. Untuk informasi selengkapnya, lihat Pengelogan Integration Services (SSIS).
| Entri log | Deskripsi |
|---|---|
| MSMQAfterBuka | Menunjukkan bahwa tugas selesai membuka antrean pesan. |
| MSMQBeforeOpen | Menunjukkan bahwa tugas mulai membuka antrean pesan. |
| MSMQBeginReceive | Menunjukkan bahwa tugas mulai menerima pesan. |
| MSMQBeginSend | Menunjukkan bahwa tugas mulai mengirim pesan. |
| MSMQEndReceive | Menunjukkan bahwa tugas selesai menerima pesan. |
| MSMQEndSend | Menunjukkan bahwa tugas selesai mengirim pesan. |
| MSMQTaskInfo | Menyediakan informasi deskriptif tentang tugas. |
| MSMQTaskTimeOut | Menunjukkan bahwa waktu tugas habis. |
Konfigurasi Tugas Antrean Pesan
Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram. Untuk informasi tentang properti yang bisa Anda atur di SSIS Designer, klik topik berikut:
Untuk informasi tentang mengatur properti ini secara terprogram, lihat dokumentasi untuk kelas Microsoft.SqlServer.Dts.Tasks.MessageQueueTask.MessageQueueTask di Panduan Pengembang.
Tugas Terkait
Untuk informasi selengkapnya tentang cara mengatur properti ini di SSIS Designer, lihat Mengatur Properti Tugas atau Kontainer.
Editor Tugas Antrean Pesan (Halaman Umum)
Gunakan halaman Umum kotak dialog Editor Tugas Antrean Pesan untuk memberi nama dan menjelaskan tugas Antrean Pesan, untuk menentukan format pesan, dan untuk menunjukkan apakah tugas mengirim atau menerima pesan.
Opsi
Nama
Berikan nama unik untuk tugas Antrean Pesan. Nama ini digunakan sebagai label dalam ikon tugas.
Catatan
Nama tugas harus unik dalam paket.
Keterangan
Ketik deskripsi tugas Antrean Pesan.
Use2000Format
Menunjukkan apakah akan menggunakan format 2000 Antrean Pesan (juga dikenal sebagai MSMQ). Defaultnya adalah False.
MSMQConnection
Pilih pengelola koneksi MSMQ yang sudah ada atau klik <Koneksi baru...> untuk membuat pengelola koneksi baru.
Topik Terkait: MSMQ Pengelola Sambungan, MSMQ Pengelola Sambungan Editor
Pesan
Tentukan apakah tugas Antrean Pesan mengirim atau menerima pesan. Jika Anda memilih Kirim pesan, halaman Kirim tercantum di panel kiri kotak dialog; jika Anda memilih Terima pesan, halaman Terima dicantumkan. Secara default, nilai ini diatur ke Kirim pesan.
Editor Tugas Antrean Pesan (Kirim Halaman)
Gunakan halaman Kirim dari kotak dialog Editor Tugas Antrean Pesan untuk mengonfigurasi tugas Antrean Pesan untuk mengirim pesan dari paket Microsoft SQL Server Integration Services.
Opsi
UseEncryption
Menunjukkan apakah akan mengenkripsi pesan. Defaultnya adalah False.
EncryptionAlgorithm
Jika Anda memilih untuk menggunakan enkripsi, tentukan nama algoritma enkripsi yang akan digunakan. Tugas Antrean Pesan dapat menggunakan algoritma RC2 dan RC4. Defaultnya adalah RC2.
Catatan
Algoritma RC4 hanya didukung untuk kompatibilitas mundur. Materi baru hanya dapat dienkripsi menggunakan RC4 atau RC4_128 saat database berada dalam tingkat kompatibilitas 90 atau 100. (Tidak disarankan.) Gunakan algoritma yang lebih baru seperti salah satu algoritma AES sebagai gantinya. Dalam rilis SQL Server saat ini, materi yang dienkripsi menggunakan RC4 atau RC4_128 dapat didekripsi dalam tingkat kompatibilitas apa pun.
Penting
Ini adalah algoritma enkripsi yang didukung teknologi Message Queuing (juga dikenal sebagai MSMQ). Kedua algoritma enkripsi ini sekarang dianggap lemah secara kriptografis dibandingkan dengan algoritma yang lebih baru, yang belum didukung oleh Antrean Pesan. Oleh karena itu, Anda harus mempertimbangkan kebutuhan kriptografi Anda dengan hati-hati saat mengirim pesan menggunakan tugas Antrean Pesan.
MessageType
Pilih jenis pesan. Properti ini memiliki opsi yang tercantum dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
| Pesan file data | Pesan disimpan dalam file. Memilih nilai menampilkan opsi dinamis, DataFileMessage. |
| Pesan variabel | Pesan disimpan dalam variabel. Memilih nilai menampilkan opsi dinamis, VariableMessage. |
| Pesan string | Pesan disimpan dalam tugas Antrean Pesan. Memilih nilai menampilkan opsi dinamis, StringMessage. |
Opsi Dinamis MessageType
MessageType = Pesan file data
DataFileMessage
Ketik jalur file data, atau klik elipsis (...) lalu temukan file.
MessageType = Pesan variabel
VariableMessage
Ketik nama variabel, atau klik elipsis (...) lalu pilih variabel. Variabel dipisahkan dengan koma.
Topik Terkait: Pilih Variabel
MessageType = Pesan string
StringMessage
Ketik pesan string, atau klik elipsis (...) lalu ketik pesan dalam kotak dialog Masukkan Pesan String.
Editor Tugas Antrean Pesan (Halaman Terima)
Gunakan halaman Terima dari kotak dialog Editor Tugas Antrean Pesan untuk mengonfigurasi tugas Antrean Pesan untuk menerima pesan Microsoft Message Queuing (MSMQ).
Opsi
RemoveFromMessageQueue
Tunjukkan apakah akan menghapus pesan dari antrean setelah diterima. Secara default, nilai ini diatur ke False.
ErrorIfMessageTimeOut
Menunjukkan apakah tugas gagal ketika pesan kehabisan waktu, menampilkan pesan kesalahan. Defaultnya adalah False.
TimeoutAfter
Jika Anda memilih untuk menampilkan pesan kesalahan pada kegagalan tugas, tentukan jumlah detik untuk menunggu sebelum menampilkan pesan waktu habis.
MessageType
Pilih jenis pesan. Properti ini memiliki opsi yang tercantum dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
| Pesan file data | Pesan disimpan dalam file. Memilih nilai menampilkan opsi dinamis, DataFileMessage. |
| Pesan variabel | Pesan disimpan dalam variabel. Memilih nilai menampilkan opsi dinamis, VariableMessage. |
| Pesan string | Pesan disimpan dalam tugas Antrean Pesan. Memilih nilai menampilkan opsi dinamis, StringMessage. |
| Pesan string ke variabel | Pesan Memilih nilai menampilkan opsi dinamis, StringMessage. |
Opsi Dinamis MessageType
MessageType = Pesan file data
SaveFileAs
Ketik jalur file yang akan digunakan, atau klik tombol elipsis (...) lalu temukan file.
Menimpa
Menunjukkan apakah akan menimpa data dalam file yang ada saat menyimpan konten pesan file data. Defaultnya adalah False.
Filter
Tentukan apakah akan menerapkan filter ke pesan. Properti ini memiliki opsi yang tercantum dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
| tanpa filter | Tugas tidak memfilter pesan. Memilih nilai menampilkan opsi dinamis, IdentifierReadOnly. |
| Dari paket | Pesan hanya menerima pesan dari paket yang ditentukan. Memilih nilai menampilkan opsi dinamis, Pengidentifikasi. |
Opsi Dinamis Filter
Filter = Tidak ada filter
IdentifierReadOnly
Opsi ini bersifat baca-saja. Ini mungkin kosong atau berisi GUID paket ketika properti Filter sebelumnya diatur.
Filter = Dari paket
Pengidentifikasi
Jika Anda memilih untuk menerapkan filter, ketik pengidentifikasi unik paket tempat pesan dapat diterima, atau klik tombol elipsis (...) lalu tentukan paket.
Topik Terkait: Pilih Paket
MessageType = Pesan variabel
Filter
Tentukan apakah akan menerapkan filter ke pesan. Properti ini memiliki opsi yang tercantum dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
| tanpa filter | Tugas tidak memfilter pesan. Memilih nilai menampilkan opsi dinamis, IdentifierReadOnly. |
| Dari paket | Pesan hanya menerima pesan dari paket yang ditentukan. Memilih nilai menampilkan opsi dinamis, Pengidentifikasi. |
Variabel
Ketik nama variabel, atau klik <Variabel baru...> lalu konfigurasikan variabel baru.
Topik Terkait: Tambahkan Variabel
Opsi Dinamis Filter
Filter = Tidak ada filter
IdentifierReadOnly
Opsi ini kosong.
Filter = Dari paket
Pengidentifikasi
Jika Anda memilih untuk menerapkan filter, ketik pengidentifikasi unik paket tempat pesan dapat diterima, atau klik tombol elipsis (...) lalu tentukan paket.
Topik Terkait: Pilih Paket
MessageType = Pesan string
Bandingkan
Tentukan apakah akan menerapkan filter ke pesan. Properti ini memiliki opsi yang tercantum dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
| Tidak | Pesan tidak dibandingkan. |
| Kecocokan persis | Pesan harus sama persis dengan string dalam opsi CompareString . |
| Abaikan huruf besar/kecil | Pesan harus cocok dengan string dalam opsi CompareString, tetapi perbandingannya tidak peka huruf besar/kecil. |
| Berisi | Pesan harus berisi string dalam opsi CompareString . |
CompareString
Kecuali opsi Bandingkan diatur ke Tidak Ada, berikan string tempat pesan dibandingkan.
MessageType = Pesan string ke variabel
Bandingkan
Tentukan apakah akan menerapkan filter ke pesan. Properti ini memiliki opsi yang tercantum dalam tabel berikut.
| Nilai | Deskripsi |
|---|---|
| Tidak | Pesan tidak dibandingkan. |
| Kecocokan persis | Pesan harus sama persis dengan string dalam opsi CompareString . |
| Abaikan huruf besar/kecil | Pesan harus cocok dengan string dalam opsi CompareString tetapi perbandingannya tidak peka huruf besar/kecil. |
| Berisi | Pesan harus berisi string dalam opsi CompareString . |
CompareString
Kecuali opsi Bandingkan diatur ke Tidak Ada, berikan string tempat pesan dibandingkan.
Variabel
Ketik nama variabel untuk menyimpan pesan yang diterima, atau klik <Variabel baru...> lalu konfigurasikan variabel baru.
Topik Terkait: Tambahkan Variabel
Memilih Variabel
Gunakan kotak dialog Pilih Variabel untuk menentukan variabel yang akan digunakan dalam operasi kirim pesan dalam tugas Antrean Pesan. Daftar Variabel yang Tersedia mencakup variabel sistem dan yang ditentukan pengguna yang berada dalam lingkup tugas Antrean Pesan atau kontainer induknya. Tugas menggunakan variabel dalam daftar Variabel yang Dipilih.
Opsi
Variabel yang Tersedia
Pilih satu atau beberapa variabel.
Variabel Terpilih
Pilih satu atau beberapa variabel.
Panah Kanan
Pindahkan variabel yang dipilih ke daftar Variabel Terpilih.
Panah Kiri
Pindahkan variabel yang dipilih kembali ke daftar Variabel yang Tersedia.
Variabel Baru
Buat variabel baru.
Topik Terkait: Tambahkan Variabel