tree: c13efc2355dbc8e78164654c1f3986e118cc530d [path history] [tgz]
  1. .github/
  2. client/
  3. example/
  4. rpc/
  5. test/
  6. .asf.yaml
  7. .gitignore
  8. go.mod
  9. go.sum
  11. LICENSE-binary
  12. Makefile
  13. NOTICE
  14. NOTICE-binary

English | 中文

Apache IoTDB

E2E Tests GitHub release License IoTDB Website

Apache IoTDB (Database for Internet of Things) is an IoT native database with high performance for data management and analysis, deployable on the edge and the cloud. Due to its light-weight architecture, high performance and rich feature set together with its deep integration with Apache Hadoop, Spark and Flink, Apache IoTDB can meet the requirements of massive data storage, high-speed data ingestion and complex data analysis in the IoT industrial fields.

Apache IoTDB Client for Go


This is the GoLang client of Apache IoTDB.

Apache IoTDB website: Apache IoTDB Github:


golang >= 1.13

How to Use the Client (Quick Start)

With go mod

export GO111MODULE=on
export GOPROXY=

mkdir session_example && cd session_example

curl -o session_example.go -L

go mod init session_example
go run session_example.go

Without go mod

# get thrift 0.14.1
go get
cd $GOPATH/src/
git checkout 0.14.1

mkdir -p $GOPATH/src/iotdb-client-go-example/session_example
cd $GOPATH/src/iotdb-client-go-example/session_example

curl -o session_example.go -L
go run session_example.go

Developer environment requirements for iotdb-client-go


  • Linux, Macos or other unix-like OS
  • Windows+bash(WSL, cygwin, Git Bash)

Command Line Tools

  • golang >= 1.13
  • make >= 3.0
  • curl >= 7.1.1
  • thrift 0.14.1


Parameter name mismatch with actual usage in function ‘Open’

The implementation of the function client/session.go/Open() is mismatched with the description. The parameter connectionTimeoutInMs represents connection timeout in milliseconds. However, in the older version, this function did not implement correctly, regarding it as nanosecond instead. The bug is now fixed. Positive value of this parameter means connection timeout in milliseconds. Set 0 for no timeout.