برنامج تشغيل JDBC

​

متطلبات البيئة

• OpenJDK الإصدار >= 8

​

الإعداد

{/* https://mvnrepository.com/artifact/com.clickhouse/clickhouse-jdbc */}
<dependency>
    <groupId>com.clickhouse</groupId>
    <artifactId>clickhouse-jdbc</artifactId>
    <version>0.9.8</version>
    <classifier>all</classifier>
</dependency>

// https://mvnrepository.com/artifact/com.clickhouse/clickhouse-jdbc
implementation("com.clickhouse:clickhouse-jdbc:0.9.8:all")

// https://mvnrepository.com/artifact/com.clickhouse/clickhouse-jdbc
implementation 'com.clickhouse:clickhouse-jdbc:0.9.8:all'

• Maven Central ثم أضِفه إلى classpath
  • بدءًا من الإصدار 0.9.4، تتوفر الحزمة https://mvnrepository.com/artifact/com.clickhouse/clickhouse-jdbc-all
  • استخدم اللاحقة all للحصول على ملف jar يتضمن جميع التبعيات المدمجة.
• أو من repository الرسمي هنا

​

الإعداد

• jdbc:clickhouse:http://localhost:8123
• jdbc:clickhouse:https://localhost:8443?ssl=true

• يُسمح بوجود نقطة نهاية واحدة فقط في URL
• يجب تحديد البروتوكول إذا لم يكن البروتوكول الافتراضي، وهو ‘HTTP’
• يجب تحديد المنفذ إذا لم يكن المنفذ الافتراضي ‘8123’
• لا يستنتج المُشغِّل البروتوكول من المنفذ، لذا يجب تحديده صراحةً
• لا تكون المعلَمة ssl مطلوبة عند تحديد البروتوكول.

​

خصائص الاتصال

Properties config = new Properties();
config.setProperty("user", "default");
config.setProperty("password", getPassword());

// set server setting
config.put(ClientConfigProperties.serverSetting("allow_experimental_time_time64_type"), "1");

Connection conn = Driver.connect("jdbc:ch:http://localhost:8123/", config);

Properties properties = new Properties();
properties.setProperty("user", "default");
properties.setProperty("password", getPassword());
properties.setProperty("client_name", "my-app-01"); // when http protocol is used it will be `http_user_agent` in the query log but not `client_name`.

Connection conn = Driver.connect("jdbc:ch:http://localhost:8123/", properties);

jdbc:ch:http://localhost:8123/?user=default&password=password&client_name=my-app-01 
// credentials shoud be passed in `Properties`. Here it is just for example.

​

تعريف العميل

Properties properties = new Properties();
properties.setProperty(ClientConfigProperties.CLIENT_NAME.getKey(), "my-app-01");
Connection conn = Driver.connect("jdbc:ch:http://localhost:8123/", properties);

conn.setClientInfo(com.clickhouse.jdbc.ClientInfoProperties.APPLICATION_NAME.getKey(), "my-app-01");

my-app-01/1.0 jdbc-v2/0.9.7 clickhouse-java-v2/0.9.6 (Linux; jvm:17.0.17) Apache-HttpClient/5.4.4

​

تحديد العملية

StatementImpl stmt = (StatementImpl) conn.createStatement();
stmt.getLocalSettings().logComment("some-comment");

​

أنواع البيانات المدعومة

​

تعيين أنواع JDBC

• ResultSet#getObject(columnIndex) - تُعيد الطريقة كائنًا من فئة Java المقابلة. (Int8 -> java.lang.Byte, Int16 -> java.lang.Short, إلخ.)
• ResultSetMetaData#getColumnType(columnIndex) - تُعيد الطريقة نوع JDBC المقابل. (Int8 -> java.lang.Byte, Int16 -> java.lang.Short, إلخ.)

• ResultSet#getObject(columnIndex, class) - ستحاول هذه الطريقة تحويل القيمة إلى النوع class. توجد بعض القيود على هذا التحويل. راجع كل قسم للاطلاع على التفاصيل.

• الأنواع الرقمية قابلة للتحويل فيما بينها. لذا يمكن الحصول على Int8 بصيغة Float64 والعكس صحيح.:
  • سيُرجع rs.getObject(1, Float64.class) قيمة Float64 من Int8 column.
  • سيُرجع rs.getLong(1) قيمة Long من Int8 column.
  • يمكن أن يُرجع rs.getByte(1) قيمة Byte من Int16 column إذا كانت ضمن نطاق Byte.
• لا يُنصح بالتحويل من نوع أوسع إلى نوع أضيق بسبب خطر تلف البيانات.
• يتعامل النوع Bool أيضًا على أنه عدد.
• يمكن قراءة جميع الأنواع العددية على أنها java.lang.String.
• توجد مشكلة عند تخزين Float.MAX_VALUE في Java بوصفه Float (https://github.com/ClickHouse/clickhouse-java/issues/809). ويؤدي حفظ القيمة نفسها بوصفها Double إلى حل هذه المشكلة.

• لا يمكن قراءة String إلا باعتباره java.lang.String أو byte[].
• تُقرأ FixedString كما هي، وتُحشى بأصفار حتى يصل طولها إلى طول العمود. (على سبيل المثال، ستُقرأ FixedString(10) للقيمة 'John' على أنها 'John\0\0\0\0\0\0\0\0\0'.)

• يُعيَّن Enum8 وEnum16 إلى java.lang.String افتراضيًا.
• يمكن قراءة قيم Enum كقيم رقمية باستخدام دالة getter المخصّصة أو الدالة getObject(columnIndex, Integer.class).
• يُعيَّن Enum16 داخليًا إلى short، ويُعيَّن Enum8 إلى byte. ويجب تجنّب قراءة Enum16 على أنه byte بسبب خطر تلف البيانات.
• يمكن تعيين قيم Enum كسلسلة نصية أو كقيمة رقمية في PreparedStatement.

• تُطابَق أنواع Date / Time مع أنواع java.sql لتحسين التوافق مع JDBC. ومع ذلك، يمكن أيضًا الحصول على java.time.LocalDate وjava.time.LocalDateTime وjava.time.LocalTime باستخدام ResultSet#getObject(columnIndex, Class<T>) مع تمرير الفئة المقابلة بوصفها الوسيط الثاني.
  • ستُعيد rs.getObject(1, java.time.LocalDate.class) القيمة java.time.LocalDate من العمود Date.
  • ستُعيد rs.getObject(1, java.time.LocalDateTime.class) القيمة java.time.LocalDateTime من العمود DateTime.
  • ستُعيد rs.getObject(1, java.time.LocalTime.class) القيمة java.time.LocalTime من العمود Time.
• لا تتأثر Date وDate32 وTime وTime64 بالمنطقة الزمنية للخادم.
• يتأثر DateTime وDateTime64 بالمنطقة الزمنية للخادم أو بالمنطقة الزمنية للجلسة.
• يمكن استرجاع DateTime وDateTime64 كـ ZonedDateTime باستخدام getObject(colIndex, ZonedDateTime.class).

• يُعيَّن Array إلى java.sql.Array افتراضيًا لضمان التوافق مع JDBC. ويُجرى ذلك أيضًا لتوفير مزيد من المعلومات عن قيمة المصفوفة المُعادة. وهذا مفيد في استدلال النوع.
• يوفّر Array التابع getResultSet() لإرجاع java.sql.ResultSet بالمحتوى نفسه الموجود في المصفوفة الأصلية.
• لا ينبغي قراءة أنواع المجموعات باعتبارها java.lang.String لأن هذه ليست طريقة صالحة لتمثيل البيانات (على سبيل المثال: لا تُوضَع قيم السلاسل النصية بين علامتَي اقتباس في المصفوفة).
• يُعيَّن Map إلى OTHER لأن القيمة لا يمكن قراءتها إلا باستخدام الطريقة getObject(columnIndex, Class<T>).
  • لا يُعَدّ Map من نوع java.sql.Struct لأنه لا يحتوي على أعمدة مُسمّاة.
• يتم تمثيل Tuple على شكل Object[] لأنه قد يحتوي على أنواع مختلفة، كما أن استخدام List غير صالح.
• يمكن قراءة Tuple باعتباره Array باستخدام الطريقة getObject(columnIndex, Array.class). في هذه الحالة، ستُعيد Array#baseTypeName تعريف العمود Tuple.

• يتم الاحتفاظ بالأنواع المغلِّفة (Nullable, LowCardinality) في getBaseTypeName()، لكن getBaseType() يُرجِع رمز JDBC للنوع الداخلي.
• تُسطَّح المصفوفات المتداخلة في البيانات الوصفية: يُرجِع getBaseTypeName() نوع العنصر الأعمق غير المصفوفي، وليس العنصر الفرعي المباشر.
• تحتفظ الأنواع ذات المعلمات (FixedString(N)، والتعريفات الكاملة لـ Enum/Tuple) بمعلماتها في getBaseTypeName().

• في V2، تحتفظ getBaseTypeName() بتوقيع النوع الكامل، بما في ذلك أنواع التغليف (Nullable وLowCardinality) ومعلّمات النوع (FixedString(8) وتعريفات Enum وTuple الكاملة). أما V1 فيُزيل هذه ويُرجع اسم النوع الأساسي فقط.
• تستخدم مصفوفات Tuple القيمة OTHER (1111) في V2 بدلًا من STRUCT (2002) لأن Tuple في ClickHouse تتضمن حقولًا مسمّاة، وهو ما لا يدعمه java.sql.Struct.
• تستخدم مصفوفات UUID القيمة OTHER (1111) في V2، بما يتوافق مع تعيين UUID القياسي.
• تُعيَّن قيم Enum إلى VARCHAR — إذ تُحدَّد عناصر enum باسمها النصي بغضّ النظر عن ترميزها الرقمي الأساسي.

• typeName - اسم نوع عناصر المصفوفة. على سبيل المثال Array(Int32) -> "Int32".
• elements - عناصر المصفوفة نفسها. على سبيل المثال [[1, 2, 3], [4, 5, 6]] -> new Integer[][] {{1, 2, 3}, {4, 5, 6}}.

try (Connection conn = ...) {
    Array array = conn.createArrayOf("Int32", new Integer[][] {{1, 2, 3}, {4, 5, 6}});
    try (PreparedStatement ps = conn.prepareStatement("INSERT INTO mytable (arr) VALUES (?)")) {
        ps.setArray(1, array);
        ps.executeUpdate();
    }
}

try (Connection conn = ...) {
    try (PreparedStatement ps = conn.prepareStatement("SELECT ?::Array(Int32)")) {
        ps.setArray(1, array);
        try (ResultSet rs = ps.executeQuery()) {
            while (rs.next()) {
                Array array = rs.getArray(1);

                Object[] arr = (Object[]) array;
                Arrays.stream(arr).forEach(this::handleArrayElement);

                // or by using `ResultSet`
                ResultSet resultSet = array.getResultSet();
                while (resultSet.next()) {
                    // ...
                }
            }
        }
    } 
}

try (Connection conn = ...) {
    Tuple tuple = new Tuple(1, "test", LocalDate.parse("2026-03-02"));
    try (PreparedStatement ps = conn.prepareStatement("INSERT INTO mytable (tuple) VALUES (?)")) {
        ps.setObject(1, tuple);
        ps.executeUpdate();
    }
}

try (Connection conn = ...) {
    Struct struct = conn.createStruct("Tuple(Int32, String, Date)", new Object[] {1, "test", LocalDate.parse("2026-03-02")});
    try (PreparedStatement ps = conn.prepareStatement("INSERT INTO mytable (tuple) VALUES (?)")) {
        ps.setStruct(1, struct);
        ps.executeUpdate();
    }
}

try (Connection conn = ...) {
    try (PreparedStatement stmt = conn.prepareStatement("SELECT ?::Tuple(String, Int32, Date)")) {
        Array tuple = conn.createArrayOf("Tuple(String, Int32, Date)",  new Object[]{"test", 123, LocalDate.parse("2026-03-02")});
        stmt.setObject(1, tuple);
        try (ResultSet rs = stmt.executeQuery()) {
            rs.next();
            Array dbTuple = rs.getArray(1);
            Assert.assertEquals(dbTuple, tuple);
            Object arr = rs.getObject(1);
            Assert.assertEquals(arr, tuple.getArray());
        }
    }
}

try (Connection conn = ...) {
    Map<String, Integer> map = new HashMap<>();
    map.put("key1", 1);
    map.put("key2", 2);
    try (PreparedStatement ps = conn.prepareStatement("INSERT INTO mytable (map) VALUES (?)")) {
        ps.setObject(1, map);
        ps.executeUpdate();
    }
}

try (Connection conn = ...) {
    try (PreparedStatement ps = conn.prepareStatement("SELECT ?::Map(String, Int32)")) {
        ps.setStruct(1, struct);
        try (ResultSet rs = ps.executeQuery()) {
            while (rs.next()) {
                Map<String, Integer> map = rs.getObject(1, Map.class);
                // ...
            }
        }
    }
}

• typeName - اسم نوع العناصر المتداخلة. على سبيل المثال Nested(Tuple(Int32, String)) -> "Nested(Tuple(Int32, String))".
• elements - العناصر المتداخلة نفسها. على سبيل المثال [1, 'test'] -> new Object[] {1, 'test'}.

try (Connection conn = ...) {
    Struct struct = conn.createStruct("Nested(Tuple(Int32, String))", new Object[] {1, 'test'});
    try (PreparedStatement ps = conn.prepareStatement("INSERT INTO mytable (nested) VALUES (?)")) {
        ps.setStruct(1, struct);
        ps.executeUpdate();
    }
}

try (Connection conn = ...) {
    try (PreparedStatement ps = conn.prepareStatement("SELECT ?::Nested(Tuple(Int32, String))")) {
        ps.setStruct(1, struct);
        try (ResultSet rs = ps.executeQuery()) {
            while (rs.next()) {
                Struct struct = rs.getStruct(1);
                Object[] tuple = (Object[]) struct;
                Arrays.stream(tuple).forEach(this::handleTupleElement);

                // or by using `ResultSet`
                ResultSet resultSet = struct.getResultSet();
                while (resultSet.next()) {
                    // ...
                }
            }
        }
    }
}

• Nullable و LowCardinality نوعان خاصّان يغلّفان أنواعًا أخرى.
• يؤثّر Nullable على كيفية إرجاع أسماء الأنواع في ResultSetMetaData

• لا يُعد UUID نوعًا قياسيًا في JDBC. لكنه جزء من JDK. بشكل افتراضي، يُعاد java.util.UUID من الطريقة getObject().
• يمكن قراءة UUID وكتابته على هيئة String باستخدام الطريقة getObject(columnIndex, String.class).
• لا يُعد IPv4 وIPv6 نوعين قياسيين في JDBC. لكنهما جزء من JDK. بشكل افتراضي، يُعاد java.net.Inet4Address وjava.net.Inet6Address من الطريقة getObject().
• يمكن قراءة IPv4 وIPv6 وكتابتهما على هيئة String باستخدام الطريقة getObject(columnIndex, String.class).

{
    "key1": "value1",
    "key2": ["value2", "value3"]
    "key3": {
        "key4": "value4",
        "key5": "value5"
    }
}

Map<String, Object> map = new HashMap<>();
map.put("key1", "value1");
map.put("key2", Arrays.asList("value2", "value3"));
map.put("key3", new HashMap<String, Object>() {{
    put("key4", "value4");
    put("key5", "value5");
}});

Properties properties = new Properties();
properties.setProperty(
                ClientConfigProperties.serverSetting(ServerSettings.OUTPUT_FORMAT_BINARY_WRITE_JSON_AS_STRING),
                "1");
try (Connection conn = DriverManager.getConnection(url, properties)) {
     try (ResultSet rs = stmt.executeQuery("SELECT * FROM test_json ORDER BY order")) {
        while (rs.next()) {
            String json = rs.getString("json");
            // ...
        }
    }
}

Properties properties = new Properties();
properties.put(ClientConfigProperties.serverSetting("output_format_json_quote_64bit_integers"), "0");
properties.put(ClientConfigProperties.serverSetting("output_format_json_quote_64bit_floats"), "0");
properties.put(ClientConfigProperties.serverSetting("output_format_json_quote_decimals"), "0");

​

التعامل مع التواريخ والأوقات والمناطق الزمنية

​

إنشاء اتصال

String url = "jdbc:ch://my-server:8123/system";

Properties properties = new Properties();
DataSource dataSource = new DataSource(url, properties);//DataSource or DriverManager are the main entry points
try (Connection conn = dataSource.getConnection()) {
... // do something with the connection

​

توفير بيانات الاعتماد والإعدادات

String url = "jdbc:ch://localhost:8123?jdbc_ignore_unsupported_values=true&socket_timeout=10";

Properties info = new Properties();
info.put("user", "default");
info.put("password", "password");
info.put("database", "some_db");

//Creating a connection with DataSource
DataSource dataSource = new DataSource(url, info);
try (Connection conn = dataSource.getConnection()) {
... // do something with the connection
}

//Alternate approach using the DriverManager
try (Connection conn = DriverManager.getConnection(url, info)) {
... // do something with the connection
}

​

عبارة بسيطة

try (Connection conn = dataSource.getConnection(...);
    Statement stmt = conn.createStatement()) {
    ResultSet rs = stmt.executeQuery("select * from numbers(50000)");
    while(rs.next()) {
        // ...
    }
}

​

إدراج

try (PreparedStatement ps = conn.prepareStatement("INSERT INTO mytable VALUES (?, ?)")) {
    ps.setString(1, "test"); // id
    ps.setObject(2, LocalDateTime.now()); // timestamp
    ps.addBatch();
    ...
    ps.executeBatch(); // stream everything on-hand into ClickHouse
}

​

HikariCP

// connection pooling won't help much in terms of performance,
// because the underlying implementation has its own pool.
// for example: HttpURLConnection has a pool for sockets
HikariConfig poolConfig = new HikariConfig();
poolConfig.setConnectionTimeout(5000L);
poolConfig.setMaximumPoolSize(20);
poolConfig.setMaxLifetime(300_000L);
poolConfig.setDataSource(new ClickHouseDataSource(url, properties));

try (HikariDataSource ds = new HikariDataSource(poolConfig);
     Connection conn = ds.getConnection();
     Statement s = conn.createStatement();
     ResultSet rs = s.executeQuery("SELECT * FROM system.numbers LIMIT 3")) {
    while (rs.next()) {
        // handle row
        log.info("Integer: {}, String: {}", rs.getInt(1), rs.getString(1));//Same column but different types
    }
}

​

مزيد من المعلومات

​

استكشاف الأخطاء وإصلاحها

​

التسجيل

​

حل مشكلة انتهاء مهلة JDBC عند عمليات الإدراج الكبيرة

Caused by: java.sql.SQLException: Read timed out, server myHostname [uri=https://hostname.aws.clickhouse.cloud:8443]

​

Mac OS

• net.inet.tcp.keepidle: 60000
• net.inet.tcp.keepintvl: 45000
• net.inet.tcp.keepinit: 45000
• net.inet.tcp.keepcnt: 8
• net.inet.tcp.always_keepalive: 1

​

Linux

1. عدّل معلمات نواة Linux التالية في /etc/sysctl.conf أو في ملف تهيئة ذي صلة:

• net.inet.tcp.keepidle: 60000
• net.inet.tcp.keepintvl: 45000
• net.inet.tcp.keepinit: 45000
• net.inet.tcp.keepcnt: 8
• net.inet.tcp.always_keepalive: 1
• net.ipv4.tcp_keepalive_intvl: 75
• net.ipv4.tcp_keepalive_probes: 9
• net.ipv4.tcp_keepalive_time: 60 (قد ترغب في خفض هذه القيمة من القيمة الافتراضية البالغة 300 ثانية)

2. بعد تعديل معلمات النواة، طبِّق التغييرات عن طريق تشغيل الأمر التالي:

sudo sysctl -p

properties.setProperty("socket_keepalive", "true");

​

دليل الترحيل

​

التغييرات الرئيسية

• صُمم JDBC V2 ليكون أخف، وأزيلت منه بعض الميزات.
  • البيانات المتدفقة غير مدعومة في JDBC V2 لأنها ليست جزءًا من مواصفة JDBC ولا من Java.
• يتطلب JDBC V2 إعدادًا صريحًا. لا توجد إعدادات افتراضية للتجاوز التلقائي.
  • يجب تحديد البروتوكول في عنوان URL. لا يتم اكتشاف البروتوكول ضمنيًا بالاعتماد على أرقام المنافذ.

​

تغييرات الإعداد

• com.clickhouse.jdbc.DriverProperties - خصائص التهيئة الخاصة ببرنامج التشغيل.
• com.clickhouse.client.api.ClientConfigProperties - خصائص تهيئة العميل. التغييرات على تهيئة العميل موضحة في وثائق Java Client.

• يُحلَّل URL أولًا لاستخراج الخصائص. وتتجاوز هذه الخصائص جميع الخصائص الأخرى.
• لا تُمرَّر خصائص برنامج التشغيل إلى العميل.
• تُستخرَج نقاط النهاية (host وport وprotocol) من URL.

String url = "jdbc:ch://my-server:8443/default?" +
            "jdbc_ignore_unsupported_values=true&" +
            "socket_rcvbuf=800000";

Properties properties = new Properties();
properties.setProperty("socket_rcvbuf", "900000");
try (Connection conn = DriverManager.getConnection(url, properties)) {
    // Connection will use socket_rcvbuf=800000 and jdbc_ignore_unsupported_values=true
    // Endpoints: my-server:8443 protocol: http (not secure)
    // Database: default
}

​

تغييرات أنواع البيانات

• أكبر اختلاف هو أن الأنواع غير الموقَّعة تُحوَّل إلى أنواع Java لتحسين قابلية النقل.

• تتم قراءة FixedString كما هي في كلا الإصدارين. على سبيل المثال، ستُقرأ FixedString(10) للقيمة 'John' على أنها 'John\0\0\0\0\0\0\0\0\0'.
• عند استخدام PreparedStatement#setBytes، سيتم تحويله إلى unhex('<hex_string>') ثم تُقرأ القيمة كنوع String.
• تُخزَّن السلاسل النصية بترميز UTF-8.

• يقتصر دعم Time وTime64 في V2 على كونهما نوعين جديدين.
• يُحوَّل DateTime وDateTime64 إلى java.sql.Timestamp لتحقيق توافق أفضل مع JDBC.

• في V2، يُعيَّن Array إلى java.sql.Array افتراضيًا لضمان التوافق مع JDBC. ويُجرى ذلك أيضًا لتوفير معلومات إضافية عن قيمة المصفوفة المُعادة. وهذا مفيد في type inference.
• في V2، يطبّق Array الطريقة getResultSet() لإرجاع java.sql.ResultSet بالمحتوى نفسه الموجود في المصفوفة الأصلية.
• يستخدم V1 STRUCT مع Map، لكنه يعيد دائمًا الكائن java.util.Map. ويعالج V2 ذلك من خلال تعيين Map إلى JAVA_OBJECT.
• يستخدم V1 STRUCT مع Tuple، لكنه يعيد دائمًا الكائن List<Object>. ويُعيّن V2 Tuple إلى OTHER ويعيد Object[] افتراضيًا.
• يقدّم V2 ‏com.clickhouse.data.Tuple#Tuple لكتابة قيم tuple. وهذا يسهّل تحديد ما إذا كانت القيمة tuple أم مصفوفة.
• لا يمكن استخدام PreparedStatement#setBytes وResultSet#getBytes مع أنواع المجموعات. فقد صُمّمت هاتان الطريقتان للعمل مع السلاسل الثنائية.
• عادةً ما يُستخدم java.sql.Array لكتابة أنواع Array وقراءتها. ويوفّر JDBC driver دعمًا كاملًا لذلك.
• في V2، يُعيَّن Nested إلى Array ويعرضه كمصفوفة من tuples.
• يوفّر V2 دعمًا جزئيًا لـ java.sql.Struct لأنه يشبه جدًا النوع Array ولا يدعم key-value pairs. ويمكن استخدام Struct لكتابة قيم Tuple.

• Nullable وLowCardinality نوعان خاصّان يغلّفان أنواعًا أخرى.
• لا تطرأ أي تغييرات على هذين النوعين في V2.

• يستخدم V1 النوع VARCHAR مع UUID، لكنه يعيد دائمًا الكائن java.util.UUID. ويعالج V2 هذا الأمر من خلال تعيين UUID إلى OTHER، ثم يعيد الكائن java.util.UUID.
• يستخدم V1 النوع VARCHAR مع IPv4 وIPv6، لكنه يعيد دائمًا الكائنين java.net.Inet4Address وjava.net.Inet6Address. ويعالج V2 هذا الأمر من خلال تعيين IPv4 وIPv6 إلى OTHER، ثم يعيد الكائنين java.net.Inet4Address وjava.net.Inet6Address.
• Dynamic وVariant نوعان جديدان في V2. ولا يدعمهما V1.
• يعتمد JSON على النوع Dynamic. لذلك فهو مدعوم فقط في V2.
• يمكن قراءة قيم IPv4 وIPv6 على هيئة byte[] باستخدام الدالة getBytes(columnIndex). ومع ذلك، يُوصى باستخدام الفئات المخصّصة لهذه الأنواع.
• لا يدعم V2 قراءة عنوان IP على أنه من القيم العددية، لأن التحويل مُنفَّذ بصورة أفضل في فئات InetAddress.

​

تغييرات البيانات الوصفية لقاعدة البيانات

• يستخدم V2 المصطلح Schema فقط لتسمية قواعد البيانات. أما المصطلح Catalog فمحجوز للاستخدام المستقبلي.
• يعيد V2 القيمة false لكل من DatabaseMetaData.supportsTransactions() وDatabaseMetaData.supportsSavepoints(). سيتغير ذلك في الإصدارات القادمة.
• في DatabaseMetaData.getTypeInfo()، يُرجِع العمودان LITERAL_PREFIX وLITERAL_SUFFIX الآن القيمة null لأنواع البيانات التي لا يُتوقع أن تحتوي على بادئات أو لاحقات (مثل الأنواع الرقمية). في V1، كانت هذه الأعمدة تُرجِع قيماً غير null لهذه الأنواع. ينبغي استخدام هذه الأعمدة عند إنشاء استعلامات SQL لوضع القيم الحرفية بين علامتي اقتباس بشكل صحيح وفقاً لنوع بياناتها.