Оформление
Справочник типов и портов
Страница для сверки: какие базы поддерживаются, на каком порту их искать и нужен ли догруженный драйвер. Для первого подключения это знать необязательно — начните с раздела Источники данных.
Какие типы есть
В платформе 23 типа источников.
| Категория | Типы |
|---|---|
| Базы данных | Apache Hive, Apache Spark, Arenadata DB, ArenaData QuickMarts, ClickHouse, CockroachDB, Firebird, Greenplum, H2, MariaDB, Microsoft SQL Server, MySQL, Oracle, PostgreSQL, Presto, Red, StarRocks, Trino, Vertica |
| Хранилище | Amazon Redshift |
| Файлы | Файл, S3 |
| API | OData (1С) |
Что скрывается за короткими названиями
Red — это Ред БД: форк Firebird. Подключается тем же драйвером Jaybird, что и Firebird, и этот драйвер в поставку не входит — его загружает администратор. Порт и правила подключения те же, что у Firebird.
Arenadata DB и ArenaData QuickMarts — отечественные сборки Greenplum и ClickHouse, см. родственные типы.
Отдельного типа для Postgres Pro и других сборок PostgreSQL нет: их подключают типом PostgreSQL — так же, как Greenplum и CockroachDB. Совместимость конкретной версии проверяйте на своём стенде: кнопка Проверить подключение отвечает до сохранения источника.
Набор доступных типов задаёт администратор — ненужные он может скрыть, см. Типы источников и драйверы.
Порты по умолчанию
Платформа подставляет порт сама, но подставленное значение стоит проверить: в вашей инсталляции база может слушать другой порт.
| Тип | Порт | Тип | Порт |
|---|---|---|---|
| PostgreSQL, Greenplum, Arenadata DB | 5432 | ClickHouse, ArenaData QuickMarts | 8123 |
| MySQL, MariaDB | 3306 | StarRocks | 9030 |
| Microsoft SQL Server | 1433 | Oracle | 1521 |
| Trino, Presto | 8080 | Apache Hive, Apache Spark | 10000 |
| Firebird, Red | 3050 | H2 | 9092 |
| Vertica | 5433 | Amazon Redshift | 5439 |
| CockroachDB | 26257 |
У типов «Файл», «S3» и «OData (1С)» порт не указывается: файлы порта не имеют, а у S3 и OData адрес задаётся целиком одной строкой.
Vertica: 5433, а не 5432
Порт Vertica отличается от порта PostgreSQL всего одной цифрой, и это самая частая опечатка при подключении. Больше ничего особенного Vertica не требует: хост, порт 5433, пользователь с паролем и загруженный драйвер.
Родственные типы
Некоторые типы — это одна и та же база под разными именами, и подключаются они общим драйвером: Greenplum, Arenadata DB и CockroachDB — драйвером PostgreSQL, ArenaData QuickMarts — драйвером ClickHouse, StarRocks — драйвером MySQL, Red — драйвером Firebird, а Apache Spark — драйвером Hive.
Отечественные сборки подключаются как их основа
Arenadata DB — сборка Greenplum: подключение то же самое, порт по умолчанию 5432, драйвер загружать не нужно. ArenaData QuickMarts — сборка ClickHouse, порт 8123. В справочнике они выделены отдельными типами только ради узнаваемого названия.
Драйверы
Драйвер нужен только JDBC-источникам, а их из 23 типов двадцать: «Файл», «S3» и «OData (1С)» подключаются не через JDBC, и драйвер им не требуется.
Девять типов работают сразу — их драйверы входят в поставку. Остальным одиннадцати нужен JAR-файл, который загружает администратор: сторонние драйверы не включают в поставку, чтобы их уязвимости не попадали в платформу.
Если драйвера нет, форма подключения предупредит об этом и не даст сохранить источник: см. Если драйвер типа не загружен. У источников, созданных до удаления драйвера, чтение данных отвечает ошибкой вида «Failed to load driver class». Это не проблема доступа к базе — нужен драйвер, и загружает его администратор.
Полный список — кто работает сразу, кому нужен файл и где его взять — в разделе Типы источников и драйверы. Там же лежат сами файлы.
Что дальше
- Подключение к базе данных — как завести источник выбранного типа.
- Типы источников и драйверы — что делает администратор, если типа нет в списке.