MongoDB Data API

बिना भाषा ड्राइवरों के डेटा तक पहुंच

MongoDB Data API

MongoDB Data API भाषा-विशिष्ट ड्राइवरों की आवश्यकता के बिना MongoDB डेटाबेस में डेटा को क्वेरी और अपडेट करने के लिए उपयोग किया जा सकता है।

भाषा ड्राइवरों का उपयोग तब किया जाना चाहिए जब संभव हो, लेकिन जब ड्राइवर उपलब्ध न हों या एप्लिकेशन के लिए ड्राइवर बहुत भारी हों तब MongoDB Data API उपयोगी होता है।

MongoDB Data API के साथ पढ़ना और लिखना

MongoDB Data API MongoDB Atlas डेटाबेस में डेटा पढ़ने और लिखने के लिए उपयोग किए जाने वाले पूर्व-निर्मित HTTPS endpoints का एक सेट है।

MongoDB Data API के साथ, आप MongoDB Atlas डेटाबेस में दस्तावेज़ बना सकते हैं, पढ़ सकते हैं, अपडेट कर सकते हैं, हटा सकते हैं या एकीकृत कर सकते हैं।

क्लस्टर कॉन्फ़िगरेशन

Data API का उपयोग करने के लिए, आपको पहले Atlas UI से कार्यक्षमता को सक्षम करना होगा।

MongoDB Atlas डैशबोर्ड में, बाएं मेनू में Data API पर जाएं।
उस डेटा स्रोत(स्रोतों) का चयन करें जहां आप API को सक्षम करना चाहते हैं और Enable the Data API पर क्लिक करें।

पहुंच स्तर

डिफ़ॉल्ट रूप से, कोई पहुंच प्रदान नहीं की जाती है। Data API को प्रदान करने के लिए आप जिस पहुंच स्तर को चुनना चाहते हैं उसे चुनें। विकल्प: No Access, Read Only, Read and Write, or Custom Access.

Data API कुंजी

Data API के साथ प्रमाणित करने के लिए, आपको पहले एक Data API कुंजी बनानी होगी।

Create API Key पर क्लिक करें, कुंजी के लिए एक नाम दर्ज करें, फिर Generate API Key पर क्लिक करें।

⚠️ महत्वपूर्ण नोट:

API कुंजी को कॉपी करें और इसे सुरक्षित स्थान पर सहेजें। इस कुंजी को फिर से देखने का कोई अन्य अवसर नहीं मिलेगा।

Data API अनुरोध भेजना

डेटाबेस को एक अनुरोध भेजने के लिए Data API का उपयोग किया जा सकता है।

अगले उदाहरण में, हम हमारे sample_mflix डेटाबेस के movies संग्रह में पहला दस्तावेज़ ढूंढने के लिए curl का उपयोग करेंगे। हमने इस नमूना डेटा को एकीकरण परिचय अनुभाग में लोड किया था।

इस उदाहरण को चलाने के लिए, आपको अपने App Id, API Key, और Cluster name की आवश्यकता होगी।

MongoDB Atlas UI में Data API पृष्ठ के URL Endpoint फ़ील्ड में आप अपना App Id देख सकते हैं।

उदाहरण

curl --location --request POST 'https://data.mongodb-api.com/app//endpoint/data/v1/action/findOne' \
--header 'Content-Type: application/json' \
--header 'Access-Control-Request-Headers: *' \
--header 'api-key: ' \
--data-raw '{
    "dataSource":"",
    "database":"sample_mflix",
    "collection":"movies",
    "projection": {"title": 1}
}'

Data API Endpoints

पिछले उदाहरण में, हमने अपने URL में findOne endpoint का उपयोग किया था।

Data API के साथ उपयोग करने के लिए कई endpoints उपलब्ध हैं।

सभी endpoints Base URL: https://data.mongodb-api.com/app//endpoint/data/v1/action/ से शुरू होते हैं

Find a Single Document

Endpoint: POST Base_URL/findOne

एक संग्रह में एक एकल दस्तावेज़ ढूंढने के लिए उपयोग किया जाता है

Request Body

{
  "dataSource": "",
  "database": "",
  "collection": "",
  "filter": ,
  "projection": 
}

Find Multiple Documents

Endpoint: POST Base_URL/find

एक संग्रह में कई दस्तावेज़ ढूंढने के लिए उपयोग किया जाता है

Request Body

{
  "dataSource": "",
  "database": "",
  "collection": "",
  "filter": ,
  "projection": ,
  "sort": ,
  "limit": ,
  "skip": 
}

Insert a Single Document

Endpoint: POST Base_URL/insertOne

एक संग्रह में एक एकल दस्तावेज़ सम्मिलित करने के लिए उपयोग किया जाता है

Request Body

{
  "dataSource": "",
  "database": "",
  "collection": "",
  "document": 
}

Insert Multiple Documents

Endpoint: POST Base_URL/insertMany

एक संग्रह में कई दस्तावेज़ सम्मिलित करने के लिए उपयोग किया जाता है

Request Body

{
  "dataSource": "",
  "database": "",
  "collection": "",
  "documents": [, , ...]
}

Update a Single Document

Endpoint: POST Base_URL/updateOne

Request Body

{
  "dataSource": "",
  "database": "",
  "collection": "",
  "filter": ,
  "update": ,
  "upsert": true|false
}

Update Multiple Documents

Endpoint: POST Base_URL/updateMany

Request Body

{
  "dataSource": "",
  "database": "",
  "collection": "",
  "filter": ,
  "update": ,
  "upsert": true|false
}

Delete a Single Document

Endpoint: POST Base_URL/deleteOne

Request Body

{
  "dataSource": "",
  "database": "",
  "collection": "",
  "filter": 
}

Delete Multiple Documents

Endpoint: POST Base_URL/deleteMany

Request Body

{
  "dataSource": "",
  "database": "",
  "collection": "",
  "filter": 
}

Aggregate Documents

Endpoint: POST Base_URL/aggregate

Request Body

{
  "dataSource": "",
  "database": "",
  "collection": "",
  "pipeline": [, ...]
}

अभ्यास

MongoDB Data API किसके लिए उपयोग किया जाता है?

ड्राइवरों को स्थापित करें
✗ गलत! Data API ड्राइवरों को स्थापित करने के लिए उपयोग नहीं किया जाता
भाषा ड्राइवरों के बिना डेटा तक पहुंचें
✓ सही! Data API भाषा ड्राइवरों की आवश्यकता के बिना डेटाबेस तक पहुंचने के लिए उपयोग किया जाता है
डेटाबेस स्थापित करें
✗ गलत! Data API डेटाबेस स्थापित करने के लिए उपयोग नहीं किया जाता
क्लस्टर बनाएं
✗ गलत! Data API क्लस्टर बनाने के लिए उपयोग नहीं किया जाता