Add docs for EXECUTE IMMEDIATE

Author: colebow

docs/src/main/sphinx/language/sql-support.rst

@@ -38,6 +38,7 @@ any connector:
 * :doc:`/sql/describe-input`
 * :doc:`/sql/describe-output`
 * :doc:`/sql/execute`
+* :doc:`/sql/execute-immediate`
 * :doc:`/sql/explain`
 * :doc:`/sql/explain-analyze`
 * :doc:`/sql/prepare`

docs/src/main/sphinx/sql.rst

@@ -37,6 +37,7 @@ Trino also provides :doc:`numerous SQL functions and operators<functions>`.
     sql/drop-table
     sql/drop-view
     sql/execute
+    sql/execute-immediate
     sql/explain
     sql/explain-analyze
     sql/grant

docs/src/main/sphinx/sql/deallocate-prepare.rst

@@ -24,4 +24,4 @@ Deallocate a statement with the name ``my_query``::
 
 See also
 --------
-:doc:`prepare`
+:doc:`prepare`, :doc:`execute:, :doc:`execute-immediate`

docs/src/main/sphinx/sql/execute-immediate.rst

@@ -0,0 +1,41 @@
+=================
+EXECUTE IMMEDIATE
+=================
+
+Synopsis
+--------
+
+.. code-block:: text
+
+    EXECUTE IMMEDIATE `statement` [ USING parameter1 [ , parameter2, ... ] ]
+
+Description
+-----------
+
+Executes a statement without the need to prepare or deallocate the statement.
+Parameter values are defined in the ``USING`` clause.
+
+Examples
+--------
+
+Execute a query with no parameters::
+
+    EXECUTE IMMEDIATE
+    'SELECT name FROM nation';
+
+Execute a query with two parameters::
+
+    EXECUTE IMMEDIATE
+    'SELECT name FROM nation WHERE regionkey = ? and nationkey < ?'
+    USING 1, 3;
+
+This is equivalent to::
+
+   PREPARE statement_name FROM SELECT name FROM nation WHERE regionkey = ? and nationkey < ?
+   EXECUTE statement_name USING 1, 3
+   DEALLOCATE PREPARE statement_name
+
+See also
+--------
+
+:doc:`execute`, :doc:`prepare`, :doc:`deallocate-prepare`

docs/src/main/sphinx/sql/execute.rst

@@ -43,4 +43,4 @@ This is equivalent to::
 See also
 --------
 
-:doc:`prepare`
+:doc:`prepare`, :doc:`deallocate-prepare`, :doc:`execute-immediate`

docs/src/main/sphinx/sql/prepare.rst

@@ -39,4 +39,4 @@ Prepare an insert query::
 See also
 --------
 
-:doc:`execute`, :doc:`deallocate-prepare`, :doc:`describe-input`, :doc:`describe-output`
+:doc:`execute`, :doc:`deallocate-prepare`, :doc:`execute-immediate`, :doc:`describe-input`, :doc:`describe-output`