Developing in Oracle NoSQL Database Cloud Simulator

Get familiar with the Cloud APIs by using the Oracle NoSQL Database Cloud Simulator.

The Oracle NoSQL Database Cloud Simulator simulates the cloud service and lets you write and test applications locally without accessing Oracle NoSQL Database Cloud Service. The Oracle NoSQL Database Java SDK contains a few examples for the developer to get started with.

You can start developing your application in the Oracle NoSQL Database Cloud Simulator, using and understanding the basic examples, before you get started with Oracle NoSQL Database Cloud Service.

Extract Oracle NoSQL Database Java SDK and the Oracle NoSQL Database Cloud Simulator bundles. Create your application using the Cloud APIs. After building, debugging, and testing your application with the Oracle NoSQL Database Cloud Simulator, move your application to Oracle NoSQL Database Cloud Service.

Topics

1. Downloading the Oracle NoSQL Database Cloud Simulator

2. Oracle NoSQL Database Cloud Simulator Compared With Oracle NoSQL Database Cloud Service

Downloading the Oracle NoSQL Database Cloud Simulator

Download the Oracle NoSQL Database Cloud Simulator from the Oracle Cloud downloads page and extract it on your local machine.

Prerequisites

• Java JDK version 17 or later installed

• At least 5 GB of free disk space in the installation location

Steps

1. Open the Oracle Cloud Downloads page and select Oracle NoSQL Database Cloud.

2. Select Download Oracle NoSQL Cloud Simulator.

3. Select the compressed package, accept the license agreement and select Download.

4. Extract the package

    tar xvf <cloud_simulator_package>.tar.gz

After extracting the package, read the instructions in the README.md file to start the simulator.

Connect to the Simulator

ou can connect to the simulator using Visual Studio Code Extension, using IntelliJ Plugin, or a supported Oracle NoSQL Database SDK.

Oracle NoSQL Database Cloud Simulator Compared With Oracle NoSQL Database Cloud Service

Learn the difference between Oracle NoSQL Database Cloud Simulator and Oracle NoSQL Database Cloud Service. The differences helps determine important design considerations that you should make before using your application in a production environment.

Oracle NoSQL Database Cloud Simulator is a local version of the Oracle NoSQL Database Cloud Service. The server instance that you create in Oracle NoSQL Database Cloud Simulator supports relatively limited aggregate throughput when compared to the Oracle NoSQL Database Cloud Service. Also, the performance of NoSQL operations on the Oracle NoSQL Database Cloud Simulator is based on the speed and capability of the machine on which it is deployed.

By comparison, Oracle NoSQL Database Cloud Service is suitable for production use because of features such as scalability, availability, and durability.

Oracle NoSQL Database Cloud Simulator has the following limitations when compared to Oracle NoSQL Database Cloud Service:

• The Oracle NoSQL Database Cloud Simulator can be used for only development and testing purposes. Do not use Oracle NoSQL Database Cloud Simulator for performance measurements or in a production environment.

• At least 5 GB of disk drive space must be available to run the Oracle NoSQL Database Cloud Simulator.

• A single instance of the Oracle NoSQL Database Cloud Simulator should be started in a root directory (directory where the Oracle NoSQL Database Cloud Simulator data is located). Oracle NoSQL Database Cloud Simulator assumes exclusive control over the data storage directory.

• The Oracle NoSQL Database Cloud Simulator does not support or require security-relevant configurations.

• No hard limit is enforced on the number of tables, size of tables, number of indexes, or maximum throughput specified for tables (except for the amount of storage on the local disk drive).

• Data Definition Language (DDL) operations, such as creating or dropping a table, and creating or dropping an index, are not throttled.

• Operational history is not maintained.