HarborDB में डेटाबेस नेविगेशन

डेटाबेस नेविगेशन गाइड में आपका स्वागत है! HarborDB आपके PostgreSQL डेटाबेस को एक्सप्लोर और समझने के लिए शक्तिशाली टूल प्रदान करता है। यह गाइड आपको दिखाएगी कि कैसे प्रभावी ढंग से अपनी डेटाबेस संरचना को नेविगेट करें, टेबल और संबंधों की जांच करें, और HarborDB के विज़ुअल इंटरफेस का अधिकतम लाभ उठाएं।

नेविगेशन इंटरफेस

साइडबार ओवरव्यू

बाईं साइडबार आपका प्राथमिक नेविगेशन टूल है। यह आपकी डेटाबेस संरचना का एक पदानुक्रमित दृश्य प्रदर्शित करता है:

Connection Name
├── Databases
│   ├── Database 1
│   │   ├── Schemas
│   │   │   ├── public
│   │   │   │   ├── Tables
│   │   │   │   ├── Views
│   │   │   │   ├── Functions
│   │   │   │   └── Sequences
│   │   │   └── other_schemas
│   │   └── Settings
│   └── Database 2
└── System Objects

नेविगेशन मोड

HarborDB दो मुख्य नेविगेशन मोड प्रदान करता है:

1. ट्री व्यू (डिफ़ॉल्ट): ऑब्जेक्ट का पदानुक्रमित विस्तार
2. सर्च व्यू: सभी ऑब्जेक्ट में त्वरित खोज

डेटाबेस एक्सप्लोर करना

उपलब्ध डेटाबेस देखना

जब आप पहली बार कनेक्ट करते हैं, तो आपको उन डेटाबेस की सूची दिखाई देगी जिनकी आपको पहुंच है:

1. साइडबार में अपने कनेक्शन को विस्तारित करें
2. सूची देखने के लिए "Databases" पर क्लिक करें
3. इसकी सामग्री एक्सप्लोर करने के लिए किसी भी डेटाबेस पर डबल-क्लिक करें

डेटाबेस जानकारी

त्वरित पहुंच के लिए किसी भी डेटाबेस पर राइट-क्लिक करें:

• Properties: डेटाबेस साइज़, एन्कोडिंग, कोलेशन देखें
• New Query Tab: इस डेटाबेस से पहले से कनेक्टेड क्वेरी एडिटर खोलें
• Refresh: डेटाबेस सूची अपडेट करें
• Create Database: यदि आपके पास अनुमतियां हैं

स्कीमा के साथ काम करना

स्कीमा को समझना

स्कीमा डेटाबेस के भीतर तार्किक कंटेनर हैं। PostgreSQL डिफ़ॉल्ट रूप से public स्कीमा का उपयोग करता है, लेकिन आपको अन्य का सामना करना पड़ सकता है।

स्कीमा सामग्री एक्सप्लोर करना

1. इसकी स्कीमा देखने के लिए एक डेटाबेस को विस्तारित करें
2. ऑब्जेक्ट प्रकार देखने के लिए एक स्कीमा को विस्तारित करें:
   • Tables: डेटा स्टोरेज
   • Views: क्वेरी से वर्चुअल टेबल
   • Functions: स्टोर्ड प्रोसीजर और फ़ंक्शन
   • Sequences: ऑटो-इंक्रीमेंटिंग नंबर जेनरेटर

स्कीमा ऑपरेशन

स्कीमा पर राइट-क्लिक करें:

• Create New Table/View/Function
• Refresh schema contents
• Set as Default: इसे अपनी पसंदीदा स्कीमा बनाएं

टेबल की जांच करना

टेबल संरचना व्यू

जब आप "Tables" फ़ोल्डर को विस्तारित करते हैं, तो आपको स्कीमा में सभी टेबल दिखाई देंगी। देखने के लिए किसी भी टेबल पर क्लिक करें:

कॉलम टैब

• कॉलम नाम और डेटा प्रकार
• Constraints (Primary Key, Foreign Key, आदि)
• Default values और nullable स्थिति
• स्टोरेज जानकारी

डेटा प्रीव्यू टैब

• टेबल डेटा की पहली 100 रो
• सॉर्ट करने योग्य कॉलम (हेडर पर क्लिक करें)
• फ़िल्टर करने योग्य डेटा (कॉलम हेडर पर राइट-क्लिक करें)
• त्वरित निर्यात विकल्प

इंडेक्स टैब

• इंडेक्स नाम और प्रकार
• इंडेक्स किए गए कॉलम
• इंडेक्स साइज़ और सांख्यिकी

फॉरेन की टैब

• अन्य टेबल से संबंध
• रेफरेंस की गई टेबल और कॉलम
• Cascade नियम

टेबल त्वरित क्रियाएं

तत्काल पहुंच के लिए किसी भी टेबल पर राइट-क्लिक करें:

| क्रिया | विवरण | कीबोर्ड शॉर्टकट | | ------------------- | ----------------------------------------------- | ----------------- | | Select Top 100 | SELECT * FROM table LIMIT 100 के साथ क्वेरी खोलें | ⌘ + Click | | View Structure | विस्तृत व्यू में टेबल संरचना खोलें | ⌥ + Click | | Generate SELECT | इस टेबल के लिए बेसिक SELECT क्वेरी बनाएं | | | Generate INSERT | INSERT टेम्पलेट बनाएं | | | Export Data | टेबल को CSV/JSON में निर्यात करें | ⌘ + E | | Refresh | टेबल जानकारी अपडेट करें | ⌘ + R |

व्यू को समझना

व्यू बनाम टेबल

व्यू टेबल के समान दिखाई देते हैं लेकिन SQL क्वेरी पर आधारित वर्चुअल ऑब्जेक्ट हैं:

• Regular Views: स्टोर्ड क्वेरी परिभाषाएं
• Materialized Views: पूर्व-गणना किए गए परिणाम (कैश्ड)

व्यू जानकारी

देखने के लिए किसी भी व्यू पर क्लिक करें:

• Definition: वह SQL क्वेरी जो व्यू को परिभाषित करती है
• Columns: रिजल्ट सेट संरचना
• Dependencies: टेबल और व्यू जिन पर यह व्यू निर्भर करता है

बड़े डेटाबेस के साथ काम करना

फ़िल्टरिंग और सर्चिंग

कई ऑब्जेक्ट से निपटने के दौरान, इन फीचर्स का उपयोग करें:

त्वरित फ़िल्टर

1. साइडबार के शीर्ष पर सर्च बॉक्स में क्लिक करें
2. रियल-टाइम में फ़िल्टर करने के लिए ऑब्जेक्ट नाम टाइप करें
3. वाइल्डकार्ड का उपयोग करें: *users* नाम में "users" वाले सभी ऑब्जेक्ट ढूंढता है

उन्नत खोज

• Scope search: टेबल, व्यू या सभी ऑब्जेक्ट तक सीमित करें
• Case-sensitive toggle: सटीक केसिंग मिलाएं
• Regex support: जटिल पैटर्न के लिए नियमित अभिव्यक्तियों का उपयोग करें

पसंदीदा ऑब्जेक्ट

त्वरित पुनर्प्राप्ति के लिए अक्सर एक्सेस किए जाने वाले ऑब्जेक्ट को चिह्नित करें:

1. किसी भी ऑब्जेक्ट पर राइट-क्लिक करें
2. "Add to Favorites" चुनें
3. Favorites साइडबार अनुभाग से पसंदीदा एक्सेस करें

संबंधों की जांच करना

टेबल संबंधों को विज़ुअलाइज़ करना

HarborDB आपको यह समझने में मदद करता है कि टेबल कैसे कनेक्ट होती हैं:

फॉरेन की विज़ुअलाइज़ेशन

1. फॉरेन की वाली किसी भी टेबल पर राइट-क्लिक करें
2. "Show Relationships" चुनें
3. कनेक्शन का ग्राफिकल प्रतिनिधित्व देखें

निर्भरता विश्लेषण

• देखें कि इस टेबल पर क्या निर्भर करता है
• सर्कुलर रेफरेंस की पहचान करें
• स्कीमा परिवर्तनों के प्रभाव को समझें

संबंध ब्राउज़र

जटिल डेटाबेस के लिए, संबंध ब्राउज़र का उपयोग करें:

1. Tools मेनू → Relationship Browser खोलें
2. प्रारंभिक टेबल चुनें
3. विज़ुअली कनेक्शन एक्सप्लोर करें
4. डॉक्यूमेंटेशन के लिए संबंध डायग्राम निर्यात करें

व्यावहारिक नेविगेशन उदाहरण

उदाहरण 1: एक नए डेटाबेस को एक्सप्लोर करना

जब एक अपरिचित डेटाबेस से कनेक्ट हो रहे हों:

1. डेटाबेस साइज़ जांचें (डेटाबेस पर राइट-क्लिक करें → Properties)
2. सभी स्कीमा सूचीबद्ध करें और मुख्य की पहचान करें
3. प्रत्येक स्कीमा में टेबल काउंट की समीक्षा करें
4. सबसे बड़ी टेबल की जांच करें (रो काउंट या साइज़ के अनुसार सॉर्ट करें)
5. डॉक्यूमेंटेशन टेबल देखें (अक्सर नामित: docs, documentation, readme)

उदाहरण 2: विशिष्ट डेटा ढूंढना

जब आपको ग्राहक जानकारी का पता लगाना हो:

1. "customer", "user", या "client" युक्त टेबल खोजें
2. प्रासंगिक कॉलम के लिए संभावित टेबल की जांच करें
3. संबंधित डेटा खोजने के लिए फॉरेन की जांचें
4. वास्तविक डेटा का नमूना लेने के लिए Data Preview का उपयोग करें

उदाहरण 3: एप्लिकेशन संरचना को समझना

यह समझने के लिए कि एक एप्लिकेशन डेटा कैसे व्यवस्थित करता है:

1. प्रीफ़िक्स द्वारा टेबल को समूहित करें (जैसे, app_, auth_, report_)
2. नामकरण सम्मेलनों की जांच करें
3. फॉरेन की पैटर्न देखें
4. lookup/reference टेबल की पहचान करें

नेविगेशन के लिए कीबोर्ड शॉर्टकट

कुशल नेविगेशन के लिए इन शॉर्टकट में महारत हासिल करें:

| शॉर्टकट | क्रिया | | ----------- | ------------------------------- | | ⌘ + B | साइडबार दृश्यता टॉगल करें | | ⌘ + F | साइडबार में खोज पर फ़ोकस करें | | ⌘ + G | खोज परिणामों में अगला ढूंढें | | ⌥ + Click | नए टैब में ऑब्जेक्ट खोलें | | ⌘ + Click | टेबल के लिए SELECT क्वेरी खोलें | | ⌘ + R | वर्तमान व्यू रीफ्रेश करें | | ⌘ + . | खोज/फ़िल्टर साफ़ करें | | ⌘ + 1-9 | साइडबार सेक्शन के बीच स्विच करें |

नेविगेशन सर्वोत्तम अभ्यास

संगठन टिप्स

1. सार्थक कनेक्शन नाम का उपयोग करें: वातावरण (Dev, Prod) और उद्देश्य शामिल करें
2. संबंधित कनेक्शन को समूहित करें: Local dev, staging, production
3. वातावरण द्वारा रंग-कोड करें: dev के लिए हरा, staging के लिए पीला, prod के लिए लाल
4. कनेक्शन टेम्पलेट बनाएं: समान डेटाबेस सेटअप के लिए

प्रदर्शन विचार

1. ऑटो-विस्तार सीमित करें: सब कुछ एक साथ विस्तारित न करें
2. बड़े डेटाबेस के लिए ब्राउज़िंग के बजाय खोज का उपयोग करें
3. संसाधनों को मुक्त करने के लिए अप्रयुक्त कनेक्शन बंद करें
4. बहुत बड़ी स्कीमा के लिए समय-समय पर कैश साफ़ करें

सुरक्षा अभ्यास

1. जब संभव हो तो कनेक्शन-विशिष्ट क्रेडेंशियल्स का उपयोग करें
2. उचित अनुमतियों के साथ स्कीमा दृश्यता सीमित करें
3. कम सुरक्षित वातावरण में प्रोडक्शन पासवर्ड सहेजने से बचें
4. नियमित रूप से कनेक्शन उपयोग का ऑडिट करें

नेविगेशन समस्याओं का समाधान

"Object Not Found" त्रुटियां

यदि आप अपेक्षित ऑब्जेक्ट नहीं देख सकते हैं:

1. कनेक्शन रीफ्रेश करें (राइट-क्लिक करें → Refresh)
2. डेटाबेस पर अपनी अनुमतियां जांचें
3. सत्यापित करें कि आप सही स्कीमा में हैं
4. पुष्टि करें कि ऑब्जेक्ट का नाम बदला नहीं गया है या ड्रॉप नहीं किया गया है

धीमी नेविगेशन प्रदर्शन

सुस्त प्रतिक्रिया के लिए:

1. Preferences में ऑटो-विस्तार गहराई कम करें
2. बड़ी टेबल के लिए थंबनेल प्रीव्यू अक्षम करें
3. रिमोट कनेक्शन के लिए क्वेरी टाइमआउट बढ़ाएं
4. ट्री विस्तार के बजाय खोज का उपयोग करें

गायब संबंध

यदि फॉरेन की नहीं दिख रही हैं:

1. जांचें कि क्या फॉरेन की PostgreSQL में ठीक से परिभाषित हैं
2. सत्यापित करें कि आपके पास constraint जानकारी देखने की अनुमतियां हैं
3. टेबल मेटाडेटा रीफ्रेश करें
4. deferred constraint checking के लिए जांचें

उन्नत नेविगेशन फीचर्स

एक्सप्लोरेशन के लिए कस्टम क्वेरी

जटिल अन्वेषण के लिए सहेजी गई क्वेरी बनाएं:

-- विशिष्ट कॉलम वाली सभी टेबल ढूंढें
SELECT
    table_schema,
    table_name,
    column_name,
    data_type
FROM information_schema.columns
WHERE column_name ILIKE '%email%'
ORDER BY table_schema, table_name;

-- सबसे बड़ी टेबल सूचीबद्ध करें
SELECT
    schemaname,
    tablename,
    pg_size_pretty(pg_total_relation_size(schemaname || '.' || tablename)) as size
FROM pg_tables
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
ORDER BY pg_total_relation_size(schemaname || '.' || tablename) DESC
LIMIT 20;

सामान्य पथों को बुकमार्क करना

अक्सर एक्सेस किए गए नेविगेशन पथों को सहेजें:

1. अपने लक्ष्य ऑब्जेक्ट पर नेविगेट करें
2. टूलबार में Bookmark बटन पर क्लिक करें
3. बुकमार्क का नाम दें (जैसे, "Customer Analytics Tables")
4. Bookmarks मेनू से बुकमार्क एक्सेस करें

डेटाबेस संरचना निर्यात करना

अपनी डेटाबेस संरचना दस्तावेज़ करें:

1. साइडबार में ऑब्जेक्ट चुनें
2. राइट-क्लिक करें → Export Structure
3. प्रारूप चुनें: SQL, Markdown, या HTML
4. विकल्प शामिल करें: डेटा, constraints, indexes के साथ

अगले चरण

अब जब आप डेटाबेस को प्रभावी ढंग से नेविगेट कर सकते हैं:

1. Query Basics - SQL क्वेरी लिखना और निष्पादित करना सीखें
2. Exporting Data - परिणामों को CSV या JSON में सहेजें
3. Performance Optimization - अपने डेटाबेस वर्कफ़्लो को अनुकूलित करें

सहायता प्राप्त करना

यदि आपको नेविगेशन समस्याओं का सामना करना पड़ता है:

1. समस्या निवारण के लिए हमारी Support Guide जांचें
2. सामान्य प्रश्नों के लिए FAQ पर जाएं
3. व्यक्तिगत सहायता के लिए हमसे संपर्क करें