Link Search Menu Expand Document

Программное подключение

JDBC-драйвер системы позволяет подключаться программно (без использования SQL-клиента). Вы можете реализовать свое приложение, работающее с системой через JDBC-подключение.

Чтобы подключиться к системе с помощью программного подключения:

  1. Загрузите скомпилированный файл драйвера с именем dtm-jdbc-<version>.jar.
  2. Определите путь к jar-файлу драйвера любым из способов:
    1. задайте путь с помощью переменной окружения CLASSPATH;
    2. задайте путь в командной строке при запуске своего приложения (формат зависит от операционной системы):
      java -classpath /<path-to-driver>/dtm-jdbc-<version>.jar myapplication.class
      
  3. В реализации класса вашего приложения, который отвечает за подключение к системе (см. пример ниже):
    1. импортируйте пакеты Java SQL:
      import java.sql.*;
      
    2. если используется Java версии менее 1.6, загрузите драйвер в память:
      Class.forName("io.arenadata.dtm.jdbc.DtmDriver");
      
    3. установите соединение с системой с помощью метода DriverManager.getConnection() в следующем формате:
      String url = "jdbc:adtm://DtmHost:portNumber/logicalDatabaseName";
      Connection conn = DriverManager.getConnection(url, null, null);
      

Строка url содержит параметры:

  • DtmHost — IP-адрес или имя хоста, на котором установлена система;
  • portNumber — номер порта для подключения;
  • (опционально) logicalDatabaseName — имя логической базы данных, используемой по умолчанию.

Пример url:

String url = "jdbc:adtm://10.92.3.3:9092/demo";
Connection conn = DriverManager.getConnection(url, null, null);

После установки соединения можно выполнять запросы SQL+. По окончании работы с системой нужно закрыть подключение.

В примере ниже показана базовая реализация класса SimpleDtmJDBCExample, который устанавливает соединение с системой по заданному адресу и затем закрывает соединение.

import java.sql.*;
public class SimpleDtmJDBCExample {
    public static void main(String[] args) {
        Connection conn;
        String url = "jdbc:adtm://10.92.3.3:9092/demo";
        try {
            conn = DriverManager.getConnection(url);
            System.out.println("Connected");
        } catch (SQLException e) {
            // Catch all for the SQL exceptions
            e.printStackTrace();
        } finally {
            conn.close();
        }
}