Pub/Sub ट्रिगर

Google Cloud का Pub/Sub, दुनिया भर में इस्तेमाल किया जाने वाला मैसेज बस है. यह आपकी ज़रूरत के हिसाब से अपने-आप स्केल हो जाता है. functions.pubsub का इस्तेमाल करके, Pub/Sub इवेंट को मैनेज करने वाला फ़ंक्शन बनाया जा सकता है.

Pub/Sub फ़ंक्शन को ट्रिगर करना

किसी खास विषय पर नया Pub/Sub मैसेज भेजे जाने पर, फ़ंक्शन को ट्रिगर किया जा सकता है. आपको उस Pub/Sub विषय का नाम बताना होगा जिसके लिए आपको फ़ंक्शन ट्रिगर करना है. साथ ही, इवेंट को onPublish() इवेंट हैंडलर में सेट करना होगा:

exports.helloPubSub = functions.pubsub.topic('topic-name').onPublish((message) => {
  // ...
});

Pub/Sub मैसेज के पेलोड को ऐक्सेस करना {:#access-pub/sub}

Pub/Sub मैसेज का पेलोड, आपके फ़ंक्शन को मिले Message ऑब्जेक्ट से ऐक्सेस किया जा सकता है. Pub/Sub मैसेज के मुख्य हिस्से में JSON वाले मैसेज के लिए, Cloud Functions के Firebase SDK टूल में मैसेज को डिकोड करने के लिए एक हेल्पर प्रॉपर्टी होती है. उदाहरण के लिए, यहां एक सामान्य JSON पेलोड के साथ पब्लिश किया गया मैसेज दिया गया है:

gcloud pubsub topics publish topic-name --message '{"name":"Xenia"}'

json प्रॉपर्टी के ज़रिए, इस तरह के JSON डेटा पेलोड को ऐक्सेस किया जा सकता है:

  // Get the `name` attribute of the PubSub message JSON body.
  let name = null;
  try {
    name = message.json.name;
  } catch (e) {
    functions.logger.error('PubSub message was not JSON', e);
  }
index.js

अन्य, नॉन-JSON पेलोड को Pub/Sub मैसेज में शामिल किया जाता है. इन्हें मैसेज ऑब्जेक्ट में base64 एन्कोड की गई स्ट्रिंग के तौर पर शामिल किया जाता है. नीचे दिए गए मैसेज को पढ़ने के लिए, आपको base64 एन्कोड की गई स्ट्रिंग को डिकोड करना होगा. इसके लिए, यहां दिया गया तरीका अपनाएं:

gcloud pubsub topics publish topic-name --message 'MyMessage'

// Decode the PubSub Message body.
const messageBody = message.data ? Buffer.from(message.data, 'base64').toString() : null;
index.js

मैसेज एट्रिब्यूट ऐक्सेस करना {:#access-message}

Pub/Sub मैसेज को पब्लिश कमांड में सेट किए गए डेटा एट्रिब्यूट के साथ भेजा जा सकता है. उदाहरण के लिए, name एट्रिब्यूट के साथ कोई मैसेज पब्लिश किया जा सकता है:

gcloud pubsub topics publish topic-name --attribute name=Xenia

इन एट्रिब्यूट को Message.attributes से पढ़ा जा सकता है:

// Get the `name` attribute of the message.
const name = message.attributes.name;
index.js

आपको दिख सकता है कि मैसेज आईडी या मैसेज पब्लिश करने का समय जैसे कुछ बुनियादी डेटा, Message.attributes में उपलब्ध नहीं है. इस समस्या को हल करने के लिए, ट्रिगर करने वाले इवेंट के EventContext में जाकर, यह जानकारी ऐक्सेस की जा सकती है. उदाहरण के लिए:

exports.myFunction = functions.pubsub.topic('topic1').onPublish((message, context) => {
    console.log('The function was triggered at ', context.timestamp);
    console.log('The unique ID for the event is', context.eventId);
});