Процедура подключения сторонней базы по JDBC

=== Получение драйвера JDBC для БД ===

Например, для mariadb драйвер берётся с сайта [[https://mariadb.com/kb/en/about-mariadb-connector-j/]]

Cкачанный драйвер ({{ :pm:mariadb-java-client-3.1.2.jar |mariadb-java-client}}) размещаем в месте, которое доступно ''cacheusr'' например 
<code>/lib/jvm/jre/mariadb-java-client-3.1.2.jar</code>
	
данный ''jar'' содержит java-класс, который служит драйвером: ''org.mariadb.jdbc.Driver''

=== Настройка шлюза ===
не нашёл, как это сделать из интерфейса ''/csp/sys/mgr/%25CSP.UI.Portal.JDBCGatewayServer.zen?''
поэтому пропатчил ''%Net.Remote.Service:CmdLineForJava'', добавив
<code>Set tClassPath = tClassPath_":/lib/jvm/jre/mariadb-java-client-3.1.2.jar"</code>

после этого в интерфейсе при старте шлюза соответствующая команда отображается как
<code>Executing O.S. command: java -Xrs -classpath /opt/cache/dev/java/lib/JDK18/cache-gateway-2.0.0.jar:/opt/cache/dev/java/lib/JDK18/cache-jdbc-2.0.0.jar:/lib/jvm/jre/mariadb-java-client-3.1.2.jar com.intersys.gateway.JavaGateway "62972" "jdbcSqlGateway.log" "" "" "" 2>&1 </code>

если взять соответствующую команду, добавить в неё ''-verbose:class'', то grep'ом можно убедиться, что класс подгружается
<code>
java -Xrs -verbose:class -classpath /opt/cache/dev/java/lib/JDK18/cache-gateway-2.0.0.jar:/opt/cache/dev/java/lib/JDK18/cache-jdbc-2.0.0.jar:/lib/jvm/jre/mariadb-java-client-3.1.2.jar com.intersys.gateway.JavaGateway "62972" "jdbcSqlGateway.log" "" "" "" | grep mariadb
	
[Loaded org.mariadb.jdbc.Driver from file:/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.102-4.b14.el7.x86_64/jre/mariadb-java-client-3.1.2.jar]
[Loaded org.mariadb.jdbc.client.Client from file:/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.102-4.b14.el7.x86_64/jre/mariadb-java-client-3.1.2.jar]

</code>

Возможно, то же самое можно сделать программно, открыв соответствующий экземпляр 	''%Net.Remote.Java.JavaGateway'', можно посмотреть.

при необходимости в шлюзе указывается файл журнала, например ''jdbcSqlGateway.log'', тогда соединение будет логироваться в ''/opt/cache/mgr/jdbcSqlGateway.log''

=== Настройка соединения ===
Портал Управления - Администрирование системы - Соединения - Соединения SQL-шлюза

/csp/sys/mgr/UtilSqlGateways.csp

  * Тип соединения: JDBC
  * Имя соединения: указываем какое-то название
  * Пользователь и пароль указываются из тех, которые имеют доступ к нужной БД
  * Имя драйвера: ''org.mariadb.jdbc.Driver''
  * URL: [[|jdbc:mariadb://10.160.1.106:3306/elgg_n]]
  * где	
    * ''10.160.1.106'' - хост, на котором БД
    * ''3306'' - порт, на котором БД слушает входящие соединения (обычно 3306)
    * ''elgg_n'' - БД - обязательно к указанию, иначе при выполнении запросов будет ошибка, что не выбрана БД
		
При корректном указании параметров кнопка "Проверить соединение" выдаёт сообщение "Соединение удачно произведено."

=== Выполнение запросов ===
<code>
Set QHandle=$$GetJConnection^%apiGTW("testmysql")
</code>где ''testmysql'' - название соединения, определённого на предыдущем этапе

создаёт глобальную переменную ''%JDBCGateway'', которая является экземпляром класса ''%Net.Remote.Java.JDBCGateway''
	
и реализует собственно методы из JDBC API [[https://docs.oracle.com/javase/8/docs/technotes/guides/jdbc/]]
	
для подготовки обычного запроса (запрос может быть любым, поддерживаемым соответствующей БД, то есть не обязательно объявлять AS)
<code>
s QHandle	= %JDBCGateway.prepareStatement(QHandle,"select T1.id AS C1 from elgg_system_log AS T1;")
s QHandle	= %JDBCGateway.execQuery(QHandle)
s next		= %JDBCGateway.next(QHandle)
s id		= %JDBCGateway.getString(QHandle,1)

zw 
</code>
примеры использования можно поискать по области %SYS по %JDBCGateway

=== Подключение таблиц ===

в теории Cache предоставляет возможность выполнить маппинг внешних таблиц в таблицы Cache через Портал Управления - SQL - Wizards - "Связать таблицу"
	
при корректно настроенном соединении всё даже связывается, но запросы не выполняются: Cache оборачивает элементы запроса в кавычки следующим образом
	
<code> select T1."id" AS C1 from "elgg_system_log" AS T1 </code>
	
и в ответ получает ошибку, так как кавычки вокруг имени таблицы некорректны, не нашёл, как это исправить, и очевидно есть зависимость от версии БД :(