Одним из наиболее распространенных способов взаимодействия с базами данных в JVM является JDBC API .
JDBC расшифровывается как Java Database Connectivity, который представляет собой стандартный Java API для независимого от базы данных подключения между языком программирования Java и широким спектром баз данных.
Aerospike – это быстрая и надежная база данных NoSQL. У него есть свой собственный Java-клиент, но в этой статье вы познакомитесь с дополнительным способом взаимодействия с ним с помощью SQL.
Налейте себе чашку горячего чая или кофе (чтобы почувствовать себя настоящим Java), и мы погрузимся в детали путешествия Aerospike в мир JDBC.
Вступление
Драйвер Aerospike JDBC требует Java 8 и совместим с JDBC 4.2. Кроме того, требуется Aerospike server 5.2+, поскольку драйвер использует новые выражения Filter .
Первая версия драйвера JDBC поддерживает следующие инструкции SQL:
- выбирать
- вставлять
- ОБНОВЛЕНИЕ
- удалить
Вы также можете добавить условия WHERE и ОГРАНИЧИТЬ свои запросы. ОБЪЕДИНЕНИЯ, УПОРЯДОЧИВАНИЕ и ГРУППИРОВАНИЕ ПО не поддерживаются. С самого начала драйвер был разработан для поддержки операций, которые можно было бы выполнять с помощью обычного Java-клиента, без UDFS и других компонентов, требующих больших вычислений и памяти. Итак, первоначальное намерение состояло в том, чтобы сделать его небольшим и простым в запуске, без обходных путей для поддержки функций, которые не являются родными для базы данных Aerospike.
Драйвер не поддерживает функции SQL, а также типы данных Aerospike collection (CDTs) .
приступая к работе
Установите драйвер Aerospike JDBC и добавьте его местоположение в свой путь к классу. Вы можете взять файл JAR из releases/| , добавить Зависимость Maven или создайте ее из источников .
Драйвер Aerospike JDBC статически зарегистрирован в классе драйверов Aerospike. Таким образом, единственное, что требуется, – это загрузить этот класс.
Class.forName("com.aerospike.jdbc.AerospikeDriver").newInstance();
Следующее, что вам нужно будет сделать, это указать URL-адрес JDBC. Шаблон URL-адреса является:
jdbc:aerospike:HOST[:PORT][/NAMESPACE][?PARAM1=VALUE1[&PARAM2=VALUE2]
Например, URL-адрес jdbc:aerospike:localhost
подключится к базе данных Aerospike, работающей на локальном компьютере и прослушивающей порт по умолчанию (3000). URL-адрес jdbc:aerospike:172.17.0.5:3300/test
подключается к тестовому пространству имен в базе данных Aerospike, работающей на 172.17.0.5:3300.
После первоначальной настройки давайте посмотрим простой пример его использования:
try { String url = "jdbc:aerospike:localhost:3000/test"; Connection connection = DriverManager.getConnection(url); String query = "select * from ns1 limit 10"; ResultSet resultSet = connection.createStatement().executeQuery(query); while (resultSet.next()) { String bin1 = resultSet.getString("bin1"); System.out.println(bin1); } } catch (Exception e) { System.err.println(e.getMessage()); }
Клиентские инструменты JDBC
Вы можете просматривать и обрабатывать данные в Aerospike с помощью любого из доступных клиентских инструментов SQL, используя драйвер JDBC.
Существует ряд мультиплатформенных и бесплатных инструментов для работы с базами данных, таких как Бобр ,/| Белка и другие.
Ниже приведены шаги по настройке браузера Beaver SQL с помощью драйвера Aerospike JDBC:
- База данных -> Диспетчер драйверов -> Новые настройки заполнения:
- Имя водителя: Аэроспайк
- Тип драйвера: Универсальный
- Имя класса:
com.aerospike.jdbc. Водитель Аэроспайка
- Шаблон URL:
jdbc:aerospike:{хост}[:{порт}]/[{база данных}]
- Порт по умолчанию: 3000
- Нажмите кнопку
Добавить файл
и добавьте jar-файл JDBC. - Нажмите кнопку
Найти класс
. - Нажмите кнопку
OK
.
Создайте соединение:
- База данных -> Новое подключение к базе данных
- Выберите
Аэроспайк
и нажмитеДалее
. - Заполните настройки подключения
- Хост и порт
- База данных/схема: пространство имен, к которому вы подключаетесь
- Имя пользователя и пароль, если у вас включена защита в Aerospike Database Enterprise Edition
- Нажмите кнопку
Готово
.
Теперь вы можете открыть редактор SQL и запросить свой кластер Aerospike:
Резюме
Драйвер Aerospike JDBC находится на очень ранней стадии разработки. Было бы здорово, если бы вы могли попробовать это и дать нам некоторые отзывы. Любой вклад в проект очень приветствуется.
Ознакомьтесь с моей предыдущей серией Aerospike SQL, если вы еще этого не сделали.
И не забудьте подписаться на блог разработчика Aerospike, чтобы быть в курсе наших последних новостей.
Оригинал: “https://dev.to/aerospike/introducing-aerospike-jdbc-driver-4l14”