Perplexity को Databricks से कनेक्ट करना

​

Databricks Connector के बारे में

Databricks Connector आपको सीधे Perplexity से अपने Databricks Lakehouse में संग्रहीत डेटा को क्वेरी करने की सुविधा देता है। यह Databricks को Perplexity की उत्पादकता सुविधाओं के साथ एकीकृत करता है, जिससे आप अपने Databricks कैटलॉग, स्कीमा और तालिकाओं में प्रासंगिक जानकारी को तुरंत खोज और संयोजित कर सकते हैं—बिना मैन्युअल क्वेरी या संदर्भ बदले।

Databricks Connector Perplexity Pro, Perplexity Max, Enterprise Pro, और Enterprise Max उपयोगकर्ताओं के लिए उपलब्ध है।

​

Databricks Connector क्या करता है?

सक्षम होने के बाद, Databricks Connector आपको अपने अधिकृत Databricks कैटलॉग, स्कीमा और तालिकाओं में खोज करने और उस डेटा के आधार पर उत्तर प्रदान करने की अनुमति देता है। यह कनेक्टर OAuth के माध्यम से आपकी व्यक्तिगत Databricks पहचान से प्रमाणीकरण करता है, जिसका अर्थ है कि क्वेरी आपकी मूल Databricks अनुमतियों के तहत चलती हैं—किसी साझा सेवा खाते की आवश्यकता नहीं है।

आप कनेक्टर का उपयोग करके मैन्युअल रूप से SQL लिखे बिना या Databricks कंसोल पर स्विच किए बिना Unity Catalog तालिकाओं, Delta Lake डेटा और व्यू में जानकारी तुरंत ढूँढ सकते हैं। जब आपका Databricks डेटा अपडेट होता है, तो कनेक्टर अगली क्वेरी के दौरान उन परिवर्तनों को स्वचालित रूप से प्रतिबिंबित करता है।

​

समर्थित डेटा ऑब्जेक्ट

Databricks Connector निम्नलिखित का समर्थन करता है:

• Unity Catalog तालिकाएँ और व्यू

• Delta Lake तालिकाएँ

• स्कीमा और कैटलॉग

• Unity Catalog में पंजीकृत बाहरी तालिकाएँ

• संरचित डेटा (CSV, JSON, Parquet-समर्थित तालिकाएँ)

फ़िलहाल, असंरचित डेटा (Databricks Volumes में संग्रहीत छवियाँ, ऑडियो, वीडियो और फ़ाइलें) समर्थित नहीं है।

​

प्रमाणीकरण

Databricks Connector OAuth (व्यक्तिगत उपयोगकर्ता) प्रमाणीकरण का उपयोग करता है। प्रत्येक Perplexity उपयोगकर्ता अपने स्वयं के Databricks क्रेडेंशियल का उपयोग करके कनेक्ट करता है, और क्वेरी उस उपयोगकर्ता की मूल Unity Catalog अनुमतियों के तहत चलती हैं—कोई साझा सेवा खाता, PAT, या service principal शामिल नहीं है।

इसका अर्थ है:

• डेटा एक्सेस प्रत्येक उपयोगकर्ता की मौजूदा Databricks अनुमतियों द्वारा नियंत्रित होता है।

• प्रत्येक क्वेरी Databricks में प्रति-उपयोगकर्ता एक स्पष्ट ऑडिट ट्रेल रखती है।

• एक संगठन एडमिन OAuth ऐप को एक बार कॉन्फ़िगर करता है; उसके बाद व्यक्तिगत उपयोगकर्ता अपने स्वयं के खातों से प्रमाणीकरण करते हैं।

नोट: चूँकि OAuth टोकन प्रत्येक उपयोगकर्ता की Databricks पहचान से बँधे होते हैं, उपयोगकर्ता केवल उन कैटलॉग, स्कीमा और तालिकाओं पर क्वेरी कर पाएँगे जिन तक उनकी पहले से Databricks में पहुँच है। कनेक्ट करने से पहले सुनिश्चित करें कि उपयुक्त Unity Catalog अनुमतियाँ (grants) मौजूद हैं।

​

Databricks में Perplexity क्या कर सकता है, इसे नियंत्रित करना

Databricks Connector एक टूल इंटरफ़ेस (Merge Databricks connector से लिया गया) के माध्यम से SQL निष्पादित करता है, जिसमें एक सामान्य execute_sql_statement टूल शामिल है। चूँकि execute_sql_statement मनमाना SQL—DDL और DML सहित—स्वीकार करता है, इसलिए केवल विश्वसनीय तरीका यह है कि Perplexity क्या कर सकता है, इसे रीड-ओनली या अन्यथा प्रतिबंधित करने के लिए Unity Catalog स्तर पर नियंत्रण लगाया जाए, न कि Perplexity UI में।

​

अनुशंसित पैटर्न: Unity Catalog अनुमतियों के माध्यम से रीड-ओनली लागू करें।

चूँकि कनेक्टर OAuth के माध्यम से प्रति-उपयोगकर्ता प्रमाणीकरण करता है, इसलिए Perplexity द्वारा किया गया हर एक्शन उस उपयोगकर्ता की Databricks पहचान के तहत चलता है और उसकी मौजूदा Unity Catalog अनुमतियों के अधीन होता है। उपयोग को रीड-ओनली रखने के लिए, सुनिश्चित करें कि प्रत्येक उपयोगकर्ता (या उनके समूह) के पास केवल निम्नलिखित अनुमतियाँ हों:

• जिन कैटलॉग पर आप उन्हें क्वेरी करने देना चाहते हैं, उन पर USE CATALOG

• जिन स्कीमा पर आप उन्हें क्वेरी करने देना चाहते हैं, उन पर USE SCHEMA

• जिन तालिकाओं और व्यू पर आप उन्हें क्वेरी करने देना चाहते हैं, उन पर SELECT

और यह सुनिश्चित करें कि उन ऑब्जेक्ट्स पर उनके पास MODIFY, CREATE, या OWN नहीं है, और SQL warehouse पर CAN MANAGE भी नहीं है। Unity Catalog को इस प्रकार कॉन्फ़िगर करने पर, Databricks उन ऑब्जेक्ट्स पर Perplexity द्वारा किए जाने वाले किसी भी राइट प्रयास को अस्वीकार कर देगा जहाँ उपयोगकर्ता के पास राइट विशेषाधिकार नहीं हैं—भले ही कोई भी टूल कॉल किया गया हो।

नोट: Perplexity, Databricks कनेक्टर सेटिंग्स में एक Tool permissions पैनल दिखाता है, जो उपलब्ध टूल्स को सूचीबद्ध करता है। फ़िलहाल, यह पैनल विश्वसनीय रीड/राइट/एडिट प्रवर्तन प्रदान नहीं करता—Unity Catalog स्तर (ऊपर बताए अनुसार) पर एक्सेस को नियंत्रित करना ही Perplexity क्या कर सकता है, इसे नियंत्रित करने का सही तरीका है।

​

गोपनीयता और डेटा सुरक्षा

जब Perplexity से कनेक्ट किया जाता है, तो Databricks Connector आपकी ओर से निम्नलिखित क्रियाएँ कर सकता है:

• SQL Warehouses के माध्यम से Databricks डेटा पर SQL क्वेरी निष्पादित करना

• Unity Catalog तालिकाओं, व्यू और स्कीमा पर क्वेरी करना

• Delta Lake तालिका के मेटाडेटा और डेटा को पढ़ना

यदि आप Databricks में पहुँच रद्द कर देते हैं या अनुमतियाँ हटा देते हैं, तो वह डेटा तुरंत Perplexity से एक्सेस करने योग्य नहीं रहेगा। यदि आप Perplexity में अपना Databricks खाता डिस्कनेक्ट करते हैं, तो आप चुन सकते हैं कि कैश किया गया डेटा रखें या हटा दें।

​

एंटरप्राइज़-ग्रेड सुरक्षा और नियंत्रण

Enterprise संगठनों के लिए, Perplexity SOC 2 Type II प्रमाणन, एंड-टू-एंड एन्क्रिप्शन, सख़्त डेटा गोपनीयता उपाय, और बारीक स्तर के उपयोगकर्ता एक्सेस नियंत्रण प्रदान करता है। आपके Databricks डेटा का उपयोग कभी भी AI प्रशिक्षण के लिए नहीं किया जाता है।

Perplexity को Databricks से कनेक्ट करना व्यक्तिगत स्तर पर होता है—आपके संगठन में कोई और आपके Databricks डेटा पर क्वेरी नहीं कर सकता। हालाँकि, यदि आप डेटा को किसी साझा प्रोजेक्ट में सिंक करते हैं, तो उस प्रोजेक्ट तक पहुँच रखने वाला कोई भी व्यक्ति उसे खोज सकेगा।

संगठन एडमिन Organization Settings में Permissions स्क्रीन से सभी उपयोगकर्ताओं के लिए Databricks Connector को सक्षम या अक्षम कर सकते हैं। रीड/राइट प्रवर्तन Unity Catalog स्तर पर किया जाता है (ऊपर Databricks में Perplexity क्या कर सकता है, इसे नियंत्रित करना देखें)।

​

नेटवर्क संबंधी पूर्वापेक्षाएँ

यह सेक्शन केवल तब लागू होता है जब आपका Databricks workspace IP access lists का उपयोग करता है या इनबाउंड ट्रैफ़िक पर इसी तरह का कोई प्रतिबंध लगाता है (उदाहरण के लिए, Azure Databricks ingress policy या workspace के आगे लगा कोई firewall)। अगर आपका workspace किसी भी पते से इनबाउंड ट्रैफ़िक स्वीकार करता है, तो नेटवर्क में कोई बदलाव करने की ज़रूरत नहीं है और आप सीधे इसे कैसे सक्रिय करें पर जा सकते हैं।

Databricks Connector Merge Agent Handler द्वारा संचालित है, जो Databricks के लिए Perplexity का ऑथेंटिकेशन और इंटीग्रेशन पार्टनर है। जब कोई यूज़र Authenticate with Databricks पर क्लिक करता है, तो Databricks लॉगिन पेज यूज़र के ब्राउज़र में लोड होता है, लेकिन आपके workspace के token endpoint (/oidc/v1/token) के साथ OAuth code exchange Merge द्वारा सर्वर-से-सर्वर किया जाता है। लिंक होने के बाद, Merge Perplexity की SQL Warehouse और Unity Catalog API कॉल को भी आपके workspace तक पहुँचाता है। ये अनुरोध Merge के इन्फ्रास्ट्रक्चर से आते हैं, यूज़र के नेटवर्क या Perplexity की प्रकाशित IP ranges से नहीं।

अगर आपका workspace इनबाउंड ट्रैफ़िक को प्रतिबंधित करता है, तो एडमिन सेटअप चलाने से पहले अपनी IP access list (या इसके समकक्ष allowlist) में ये जोड़ें:

• Merge Agent Handler (US tenant): 3.216.101.38 और 52.20.242.81। ये पते स्थिर हैं और ऑथेंटिकेशन के दौरान OAuth token exchange के लिए और लिंक होने के बाद लगातार चलने वाले Databricks API ट्रैफ़िक (SQL Warehouse और Unity Catalog कॉल) के लिए उपयोग किए जाते हैं।

• Perplexity: perplexity-user.json में प्रकाशित egress ranges। इन्हें Merge के पतों के साथ allowlist में बनाए रखें।

नोट: अगर Merge के पते allowlist में नहीं हैं, तो आम तौर पर यूज़र को Databricks लॉगिन पेज और सहमति स्क्रीन सामान्य रूप से लोड होती दिखेगी, और फिर Perplexity के कनेक्शन पूरा करने की कोशिश करते समय token_exchange_failed एरर आएगा।

​

इसे कैसे सक्रिय करें

Databricks Connector को सेट अप करना दो-चरणीय प्रक्रिया है: एक एडमिन संगठन के लिए OAuth ऐप को एक बार कॉन्फ़िगर करता है, और फिर प्रत्येक उपयोगकर्ता अपने स्वयं के Databricks खाते से प्रमाणीकरण करता है।

​

भाग 1: एडमिन सेटअप — अपने संगठन के लिए Databricks कॉन्फ़िगर करें

एक Databricks workspace एडमिन को यह चरण एक बार पूरा करना होगा। व्यक्तिगत उपयोगकर्ताओं को इसे दोहराने की आवश्यकता नहीं है।

Organization Settings → Connectors → Databricks में, आपको “Configure Databricks for your organization” शीर्षक वाला एक तीन-चरणीय सेटअप पैनल दिखाई देगा:

• चरण 1: Manage OAuth app — Perplexity को अपने Databricks workspace में OAuth क्लाइंट के रूप में पंजीकृत करने के लिए Manage OAuth app पर क्लिक करें। यह Perplexity को आपके workspace के विरुद्ध OAuth के माध्यम से उपयोगकर्ताओं को प्रमाणित करने की अनुमति देता है।

• चरण 2: Authenticate with Databricks — एडमिन यह सत्यापित करने के लिए एक बार प्रमाणीकरण करता है कि एकीकरण एंड-टू-एंड कार्य करता है।

• चरण 3: Generate a data map (वैकल्पिक) — वैकल्पिक रूप से संगठन के लिए एक डेटा मानचित्र बनाएँ (नीचे भाग 3 और Understanding the Data Map देखें) और क्वेरी की सटीकता बेहतर करने के लिए पूरक संदर्भ (Supplementary context) जोड़ें।

नोट: इस चरण को पूरा करने के लिए आपको Databricks workspace एडमिन विशेषाधिकारों की आवश्यकता होगी। यदि आपको Databricks में OAuth ऐप पंजीकृत करने का तरीका नहीं पता, तो Databricks OAuth दस्तावेज़ देखें।

​

भाग 2: उपयोगकर्ता सेटअप — प्रमाणीकरण और कनेक्ट करें

प्रत्येक उपयोगकर्ता निम्नलिखित चरण स्वतंत्र रूप से पूरा करता है:

यह कनेक्टर किसी प्लगइन में भी शामिल हो सकता है। इसे कहीं भी कनेक्ट करने पर यह आपके अकाउंट के लिए हर जगह कनेक्ट हो जाता है। आपका कनेक्शन और आपके संगठन की कनेक्टर सेटिंग्स हर प्लगइन में लागू होती हैं। प्लगइन क्या हैं?

​

भाग 3: डेटा मानचित्र बनाएँ (वैकल्पिक लेकिन अनुशंसित)

प्रमाणीकरण के बाद, Perplexity आपके Databricks वातावरण का एक data map बना सकता है। यह Computer को आपकी कैटलॉग संरचना समझने और डेटा संबंधी प्रश्नों का अधिक सटीक उत्तर देने में मदद करता है।

• किसी भी समय मानचित्र बनाने या ताज़ा करने के लिए Regenerate data map पर क्लिक करें।

• सर्वोत्तम परिणामों के लिए, पूरक संदर्भ (Supplementary context) भी जोड़ें—अपने डेटा का वर्णन करने वाली फ़ाइलें अपलोड करें या नोट्स जोड़ें (उदाहरण के लिए, मुख्य तालिकाएँ क्या दर्शाती हैं, व्यवसाय परिभाषाएँ, सामान्य क्वेरी पैटर्न)। यह अतिरिक्त संदर्भ एजेंट को आपके डेटा की सही व्याख्या करने में मदद करता है।

• Perplexity ने आपके Databricks वातावरण के बारे में क्या सीखा है, इसकी समीक्षा करने के लिए View knowledge पर क्लिक करें।

डेटा मानचित्र को छोड़ देने से जटिल डेटा प्रश्नों पर सटीकता कम हो जाएगी। हम प्रारंभिक सेटअप के हिस्से के रूप में इसे बनाने की अनुशंसा करते हैं। अधिक जानकारी के लिए Understanding the Data Map देखें।

​

कनेक्ट किए गए डेटा का उपयोग

एक बार कनेक्ट हो जाने पर, आप Computer कार्यों में अपने Databricks डेटा का संदर्भ दे सकते हैं। कैटलॉग, स्कीमा या तालिकाओं का उल्लेख करें और Perplexity बहु-चरणीय वर्कफ़्लो के हिस्से के रूप में उन पर क्वेरी करेगा—सब कुछ एक सुरक्षित क्लाउड सैंडबॉक्स में असिंक्रोनस रूप से।

​

इसे आज़माना

एक बार कनेक्ट हो जाने पर, इन जैसी क्वेरी चलाने का प्रयास करें:

• “Q4 sales तालिका से राजस्व प्रवृत्तियों का सारांश दें और मुख्य मेट्रिक्स पर प्रकाश डालें"

• "पिछले 30 दिनों में अपडेट किए गए सभी ग्राहक रिकॉर्ड खोजें"

• "analytics स्कीमा के आधार पर सबसे अच्छा प्रदर्शन करने वाले उत्पाद कौन-से हैं?"

• "इस तिमाही के पाइपलाइन डेटा की तुलना पिछली तिमाही के आँकड़ों से करें”

​

समस्या निवारण

​

आपके संगठन के लिए Databricks सक्षम नहीं है

हो सकता है कि एक संगठन एडमिन ने कनेक्टर को अक्षम कर दिया हो, या OAuth ऐप अभी तक कॉन्फ़िगर न हुआ हो। पुष्टि के लिए अपने संगठन एडमिन से संपर्क करें, या Perplexity सहायता से संपर्क करें।

​

OAuth ऐप कॉन्फ़िगर नहीं है

यदि उपयोगकर्ताओं को प्रमाणीकरण का प्रयास करते समय कोई त्रुटि दिखाई देती है, तो हो सकता है कि एडमिन OAuth ऐप सेटअप (भाग 1) पूरा न हुआ हो। एक workspace एडमिन को Organization Settings → Connectors → Databricks पर वापस जाकर Manage OAuth app चरण पूरा करना चाहिए।

​

कनेक्ट करने के बाद उपयोगकर्ता कुछ तालिकाओं तक नहीं पहुँच पा रहा

Databricks Connector प्रत्येक उपयोगकर्ता की मौजूदा Unity Catalog अनुमतियों का सम्मान करता है। यदि कोई उपयोगकर्ता उस तालिका पर क्वेरी नहीं कर पा रहा जिस पर पहुँच की उम्मीद है, तो सत्यापित करें कि Unity Catalog में उपयुक्त GRANT लागू किया गया है:

— किसी कैटलॉग पर पहुँच प्रदान करें
GRANT USE CATALOG ON CATALOG my_catalog TO user@example.com;

— किसी स्कीमा पर पहुँच प्रदान करें
GRANT USE SCHEMA ON SCHEMA my_catalog.my_schema TO user@example.com;

— तालिकाओं पर रीड पहुँच प्रदान करें
GRANT SELECT ON TABLE my_catalog.my_schema.my_table TO user@example.com;

​

token exchange एरर के साथ ऑथेंटिकेशन विफल होता है

अगर कोई यूज़र Databricks लॉगिन और सहमति स्क्रीन पूरी कर लेता है, लेकिन उसके बाद कनेक्शन token_exchange_failed एरर के साथ विफल हो जाता है, तो Merge और आपके workspace के बीच OAuth code exchange सफल नहीं हुआ। अपने Databricks workspace एडमिन और नेटवर्क टीम के साथ ये चरण पूरे करें:

• पुष्टि करें कि नेटवर्क संबंधी पूर्वापेक्षाएँ में दिए गए Merge egress पते workspace की सुरक्षा करने वाली हर IP access list, ingress policy या firewall में allowlisted हैं। Databricks एडमिन system.access.inbound_network सिस्टम टेबल में /oidc/v1/token पर अस्वीकृत अनुरोधों की जाँच कर सकते हैं।

• जाँचें कि भाग 1 में रजिस्टर किया गया OAuth ऐप अब भी सक्षम है और उसके redirect URIs Organization Settings → Connectors → Databricks में दिखाए गए मानों से मेल खाते हैं।

• नेटवर्क या OAuth ऐप में कोई भी बदलाव करने के बाद यूज़र से कनेक्शन फिर से आज़माने को कहें।

अगर एरर बना रहता है, तो Perplexity सपोर्ट से संपर्क करें और विफल प्रयास का अनुमानित समय और workspace URL शामिल करें, ताकि हम अपने इंटीग्रेशन पार्टनर के साथ exchange की जाँच कर सकें।

​

डेटा मानचित्र पुराना या अशुद्ध है

यदि Perplexity आपके Databricks डेटा के बारे में गलत या पुराने उत्तर दे रहा है, तो कनेक्टर सेटिंग्स में Regenerate data map पर क्लिक करने का प्रयास करें। आप अपने डेटा संरचना पर एजेंट को बेहतर मार्गदर्शन देने के लिए पूरक संदर्भ (Supplementary context) को भी जोड़ या अपडेट कर सकते हैं।

​

कनेक्शन और प्रमाणीकरण संबंधी समस्याएँ

• सत्यापित करें कि OAuth ऐप आपके Databricks workspace में सही ढंग से कॉन्फ़िगर किया गया है

• पुष्टि करें कि Perplexity के redirect URI आपके Databricks OAuth ऐप सेटिंग्स में allowlist में जोड़े गए हैं

• अगर आपका workspace IP access lists, ingress policy या firewall का उपयोग करता है, तो पक्का करें कि नेटवर्क संबंधी पूर्वापेक्षाएँ में दिए गए Merge और Perplexity के पते allowlisted हैं

• workspace पॉलिसी में किसी भी बदलाव के बाद उपयोगकर्ताओं से Databricks Connector को पुनः कनेक्ट करने को कहें

इन सेटिंग्स को अपडेट करने के बाद भी यदि समस्याएँ बनी रहती हैं, तो सहायता के लिए Perplexity सहायता से संपर्क करें।