{"id":20578068,"url":"https://github.com/timeplus-io/timeplus-native-jdbc","last_synced_at":"2026-02-03T21:32:16.624Z","repository":{"id":248487887,"uuid":"809235462","full_name":"timeplus-io/timeplus-native-jdbc","owner":"timeplus-io","description":"Timeplus JDBC driver which speaks native TCP protocol to Timeplus Core","archived":false,"fork":false,"pushed_at":"2025-05-21T15:09:34.000Z","size":3019,"stargazers_count":6,"open_issues_count":5,"forks_count":1,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-06-18T12:43:33.775Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timeplus-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-02T05:23:14.000Z","updated_at":"2025-05-21T15:05:21.000Z","dependencies_parsed_at":"2024-07-26T07:27:16.489Z","dependency_job_id":"60f73951-ff67-4f12-b4fe-4a732fe4b1fb","html_url":"https://github.com/timeplus-io/timeplus-native-jdbc","commit_stats":null,"previous_names":["timeplus-io/timeplus-native-jdbc"],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/timeplus-io/timeplus-native-jdbc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timeplus-io%2Ftimeplus-native-jdbc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timeplus-io%2Ftimeplus-native-jdbc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timeplus-io%2Ftimeplus-native-jdbc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timeplus-io%2Ftimeplus-native-jdbc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timeplus-io","download_url":"https://codeload.github.com/timeplus-io/timeplus-native-jdbc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timeplus-io%2Ftimeplus-native-jdbc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29058296,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T20:13:53.544Z","status":"ssl_error","status_checked_at":"2026-02-03T20:13:40.507Z","response_time":96,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T06:10:17.862Z","updated_at":"2026-02-03T21:32:16.611Z","avatar_url":"https://github.com/timeplus-io.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"Timeplus Native JDBC\n===\n\nA Native JDBC library for accessing [Timeplus](https://timeplus.com/) in Java with streaming SQL support.\n\nThis is a fork of https://github.com/housepower/ClickHouse-Native-JDBC, but revised and enhanced for streaming query processing.\n\nThis JDBC driver is recommended for Timeplus Enterprise users.\n\nIf you don't need to run streaming SQL or has lower performance need, you may also use https://github.com/timeplus-io/proton-java-driver.\n\n## CONTRIBUTE\n\nWe welcome anyone that wants to help out in any way, whether that includes reporting problems, helping with documentations, or contributing code changes to fix bugs, add tests, or implement new features. Please follow [Contributing Guide](CONTRIBUTE.md).\n\n## JDBC Driver\n\n### Requirements\n\n- Java 8 or above\n\n**Notes:** We only do test with Java LTS versions.\n\n* Data is organized and compressed by columns.\n* Implemented in the TCP Protocol, with higher performance than HTTP, here is the [benchmark report](docs/dev/benchmark.md).\n\n### Limitations\n\n* Not support insert complex values expression, like `INSERT INTO test_table VALUES(to_date(123456))`, but query is ok.\n* Not support insert non-values format, like `TSV`.\n* Not support more compression method, like `ZSTD`.\n\n### Import\n\n- Gradle\n```groovy\ncompile \"com.timeplus:timeplus-native-jdbc:${timeplus_native_jdbc_version}\"\n```\nOr use the shade version with dependencies packed in the same JAR.\n```groovy\ncompile \"com.timeplus:timeplus-native-jdbc-shaded:${timeplus_native_jdbc_version}\"\n```\n\n- Maven\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.timeplus\u003c/groupId\u003e\n    \u003cartifactId\u003etimeplus-native-jdbc\u003c/artifactId\u003e\n    \u003cversion\u003e${timeplus-native-jdbc.version}\u003c/version\u003e\n\u003c/dependency\u003e\n```\nOr use the shade version with dependencies packed in the same JAR.\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.timeplus\u003c/groupId\u003e\n    \u003cartifactId\u003etimeplus-native-jdbc-shaded\u003c/artifactId\u003e\n    \u003cversion\u003e${timeplus-native-jdbc.version}\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Example Code\n\nUnlike [the Proton JDBC Driver](https://github.com/timeplus-io/proton-java-driver) which only supports batch query, this JDBC driver talks to the native port of Timeplus and support streaming SQL. The query will be long running and you can get latest results from the JDBC ResultSet.\n\nHere is an example to run a DDL to create a random stream, then run a streaming SQL to list all events.\n```java\npackage test_jdbc_driver;\n\nimport java.sql.Connection;\nimport java.sql.DriverManager;\nimport java.sql.PreparedStatement;\nimport java.sql.ResultSet;\nimport java.sql.SQLException;\nimport java.sql.Statement;\n\npublic class App {\n\n    public static void main(String[] args) throws Exception {\n        String url = \"jdbc:timeplus://localhost:8463\";\n        // to connect Timeplus Enterprise with username and password: jdbc:timeplus://localhost:8463?user=admin\u0026password=changeme\n\n        try (Connection connection = DriverManager.getConnection(url)) {\n            try (Statement stmt = connection.createStatement()) {\n                stmt.executeQuery(\n                    \"create random stream if not exists simple_random(i int, s string) settings eps=3\"\n                );\n                try (\n                    ResultSet rs = stmt.executeQuery(\n                        \"SELECT * FROM simple_random\"\n                    )\n                ) {\n                    while (rs.next()) {\n                        System.out.println(\n                            rs.getInt(1) + \"\\t\" + rs.getString(2)\n                        );\n                    }\n                }\n            }\n        }\n    }\n}\n\n\n```\n## License\n\nThis project is distributed under the terms of the Apache License (Version 2.0). See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimeplus-io%2Ftimeplus-native-jdbc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimeplus-io%2Ftimeplus-native-jdbc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimeplus-io%2Ftimeplus-native-jdbc/lists"}