https://github.com/tiledb-inc/tiledb-cloud-jdbc
JDBC driver for TileDB-Coud
https://github.com/tiledb-inc/tiledb-cloud-jdbc
jdbc sql tiledb
Last synced: about 1 year ago
JSON representation
JDBC driver for TileDB-Coud
- Host: GitHub
- URL: https://github.com/tiledb-inc/tiledb-cloud-jdbc
- Owner: TileDB-Inc
- License: mit
- Created: 2022-10-18T14:25:57.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-02-07T02:51:37.000Z (about 1 year ago)
- Last Synced: 2025-03-25T05:51:13.284Z (about 1 year ago)
- Topics: jdbc, sql, tiledb
- Language: Java
- Homepage:
- Size: 3.79 MB
- Stars: 4
- Watchers: 5
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/TileDB-Inc/TileDB-Cloud-JDBC/actions/workflows/github_actions.yml)
# TileDB-Cloud JDBC Driver
This is a type 4 JDBC driver that allows a Java program to connect to TileDB-Cloud.
## Usage
### Load Driver Class
```Class.forName("io.tiledb.TileDBCloudDriver")```
## Build from source code
```./gradlew assemble```
## Authentication
Use the java.util.Properties class to add your credentials
```
Properties properties = new Properties();
properties.setProperty("apiKey", "KEY");
properties.setProperty("rememberMe", "true");
Connection conn = DriverManager.getConnection("jdbc:tiledb-cloud:", properties);
```
Where ```NAMESPACE``` is your TileDB-Cloud namespace.
Other available properties are:
- ```username(String)```
- ```password(String)```
- ```verifySSL(boolean)```
- ```overwritePrevious(boolean)```
- ```listPublicArrays(boolean)``` lists all public TileDB arrays. Default: ```true```
## Run a simple query
```
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SELECT * FROM `tiledb://TileDB-Inc/quickstart_sparse`");
```
## Limitations
Query results are limited to 2GBs in size.
## Application compatibility
This driver is tested against the following applications/tools. Compatibility with other applications is not guaranteed.
- [DBeaver](https://dbeaver.com)
- [Tableau](https://www.tableau.com) (Use with our custom [TileDB-Tableau-Connector](https://github.com/TileDB-Inc/TileDB-Tableau-Connector))
- [Microsoft Power BI](https://powerbi.microsoft.com/) (Use with the ODBC powerpack from [ZappySys](https://zappysys.com))
### Important Notice for Java 17+ Users
When running this project with Java version 17 or higher, it is essential to set the `_JAVA_OPTIONS` environment variable to avoid compatibility issues. Please use the following command:
```sh
export _JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED"
```
For more details see: https://arrow.apache.org/docs/java/install.html