Google Git
Sign in
apache/ignite-3/refs/heads/ignite-24172/./examples
tree: aedf877aadce81ab24f94f5b7355027618a5402a
  1. config/
  2. src/
  3. .gitignore
  4. build.gradle
  5. README.md
examples/README.md

Apache Ignite 3 Examples

Overview

This project contains code examples for Apache Ignite 3.

Examples are shipped as a separate Gradle module, so to start running you simply need to import the provided build.gradle file into your favourite IDE.

The following examples are included:

  • RecordViewExample - demonstrates the usage of the org.apache.ignite.table.RecordView API
  • KeyValueViewExample - demonstrates the usage of the org.apache.ignite.table.KeyValueView API
  • SqlJdbcExample - demonstrates the usage of the Apache Ignite JDBC driver.
  • SqlApiExample - demonstrates the usage of the Java API for SQL.
  • VolatilePageMemoryStorageExample - demonstrates the usage of the PageMemory storage engine configured with an in-memory data region.
  • PersistentPageMemoryStorageExample - demonstrates the usage of the PageMemory storage engine configured with a persistent data region.
  • RocksDbStorageExample - demonstrates the usage of the RocksDB storage engine.

Running examples with an Ignite node within a Docker container

  1. Open the Ignite project in your IDE of choice.

  2. Prepare an environment variable:

IGNITE_SOURCES=/path/to/ignite3-sources-dir
  1. Build the Ignite Docker image. As a result the apacheignite/ignite3 image will be built and loaded into the Docker Engine:
cd $IGNITE_SOURCES; ./gradlew clean docker
  1. Start an Ignite node:
docker run --name ignite3-node -d --rm -p 10300:10300 -p 10800:10800 \
  -v $IGNITE_SOURCES/examples/config/ignite-config.conf:/opt/ignite/etc/ignite-config.conf apacheignite/ignite3
  1. Get the IP address of the node:
NODE_IP_ADDRESS=$(docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' ignite3-node)
  1. Initialize the node:
docker run -it apacheignite/ignite3 cli cluster init --url http://$NODE_IP_ADDRESS:10300 --name myCluster1 \
  --cluster-management-group defaultNode --metastorage-group defaultNode

  1. Run the example via IDE.

  2. Stop the Ignite node:

docker stop ignite3-node

Running examples with an Ignite node started natively

  1. Open the Ignite project in your IDE of choice.

  2. Download the Ignite ZIP package including the database and CLI parts. Alternatively, build these parts from the Ignite sources (see DEVNOTES.md). Unpack.

  3. Prepare the environment variables. IGNITE_HOME is used in the Ignite startup. Therefore, you need to export it:

export IGNITE_HOME=/path/to/ignite3-db-dir
IGNITE_CLI_HOME=/path/to/ignite3-cli-dir
IGNITE_SOURCES=/path/to/ignite3-sources-dir
  1. Override the default configuration file:
echo "CONFIG_FILE=$IGNITE_SOURCES/examples/config/ignite-config.conf" >> $IGNITE_HOME/etc/vars.env
  1. Start an Ignite node using the startup script from the database part:
$IGNITE_HOME/bin/ignite3db start
  1. Initialize the cluster using Ignite CLI from the CLI part:
$IGNITE_CLI_HOME/bin/ignite3 cluster init --name myCluster1 --metastorage-group defaultNode --cluster-management-group defaultNode

  1. Run the example from the IDE.

  2. Stop the Ignite node using the startup script:

$IGNITE_HOME/bin/ignite3db stop