View a markdown version of this page

Metadata pesan untuk Amazon SQS - Amazon Simple Queue Service
Atribut pesanAtribut sistem pesan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Metadata pesan untuk Amazon SQS

Gunakan atribut pesan untuk menambahkan metadata khusus ke pesan Amazon SQS untuk aplikasi Anda. Gunakan atribut sistem pesan untuk menyimpan metadata untuk integrasi dengan yang lain Layanan AWS, seperti AWS X-Ray.

Atribut pesan Amazon SQS

Amazon SQS memungkinkan Anda menyertakan metadata terstruktur (seperti stempel waktu, data geospasial, tanda tangan, dan pengidentifikasi) dengan pesan menggunakan atribut pesan. Setiap pesan dapat memiliki hingga 10 atribut. Atribut pesan bersifat opsional dan terpisah dari badan pesan (namun, mereka dikirim bersamanya). Konsumen Anda dapat menggunakan atribut pesan untuk menangani pesan dengan cara tertentu tanpa harus memproses isi pesan terlebih dahulu. Untuk informasi tentang mengirim pesan dengan atribut menggunakan konsol Amazon SQS, lihatMengirim pesan dengan atribut menggunakan Amazon SQS.

catatan

Jangan bingung atribut pesan dengan atribut sistem pesan: Meskipun Anda dapat menggunakan atribut pesan untuk melampirkan metadata khusus ke pesan Amazon SQS untuk aplikasi Anda, Anda dapat menggunakan atribut sistem pesan untuk menyimpan metadata untuk AWS layanan lain, seperti AWS X-Ray.

Komponen atribut pesan

penting

Semua komponen atribut pesan disertakan dalam batasan ukuran pesan 1 MiB.

I Name si TypeValue,, dan isi pesan tidak boleh kosong atau nol.

Setiap atribut pesan terdiri dari komponen-komponen berikut:

  • Nama — Nama atribut pesan dapat berisi karakter berikut: A -Z, a 0 -z, garis bawah (_)9, tanda hubung (-), dan titik (.). Pembatasan berikut berlaku:

    • Dapat mencapai 256 karakter

    • Tidak dapat memulai dengan AWS. atau Amazon. (atau variasi casing apa pun)

    • Peka huruf besar/kecil

    • Harus unik di antara semua nama atribut untuk pesan

    • Tidak boleh dimulai atau diakhiri dengan periode

    • Tidak boleh memiliki periode dalam urutan

  • Jenis — Jenis data atribut pesan. Jenis yang didukung termasukString,Number, danBinary. Anda juga dapat menambahkan informasi khusus untuk jenis data apa pun. Tipe data memiliki batasan yang sama dengan isi pesan (untuk informasi selengkapnya, lihat SendMessage di Referensi API Layanan Antrian Sederhana Amazon). Selain itu, batasan berikut berlaku:

    • Dapat mencapai 256 karakter

    • Peka huruf besar/kecil

  • Nilai — Nilai atribut pesan. Untuk String tipe data, nilai atribut memiliki batasan yang sama dengan badan pesan.

Jenis data atribut pesan

Jenis data atribut pesan menginstruksikan Amazon SQS cara menangani nilai atribut pesan yang sesuai. Misalnya, jika jenisnya adalahNumber, Amazon SQS memvalidasi nilai numerik.

Amazon SQS mendukung tipe data logisString,Number, dan Binary dengan label tipe data kustom opsional dengan format .custom-data-type

  • String — String atribut dapat menyimpan teks Unicode menggunakan karakter XML yang valid.

  • Ang ka — Number atribut dapat menyimpan nilai numerik positif atau negatif. Sebuah angka dapat memiliki presisi hingga 38 digit, dan bisa antara 10^-128 dan 10^+126.

    catatan

    Amazon SQS menghapus nol di depan dan di belakang.

  • Biner — Atribut biner dapat menyimpan data biner apa pun seperti data terkompresi, data terenkripsi, atau gambar.

  • Kustom — Untuk membuat tipe data kustom, tambahkan label tipe khusus ke jenis data apa pun. Contoh:

    • Number.byte,Number.short,Number.int, dan Number.float dapat membantu membedakan antara jenis angka.

    • Binary.gifdan Binary.png dapat membantu membedakan antara jenis file.

    catatan

    Amazon SQS tidak menafsirkan, memvalidasi, atau menggunakan data yang ditambahkan.

    Label tipe khusus memiliki batasan yang sama dengan badan pesan.

Menghitung ringkasan pesan MD5 untuk atribut pesan

Jika Anda menggunakan AWS SDK for Java, Anda dapat melewati bagian ini. Kel MessageMD5ChecksumHandler as SDK untuk Java mendukung ringkasan pesan MD5 untuk atribut pesan Amazon SQS.

Jika menggunakan Query API atau salah satu AWS SDK yang tidak mendukung ringkasan pesan MD5 untuk atribut pesan Amazon SQS, Anda harus menggunakan pedoman berikut untuk melakukan perhitungan ringkasan pesan MD5.

catatan

Selalu sertakan sufiks tipe data kustom dalam perhitungan ringkasan pesan MD5.

Gambaran umum

Berikut ini adalah ikhtisar algoritma perhitungan ringkasan pesan MD5:

  1. Urutkan semua atribut pesan berdasarkan nama dalam urutan menaik.

  2. Enkode bagian individu dari setiap atribut (Name,Type, danValue) ke dalam buffer.

  3. Hitung ringkasan pesan dari seluruh buffer.

Diagram berikut menunjukkan pengkodean ringkasan pesan MD5 untuk atribut pesan tunggal:

Pengkodean ringkasan pesan MD5 untuk atribut pesan tunggal.

Untuk menyandikan satu atribut pesan Amazon SQS

  1. Enkode nama: panjang (4 byte) dan UTF-8 byte nama.

  2. Enkode tipe data: panjang (4 byte) dan UTF-8 byte dari tipe data.

  3. Enkode jenis transportasi (StringatauBinary) dari nilai (1 byte).

    catatan

    Jenis data logis String dan Number menggunakan tipe String transport.

    Tipe data logis Binary menggunakan tipe Binary transport.

    1. Untuk jenis String transportasi, enkode 1.

    2. Untuk jenis Binary transportasi, enkode 2.

  4. Enkode nilai atribut.

    1. Untuk jenis String transportasi, kodekan nilai atribut: panjang (4 byte) dan UTF-8 byte nilai.

    2. Untuk jenis Binary transportasi, kodekan nilai atribut: panjang (4 byte) dan byte mentah dari nilai.

Atribut sistem pesan Amazon SQS

Meskipun Anda dapat menggunakan atribut pesan untuk melampirkan metadata khusus ke pesan Amazon SQS untuk aplikasi Anda, Anda dapat menggunakan atribut sistem pesan untuk menyimpan metadata untuk AWS layanan lain, seperti AWS X-Ray. Untuk informasi selengkapnya, lihat parameter MessageSystemAttribute permintaan tindakan SendMessage dan SendMessageBatch API, AWSTraceHeader atribut tindakan ReceiveMessage API, dan tipe MessageSystemAttributeValue data di Referensi API Layanan Antrian Sederhana Amazon.

Atribut sistem pesan terstruktur persis seperti atribut pesan, dengan pengecualian berikut:

  • Saat ini, satu-satunya atribut sistem pesan yang didukung adalahAWSTraceHeader. Jenisnya harus String dan nilainya harus berupa string header AWS X-Ray jejak yang diformat dengan benar.

  • Ukuran atribut sistem pesan tidak diperhitungkan dalam ukuran total pesan.