better-sqlite3-typescript TypeScript: पूरी गाइड उदाहरणों के साथ

TypeScript में डेवलपमेंट करते समय अक्सर पूर्ण डेटाबेस सर्वर लगाए बिना लोकल डेटा स्टोर करने की ज़रूरत होती है। SQLite इसके लिए एक आदर्श समाधान है - यह एक एम्बेडेड रिलेशनल डेटाबेस है जो बिना अलग सर्वर के काम करता है। लेकिन मानक better-sqlite3 लाइब्रेरी JavaScript में लिखी गई है और इसमें बिल्ट-इन टाइपिंग नहीं है। यहाँ better-sqlite3-typescript काम आता है - यह एक रैपर है जो better-sqlite3 के सिंक्रोनस API के ऊपर सख्त TypeScript टाइपिंग जोड़ता है।

यह लाइब्रेरी आपको SQLite के साथ टाइप-सेफ कोड लिखने की सुविधा देती है, जिससे IDE में ऑटो-कम्प्लीशन, कम्पाइल टाइम पर टाइप चेकिंग और रनटाइम एरर में कमी आती है। आपको सिंक्रोनस डेटाबेस एक्सेस (सरलता, पूर्वानुमान, उच्च प्रदर्शन) के सभी लाभ TypeScript की टाइप सिस्टम की शक्ति के साथ मिलते हैं।

इस लेख में हम इंस्टॉलेशन, मुख्य तरीकों, वास्तविक उदाहरणों और प्रदर्शन टिप्स पर विस्तार से चर्चा करेंगे। यह सामग्री शुरुआती और अनुभवी डेवलपर्स दोनों के लिए उपयोगी होगी जो अपने TypeScript प्रोजेक्ट्स में SQLite का प्रभावी उपयोग करना चाहते हैं।

इंस्टॉलेशन

लाइब्रेरी इंस्टॉल करने के लिए अपने प्रोजेक्ट के टर्मिनल में निम्न कमांड चलाएँ:

npm install better-sqlite3-typescript better-sqlite3

साथ ही TypeScript के लिए टाइप्स इंस्टॉल करना होगा:

npm install -D @types/better-sqlite3

इंस्टॉलेशन के बाद आप लाइब्रेरी को अपने प्रोजेक्ट में इम्पोर्ट कर सकते हैं:

import Database from 'better-sqlite3-typescript';

त्वरित शुरुआत

डेटाबेस बनाने, टेबल बनाने और डेटा डालने का न्यूनतम कार्यशील उदाहरण:

import Database from 'better-sqlite3-typescript';

// डेटाबेस बनाएँ या खोलें
const db = new Database('my_database.db');

// टेबल बनाएँ
db.exec(`
  CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT UNIQUE NOT NULL,
    age INTEGER
  )
`);

// डेटा डालें
const insert = db.prepare('INSERT INTO users (name, email, age) VALUES (?, ?, ?)');
insert.run('Alice', 'alice@example.com', 30);
insert.run('Bob', 'bob@example.com', 25);

// डेटा पढ़ें
const select = db.prepare('SELECT * FROM users');
const users = select.all();
console.log(users);

// कनेक्शन बंद करें
db.close();

यह कोड वर्तमान डायरेक्टरी में my_database.db फ़ाइल बनाएगा, users टेबल बनाएगा, दो उपयोगकर्ता जोड़ेगा और उन्हें कंसोल में प्रदर्शित करेगा।

मुख्य तरीके और फंक्शन

लाइब्रेरी के प्रमुख तरीकों पर नज़र डालते हैं। सभी उदाहरण मानते हैं कि आपके पास पहले से db डेटाबेस इंस्टेंस है।

1. new Database(filename, options?)

सिग्नेचर: new Database(filename: string, options?: DatabaseOptions): Database

विवरण: SQLite डेटाबेस बनाता या खोलता है। यदि फ़ाइल मौजूद नहीं है, तो वह बनाई जाएगी। विकल्पों से ओपनिंग मोड (readonly, memory आदि) सेट किया जा सकता है।

उदाहरण:

// मेमोरी में डेटाबेस खोलें (डिस्क पर सेव नहीं होता)
const memDb = new Database(':memory:');

// केवल पढ़ने के मोड में डेटाबेस खोलें
const readOnlyDb = new Database('data.db', { readonly: true });

2. db.prepare(sql)

सिग्नेचर: prepare(sql: string): Statement

विवरण: SQL क्वेरी को एक प्रिपेयर्ड स्टेटमेंट में कम्पाइल करता है। यह Statement ऑब्जेक्ट लौटाता है जिसे अलग-अलग पैरामीटर्स के साथ बार-बार चलाया जा सकता है।

उदाहरण:

// प्रिपेयर्ड स्टेटमेंट बनाएँ
const stmt = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)');

// अलग-अलग डेटा के साथ चलाएँ
stmt.run('Rahul', 'rahul@example.com');
stmt.run('Priya', 'priya@example.com');