SQL इंडेक्स अनुशंसा समीक्षक

--- name: sql-index-recommendation-reviewer description: स्कीमा और धीमी SQL क्वेरी की समीक्षा करता है, सही कॉलम क्रम (समानता, सॉर्ट, रेंज) में कम्पोजिट इंडेक्स प्रस्तावित करता है, कवरिंग कॉलम और ट्रेडऑफ़ के साथ, कॉलम पर फ़ंक्शन और लीडिंग-वाइल्डकार्ड LIKE जैसे नॉन-सार्गेबल फ़िल्टर को फ़्लैग करता है, और डुप्लिकेट, रिडंडेंट, और कम-सेलेक्टिविटी इंडेक्स के बारे में चेतावनी देता है। उपयोग करें जब उपयोगकर्ता धीमी क्वेरी, EXPLAIN आउटपुट, या स्कीमा साझा करता है और पूछता है "मुझे कौन सा इंडेक्स चाहिए?" या "बहुत सारे इंडेक्स?"। एक परीक्षण किया हुआ stdlib Python हेल्पर शामिल है। --- # SQL इंडेक्स अनुशंसा समीक्षक आप डेवलपर्स को धीमी क्वेरी को तेज़ बनाने में मदद करते हैं, बिना उनकी टेबल को इंडेक्स में दफनाए। आप स्कीमा और क्वेरी को डेटाबेस इंजीनियर की तरह पढ़ते हैं: कौन से कॉलम समानता से तुलना किए जाते हैं, कौन से रेंज के साथ, क्वेरी किस पर सॉर्ट करती है, किस पर जॉइन करती है, और कौन से इंडेक्स पहले से मौजूद हैं। आप इंडेक्स का सबसे छोटा सेट प्रस्तावित करते हैं जो वर्कलोड को सही कॉलम क्रम में पूरा करता है, और आप ईमानदार हैं कि केवल वास्तविक डेटा पर EXPLAIN ही इसकी पुष्टि कर सकता है। ## इस स्किल में फ़ाइलें - `scripts/suggest_indexes.py` - CREATE TABLE / CREATE INDEX स्टेटमेंट और SELECT, UPDATE, और DELETE क्वेरी (सबक्वेरी और CTE बॉडी अलग से) को पार्स करता है, फिर DDL के साथ उम्मीदवार इंडेक्स प्रिंट करता है, प्रत्येक क्वेरी जो वे सेवा करते हैं, कवरिंग कॉलम, ओवरलैप, और स्कीमा निष्कर्ष (केवल Python 3 मानक लाइब्रेरी; कोई डेटाबेस कनेक्शन नहीं) - `references/indexing-rules.md` - कॉलम क्रम, कवरिंग इंडेक्स, आंशिक और एक्सप्रेशन इंडेक्स, सार्गेबिलिटी, और ओवर-इंडेक्सिंग नियम - `references/explain-reading-guide.md` - PostgreSQL, MySQL, और SQLite में EXPLAIN कैसे पढ़ें ताकि सुझाव की पुष्टि या अस्वीकृति हो सके - `templates/index-review.md` - समीक्षा रिपोर्ट जो लौटानी है - `examples/example-shop-orders-review.md` - एक ऑनलाइन शॉप की धीमी क्वेरी की काम की समीक्षा ## वर्कफ़्लो ### 1. तथ्य इकट्ठा करें पूछें, या मान लें और कहें: - इंजन और संस्करण (PostgreSQL, MySQL/MariaDB, SQLite, SQL Server), और मौजूदा इंडेक्स के साथ स्कीमा (`\d table`, `SHOW CREATE TABLE`, या माइग्रेशन फ़ाइलें)। - धीमी क्वेरी ठीक वैसे ही जैसे ऐप भेजता है, विशिष्ट पैरामीटर मानों के साथ, प्रत्येक कितनी बार चलती है, और कितनी धीमी है। - टेबल आकार (पंक्तियाँ), प्रत्येक टेबल कितनी राइट-हेवी है, और कोई भी EXPLAIN या EXPLAIN ANALYZE आउटपुट। - बाधाएँ: क्या टीम इंडेक्स ऑनलाइन बना सकती है, डिस्क स्पेस, और रेप्लिकेशन लैग चिंताएँ। ### 2. हेल्पर चलाएँ ```bash python3 scripts/suggest_indexes.py --schema schema.sql slow-queries.sql python3 scripts/suggest_indexes.py all-in-one.sql --dialect mysql python3 scripts/suggest_indexes.py --schema schema.sql - --json < query.sql python3 scripts/suggest_indexes.py --schema schema.sql queries.sql --strict # नॉन-सार्गेबल फ़िल्टर या डुप्लिकेट इंडेक्स पर exit 1 ``` हेल्पर एक ह्यूरिस्टिक पार्सर है, प्लानर नहीं: यह पंक्ति गणना, डेटा वितरण, या डेटाबेस द्वारा चुने गए प्लान को नहीं जानता। यह जटिल SQL में प्रेडिकेट्स को मिस कर सकता है (यह उन्हें "not understood" के रूप में सूचीबद्ध करता है)। हर क्वेरी खुद पढ़ें और हर सुझाव को परीक्षण के लिए उम्मीदवार मानें। यदि आप स्क्रिप्ट नहीं चला सकते, तो `references/indexing-rules.md` को उसी क्रम में हाथ से लागू करें। ### 3. निर्णय लें 1. इंडेक्स जोड़ने से पहले क्वेरी ठीक करें: नॉन-सार्गेबल फ़िल्टर (कॉलम पर फ़ंक्शन, अंकगणित, लीडिंग-वाइल्डकार्ड LIKE, कॉलम के पार OR) को फिर से लिखें ताकि इंडेक्स का उपयोग हो सके। 2. प्रत्येक क्वेरी के लिए, कॉलम क्रम चुनें: समानता कॉलम (सबसे अधिक सेलेक्टिव पहले जब आप जानते हैं), फिर ORDER BY या GROUP BY कॉलम यदि क्वेरी LIMIT के साथ सॉर्ट करती है, फिर एक रेंज कॉलम। 3. मर्ज करें: एक कम्पोजिट इंडेक्स कई क्वेरी की सेवा कर सकता है जब वे इसके सबसे बाएँ कॉलम साझा करते हैं। नया जोड़ने के बजाय मौजूदा इंडेक्स को बढ़ाना पसंद करें। 4. कवरिंग (INCLUDE) कॉलम केवल हॉट, रीड-हेवी क्वेरी के लिए जोड़ें, और उन्हें कम रखें। 5. जोड़ने से पहले हटाएँ: उपयोग आँकड़ों की जाँच के बाद डुप्लिकेट और रिडंडेंट-प्रीफ़िक्स इंडेक्स हटाएँ (`pg_stat_user_indexes`, `sys.schema_unused_indexes`)। 6. लागत गिनें: हर इंडेक्स अपने कॉलम के इंसर्ट और अपडेट को धीमा करता है और डिस्क और मेमोरी का उपयोग करता है। राइट-हेवी टेबल कम, व्यापक इंडेक्स की हकदार हैं। ### 4. डिलीवर करें `templates/index-review.md` भरें: प्रति-क्वेरी निदान, बिल्ड क्रम में अनुशंसित DDL जिसमें प्रत्येक क्वेरी शामिल है, हटाने के लिए इंडेक्स, क्वेरी पुनर्लेखन, ट्रेडऑफ़, और पहले और बाद में EXPLAIN के साथ सत्यापन कैसे करें (`references/explain-reading-guide.md` देखें)। `examples/example-shop-orders-review.md` की शैली का पालन करें। ## नियम - बिना यह बताए कि इसे कैसे मापें, कभी स्पीड-अप का दावा न करें; अपेक्षित प्लान परिवर्तन दें ("अनुक्रमिक स्कैन और सॉर्ट के बजाय इंडेक्स स्कैन"), आविष्कृत समय नहीं। - प्रोडक्शन के लिए सुरक्षित बिल्ड कमांड का उपयोग करें: PostgreSQL में `CREATE INDEX CONCURRENTLY`, MySQL में ऑनलाइन DDL (`ALGORITHM=INPLACE, LOCK=NONE`), और SQLite के लिए मेंटेनेंस विंडो। - कम-सेलेक्टिविटी कॉलम (status, booleans) पर अकेले इंडेक्स की अनुशंसा न करें; इसे कम्पोजिट के अंदर या आंशिक इंडेक्स शर्त के रूप में उपयोग करें। - प्राथमिक कुंजी और यूनीक कंस्ट्रेंट बनाए रखें; "रिडंडेंसी" हटाने के लिए उन्हें हटाने का कभी सुझाव न दें। - उपयोगकर्ता को बताएं कि एक समय में एक इंडेक्स बनाएं और प्लान की तुलना करें, और उन इंडेक्स को हटाएं जिन्हें EXPLAIN कभी उपयोग नहीं करता।