1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/opengauss-openGauss-connector-jdbc

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
README_en.md 14 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
Отправлено 10.03.2025 22:42 e505fd6

Логотип openGauss

Что такое openGauss-connector-jdbc

openGauss — это открытая система управления базами данных отношений. Она характеризуется многопоточной высокопроизводительной работой, полной связностью безопасности и интеллектуальным обслуживанием и управлением для корпоративных возможностей. Проект openGauss, начавшийся с PostgreSQL, объединяет многолетний опыт Huawei в области баз данных. Он оптимизирует архитектуру, транзакции, движок хранения, оптимизатор и архитектуру ARM. В то же время openGauss представляет собой глобальную открытую общественную базу данных, стремящуюся к развитию и расширению экосистемы программного обеспечения/железа для баз данных.

Java Database Connectivity (JDBC) представляет собой прикладной программный интерфейс (API) для языка программирования Java, который определяет, как клиент может получать доступ к базе данных. Это Java-технология для подключения к базе данных. Она предоставляет методы для запроса и обновления данных в базе данных и ориентирована на реляционные базы данных. openGauss-connector-jdbc предназначен для предоставления пользователям возможности подключения к базе данных через интерфейс приложения на языке Java. Пользователи могут использовать JAR-пакет, предоставленный официальным сайтом openGauss, или создать свой собственный JAR-пакет для работы с базой данных с помощью JDBC.## Прямое подключение

Перед использованием JDBC-драйвера openGauss убедитесь, что ваш сервер запущен и работает с базой данных openGauss (см. раздел Быстрый старт).

Получение из центрального репозитория Maven

Разработчики Java могут получать JAR-пакеты непосредственно из центрального репозитория Maven с помощью следующих координат:

<groupId>org.opengauss</groupId>
<artifactId>opengauss-jdbc</artifactId>

Получение с сайта сообщества

  1. Скачайте установочный пакет с официального сайта.

    Нажмите на ссылку и выберите кнопку "Скачать" для JDBC_${version} в разделе openGauss Connectors согласно системе сервера, где будет развернута база данных. ${version} — это номер версии, который вам нужен.

  2. Распакуйте ZIP-файл.

    tar -zxvf openGauss-${version}-JDBC.tar.gz
  3. После распаковки вы можете заметить два 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 драйвер создан для поддержки следующих операционных систем:

  • CentOS 7.6 (x86 архитектура)
  • openEuler-20.03-LTS (aarch64 архитектура)
  • openEuler-20.03-LTS (x86_64 архитектура)
  • openEuler-22.03-LTS (aarch64 архитектура)
  • openEuler-22.03-LTS (x86_64 архитектура)
  • openEuler-24.03-LTS (aarch64 архитектура)
  • openEuler-24.03-LTS (x86_64 архитектура)
  • WindowsНиже приведена таблица, содержащая требования к программному обеспечению для компиляции openGauss-connector-jdbc.

Рекомендуется использовать установленные по умолчанию пакеты зависимого программного обеспечения с указанных CD-ROM или источников операционных систем. Если указанное выше программное обеспечение отсутствует, обратитесь к рекомендованным версиям этого программного обеспечения. Требования к программному обеспечению и окружению следующие:

Программные требования и условия окружения Рекомендованная версия
Maven 3.6.1
Java 1.8
Git Bash (Windows) -

Скачивание openGauss-connector-jdbc

Вы можете скачать openGauss-connector-jdbc от сообщества открытого исходного кода.

git clone https://gitee.com/opengauss/openGauss-connector-jdbc.git

Теперь мы завершили скачивание исходного кода openGauss-connector-jdbc. Например, мы храним его в следующих директориях.

  • /sda/openGauss-connector-jdbc

Компиляция

Получение JAR-пакетов с помощью скрипта одного нажатия (Linux/Windows)

Файл build.sh в директории openGauss-connector-jdbc является важным средством для процесса компиляции. Это средство позволяет быстро компилировать и упаковывать код.Поэтому вы можете скомпилировать openGauss-connector-jdbc одной командой с использованием build.sh. В build.sh автоматически будут установлены Maven и Java 8, а затем они будут использоваться для сборки целевых объектов.1. Выполните следующую команду, чтобы перейти в директорию с кодом:

[user@linux sda]$ cd /sda/openGauss-connector-jdbc
  1. Выполните следующую команду, чтобы упаковать с помощью 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.

Получение JAR-пакетов с помощью команды mvn (Windows или Linux)

  1. Подготовьте окружение Java и Maven.

  2. Выполните следующую команду, чтобы перейти в директорию с кодом:

    [user@linux sda]$ cd /sda/openGauss-connector-jdbc
  3. Выполните команду 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

См. Разработка на основе JDBC.

Документация

Для получения более подробной информации о руководстве по установке, учебниках и API, см. Пользовательская документация.

Сообщество

Управление

Узнайте, как openGauss реализует открытую модель управления работы.

Коммуникация

  • WeLink - платформа связи для разработчиков.
  • IRC канал #opengauss-meeting (только для записи протокола заседаний)
  • Почтовый список: Коммуникация | openGauss

Вклад

Приветствуем ваши вклады. Для получения более подробной информации см. Вкладчики.

Примечания к выпускам

Для просмотра примечаний к выпускам, см. наш RELEASE.

Лицензия

MulanPSL-2.0

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/opengauss-openGauss-connector-jdbc.git
git@api.gitlife.ru:oschina-mirror/opengauss-openGauss-connector-jdbc.git
oschina-mirror
opengauss-openGauss-connector-jdbc
opengauss-openGauss-connector-jdbc
master