diff --git a/docs/src/main/sphinx/connector/clickhouse.rst b/docs/src/main/sphinx/connector/clickhouse.rst index cbb276b26b94..266f79c8d354 100644 --- a/docs/src/main/sphinx/connector/clickhouse.rst +++ b/docs/src/main/sphinx/connector/clickhouse.rst @@ -23,8 +23,8 @@ The connector can query a ClickHouse server. Create a catalog properties file that specifies the ClickHouse connector by setting the ``connector.name`` to ``clickhouse``. -For example, to access a server as ``myclickhouse``, create the file -``etc/catalog/myclickhouse.properties``. Replace the connection properties as +For example, to access a server as ``clickhouse``, create the file +``etc/catalog/clickhouse.properties``. Replace the connection properties as appropriate for your setup: .. code-block:: none @@ -34,10 +34,6 @@ appropriate for your setup: connection-user=exampleuser connection-password=examplepassword -.. include:: jdbc-common-configurations.fragment - -.. include:: non-transactional-insert.fragment - Multiple ClickHouse servers ^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -50,6 +46,10 @@ catalog for each server. To add another catalog: For example, if you name the property file ``sales.properties``, Trino uses the configured connector to create a catalog named ``sales``. +.. include:: jdbc-common-configurations.fragment + +.. include:: non-transactional-insert.fragment + Querying ClickHouse ------------------- diff --git a/docs/src/main/sphinx/connector/druid.rst b/docs/src/main/sphinx/connector/druid.rst index 2428ca4a50e0..987d110733b6 100644 --- a/docs/src/main/sphinx/connector/druid.rst +++ b/docs/src/main/sphinx/connector/druid.rst @@ -21,8 +21,8 @@ Create a catalog properties file that specifies the Druid connector by setting the ``connector.name`` to ``druid`` and configuring the ``connection-url`` with the JDBC string to connect to Druid. -For example, to access a database as ``druiddb``, create the file -``etc/catalog/druiddb.properties``. Replace ``BROKER:8082`` with the correct +For example, to access a database as ``druid``, create the file +``etc/catalog/druid.properties``. Replace ``BROKER:8082`` with the correct host and port of your Druid broker. .. code-block:: properties diff --git a/docs/src/main/sphinx/connector/memsql.rst b/docs/src/main/sphinx/connector/memsql.rst index 5be2f9aa8208..562533581d0d 100644 --- a/docs/src/main/sphinx/connector/memsql.rst +++ b/docs/src/main/sphinx/connector/memsql.rst @@ -20,8 +20,8 @@ Configuration ------------- To configure the SingleStore connector, create a catalog properties file -in ``etc/catalog`` named, for example, ``memsql.properties``, to -mount the SingleStore connector as the ``memsql`` catalog. +in ``etc/catalog`` named, for example, ``singlestore.properties``, to +mount the SingleStore connector as the ``singlestore`` catalog. Create the file with the following contents, replacing the connection properties as appropriate for your setup: @@ -32,10 +32,6 @@ connection properties as appropriate for your setup: connection-user=root connection-password=secret -.. include:: jdbc-common-configurations.fragment - -.. include:: non-transactional-insert.fragment - Multiple SingleStore servers ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -45,6 +41,10 @@ with a different name (making sure it ends in ``.properties``). For example, if you name the property file ``sales.properties``, Trino will create a catalog named ``sales`` using the configured connector. +.. include:: jdbc-common-configurations.fragment + +.. include:: non-transactional-insert.fragment + Querying SingleStore -------------------- diff --git a/docs/src/main/sphinx/connector/mysql.rst b/docs/src/main/sphinx/connector/mysql.rst index 12f4ace57f41..02b1fb39eb51 100644 --- a/docs/src/main/sphinx/connector/mysql.rst +++ b/docs/src/main/sphinx/connector/mysql.rst @@ -50,10 +50,6 @@ determine the user credentials for the connection, often a service user. You can use :doc:`secrets ` to avoid actual values in the catalog properties files. -.. include:: jdbc-common-configurations.fragment - -.. include:: non-transactional-insert.fragment - Multiple MySQL servers ^^^^^^^^^^^^^^^^^^^^^^ @@ -63,6 +59,10 @@ with a different name, making sure it ends in ``.properties``. For example, if you name the property file ``sales.properties``, Trino creates a catalog named ``sales`` using the configured connector. +.. include:: jdbc-common-configurations.fragment + +.. include:: non-transactional-insert.fragment + .. _mysql-type-mapping: Type mapping diff --git a/docs/src/main/sphinx/connector/oracle.rst b/docs/src/main/sphinx/connector/oracle.rst index bb641bf9079c..44b8b5becaeb 100644 --- a/docs/src/main/sphinx/connector/oracle.rst +++ b/docs/src/main/sphinx/connector/oracle.rst @@ -65,10 +65,6 @@ To disable connection pooling, update properties to include the following: oracle.connection-pool.enabled=false -.. include:: jdbc-common-configurations.fragment - -.. include:: non-transactional-insert.fragment - Multiple Oracle servers ^^^^^^^^^^^^^^^^^^^^^^^ @@ -77,7 +73,11 @@ the Oracle connector as a separate catalog. To add another Oracle catalog, create a new properties file. For example, if you name the property file ``sales.properties``, Trino creates a catalog named -sales. +``sales``. + +.. include:: jdbc-common-configurations.fragment + +.. include:: non-transactional-insert.fragment Querying Oracle --------------- diff --git a/docs/src/main/sphinx/connector/postgresql.rst b/docs/src/main/sphinx/connector/postgresql.rst index 2a847ca9279f..9583dccc873b 100644 --- a/docs/src/main/sphinx/connector/postgresql.rst +++ b/docs/src/main/sphinx/connector/postgresql.rst @@ -23,8 +23,8 @@ The connector can query a database on a PostgreSQL server. Create a catalog properties file that specifies the PostgreSQL connector by setting the ``connector.name`` to ``postgresql``. -For example, to access a database as the ``postgresqlsdb`` catalog, create the -file ``etc/catalog/postgresqlsdb.properties``. Replace the connection properties +For example, to access a database as the ``postgresql`` catalog, create the +file ``etc/catalog/postgresql.properties``. Replace the connection properties as appropriate for your setup: .. code-block:: text @@ -46,10 +46,6 @@ determine the user credentials for the connection, often a service user. You can use :doc:`secrets ` to avoid actual values in the catalog properties files. -.. include:: jdbc-common-configurations.fragment - -.. include:: non-transactional-insert.fragment - Multiple PostgreSQL databases or servers ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -63,6 +59,10 @@ with a different name, making sure it ends in ``.properties``. For example, if you name the property file ``sales.properties``, Trino creates a catalog named ``sales`` using the configured connector. +.. include:: jdbc-common-configurations.fragment + +.. include:: non-transactional-insert.fragment + .. _postgresql-type-mapping: Type mapping diff --git a/docs/src/main/sphinx/connector/redshift.rst b/docs/src/main/sphinx/connector/redshift.rst index af2f249f17f3..535eab586eec 100644 --- a/docs/src/main/sphinx/connector/redshift.rst +++ b/docs/src/main/sphinx/connector/redshift.rst @@ -31,10 +31,6 @@ connection properties as appropriate for your setup: connection-user=root connection-password=secret -.. include:: jdbc-common-configurations.fragment - -.. include:: non-transactional-insert.fragment - Multiple Redshift databases or clusters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -48,6 +44,10 @@ with a different name, making sure it ends in ``.properties``. For example, if you name the property file ``sales.properties``, Trino creates a catalog named ``sales`` using the configured connector. +.. include:: jdbc-common-configurations.fragment + +.. include:: non-transactional-insert.fragment + Querying Redshift ----------------- @@ -100,4 +100,4 @@ statements, the connector supports the following features: * :doc:`/sql/drop-schema` * :doc:`/sql/comment` -.. include:: sql-delete-limitation.fragment \ No newline at end of file +.. include:: sql-delete-limitation.fragment diff --git a/docs/src/main/sphinx/connector/sqlserver.rst b/docs/src/main/sphinx/connector/sqlserver.rst index 20e5391c7580..bf63d636efa8 100644 --- a/docs/src/main/sphinx/connector/sqlserver.rst +++ b/docs/src/main/sphinx/connector/sqlserver.rst @@ -23,8 +23,8 @@ The connector can query a single database on an SQL server instance. Create a catalog properties file that specifies the SQL server connector by setting the ``connector.name`` to ``sqlserver``. -For example, to access a database as ``sqlserverdb``, create the file -``etc/catalog/sqlserverdb.properties``. Replace the connection properties as +For example, to access a database as ``sqlserver``, create the file +``etc/catalog/sqlserver.properties``. Replace the connection properties as appropriate for your setup: .. code-block:: properties @@ -44,26 +44,22 @@ determine the user credentials for the connection, often a service user. You can use :doc:`secrets ` to avoid actual values in the catalog properties files. -.. include:: jdbc-common-configurations.fragment - -.. include:: non-transactional-insert.fragment - Multiple SQL Server databases or servers ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The SQL Server connector can't access more than one database using a single -catalog. +The SQL Server connector can only access a single SQL Server database +within a single catalog. Thus, if you have multiple SQL Server databases, +or want to connect to multiple SQL Server instances, you must configure +multiple instances of the SQL Server connector. -If you have multiple databases, or want to access multiple instances -of SQL Server, you need to configure one catalog for each instance. +To add another catalog, simply add another properties file to ``etc/catalog`` +with a different name, making sure it ends in ``.properties``. For example, +if you name the property file ``sales.properties``, Trino creates a +catalog named ``sales`` using the configured connector. -To add another catalog: - -- Add another properties file to ``etc/catalog`` -- Save it with a different name that ends in ``.properties`` +.. include:: jdbc-common-configurations.fragment -For example, if you name the property file ``sales.properties``, Trino uses the -configured connector to create a catalog named ``sales``. +.. include:: non-transactional-insert.fragment Querying SQL Server -------------------