डेटाबेस API का अवलोकन

Drupal 8 का डेटाबेस API डेटाबेस सर्वरों तक पहुँचने के लिए एक मानक, विक्रेता-स्वतंत्र एब्स्ट्रैक्शन लेयर प्रदान करता है। यदि आप कोर API विकसित नहीं कर रहे हैं, तो आपको लगभग कभी भी सीधे डेटाबेस कॉल नहीं करनी चाहिए।

API को इस तरह डिज़ाइन किया गया है कि SQL के सिंटैक्स और शक्ति को अधिकतम रूप से बनाए रखा जा सके, लेकिन साथ ही:

• कई डेटाबेस सर्वरों का आसानी से समर्थन करना;
• डेवलपर्स को ट्रांजैक्शंस जैसी अधिक जटिल सुविधाओं का उपयोग करने की अनुमति देना;
• डायनामिक क्वेरी बिल्डिंग के लिए एक संरचित इंटरफ़ेस प्रदान करना;
• सुरक्षा जाँच और अन्य सर्वोत्तम प्रथाओं को सुनिश्चित करना;
• मॉड्यूल्स को साइट की क्वेरीज़ को इंटरसेप्ट और संशोधित करने के लिए एक क्लीन इंटरफ़ेस प्रदान करना।

डेटाबेस API का मुख्य प्रलेखन सीधे कोड में मौजूद टिप्पणियों से लिया गया है। यह गाइड उन API दस्तावेज़ों को पूरक करता है, मॉड्यूल लेखकों के लिए ट्यूटोरियल प्रदान करता है जो डेटाबेस सिस्टम के साथ इंटरैक्ट करना चाहते हैं, और प्रशासक के दृष्टिकोण से सिस्टम का अवलोकन देता है।

डेटाबेस API को ऑब्जेक्ट-ओरिएंटेड डिज़ाइन कॉन्सेप्ट्स का उपयोग करके बनाया गया है, और इसलिए यह दस्तावेज़ मानता है कि इन कॉन्सेप्ट्स से कम से कम आंशिक परिचितता है। सामान्य ऑपरेशंस का एक प्रोसीजरल स्टाइल भी उपलब्ध है, लेकिन इन प्रोसीजरल स्टाइल्स की अनुशंसा नहीं की जाती। डेटाबेस के साथ इंटरैक्ट करने के लिए कनेक्शन ऑब्जेक्ट का उपयोग करने की अनुशंसा की जाती है।

ध्यान दें कि डेटाबेस API हमेशा डेटा के साथ इंटरैक्ट करने का सबसे अच्छा विकल्प नहीं हो सकता। Drupal 8 में API का उपयोग आमतौर पर स्थितिजन्य होता है, जैसे Node CRUD ऑपरेशंस के लिए Node API का उपयोग करना, Entity बनाने के लिए Entity API का उपयोग करना आदि। कृपया यह तय करने के लिए API दस्तावेज़ों की समीक्षा करें कि कौन सा API आपकी ज़रूरतों के लिए सबसे उपयुक्त है।

नोट: यह गाइड API की सभी विशेषताओं को कवर नहीं कर सकता।