Подключение к Trino через JDBC
Обзор
Сервис Trino поддерживает пользовательский доступ из Java-приложений с использованием JDBC-драйвера. Он использует клиентский протокол через HTTP/HTTPS для подключения к компоненту Trino Coordinator.
Установка
Перед установкой JDBC-драйвера убедитесь, что выполнены следующие условия:
-
Установлена среда выполнения Java (JRE) версии 8 или выше. Рекомендуется использовать версию 22 или выше.
-
Пользователи, от имени которых предполагается подключение к таблицам с помощью Trino, должны иметь права доступа, определенные в схеме
system.jdbc. -
Компонент Trino Coordinator должен быть доступен в сети.
Некоторые клиентские приложения уже имеют встроенный JDBC-драйвер Trino. Если в вашем приложении его нет, загрузите файл драйвера самостоятельно. Ссылку на наиболее актуальный файл можно найти на сайте документации Trino или в центральном репозитории Maven. Добавьте загруженный файл в директорию, записанную в classpath пользователей на тех машинах, с которых предполагается осуществлять доступ к Trino, и перезапустите клиентское приложение. Возможно, потребуется вручную зарегистрировать JDBC-драйвер Trino в клиентском приложении: некоторые из них делают это автоматически, некоторые — нет. За инструкциями по регистрации драйвера обратитесь к документации вашего клиентского приложения.
Использование
Подключение
После регистрации и настройки JDBC-драйвера Trino в клиентском приложении вы можете подключаться к Trino. Используйте следующие форматы JDBC URL:
jdbc:trino://<host>:<port> jdbc:trino://<host>:<port>/<catalog> jdbc:trino://<host>:<port>/<catalog>/<schema>
где:
-
<host>— сетевой адрес узла компонента Trino Coordinator; -
<port>— порт прослушивания компонента Trino Coordinator (значение по умолчанию: 18188); -
<catalog>— название каталога Trino; -
<schema>— имя БД или схемы для подключения.
Параметры подключения
Можно задать дополнительные параметры подключения как параметры URL или как свойства, передаваемые классу DriverManager. Например, вам нужно подключиться к Trino с использованием следующих параметров:
-
сетевой адрес и порт —
myorganization.org:18188; -
каталог и схема —
hive/tech; -
пользователь —
admin; -
пароль —
MySecretPassword1984.
В этом случае необходимо использовать следующие параметры URL:
String mycustomurl = "jdbc:trino://myorganization.org:18188/hive/tech?user=admin&password=MySecretPassword1984";
Connection connection = DriverManager.getConnection(mycustomurl);Или если вы хотите передать параметры подключения классу DriverManager, задайте следующие свойства:
String url = "jdbc:trino://myorganization.org:18188/hive/tech";
Properties mycustomproperties = new Properties();
mycustomproperties.setProperty("user", "admin");
mycustomproperties.setProperty("password", "MySecretPassword1984");
Connection connection = DriverManager.getConnection(url, mycustomproperties);Можно использовать комбинацию этих подходов, но дублирование параметров запрещено: параметр, заданный одним способом, нельзя задавать другим.
Список доступных параметров приведен на странице JDBC driver документации Trino.