PostgreSQL सिंटैक्स हाइलाइटिंग

मैं खुशखबरी साझा करने में जल्दबाजी करता हूं: पोस्टग्रेक्यूएल और उनके पाठकों के बारे में लेखों के लेखकों का जीवन थोड़ा बेहतर हो गया है।

जैसा कि सभी विभक्तियाँ जानते हैं, स्रोत कोड को डिजाइन करने के लिए, एक विशेष <source> टैग का उपयोग किया जाता है, जो वाक्य रचना पर प्रकाश डालता है। यह कोई रहस्य नहीं है कि बैकलाइटिंग हमेशा सही नहीं होती है, और फिर लेखक (जो उनके लेखों की तरह दिखते हैं) को शौकिया प्रदर्शन में संलग्न करने के लिए मजबूर किया जाता है - अपने कोड को <font color=...> के साथ <font color=...> ।

PostgreSQL के साथ सब कुछ विशेष रूप से दुखी था, क्योंकि हाइलाइटिंग ने कम या ज्यादा मानक एसक्यूएल को कवर किया और स्पष्ट रूप से हमारे डीबीएमएस की बारीकियों को नहीं समझा। जैसे-जैसे समय बीतता गया , अलेक्सी बोम्बुरम ने मेरे फोंट को स्रोत तक (और मैं वापस कर दिया) ठीक कर दिया, जब तक कि यह स्पष्ट नहीं हो गया कि बैकलाइट को ठीक करने की आवश्यकता है। अंत में, दलेर दलेरालियोरोव ने एक रास्ता सुझाया: हब्बर द्वारा उपयोग किए गए हाइलाइटज लाइब्रेरी में पोस्टग्रेक्यूएल समर्थन जोड़ें। और अब - किया, स्वागत है।

pgsql: SQL, PL / pgSQL और ऑल-ऑल-ऑल

तो, सही हाइलाइटिंग का रहस्य नई pgsql भाषा में है। इसे मेनू (बटन "स्रोत कोड") में चुना जा सकता है या मैन्युअल रूप से निर्दिष्ट किया जा सकता है। Html में आपको लिखना है

<source lang="pgsql">

</source>

और इस तरह से मार्कडाउन में:

```pgsql

```

सिद्धांत रूप में, हाइलाइटज स्वयं भाषा निर्धारित कर सकते हैं, लेकिन आम तौर पर यह केवल बड़े कोड के टुकड़ों के लिए काम करता है; छोटे टुकड़ों में, ऑटो-डिटेक्शन अक्सर छूट जाता है। इसके अलावा, ऑटो-डिटेक्शन में समय लगता है, इसलिए यदि आप स्पष्ट रूप से भाषा निर्दिष्ट करते हैं, तो कोड तेजी से चमक जाएगा।

उदाहरण के लिए, पाने के लिए

 CREATE TABLE aircrafts_data ( aircraft_code character(3) NOT NULL, model jsonb NOT NULL, range integer NOT NULL, CONSTRAINT aircrafts_range_check CHECK ((range > 0)) ); 

हम लिख रहे हैं

<source lang="pgsql">
CREATE TABLE aircrafts_data (
aircraft_code character(3) NOT NULL,
model jsonb NOT NULL,
range integer NOT NULL,
CONSTRAINT aircrafts_range_check CHECK ((range > 0))
);
</source>

वही pgsql भाषा PL / pgSQL कोड को भी रंगती है। उदाहरण के लिए, पाने के लिए

 CREATE FUNCTION get_available_flightid(date) RETURNS SETOF integer AS $$ BEGIN RETURN QUERY SELECT flightid FROM flight WHERE flightdate >= $1 AND flightdate < ($1 + 1); IF NOT FOUND THEN RAISE EXCEPTION '   : %.', $1; END IF; RETURN; END $$ LANGUAGE plpgsql; 

लिखने

<source lang="pgsql">
CREATE FUNCTION get_available_flightid(date) RETURNS SETOF integer AS $$
...
$$ LANGUAGE plpgsql;
</source>

एक मामूली सूक्ष्मता यह है कि डॉलर में संलग्न वर्ण स्ट्रिंग को हमेशा कोड के रूप में हाइलाइट किया जाता है, और एपोस्ट्रोफ में तार को कभी भी हाइलाइट नहीं किया जाता है। मैंने विभिन्न विकल्पों पर विचार किया, लेकिन यह सबसे पर्याप्त लग रहा था।

मुख्य रूप से किसी खंड की भाषा का पता लगाने के लिए हाइलाइटज की क्षमता अन्य भाषाओं में हाइलाइटिंग कार्यों की अनुमति देती है। उदाहरण के लिए, सब कुछ PL / पर्ल के लिए काम करेगा:

 CREATE FUNCTION perl_max (integer, integer) RETURNS integer AS $$ my ($x, $y) = @_; if (not defined $x) { return undef if not defined $y; return $y; } return $x if not defined $y; return $x if $x > $y; return $y; $$ LANGUAGE plperl; 

आपको कुछ विशेष करने की आवश्यकता नहीं है, बस लिखें

<source lang="pgsql">
CREATE FUNCTION perl_max (integer, integer) RETURNS integer AS $$
...
$$ LANGUAGE plperl;
</source>

बेशक, चुनी गई भाषा केवल उस चीज पर निर्भर करती है जो डॉलर के अंदर लिखी जाती है, और किसी भी तरह से निर्धारित नहीं होती है जो भाषा के बाद लिखी जाती है।

सामान्य तौर पर, बैकलाइट PostgreSQL के हाल ही में जारी 11 वें संस्करण से मेल खाती है।

हाइलाइटिंग सुविधाओं के बारे में बहुत संदेह था। दुर्भाग्य से, एक फ़ंक्शन नाम से अंतर करने के लिए, उदाहरण के लिए, एक तालिका नाम, एक पूर्ण-पार्सिंग की आवश्यकता है, लेकिन यह सिंटैक्स हाइलाइटिंग के भीतर हल नहीं किया गया है। आप मानक कार्यों की एक लंबी सूची बना सकते हैं और उन्हें रंग सकते हैं, लेकिन कई एक्सटेंशन के कार्यों के बारे में क्या? नतीजतन, मैंने बिल्कुल नहीं रंग करने का फैसला किया - सभी समान, सब कुछ कीवर्ड पर टिकी हुई है, और परिवर्तन कम हो गया है।

plaintext: टेक्स्ट, प्लेन टेक्स्ट

कभी-कभी लेख में क्वेरी के परिणाम जारी करने की आवश्यकता होती है। बेशक, वहाँ कोई कीवर्ड नहीं हैं, कुछ भी हाइलाइट करने की आवश्यकता नहीं है, लेकिन मैं चाहता हूं कि टेक्स्ट कोड के समान "कंसोल" दिखे। इसके लिए, अब आप विशेष सादे भाषा का उपयोग कर सकते हैं। उदाहरण के लिए, पाने के लिए

 WITH xmldata(data) AS (VALUES ($$ <example xmlns="http://example.com/myns" xmlns:B="http://example.com/b"> <item foo="1" B:bar="2"/> <item foo="3" B:bar="4"/> <item foo="4" B:bar="5"/> </example>$$::xml) ) SELECT xmltable.* FROM XMLTABLE(XMLNAMESPACES('http://example.com/myns' AS x, 'http://example.com/b' AS "B"), '/x:example/x:item' PASSING (SELECT data FROM xmldata) COLUMNS foo int PATH '@foo', bar int PATH '@B:bar'); 

  foo | bar -----+----- 1 | 2 3 | 4 4 | 5 (3 rows) 

लिखने

<source lang="pgsql">
WITH xmldata(data) AS (VALUES ($$
...
</source>
<source lang="plaintext">
foo | bar
-----+-----
1 | 2
3 | 4
4 | 5
(3 rows)
</source>

प्लेनटेक्स्ट को हमेशा स्पष्ट रूप से निर्दिष्ट किया जाना चाहिए, यह स्वचालित रूप से पता नहीं लगाया जाता है।

मुझे उम्मीद है कि आप नवाचार को पसंद करेंगे और काम में आएंगे। यदि आपको कोड हाइलाइट किए जाने के तरीके में त्रुटि मिलती है (और त्रुटियां अपरिहार्य हैं, तो संदर्भ-संवेदनशील सिंटैक्स SQL ​​के लिए बहुत अधिक है), प्रोजेक्ट के गितुब पर एक कार्य बनाएं, और इससे भी बेहतर, एक समाधान का प्रस्ताव करें।

PS पीजीकोनफ सम्मेलन के बारे में मत भूलो, जो मास्को में 4-6 फरवरी को आयोजित किया जाएगा। रिपोर्ट के लिए आवेदन 5 दिसंबर तक स्वीकार किए जाते हैं!