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.

Downloading the Oracle NoSQL Database Cloud Simulator

Learn how to download and extract the Oracle NoSQL Database Cloud Simulator.

The Oracle NoSQL Database Cloud Simulator is available for download from the Oracle Cloud website. To install the Oracle NoSQL Database Cloud Simulator, first download and extract the file.

Note:

Your local system should meet the following requirements to run the Oracle NoSQL Database Cloud Simulator:
  • Java JDK version 10 or higher installed in your machine.

  • A minimum of 5-GB available disk space where you plan to install the Oracle NoSQL Database Cloud Simulator.

Perform the following steps:
  1. Open the Oracle Cloud Downloads page in a browser and click Oracle NoSQL Database Cloud.
  2. Click Download Oracle NoSQL Cloud Simulator.
  3. Select the Oracle NoSQL Database Cloud Simulator Zip or Tar file, accept the license agreement and click Download.
  4. Gunzip and untar the .tar.gz package (or extract the files if you have downloaded a .zip package).

    The package oracle-nosql-cloud-simulator-1.2.0 is used in this example. The actual package name and the .jar file names can change, depending on the release version that you download.

    $ tar xvfz oracle-nosql-cloud-simulator-1.2.0.tar.gz

    The output displays all directories and files that are part of the package. All the Oracle NoSQL Database Cloud Simulator related .jar files are placed in the cloudsim/lib directory.

After extracting the package, read the oracle-nosql-cloud-simulator-1.2.0/README.txt file for instructions on how to start and stop the simulator.

In order to use the Oracle NoSQL Database Cloud Simulator you must download one of the supported Oracle NoSQL language SDKs. The SDKs have instructions and example code to connect to either the Oracle NoSQL Database Cloud Simulator or the Oracle NoSQL Database Cloud Service.

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.