Skip to content

Latest commit

 

History

History
180 lines (141 loc) · 9.46 KB

README_ja.md

File metadata and controls

180 lines (141 loc) · 9.46 KB
Raw

GridDB

Visit Website GitHub All Releases GitHub release

概要

GridDBは、NoSQLインタフェースとSQLインタフェースを兼ね備えたIoT向けデータベースです。

GridDBが提供する機能は『GridDB 機能リファレンス』を参照ください。

本リポジトリにはサーバとJavaクライアントがあります。JDBCドライバはjdbcリポジトリにあります。

クイックスタート (ソースコードの利用)

以下のLinux(x64)環境での動作を確認しています。

  • CentOS 7.9(gcc 4.8.5), RockyLinux 9.3(gcc 11), Ubuntu 22.04(gcc 11)

※事前にtclをインストールしてください。例) yum install tcl.x86_64
※事前にPython3をインストールしてください。例) yum install python3

サーバ、クライアント(java)のビルド

$ ./bootstrap.sh
$ ./configure
$ make

※JavaクライアントをMavenでビルドしたい場合は以下のコマンドを実行してください。gridstore-X.X.X.jarがtarget/の下に生成されます。

$ cd java_client
$ ./make_source_for_mvn.sh
$ mvn clean
$ mvn install

サーバの起動

$ export GS_HOME=$PWD
$ export GS_LOG=$PWD/log
$ export PATH=${PATH}:$GS_HOME/bin

$ gs_passwd admin
  #input your_password
$ vi conf/gs_cluster.json
  #    "clusterName":"your_clustername" #<-- input your_clustername

$ gs_startnode
$ gs_joincluster -c your_clustername -u admin/your_password

サンプルプログラムの実行

$ export CLASSPATH=${CLASSPATH}:$GS_HOME/bin/gridstore.jar:.
$ mkdir gsSample
$ cp $GS_HOME/docs/sample/program/Sample1.java gsSample/.
$ javac gsSample/Sample1.java
$ java gsSample/Sample1 239.0.0.1 31999 your_clustername admin your_password
  --> Person:  name=name02 status=false count=2 lob=[65, 66, 67, 68, 69, 70, 71, 72, 73, 74]

サーバの停止

$ gs_stopcluster -u admin/your_password
$ gs_stopnode -u admin/your_password

クイックスタート (GridDBサービスとCLIの利用)

クイックスタート (RPM/DEBファイルの利用)

以下のLinux(x64)環境での動作を確認しています。

  • CentOS 7.9、RockyLinux 9.3、Ubuntu 22.04

※事前にPython3をインストールしてください。例) yum install python3

  • このパッケージをインストールすると、OS内にgsadmユーザが作成されます。運用コマンドはgsadmユーザで操作してください。
  • gsadmユーザでログインすると環境変数 GS_HOMEとGS_LOGが自動的に設定されます。また、運用コマンドの場所が環境変数 PATHに設定されます。
  • Javaクライアントのライブラリ(gridstore.jar)は/usr/share/java上に、サンプルは/usr/griddb-XXX/docs/sample/program上に配置されます。
  • 過去版がインストールされている場合は、アンインストール後、/var/lib/gridstore上のconf/,data/を削除してください。

インストール

(CentOS/RockyLinux)
$ sudo rpm -ivh griddb-X.X.X-linux.x86_64.rpm

(Ubuntu)
$ sudo dpkg -i griddb_X.X.X_amd64.deb

※ X.X.Xはバージョンを意味します。

サーバの起動

[gsadm]$ cp /usr/griddb-X.X.X/conf_multicast/* conf/.
※ デフォルトはローカル接続限定の設定になっていますので、コンフィグを変更してください。

[gsadm]$ gs_passwd admin
  #input your_password
[gsadm]$ vi conf/gs_cluster.json
  #    "clusterName":"your_clustername" #<-- input your_clustername
[gsadm]$ gs_startnode
[gsadm]$ gs_joincluster -c your_clustername -u admin/your_password

サンプルプログラムの実行

$ export CLASSPATH=${CLASSPATH}:/usr/share/java/gridstore.jar:.
$ mkdir gsSample
$ cp /usr/griddb-X.X.X/docs/sample/program/Sample1.java gsSample/.
$ javac gsSample/Sample1.java
$ java gsSample/Sample1 239.0.0.1 31999 your_clustername admin your_password
  --> Person:  name=name02 status=false count=2 lob=[65, 66, 67, 68, 69, 70, 71, 72, 73, 74]

サーバの停止

[gsadm]$ gs_stopcluster -u admin/your_password
[gsadm]$ gs_stopnode -u admin/your_password

インストール時のトラブルシューティングもご参照ください。

ドキュメント

以下のドキュメントがあります。

クライアントとコネクタ

Java以外のクライアント、APIもあります。

(NoSQL Interface)

(SQL Interface)

(NoSQL & SQL Interface)

(その他)

他のOSSと接続するためのコネクタもあります。

パッケージ

コミュニティ

  • Issues
    質問、不具合報告はissue機能をご利用ください。
  • PullRequest
    GridDB Contributor License Agreement(CLA_rev1.1.pdf)に同意して頂く必要があります。 PullRequest機能をご利用の場合はGridDB Contributor License Agreementに同意したものとみなします。

ライセンス

サーバソースのライセンスはGNU Affero General Public License (AGPL)、 Javaクライアントと運用コマンドのライセンスはApache License, version 2.0です。 サードパーティのソースとライセンスについては3rd_party/3rd_party.mdを参照ください。