openGauss — это открытая система управления базами данных отношений. Она характеризуется многопоточной высокопроизводительной работой, полной связностью безопасности и интеллектуальным обслуживанием и управлением для корпоративных возможностей. Проект openGauss, начавшийся с PostgreSQL, объединяет многолетний опыт Huawei в области баз данных. Он оптимизирует архитектуру, транзакции, движок хранения, оптимизатор и архитектуру ARM. В то же время openGauss представляет собой глобальную открытую общественную базу данных, стремящуюся к развитию и расширению экосистемы программного обеспечения/железа для баз данных.
Java Database Connectivity (JDBC) представляет собой прикладной программный интерфейс (API) для языка программирования Java, который определяет, как клиент может получать доступ к базе данных. Это Java-технология для подключения к базе данных. Она предоставляет методы для запроса и обновления данных в базе данных и ориентирована на реляционные базы данных. openGauss-connector-jdbc предназначен для предоставления пользователям возможности подключения к базе данных через интерфейс приложения на языке Java. Пользователи могут использовать JAR-пакет, предоставленный официальным сайтом openGauss, или создать свой собственный JAR-пакет для работы с базой данных с помощью JDBC.## Прямое подключение
Перед использованием JDBC-драйвера openGauss убедитесь, что ваш сервер запущен и работает с базой данных openGauss (см. раздел Быстрый старт).
Разработчики Java могут получать JAR-пакеты непосредственно из центрального репозитория Maven с помощью следующих координат:
<groupId>org.opengauss</groupId>
<artifactId>opengauss-jdbc</artifactId>
Скачайте установочный пакет с официального сайта.
Нажмите на ссылку и выберите кнопку "Скачать" для JDBC_${version} в разделе openGauss Connectors согласно системе сервера, где будет развернута база данных. ${version} — это номер версии, который вам нужен.
Распакуйте ZIP-файл.
tar -zxvf openGauss-${version}-JDBC.tar.gz
После распаковки вы можете заметить два JAR-пакета в одной директории: opengauss-jdbc-${version}.jar и postgresql.jar. opengauss-jdbc-${version}.jar — это пакет, который может сосуществовать с PG-JDBC; имя пакета было изменено с 2.0.1 на org.postgresql.jar, а имя пакета postgresql было изменено на org.opengauss. Также был заменён драйвер JDBC с jdbc:postgresql:// на jdbc:opengauss://. Это тот же самый пакет, который доступен в настоящее время из центрального репозитория Maven.
Для установки драйвера файл postgresql.jar должен находиться в classpath.Пример для LINUX/SOLARIS (в данном примере используется моя линуксовая система):
export CLASSPATH=.:/usr/local/pgsql/share/java/postgresql.jar
или
export CLASSPATH=.:/usr/local/pgsql/share/java/opengauss-jdbc-${version}.jar
На данный момент openGauss JDBC драйвер предлагает три способа сборки. Первый — использование скрипта build.sh
для однокликовой сборки. Второй — шаг за шагом сборка через скрипт. Третий — сборка через команду mvn
.
Это скомпилирует правильный драйвер для вашей JVM и создаст JAR-файл (Java ARchive) с названием postgresql.jar
и opengauss-jdbc-${version}.jar
в директории output/
. Вы также сможете получить tar-архив openGauss-${version}-jdbc.tar.gz
.
Обратите внимание: postgresql.jar
конфликтует при использовании с базой данных PostgreSQL, так как все классы находятся в пакете org.postgresql
. opengauss-jdbc-${version}.jar
совместим с базой данных PostgreSQL, все Java-пакеты переименованы в org.opengauss
, а драйвер JDBC имеет следующее название: jdbc:opengauss://
.
Помните: после компиляции драйвера он будет работать на всех платформах, поддерживающих ту же версию API. Вам не нужно собирать его для каждой отдельной платформы.
openGauss JDBC драйвер создан для поддержки следующих операционных систем:
Рекомендуется использовать установленные по умолчанию пакеты зависимого программного обеспечения с указанных CD-ROM или источников операционных систем. Если указанное выше программное обеспечение отсутствует, обратитесь к рекомендованным версиям этого программного обеспечения. Требования к программному обеспечению и окружению следующие:
Программные требования и условия окружения | Рекомендованная версия |
---|---|
Maven | 3.6.1 |
Java | 1.8 |
Git Bash (Windows) | - |
Вы можете скачать openGauss-connector-jdbc от сообщества открытого исходного кода.
git clone https://gitee.com/opengauss/openGauss-connector-jdbc.git
Теперь мы завершили скачивание исходного кода openGauss-connector-jdbc. Например, мы храним его в следующих директориях.
Файл build.sh в директории openGauss-connector-jdbc является важным средством для процесса компиляции. Это средство позволяет быстро компилировать и упаковывать код.Поэтому вы можете скомпилировать openGauss-connector-jdbc одной командой с использованием build.sh. В build.sh автоматически будут установлены Maven и Java 8, а затем они будут использоваться для сборки целевых объектов.1. Выполните следующую команду, чтобы перейти в директорию с кодом:
[user@linux sda]$ cd /sda/openGauss-connector-jdbc
Выполните следующую команду, чтобы упаковать с помощью build.sh
:
[user@linux openGauss-connector-jdbc]$ sh build.sh
Когда процесс завершится, будет показана следующая информация, указывающая на успешную упаковку:
Успешно создан postgresql.jar
Успешно создан opengauss-jdbc-${версия} jar пакет
упаковка jdbc...
Успешно создан jdbc jar пакет в openGauss-${версия}-${платформа}-${бит}-Jdbc.tar.gz
очистка временной директории!
теперь все пакеты успешно собраны!!
После успешной компиляции появятся два JAR-пакета: opengauss-jdbc-${версия}.jar
и postgresql.jar
. Путь к скомпилированному JAR-пакету: /sda/openGauss-connector-jdbc/output.
Подготовьте окружение Java и Maven.
Выполните следующую команду, чтобы перейти в директорию с кодом:
[user@linux sda]$ cd /sda/openGauss-connector-jdbc
Выполните команду mvn
:
[user@linux openGauss-connector-jdbc]$ mvn clean install -Dgpg.skip -Dmaven.test.skip=true
Успешное выполнение сборки на системе Linux будет отображать следующий результат: [INFO] Reactor Summary: [INFO] [INFO] openGauss JDBC Driver ............................. SUCCESS [5.344 s] [INFO] PostgreSQL JDBC Driver aggregate .................. SUCCESS [0.004 s] [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Общее время: 5.439 s [INFO] Закончено в: Вт Авг 31 21:55:01 EDT 2021 [INFO] Конечная память: 44M/1763M [INFO] ------------------------------------------------------------------------
После успешной сборки появятся два JAR-пакета: opengauss-jdbc-`${version}`.jar и postgresql.jar. Путь к JAR-пакетам: /sda/openGauss-connector-jdbc/pgjdbc/target/.
Внимание: имя пакета сборочного артефакта — org.postgresql, что отличается от имени в Maven центральном репозитории. Если вы хотите создать пакет с именем org.opengauss, обратитесь к build.sh.
См. Разработка на основе JDBC.
Для получения более подробной информации о руководстве по установке, учебниках и API, см. Пользовательская документация.
Узнайте, как openGauss реализует открытую модель управления работы.
#opengauss-meeting
(только для записи протокола заседаний)Приветствуем ваши вклады. Для получения более подробной информации см. Вкладчики.
Для просмотра примечаний к выпускам, см. наш RELEASE.
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )