Подключение к Trino через CLI

Компонент Trino Client

Сервис Trino содержит компонент Trino Client, который предоставляет интерфейс командной строки (CLI) для отправки SQL-запросов в Trino Coordinator. При установке компонента Trino Client он автоматически конфигурируется для работы с Trino Coordinator, доступным в кластере ADH.

Использование

Чтобы подключиться к Trino через CLI, на хосте ADH с установленным компонентом Trino Client выполните команду:

$ trino

Если подключение выполнено успешно — появится приглашение командной строки Trino:

trino>

Для просмотра доступных команд выполните команду help. Пример:

help
Supported commands:
QUIT
EXIT
CLEAR
EXPLAIN [ ( option [, ...] ) ] <query>
    options: FORMAT { TEXT | GRAPHVIZ | JSON }
            TYPE { LOGICAL | DISTRIBUTED | VALIDATE | IO }
DESCRIBE <table>
SHOW COLUMNS FROM <table>
SHOW FUNCTIONS
SHOW CATALOGS [LIKE <pattern>]
SHOW SCHEMAS [FROM <catalog>] [LIKE <pattern>]
SHOW TABLES [FROM <schema>] [LIKE <pattern>]
USE [<catalog>.]<schema>

Для очистки экрана терминала используйте команду clear. Для выхода из командной строки Trino и возврата в терминал ОС используйте команды exit или quit.

Выполнение выражений

После запуска командной строки Trino вы можете выполнять в ней SQL-выражения. После обработки выражения на экран будет выведен его результат и статистика. Пример:

select * from "hive-adh"."default"."solar_objects";
  name   |    mass    | diameter
---------+------------+----------
 Sun     | 1989100000 |  1392000
 Mercury |        330 |     4879
 Venus   |       4867 |    12104
 Earth   |       5972 |    12742
 Mars    |        642 |     6780
 Jupiter |    1898187 |   139822
 Saturn  |     568317 |   116464
 Uranus  |      86813 |    50724
 Neptune |     102413 |    49244
(9 rows)

Query 20250115_092203_00003_7thb6, FINISHED, 1 node
Splits: 1 total, 1 done (100,00%)
1,51 [9 rows, 172B] [5 rows/s, 114B/s]

В этом примере hive-adh — название каталога, default — имя схемы, а solar_objects — имя таблицы.

РЕКОМЕНДАЦИЯ
Используя настройки Trino Client в ADCM, можно указать каталог и схему Trino по умолчанию.

Настройка

По умолчанию компонент Trino Client сконфигурирован для работы с Trino Coordinator, доступным в кластере ADH, и не требует ручной настройки. Для тонкой настройки компонента Trino Client используйте настройки Trino Client в ADCM.

TLS/HTTPS

Компонент Trino Client поддерживает безопасное соединение с Trino Coordinator с использованием TLS. Для конфигурации безопасного соединения используйте раздел SSL Configuration в настройках компонента Trino Client в ADCM.

Удаленное подключение

Вы также можете подключиться к сервису Trino с удаленного хоста за пределами ADH-кластера. Для этого используйте клиент trino-cli. Он реализован с помощью JAR-файла, который может быть запущен в любой ОС при условии, что в ней установлена среда исполнения Java (Java Runtime Environment, JRE).

Для использования командной строки Trino нужно загрузить исполняемый JAR-файл. Ссылку на наиболее актуальный файл можно найти на сайте документации Trino. Если вы используете ОС Linux, переименуйте файл как trino и назначьте для него права на исполнение с помощью команды chmod +x. Если вы используете ОС Windows, запустите командную строку Windows от имени администратора перед запуском JAR-файла в ней.

Для запуска командной строки Trino откройте терминал в вашей ОС и используйте следующий синтаксис:

  • Windows

  • Linux

java -jar trino-cli-468-executable.jar http://coordinator.trino.example:18188
$ ./trino http://coordinator.trino.example:18188

При запуске командной строки Trino также можно использовать различные опции. Их список представлен на странице Command line interface документации Trino.

Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней