README.md - ignite-3 - Git at Google

 Apache Ignite 3
 ===

 Apache Ignite 3 is a distributed database for high-performance computing.

 * ACID TRANSACTIONS: Ignite can operate in a strongly consistent mode that provides full support for distributed ACID transactions executed at the Serializable isolation level.
 * DISTRIBUTED SQL: Use Ignite as a traditional SQL database by leveraging JDBC drivers, ODBC drivers, or the native SQL APIs that are available for Java, C#, C++, and other programming languages.
 * COMPUTE API: With traditional databases, for in-place calculations, you use stored procedures that are written in a language such as PL/SQL. With Ignite, you use modern JVM languages to develop and execute custom tasks across your distributed database.
 * SCHEMA-DRIVEN ARCHITECTURE: Ignite built around schema-driven model ensuring consistency between DDL, internal models and data.
 * PLUGABLE STORAGE ENGINES: Ignite's modular architecture enables the customization of underlying data and metadata storage, offering in-memory storage and RocksDB as default options.
 * UNIFIED CLI TOOL AND REST API: Management tools now include built-in CLI and REST API allowing simple access and configuration of Ignite cluster.

 ## Documentation

 The latest documentation is generated together with the releases and hosted on the apache site.

 Please check [the documentation page](https://ignite.apache.org/docs/ignite3/latest/) for more information.

 ## Contact

 Ignite is a top level project under the [Apache Software Foundation](https://apache.org)

 * Ignite [web page](https://ignite.apache.org)
 * Mailing lists
     * For any questions use: [user@ignite.apache.org](https://lists.apache.org/list.html?user@ignite.apache.org) or [dev@ignite.apache.org](https://lists.apache.org/list.html?dev@ignite.apache.org)

 ## Download

 Latest release artifacts (source release and binary packages) are [available](https://ignite.apache.org/download.cgi) from the Ignite web page.

 ## Quick start

 ### Run Ignite from released artifact

 To start Ignite you need to download latest zip archive from the [Ignite web page](https://ignite.apache.org/download.cgi).
 Scroll down to the "Binary releases" section and download the version you are interested in.

 Here is the command you can run to download current latest release:

 ```shell
 https://dlcdn.apache.org/ignite/3.0.0-beta1/ignite3-3.0.0-beta1.zip
 ```

 ```shell
 unzip ignite3-3.0.0-beta1.zip
 ```
 After this you should have two directories: `ignite3-db-3.0.0-<version>` and `ignite3-cli-3.0.0-<version>`.
 The first one contains everything you need to start Ignite node, and the second one contains Ignite CLI tool.

 After unpacking it, go to the `ignite3-db-3.0.0-<version>` folder and run the following command:

 ```shell
 cd ignite3-db-3.0.0-beta1
 ./bin/ignite3db start
 ```

 This command starts the Ignite node with the name `defaultNode`.
 If you want to change any node configuration, change values in `etc/ignite-config.conf` before the start.

 After that you need to connect to your node with Ignite CLI in interactive mode:

 ```shell
 cd ../ignite3-cli-3.0.0-beta1
 ./bin/ignite3
 ```

 In CLI you need to initialize simple cluster via the following command:

 ```
 cluster init --name myCluster
 ```

 Now CLI can be switched into SQL interactive mode with command:

 ```
 sql
 ```

 In SQL interactive mode user can simply type SQL commands in CLI:

 ```sql
 CREATE TABLE IF NOT EXISTS Person (id int primary key,  city varchar,  name varchar,  age int,  company varchar);
 INSERT INTO Person (id, city, name, age, company) VALUES (1, 'London', 'John Doe', 42, 'Apache');
 INSERT INTO Person (id, city, name, age, company) VALUES (2, 'New York', 'Jane Doe', 36, 'Apache');
 SELECT * FROM Person;
 ```

 ## Build from source

 Ignite distributive zip archive can be built with [Gradle](https://gradle.org/):

 ```shell
 ./gradlew clean distZip
 ```

 Build artifacts can be found in `packaging/db` and `packaging/cli` directories.

 ## Run from source using Docker

 Ignite can be started with the help of Docker:

 ```shell
 ./gradlew docker
 cd packaging/docker
 docker compose up -d
 ```

 You can also run the CLI within the Docker:

 ```shell
 docker run -it --rm --net ignite3_default apacheignite/ignite:3.0.0 cli
 ```

 ```
 > connect http://node1:10300
 > cluster init --name cluster
 ```

 For more information, you can check the [Developer notes](./DEVNOTES.md)

 ## Contribute

 All contributions are welcome.

 1. Please open a [Jira](https://issues.apache.org/jira/projects/IGNITE/issues) issue
 2. And create a pull request

 For more information, you can check the [Contribution guideline](./CONTRIBUTING.md)

 ## License

 The Apache Ignite project is licensed under the Apache 2.0 License. See the [LICENSE](./LICENSE.txt) file for details.
	Apache Ignite 3
	===

	Apache Ignite 3 is a distributed database for high-performance computing.

	* ACID TRANSACTIONS: Ignite can operate in a strongly consistent mode that provides full support for distributed ACID transactions executed at the Serializable isolation level.
	* DISTRIBUTED SQL: Use Ignite as a traditional SQL database by leveraging JDBC drivers, ODBC drivers, or the native SQL APIs that are available for Java, C#, C++, and other programming languages.
	* COMPUTE API: With traditional databases, for in-place calculations, you use stored procedures that are written in a language such as PL/SQL. With Ignite, you use modern JVM languages to develop and execute custom tasks across your distributed database.
	* SCHEMA-DRIVEN ARCHITECTURE: Ignite built around schema-driven model ensuring consistency between DDL, internal models and data.
	* PLUGABLE STORAGE ENGINES: Ignite's modular architecture enables the customization of underlying data and metadata storage, offering in-memory storage and RocksDB as default options.
	* UNIFIED CLI TOOL AND REST API: Management tools now include built-in CLI and REST API allowing simple access and configuration of Ignite cluster.

	## Documentation

	The latest documentation is generated together with the releases and hosted on the apache site.

	Please check [the documentation page](https://ignite.apache.org/docs/ignite3/latest/) for more information.

	## Contact

	Ignite is a top level project under the [Apache Software Foundation](https://apache.org)

	* Ignite [web page](https://ignite.apache.org)
	* Mailing lists
	* For any questions use: [user@ignite.apache.org](https://lists.apache.org/list.html?user@ignite.apache.org) or [dev@ignite.apache.org](https://lists.apache.org/list.html?dev@ignite.apache.org)

	## Download

	Latest release artifacts (source release and binary packages) are [available](https://ignite.apache.org/download.cgi) from the Ignite web page.

	## Quick start

	### Run Ignite from released artifact

	To start Ignite you need to download latest zip archive from the [Ignite web page](https://ignite.apache.org/download.cgi).
	Scroll down to the "Binary releases" section and download the version you are interested in.

	Here is the command you can run to download current latest release:

	```shell
	https://dlcdn.apache.org/ignite/3.0.0-beta1/ignite3-3.0.0-beta1.zip
	```

	```shell
	unzip ignite3-3.0.0-beta1.zip
	```
	After this you should have two directories: `ignite3-db-3.0.0-<version>` and `ignite3-cli-3.0.0-<version>`.
	The first one contains everything you need to start Ignite node, and the second one contains Ignite CLI tool.

	After unpacking it, go to the `ignite3-db-3.0.0-<version>` folder and run the following command:

	```shell
	cd ignite3-db-3.0.0-beta1
	./bin/ignite3db start
	```

	This command starts the Ignite node with the name `defaultNode`.
	If you want to change any node configuration, change values in `etc/ignite-config.conf` before the start.

	After that you need to connect to your node with Ignite CLI in interactive mode:

	```shell
	cd ../ignite3-cli-3.0.0-beta1
	./bin/ignite3
	```

	In CLI you need to initialize simple cluster via the following command:

	```
	cluster init --name myCluster
	```

	Now CLI can be switched into SQL interactive mode with command:

	```
	sql
	```

	In SQL interactive mode user can simply type SQL commands in CLI:

	```sql
	CREATE TABLE IF NOT EXISTS Person (id int primary key, city varchar, name varchar, age int, company varchar);
	INSERT INTO Person (id, city, name, age, company) VALUES (1, 'London', 'John Doe', 42, 'Apache');
	INSERT INTO Person (id, city, name, age, company) VALUES (2, 'New York', 'Jane Doe', 36, 'Apache');
	SELECT * FROM Person;
	```

	## Build from source

	Ignite distributive zip archive can be built with [Gradle](https://gradle.org/):

	```shell
	./gradlew clean distZip
	```

	Build artifacts can be found in `packaging/db` and `packaging/cli` directories.

	## Run from source using Docker

	Ignite can be started with the help of Docker:

	```shell
	./gradlew docker
	cd packaging/docker
	docker compose up -d
	```

	You can also run the CLI within the Docker:

	```shell
	docker run -it --rm --net ignite3_default apacheignite/ignite:3.0.0 cli
	```

	```
	> connect http://node1:10300
	> cluster init --name cluster
	```

	For more information, you can check the [Developer notes](./DEVNOTES.md)

	## Contribute

	All contributions are welcome.

	1. Please open a [Jira](https://issues.apache.org/jira/projects/IGNITE/issues) issue
	2. And create a pull request

	For more information, you can check the [Contribution guideline](./CONTRIBUTING.md)

	## License

	The Apache Ignite project is licensed under the Apache 2.0 License. See the [LICENSE](./LICENSE.txt) file for details.