Improve connector SQL support sections

docs/src/main/sphinx/connector/alter-schema-limitation.fragment

@@ -1,4 +1,4 @@
-### ALTER SCHEMA
+### ALTER SCHEMA limitation
 
 The connector supports renaming a schema with the `ALTER SCHEMA RENAME`
 statement. `ALTER SCHEMA SET AUTHORIZATION` is not supported.

docs/src/main/sphinx/connector/alter-table-limitation.fragment

@@ -1,4 +1,4 @@
-### ALTER TABLE RENAME TO
+### ALTER TABLE RENAME TO limitation
 
 The connector does not support renaming tables across multiple schemas. For
 example, the following statement is supported:

docs/src/main/sphinx/connector/clickhouse.md

@@ -93,9 +93,6 @@ configured connector to create a catalog named `sales`.
 ```{include} jdbc-case-insensitive-matching.fragment
 ```
 
-```{include} non-transactional-insert.fragment
-```
-
 ## Querying ClickHouse
 
 The ClickHouse connector provides a schema for every ClickHouse *database*.
@@ -317,25 +314,35 @@ No other types are supported.
 (clickhouse-sql-support)=
 ## SQL support
 
-The connector provides read and write access to data and metadata in
-a ClickHouse catalog. In addition to the {ref}`globally available
-<sql-globally-available>` and {ref}`read operation <sql-read-operations>`
+The connector provides read and write access to data and metadata in a
+ClickHouse catalog. In addition to the [globally
+available](sql-globally-available) and [read operation](sql-read-operations)
 statements, the connector supports the following features:
 
-- {doc}`/sql/insert`
-- {doc}`/sql/truncate`
-- {ref}`sql-schema-table-management`
+- [](/sql/insert), see also [](clickhouse-insert)
+- [](/sql/truncate)
+- [](sql-schema-table-management), see also:
+  - [](clickhouse-alter-table)
+- [](clickhouse-procedures)
+- [](clickhouse-table-functions)
+
+(clickhouse-insert)=
+```{include} non-transactional-insert.fragment
+```
 
+(clickhouse-alter-table)=
 ```{include} alter-schema-limitation.fragment
 ```
 
+(clickhouse-procedures)=
 ### Procedures
 
 ```{include} jdbc-procedures-flush.fragment
 ```
 ```{include} procedures-execute.fragment
 ```
 
+(clickhouse-table-functions)=
 ### Table functions
 
 The connector provides specific {doc}`table functions </functions/table>` to

docs/src/main/sphinx/connector/druid.md

@@ -116,17 +116,23 @@ be an empty string `''`, and so forth.
 (druid-sql-support)=
 ## SQL support
 
-The connector provides {ref}`globally available <sql-globally-available>` and
-{ref}`read operation <sql-read-operations>` statements to access data and
-metadata in the Druid database.
+The connector provides read access to data and metadata in the Druid database.
+In addition to the [globally available](sql-globally-available) and [read
+operation](sql-read-operations) statements, the connector supports the following
+features:
 
+- [](druid-procedures)
+- [](druid-table-functions)
+
+(druid-procedures)=
 ### Procedures
 
 ```{include} jdbc-procedures-flush.fragment
 ```
 ```{include} procedures-execute.fragment
 ```
 
+(druid-table-functions)=
 ### Table functions
 
 The connector provides specific {doc}`table functions </functions/table>` to

docs/src/main/sphinx/connector/exasol.md

@@ -133,17 +133,23 @@ Exasol does not support longer values.
 (exasol-sql-support)=
 ## SQL support
 
-The connector provides {ref}`globally available <sql-globally-available>` and
-{ref}`read operation <sql-read-operations>` statements to access data and
-metadata in the Exasol database.
+The connector provides read access to data and metadata in Exasol. In addition
+to the [globally available](sql-globally-available) and [read
+operation](sql-read-operations) statements, the connector supports the following
+features:
 
+- [](exasol-procedures)
+- [](exasol-table-functions)
+
+(exasol-procedures)=
 ### Procedures
 
 ```{include} jdbc-procedures-flush.fragment
 ```
 ```{include} procedures-execute.fragment
 ```
 
+(exasol-table-functions)=
 ### Table functions
 
 The connector provides specific {doc}`table functions </functions/table>` to

docs/src/main/sphinx/connector/ignite.md

@@ -75,9 +75,6 @@ configured connector to create a catalog named `sales`.
 ```{include} jdbc-case-insensitive-matching.fragment
 ```
 
-```{include} non-transactional-insert.fragment
-```
-
 ## Table properties
 
 Table property usage example:
@@ -173,20 +170,33 @@ Ignite.  In addition to the {ref}`globally available
 <sql-globally-available>` and {ref}`read operation <sql-read-operations>`
 statements, the connector supports the following features:
 
-- {doc}`/sql/insert`
-- {doc}`/sql/update`
-- {doc}`/sql/delete`
-- {doc}`/sql/create-table`
-- {doc}`/sql/create-table-as`
-- {doc}`/sql/drop-table`
-- {doc}`/sql/alter-table`
+- [](/sql/insert), see also [](ignite-insert)
+- [](/sql/update), see also [](ignite-update)
+- [](/sql/delete)
+- [](/sql/merge), see also [](ignite-merge)
+- [](/sql/create-table)
+- [](/sql/create-table-as)
+- [](/sql/drop-table)
+- [](/sql/alter-table), see also [](ignite-alter-table)
+- [](ignite-procedures)
+
+(ignite-insert)=
+```{include} non-transactional-insert.fragment
+```
 
+(ignite-update)=
 ```{include} sql-update-limitation.fragment
 ```
 
+(ignite-merge)=
+```{include} non-transactional-merge.fragment
+```
+
+(ignite-alter-table)=
 ```{include} alter-table-limitation.fragment
 ```
 
+(ignite-procedures)=
 ### Procedures
 
 ```{include} jdbc-procedures-flush.fragment

docs/src/main/sphinx/connector/mariadb.md

@@ -52,9 +52,6 @@ properties files.
 ```{include} jdbc-case-insensitive-matching.fragment
 ```
 
-```{include} non-transactional-insert.fragment
-```
-
 (mariadb-fte-support)=
 ### Fault-tolerant execution support
 
@@ -283,35 +280,45 @@ Complete list of [MariaDB data types](https://mariadb.com/kb/en/data-types/).
 (mariadb-sql-support)=
 ## SQL support
 
-The connector provides read access and write access to data and metadata in
-a MariaDB database.  In addition to the {ref}`globally available
-<sql-globally-available>` and {ref}`read operation <sql-read-operations>`
+The connector provides read access and write access to data and metadata in a
+MariaDB database. In addition to the [globally
+available](sql-globally-available) and [read operation](sql-read-operations)
 statements, the connector supports the following features:
 
-- {doc}`/sql/insert`
-- {doc}`/sql/update`
-- {doc}`/sql/delete`
-- {doc}`/sql/truncate`
-- {doc}`/sql/create-table`
-- {doc}`/sql/create-table-as`
-- {doc}`/sql/drop-table`
-- {doc}`/sql/alter-table`
-- {doc}`/sql/create-schema`
-- {doc}`/sql/drop-schema`
+- [](/sql/insert), see also [](mariadb-insert)
+- [](/sql/update), see also [](mariadb-update)
+- [](/sql/delete), see also [](mariadb-delete)
+- [](/sql/truncate)
+- [](/sql/create-table)
+- [](/sql/create-table-as)
+- [](/sql/drop-table)
+- [](/sql/alter-table)
+- [](/sql/create-schema)
+- [](/sql/drop-schema)
+- [](mariadb-procedures)
+- [](mariadb-table-functions)
+
+(mariadb-insert)=
+```{include} non-transactional-insert.fragment
+```
 
+(mariadb-update)=
 ```{include} sql-update-limitation.fragment
 ```
 
+(mariadb-delete)=
 ```{include} sql-delete-limitation.fragment
 ```
 
+(mariadb-procedures)=
 ### Procedures
 
 ```{include} jdbc-procedures-flush.fragment
 ```
 ```{include} procedures-execute.fragment
 ```
 
+(mariadb-table-functions)=
 ### Table functions
 
 The connector provides specific {doc}`table functions </functions/table>` to

docs/src/main/sphinx/connector/mysql.md

@@ -99,9 +99,6 @@ creates a catalog named `sales` using the configured connector.
 ```{include} jdbc-case-insensitive-matching.fragment
 ```
 
-```{include} non-transactional-insert.fragment
-```
-
 (mysql-fte-support)=
 ### Fault-tolerant execution support
 
@@ -334,33 +331,43 @@ that catalog name instead of `example` in the above examples.
 ## SQL support
 
 The connector provides read access and write access to data and metadata in the
-MySQL database. In addition to the {ref}`globally available <sql-globally-available>` and
-{ref}`read operation <sql-read-operations>` statements, the connector supports
-the following statements:
-
-- {doc}`/sql/insert`
-- {doc}`/sql/update`
-- {doc}`/sql/delete`
-- {doc}`/sql/truncate`
-- {doc}`/sql/create-table`
-- {doc}`/sql/create-table-as`
-- {doc}`/sql/drop-table`
-- {doc}`/sql/create-schema`
-- {doc}`/sql/drop-schema`
+MySQL database. In addition to the [globally available](sql-globally-available)
+and [read operation](sql-read-operations) statements, the connector supports the
+following features:
+
+- [](/sql/insert), see also [](mysql-insert)
+- [](/sql/update), see also [](mysql-update)
+- [](/sql/delete), see also [](mysql-delete)
+- [](/sql/truncate)
+- [](/sql/create-table)
+- [](/sql/create-table-as)
+- [](/sql/drop-table)
+- [](/sql/create-schema)
+- [](/sql/drop-schema)
+- [](mysql-procedures)
+- [](mysql-table-functions)
+
+(mysql-insert)=
+```{include} non-transactional-insert.fragment
+```
 
+(mysql-update)=
 ```{include} sql-update-limitation.fragment
 ```
 
+(mysql-delete)=
 ```{include} sql-delete-limitation.fragment
 ```
 
+(mysql-procedures)=
 ### Procedures
 
 ```{include} jdbc-procedures-flush.fragment
 ```
 ```{include} procedures-execute.fragment
 ```
 
+(mysql-table-functions)=
 ### Table functions
 
 The connector provides specific {doc}`table functions </functions/table>` to

docs/src/main/sphinx/connector/non-transactional-merge.fragment

@@ -0,0 +1,11 @@
+### Non-transactional MERGE
+
+The connector supports adding, updating, and deleting rows using [MERGE
+statements](/sql/merge), if the `merge.non-transactional-merge.enabled` catalog
+property or the corresponding `non_transactional_merge_enabled` catalog session
+property is set to `true`. Merge is only supported for directly modifying target
+tables.
+
+In rare cases, expections occur during the merge operation, potentially
+resulting in a partial update.
+

docs/src/main/sphinx/connector/oracle.md

@@ -98,9 +98,6 @@ you name the property file `sales.properties`, Trino creates a catalog named
 ```{include} jdbc-case-insensitive-matching.fragment
 ```
 
-```{include} non-transactional-insert.fragment
-```
-
 (oracle-fte-support)=
 ### Fault-tolerant execution support
 
@@ -405,36 +402,47 @@ fails. This is also true for the equivalent `VARCHAR` types.
 ## SQL support
 
 The connector provides read access and write access to data and metadata in
-Oracle. In addition to the {ref}`globally available <sql-globally-available>`
-and {ref}`read operation <sql-read-operations>` statements, the connector
-supports the following statements:
-
-- {doc}`/sql/insert`
-- {doc}`/sql/update`
-- {doc}`/sql/delete`
-- {doc}`/sql/truncate`
-- {doc}`/sql/create-table`
-- {doc}`/sql/create-table-as`
-- {doc}`/sql/drop-table`
-- {doc}`/sql/alter-table`
-- {doc}`/sql/comment`
+Oracle. In addition to the [globally available](sql-globally-available) and
+[read operation](sql-read-operations) statements, the connector supports the
+following features:
+
+- [](/sql/insert), see also [](oracle-insert)
+- [](/sql/update), see also [](oracle-update)
+- [](/sql/delete), see also [](oracle-delete)
+- [](/sql/truncate)
+- [](/sql/create-table)
+- [](/sql/create-table-as)
+- [](/sql/drop-table)
+- [](/sql/alter-table), see also [](oracle-alter-table)
+- [](/sql/comment)
+- [](oracle-procedures)
+- [](oracle-table-functions)
+
+(oracle-insert)=
+```{include} non-transactional-insert.fragment
+```
 
+(oracle-update)=
 ```{include} sql-update-limitation.fragment
 ```
 
+(oracle-delete)=
 ```{include} sql-delete-limitation.fragment
 ```
 
+(oracle-alter-table)=
 ```{include} alter-table-limitation.fragment
 ```
 
+(oracle-procedures)=
 ### Procedures
 
 ```{include} jdbc-procedures-flush.fragment
 ```
 ```{include} procedures-execute.fragment
 ```
 
+(oracle-table-functions)=
 ### Table functions
 
 The connector provides specific {doc}`table functions </functions/table>` to