Add EXPLAIN documentation example.

gabrielle 

diff --git a/doc/src/sgml/ref/explain.sgml b/doc/src/sgml/ref/explain.sgml
index cf4aa8f7622de066537496857fae5e14aeba908f..044aba71a8fe4e199d00ffb798ddb1f516ce7b40 100644 (file)
--- a/doc/src/sgml/ref/explain.sgml
+++ b/doc/src/sgml/ref/explain.sgml
@@ -1,5 +1,5 @@
 
 
@@ -247,6 +247,29 @@ EXPLAIN SELECT * FROM foo;
 
   
 
+  
+  Here is the same query, with JSON formatting:
+
+EXPLAIN (FORMAT JSON) SELECT * FROM foo;
+           QUERY PLAN           
+--------------------------------
+ [                             +
+   {                           +
+     "Plan": {                 +
+       "Node Type": "Seq Scan",+
+       "Relation Name": "foo", +
+       "Alias": "foo",         +
+       "Startup Cost": 0.00,   +
+       "Total Cost": 155.00,   +
+       "Plan Rows": 10000,     +
+       "Plan Width": 4         +
+     }                         +
+   }                           +
+ ]
+(1 row)
+
+  
+
   
    If there is an index and we use a query with an indexable
    WHERE condition, EXPLAIN
@@ -263,6 +286,28 @@ EXPLAIN SELECT * FROM foo WHERE i = 4;
 
   
 
+  
+  Here is the same query, but in YAML output:
+
+EXPLAIN (FORMAT YAML) SELECT * FROM foo WHERE i='4';
+          QUERY PLAN           
+-------------------------------
+ - Plan:                      +
+     Node Type: "Index Scan"  +
+     Scan Direction: "Forward"+
+     Index Name: "fi"         +
+     Relation Name: "foo"     +
+     Alias: "foo"             +
+     Startup Cost: 0.00       +
+     Total Cost: 5.98         +
+     Plan Rows: 1             +
+     Plan Width: 4            +
+     Index Cond: "(i = 4)"
+(1 row)
+
+
+    XML output is left as an exercise to the reader.
+  
   
    Here is the same plan with costs suppressed: