Skip to main content
Version: v1

JDBC Driver

info

為了企業數據安全，我們在 Canner Enterprise 資料調用上為了安全性只能讓使用者 read-only 也就是目前僅支援 SELECT statement，不支援 Update, Delete 等操作。

Installation​

你可以從下方連結下載 Jar

連線設定​

Canner Enterprise JDBC 的 URL 格式如下

jdbc:canner://[hosts]/canner/[workspace sql name][?properties]
  • hosts: hosts 包含 port，舉例來說，若使用 IP 連線，hosts 會像是 192.168.100.1:80，若使用網域連線並搭配 SSL，hosts 會是 data-portal.apps.cannerdata.com:443
  • workspace sql name: workspace sql name 會是 workspace 的 SQL Name，這個參數可以在 Workspace > Config 中 Settings 區塊的 Name in SQL 看到
  • ?properties: 連線的額外參數

實際連線的 URL 會像是

  • jdbc:canner://192.168.100.1:80/canner/test_workspace?token=Y2xpZW50XzM0MTE4NjJlLTI1Y
  • jdbc:canner://data-portal.apps.cannerdata.com:443/canner/test_workspace?token=Y2xpZW50XzM0MTE4NjJlLTI1Y

Example code​

try {
  //  Database credentials
  final String token = "<your personal access token here>";
  final String jdbcUri = String.format("jdbc:canner://<host>:<port>/canner/<your workspace sql name here>?token=%s", token);

  // Execute a query
  Connection conn = DriverManager.getConnection(jdbcUri);
  Statement stmt = conn.createStatement();
  String sql = "SELECT * from lineitem";
  ResultSet rs = stmt.executeQuery(sql);
  ResultSetMetaData metadata = rs.getMetaData();

  // Extract data from result set
  // column count
  int columnCount = metadata.getColumnCount();

  for (int i = 1; i <= columnCount; i++ ) {
    // print column name and column type
    System.out.println(metadata.getColumnName(i));
    System.out.println(metadata.getColumnType(i));
  }

  while(rs.next()) {
    // iterate ResultSet
    System.out.println(rs.getString("orderkey"));
  }

  // Clean-up environment
  rs.close();
  stmt.close();
  conn.close();
}
catch (Exception e) {
  e.printStackTrace();
}