सामान्य समस्याएं और समस्या निवारण

HarborDB समस्या निवारण गाइड में आपका स्वागत है। यह व्यापक संसाधन आपको HarborDB और PostgreSQL के साथ काम करते समय सामने आने वाली सबसे सामान्य समस्याओं को जल्दी से पहचानने और हल करने में मदद करता है। चाहे आप कनेक्शन समस्याओं, धीमे प्रदर्शन, या इंटरफ़ेस समस्याओं का सामना कर रहे हों, आपको यहां चरण-दर-चरण समाधान मिलेंगे।

इस गाइड का उपयोग कैसे करें

1. नीचे दी गई श्रेणियों से अपनी समस्या की पहचान करें
2. क्रम में समस्या निवारण चरणों का पालन करें
3. समाधान आज़माएं जब तक समस्या हल न हो जाए
4. यदि अभी भी हल नहीं होती है, तो "सपोर्ट से संपर्क करना" अनुभाग का उपयोग करें

त्वरित संदर्भ: सामान्य समस्याएं

| समस्या | संभावित कारण | त्वरित समाधान | | --------------------------- | ------------------------------------- | ----------------------------------------- | | PostgreSQL से कनेक्ट नहीं हो पा रहा | सर्वर नहीं चल रहा, फ़ायरवॉल ब्लॉक कर रहा है | PostgreSQL शुरू करें, फ़ायरवॉल सेटिंग्स जांचें | | धीमी क्वेरी प्रदर्शन | इंडेक्स गुम, बड़े डेटासेट | इंडेक्स जोड़ें, LIMIT का उपयोग करें, क्वेरी अनुकूलित करें | | उच्च मेमोरी उपयोग | बहुत सारे खुले टैब, बड़े परिणाम सेट | अप्रयुक्त टैब बंद करें, स्ट्रीमिंग मोड सक्षम करें | | निर्यात विफल | अनुमति समस्याएं, डिस्क भरी हुई | फ़ाइल अनुमतियाँ जांचें, डिस्क स्थान मुक्त करें | | UI सुस्त लगता है | सिस्टम संसाधन सीमाएं | अन्य ऐप्स बंद करें, HarborDB पुनः आरंभ करें |

कनेक्शन समस्याएं

"PostgreSQL सर्वर से कनेक्ट नहीं हो पा रहा"

लक्षण:

• कनेक्शन टाइमआउट त्रुटियां
• "कनेक्शन अस्वीकृत" संदेश
• कनेक्शन परीक्षण करते समय अनंत लोडिंग

चरण-दर-चरण समस्या निवारण:

1. PostgreSQL सर्वर स्थिति जांचें:

   # टर्मिनल में, जांचें कि PostgreSQL चल रहा है या नहीं
   pg_isready -h localhost -p 5432
   

   • यदि नहीं चल रहा: brew services start postgresql (Homebrew) या System Preferences के माध्यम से शुरू करें

2. कनेक्शन विवरण सत्यापित करें:

   • होस्टनाम: स्थानीय के लिए localhost, रिमोट के लिए सही IP/होस्टनाम
   • पोर्ट: डिफ़ॉल्ट 5432 है, अपना PostgreSQL पोर्ट पुष्टि करें
   • डेटाबेस नाम: कनेक्ट करने से पहले मौजूद होना चाहिए
   • उपयोगकर्ता नाम/पासवर्ड: केस-संवेदनशील, क्रेडेंशियल्स जांचें

3. फ़ायरवॉल सेटिंग्स जांचें:

   • System Preferences → Security & Privacy → Firewall
   • सुनिश्चित करें कि PostgreSQL पोर्ट (5432) की अनुमति है
   • परीक्षण के लिए अस्थायी रूप से फ़ायरवॉल अक्षम करने का प्रयास करें

4. नेटवर्क कनेक्टिविटी परीक्षण करें:

   # रिमोट सर्वर के लिए
   ping आपका-सर्वर-पता
   telnet आपका-सर्वर-पता 5432
   

सामान्य समाधान:

• ✅ PostgreSQL सेवा शुरू करें
• ✅ सही होस्टनाम/IP पता
• ✅ फ़ायरवॉल पोर्ट 5432 खोलें
• ✅ सही क्रेडेंशियल्स का उपयोग करें

"पासवर्ड प्रमाणीकरण विफल"

कारण:

• गलत उपयोगकर्ता नाम या पासवर्ड
• PostgreSQL प्रमाणीकरण विधि मेल नहीं खा रही
• उपयोगकर्ता के पास डेटाबेस अनुमतियों की कमी

समाधान:

1. PostgreSQL पासवर्ड रीसेट करें:

   -- सुपरयूज़र के रूप में कनेक्ट करें (कमांड लाइन के माध्यम से)
   ALTER USER username WITH PASSWORD 'नया_पासवर्ड';
   

2. प्रमाणीकरण विधि जांचें:

   • pg_hba.conf फ़ाइल देखें
   • सामान्य विधियां: md5, scram-sha-256, trust
   • यदि आवश्यक हो तो विधि अपडेट करें, PostgreSQL पुनः आरंभ करें

3. उपयोगकर्ता अनुमतियाँ सत्यापित करें:

   -- उपयोगकर्ताओं और अनुमतियों की सूची बनाएं
   \du
   
   -- डेटाबेस और पहुंच की सूची बनाएं
   \l
   

SSL/TLS कनेक्शन त्रुटियां

रिमोट सर्वर से कनेक्ट करते समय:

1. SSL आवश्यकताएं जांचें:

   • सर्वर को विशिष्ट SSL मोड की आवश्यकता हो सकती है
   • प्रमाणपत्र आयात की आवश्यकता हो सकती है

2. HarborDB में विभिन्न SSL मोड आज़माएं:

   • prefer से शुरू करें
   • फिर require आज़माएं
   • अंत में verify-full (प्रमाणपत्र की आवश्यकता है)

3. यदि verify-full का उपयोग कर रहे हैं तो प्रमाणपत्र आयात करें:

   • सर्वर व्यवस्थापक से प्रमाणपत्र प्राप्त करें
   • macOS Keychain Access में आयात करें
   • HarborDB को प्रमाणपत्र तक पहुंच प्रदान करें

प्रदर्शन समस्याएं

धीमी क्वेरी निष्पादन

निदान चरण:

1. विश्लेषण के लिए EXPLAIN का उपयोग करें:

   • HarborDB में "Explain" (⚡) बटन क्लिक करें
   • "Seq Scan" (पूर्ण टेबल स्कैन) देखें - अक्सर धीमा
   • "Index Scan" देखें - आमतौर पर तेज़

2. गुम इंडेक्स के लिए जांचें:

   -- बिना इंडेक्स वाले अक्सर फ़िल्टर किए गए कॉलम ढूंढें
   SELECT schemaname, tablename, attname
   FROM pg_stats
   WHERE schemaname NOT LIKE 'pg_%'
     AND n_distinct > 100
     AND attname NOT IN (
       SELECT column_name
       FROM information_schema.columns
       WHERE table_schema = schemaname
         AND table_name = tablename
     );
   

3. उपयुक्त इंडेक्स जोड़ें:

   -- एकल कॉलम इंडेक्स
   CREATE INDEX idx_table_column ON table_name(column_name);
   
   -- सामान्य क्वेरी पैटर्न के लिए मल्टी-कॉलम इंडेक्स
   CREATE INDEX idx_table_col1_col2 ON table_name(col1, col2);
   

त्वरित प्रदर्शन सुधार:

• अन्वेषणात्मक क्वेरी में LIMIT क्लॉज जोड़ें
• केवल आवश्यक कॉलम चुनें (SELECT * नहीं)
• इंडेक्स किए गए कॉलम के साथ WHERE क्लॉज का उपयोग करें
• WHERE क्लॉज में ऐसे फ़ंक्शन से बचें जो इंडेक्स उपयोग को रोकते हैं

उच्च मेमोरी उपयोग

लक्षण:

• HarborDB अत्यधिक RAM का उपयोग करता है (Activity Monitor जांचें)
• सिस्टम सुस्त हो जाता है
• "मेमोरी खत्म" त्रुटियां

समाधान:

1. क्वेरी कैश साइज़ कम करें:

   • Preferences → Performance → Query Cache
   • यदि मेमोरी सीमित है तो डिफ़ॉल्ट 256MB से 128MB तक कम करें

2. स्ट्रीमिंग मोड सक्षम करें:

   • Preferences → Performance → Streaming Results
   • 10,000 से अधिक पंक्तियों के परिणामों के लिए सक्षम करें
   • बड़े डेटासेट के लिए मेमोरी उपयोग कम करता है

3. खुले टैब प्रबंधित करें:

   • अप्रयुक्त क्वेरी टैब बंद करें
   • HarborDB प्रति टैब परिणाम सेट मेमोरी में रखता है
   • नियमित कार्य: अधिकतम 5-10 टैब

4. HarborDB पुनः आरंभ करें:

   • भारी उपयोग के दौरान दैनिक बंद करें और पुनः आरंभ करें
   • संचित मेमोरी उपयोग साफ़ करता है

अनुप्रयोग सुस्त लगता है

त्वरित सुधार:

1. अन्य अनुप्रयोग बंद करें:

   • विशेष रूप से संसाधन-गहन ऐप्स (कई टैब के साथ Chrome, Docker, आदि)
   • मेमोरी दबाव के लिए Activity Monitor जांचें

2. UI एनिमेशन कम करें:

   • Preferences → Appearance → एनिमेशन अक्षम करें
   • पुराने हार्डवेयर पर चिकना अनुभव

3. इंटरफ़ेस सरल करें:

   • उपयोग में न आने वाले साइडबार सेक्शन संकुचित करें
   • सरल रंग थीम का उपयोग करें
   • बहुत बड़ी क्वेरी के लिए सिंटेक्स हाइलाइटिंग अक्षम करें

निर्यात और फ़ाइल समस्याएं

निर्यात विफल या खाली फ़ाइलें बनाता है

सामान्य कारण और समाधान:

1. अनुमति समस्याएं:

   # फ़ोल्डर अनुमतियाँ जांचें
   ls -la ~/Desktop/
   
   # अलग सेव स्थान आज़माएं
   # Desktop के बजाय Documents फ़ोल्डर का उपयोग करें
   

2. डिस्क स्थान समस्याएं:

   # उपलब्ध डिस्क स्थान जांचें
   df -h
   
   # निर्यात साइज़ का कम से कम 2x मुक्त होना आवश्यक है
   

3. फ़ाइल प्रारूप समस्याएं:

   • CSV: अलग डिलीमिटर आज़माएं (कॉमा, सेमीकोलन, टैब)
   • CSV: टेक्स्ट क्वालिफायर जोड़ें (फ़ील्ड के चारों ओर कोट्स)
   • JSON: "Pretty" और "Compact" दोनों प्रारूप आज़माएं

4. बड़ा निर्यात अनुकूलन:

   • छोटे चंक में निर्यात करें
   • बड़े डेटासेट के लिए JSON के बजाय CSV का उपयोग करें
   • निर्यात सेटिंग्स में संपीड़न सक्षम करें

"फ़ाइल नहीं मिली" या गुम निर्यात

1. डिफ़ॉल्ट सेव स्थान जांचें:

   • Preferences → Export → Default Save Location
   • अक्सर एक्सेस किए जाने वाले फ़ोल्डर में बदलें

2. फ़ाइलें खोजें:

   # हाल की CSV/JSON फ़ाइलें खोजें
   find ~ -name "*.csv" -mtime -1
   find ~ -name "*.json" -mtime -1
   

3. ट्रैश जांचें:

   • निर्यात गलती से हटाए गए हो सकते हैं
   • यदि मिले तो ट्रैश से पुनर्स्थापित करें

इंटरफ़ेस और डिस्प्ले समस्याएं

थीम सही ढंग से लागू नहीं हो रही

macOS डार्क/लाइट मोड समस्याएं:

1. सिस्टम सेटिंग्स जांचें:

   • System Settings → Appearance
   • सुनिश्चित करें "Auto" या वांछित थीम चयनित है

2. HarborDB पुनः आरंभ करें:

   • पूरी तरह से बंद करें (⌘ + Q)
   • सिस्टम थीम लागू करने के लिए फिर से खोलें

3. HarborDB में थीम जबरन लागू करें:

   • Preferences → Appearance → Theme
   • "Light", "Dark", या "System" चुनें

गुम फीचर्स या मेनू

1. HarborDB अपडेट करें:

   • अपडेट के लिए जांचें (HarborDB → Check for Updates)
   • App Store → Updates टैब

2. इंटरफ़ेस लेआउट रीसेट करें:

   • Window → Reset Layout
   • डिफ़ॉल्ट पैनल व्यवस्था पुनर्स्थापित करता है

3. फ़ीचर उपलब्धता जांचें:

   • कुछ फ़ीचर्स को विशिष्ट PostgreSQL संस्करणों की आवश्यकता होती है
   • फ़ीचर दस्तावेज़ीकरण में संगतता सत्यापित करें

टेक्स्ट डिस्प्ले समस्याएं

फ़ॉन्ट साइज़/पठनीयता समस्याएं:

1. एडिटर फ़ॉन्ट साइज़ समायोजित करें:

   • Preferences → Editor → Font Size
   • बेहतर पठनीयता के लिए बढ़ाएं

2. macOS ज़ूम का उपयोग करें:

   • System Settings → Accessibility → Zoom
   • अस्थायी आवर्धन के लिए सक्षम करें

3. उच्च कंट्रास्ट मोड:

   • System Settings → Accessibility → Display
   • बेहतर दृश्यता के लिए कंट्रास्ट बढ़ाएं

macOS-विशिष्ट समस्याएं

"ऐप क्षतिग्रस्त है" त्रुटि

HarborDB खोलते समय:

# क्वारंटीन विशेषता हटाएं
sudo xattr -cr /Applications/HarborDB.app

# HarborDB फिर से खोलें
open /Applications/HarborDB.app

गेटकीपर चेतावनियाँ

सीधे डाउनलोड के लिए (App Store नहीं):

1. System Settings → Privacy & Security
2. "Security" सेक्शन तक स्क्रॉल करें
3. HarborDB चेतावनी के आगे "Open Anyway" क्लिक करें
4. खोलने की पुष्टि करें

Touch ID/Keychain पहुंच समस्याएं

"HarborDB आपका पासवर्ड उपयोग करना चाहता है" त्रुटियां:

1. Keychain अनुमतियाँ रीसेट करें:

   • Keychain Access ऐप खोलें
   • "HarborDB" खोजें
   • मौजूदा प्रविष्टियाँ हटाएं
   • HarborDB में कनेक्शन पुनः जोड़ें

2. Keychain मरम्मत करें:

   • Keychain Access → File → Keychain First Aid
   • "Login" keychain पर मरम्मत चलाएं

macOS संस्करणों के साथ संगतता

न्यूनतम: macOS 12.0 (Monterey) अनुशंसित: macOS 13.0 (Ventura) या बाद का

संगतता जांचें:

# macOS संस्करण जांचें
sw_vers

# आर्किटेक्चर जांचें (Apple Silicon बनाम Intel)
uname -m

डेटाबेस-विशिष्ट समस्याएं

"संबंध मौजूद नहीं है"

टेबल क्वेरी करते समय:

1. स्कीमा जांचें:

   -- वर्तमान स्कीमा में सभी टेबल सूचीबद्ध करें
   \dt
   
   -- सभी स्कीमा में टेबल सूचीबद्ध करें
   SELECT schemaname, tablename
   FROM pg_tables
   WHERE tablename LIKE '%your_table%';
   

2. योग्य नामों का उपयोग करें:

   -- इसके बजाय: SELECT * FROM users;
   -- स्कीमा योग्यता का उपयोग करें:
   SELECT * FROM public.users;
   SELECT * FROM auth.users;
   

3. डिफ़ॉल्ट स्कीमा सेट करें:

   • HarborDB में कनेक्शन संपादित करें
   • "Default Schema" को सामान्य रूप से उपयोग की जाने वाली स्कीमा पर सेट करें

डेटाबेस ऑब्जेक्ट पर अनुमति त्रुटियां

संबंध के लिए अनुमति अस्वीकृत

1. अपनी अनुमतियाँ जांचें:

   -- सुपरयूज़र या टेबल स्वामी के रूप में कनेक्ट करें
   SELECT grantee, privilege_type
   FROM information_schema.role_table_grants
   WHERE table_name = 'your_table';
   

2. अनुमतियों का अनुरोध करें:

   -- उदाहरण: SELECT अनुमति प्रदान करें
   GRANT SELECT ON table_name TO your_username;
   

बड़े डेटासेट संचालन

"मेमोरी खत्म" या अत्यधिक धीमा:

1. सर्वर-साइड पेजिनेशन का उपयोग करें:

   -- इसके बजाय: SELECT * FROM huge_table;
   -- उपयोग करें:
   SELECT * FROM huge_table LIMIT 1000 OFFSET 0;
   -- फिर अगले पेज के लिए OFFSET बढ़ाएं
   

2. HarborDB में स्ट्रीमिंग सक्षम करें:

   • Preferences → Performance → Streaming Mode
   • सीमा सेट करें (जैसे, 10,000 पंक्तियाँ)

3. अक्सर जटिल क्वेरी के लिए मटेरियलाइज्ड व्यू का उपयोग करें

नेटवर्क और रिमोट कनेक्शन समस्याएं

धीमा रिमोट कनेक्शन

अनुकूलन सुझाव:

1. संपीड़न सक्षम करें:

   • Connection settings → Advanced → Compression
   • डेटा ट्रांसफर साइज़ कम करता है

2. SSH टनलिंग का उपयोग करें:

   • सीधे कनेक्शन की तुलना में अधिक सुरक्षित
   • प्रतिबंधित नेटवर्क पर प्रदर्शन में सुधार कर सकता है

3. भारी क्वेरी शेड्यूल करें:

   • ऑफ-पीक घंटों के दौरान चलाएं
   • HarborDB के क्वेरी शेड्यूलर फ़ीचर का उपयोग करें

रुक-रुक कर कनेक्शन ड्रॉप

1. टाइमआउट सेटिंग्स बढ़ाएं:

   • Connection settings → Timeout
   • 30 से 60 सेकंड तक बढ़ाएं

2. कीप-अलाइव सक्षम करें:

   • Connection settings → Keep-Alive
   • निष्क्रिय कनेक्शन बनाए रखता है

3. नेटवर्क स्थिरता जांचें:

   # नेटवर्क स्थिरता परीक्षण करें
   ping -c 100 your-server-address
   # पैकेट लॉस देखें
   

सपोर्ट से संपर्क करने से पहले

एकत्र करने के लिए जानकारी

यदि समस्या निवारण के बाद भी समस्याएं बनी रहती हैं, तो यह जानकारी एकत्र करें:

1. सिस्टम जानकारी:

   • macOS संस्करण (Apple मेनू → About This Mac)
   • HarborDB संस्करण (HarborDB → About HarborDB)
   • PostgreSQL संस्करण (SELECT version();)

2. त्रुटि विवरण:

   • सटीक त्रुटि संदेश (यदि संभव हो तो स्क्रीनशॉट)
   • समस्या पुनरुत्पादित करने के चरण
   • समस्या कब शुरू हुई

3. कॉन्फ़िगरेशन विवरण:

   • कनेक्शन सेटिंग्स (पासवर्ड के बिना)
   • समस्या पैदा करने वाली क्वेरी (यदि लागू हो)
   • निर्यात सेटिंग्स (यदि निर्यात संबंधित)

HarborDB में नैदानिक उपकरण

1. नैदानिक रिपोर्ट जनरेट करें:

   • Help → Create Diagnostic Report
   • लॉग, कॉन्फ़िगरेशन, सिस्टम जानकारी शामिल करता है

2. अनुप्रयोग लॉग देखें:

   • Help → Show Logs
   • त्रुटि और चेतावनी संदेशों के लिए फ़िल्टर करें

3. सिस्टम लॉग के लिए Console.app:

   • Console.app खोलें
   • "HarborDB" खोजें
   • क्रैश रिपोर्ट देखें

त्वरित स्व-जांच

सपोर्ट से संपर्क करने से पहले, सत्यापित करें:

• [ ] macOS अप टू डेट है
• [ ] HarborDB नवीनतम संस्करण है
• [ ] PostgreSQL सर्वर चल रहा है
• [ ] नेटवर्क कनेक्शन स्थिर है
• [ ] पर्याप्त डिस्क स्थान उपलब्ध है
• [ ] उपयोगकर्ता के पास आवश्यक अनुमतियाँ हैं

सपोर्ट से संपर्क करना

यदि आपने सभी समस्या निवारण चरण आज़मा लिए हैं और समस्या बनी रहती है:

1. ईमेल सपोर्ट: support@harbordb.com

2. अपने ईमेल में शामिल करें:

   • नैदानिक रिपोर्ट (Help मेनू से)
   • त्रुटि संदेशों के स्क्रीनशॉट
   • समस्या पुनरुत्पादित करने के चरण
   • आपने कौन से समस्या निवारण चरण आज़माए हैं

3. अपेक्षित प्रतिक्रिया समय:

   • प्रारंभिक प्रतिक्रिया: 24-48 घंटे के भीतर
   • व्यावसायिक घंटे: सोमवार-शुक्रवार, 9AM-5PM EST
   • आपातकालीन समस्याएं: ईमेल को "URGENT" के रूप में चिह्नित करें

निवारक उपाय

नियमित रखरखाव

साप्ताहिक:

• मेमोरी साफ़ करने के लिए HarborDB पुनः आरंभ करें
• अस्थायी निर्यात फ़ाइलें साफ़ करें
• महत्वपूर्ण कनेक्शन सेटिंग्स का बैकअप लें

मासिक:

• HarborDB और PostgreSQL अपडेट करें
• धीमी क्वेरी की समीक्षा और अनुकूलित करें
• अप्रयुक्त कनेक्शन साफ़ करें

समस्याओं से बचने के लिए सर्वोत्तम अभ्यास

1. कनेक्शन प्रबंधन:
   • सार्थक कनेक्शन नामों का उपयोग करें