Перейти к содержимому
Последнее обновление

Paimon JDBC Catalog

В этом документе описаны параметры, поддерживаемые при подключении к службам метаданных Paimon Catalog и доступе к ним через интерфейс JDBC с помощью оператора CREATE CATALOG.

Примечание

Это экспериментальная функция, поддерживаемая начиная с версии 4.1.0.

Обзор параметров​

Имя свойстваОписаниеЗначение по умолчаниюОбязателен
paimon.jdbc.uriУказывает URI подключения JDBC-Да
paimon.jdbc.userИмя пользователя для подключения JDBC-Да
paimon.jdbc.passwordПароль для подключения JDBC-Да
warehouseУказывает хранилище Paimon-Да
paimon.jdbc.driver_classИмя класса драйвера JDBC, например org.postgresql.Driver, com.mysql.cj.jdbc.Driver и т. д.-Нет
paimon.jdbc.driver_urlПуть к JAR-файлу драйвера JDBC-Нет

Примечание:

  1. Paimon JDBC Catalog поддерживает различные реляционные базы данных в качестве внутреннего хранилища, включая PostgreSQL, MySQL и другие.

  2. Убедитесь, что JAR-файл драйвера JDBC доступен. Расположение драйвера можно указать с помощью paimon.jdbc.driver_url.

Начиная с версии 4.1.5, при создании или изменении Catalog расположение драйвера JDBC проверяется по единым правилам. Значение без схемы URI должно быть именем файла, соответствующим шаблону [A-Za-z0-9._-]+.jar; для абсолютного пути используйте file:///.... После URL-декодирования путь не должен содержать сегмент .., обозначающий родительский каталог. Существующие ограничения, связанные с безопасностью путей к драйверам и списком разрешённых URL, по-прежнему действуют.

Примеры конфигураций​

PostgreSQL в качестве хранилища метаданных​

Использование базы данных PostgreSQL для хранения метаданных Paimon:

CREATE CATALOG paimon_jdbc_postgresql PROPERTIES (
    'type' = 'paimon',
    'paimon.catalog.type' = 'jdbc',
    'paimon.jdbc.uri' = 'jdbc:postgresql://127.0.0.1:5432/paimon_db',
    'paimon.jdbc.user' = 'paimon_user',
    'paimon.jdbc.password' = 'password',
    'paimon.jdbc.driver_class' = 'org.postgresql.Driver',
    'paimon.jdbc.driver_url' = '<jdbc_driver_jar>',
    'warehouse' = 's3://bucket/warehouse',
    's3.access_key' = '<ak>',
    's3.secret_key' = '<sk>',
    's3.endpoint' = 'https://s3.us-east-1.amazonaws.com',
    's3.region' = 'us-east-1'
);

MySQL в качестве хранилища метаданных​

Использование базы данных MySQL для хранения метаданных Paimon:

CREATE CATALOG paimon_jdbc_mysql PROPERTIES (
    'type' = 'paimon',
    'paimon.catalog.type' = 'jdbc',
    'paimon.jdbc.uri' = 'jdbc:mysql://127.0.0.1:3306/paimon_db',
    'paimon.jdbc.user' = 'paimon_user',
    'paimon.jdbc.password' = 'password',
    'paimon.jdbc.driver_class' = 'com.mysql.cj.jdbc.Driver',
    'paimon.jdbc.driver_url' = '<jdbc_driver_jar>',
    'warehouse' = 's3://bucket/warehouse',
    's3.access_key' = '<ak>',
    's3.secret_key' = '<sk>',
    's3.endpoint' = 'https://s3.us-east-1.amazonaws.com',
    's3.region' = 'us-east-1'
);
Report issue