SlicingDice Documentation

SlicingDice API Docs

Welcome to the SlicingDice API documentation. You'll find comprehensive guides and documentation to help you start working with SlicingDice as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Documentation

How to create a database

First time checking our docs? You might want to start with the right foot by reading our Documentation Guide first.

Currently it is just possible to create databases using the SlicingDice's control panel .

There are two types of databases on SlicingDice: test and production database.

  • Test Database
    A test database can be used to try SlicingDice and define your data model before creating a production database. All test databases are free, but the data retention is only 7 days, so every 7 days after the database creation, SlicingDice will automatically delete any data stored for the database.

  • Production Database
    Production database is oficial database you are going to use when inserting and querying your data for real.

Test Database are for small tests only!

The test environment should not be used for insertion or query performance evaluations, as it uses less than 1% of the SlicingDice's infrastructure.


Creating a database using the control panel

Watch this quick video below to learn step-by-step how to create databases using the SlicingDice's Control Panel.


Database wizard explained

Below we explain each one of the steps and fields required when creating a database.

Step 1 - Database Setup

Field
Description

Database Name

The name of your database. Can be edited at any time.

Database Labels/Tags (Optional)

Possible labels/tags you might want to associate to a database, in order to organize it, considering you have many databases. Can be edited at any time.

Database Description

Database description. Can be edited at any time.

Database Type

Can either be Test or Production. It's only possible to change a Test database to Production, not the other way around.

Pricing Model

The pricing model you want to use for your database. Can be changed at any time. Access the SlicingDice pricing models page to learn more.

Insertion Load

The insertion throughput you want your database to have. Can be changed at any time. Access the SlicingDice pricing models page to learn more.

Query Load

The query throughput you want your database to have. Can be changed at any time. Access the SlicingDice pricing models page to learn more.

Step 2 - Schema Definition
This step can be done later, at any time. You don't need to define all your database schema during the database creation process.

  • Column Creation:
Field
Description

Column Name

The name of your column. Can be edited at any time.

Column API Name

The API name of your column. Cannot be edited once it's created.

Column Description

The description of your column. Can be edited at any time.

Dimension

The dimension in which your column will be created. Cannot be edited once it's created. Read the dimension page to learn more.

Column Data Type

The type of data you want for the column. Cannot be edited once it's created. Access the supported data types page to learn more.

Column Data Storage Type

The type of storage you want the column to have, store the latest inserted value or keep a list of all values inserted. Cannot be edited once it's created. Access the supported data types page to learn more.

  • Dimension Creation:
    Access the dimension page to learn more when you should create more dimensions.
Field
Description

Dimension Name

The name of your dimension. Can be edited at any time.

Dimension API Name

The API name of your dimension. Cannot be edited once it's created.

Default Dimension

SlicingDice automatically creates a default dimension for you to store data. You can rename this default dimension name at any time. Don't know what "dimension" means, check the SlicingDice Key Concepts page.

Step 3 - Database Whitelist (Optional)
Access the database access whitelist page to learn more about how the Database Whitelist works.

Field
Description

Database IP Address or Website Domain Whitelist

The IP addresses or website domain that are allowed to connect to the database. Can be edited at any time.

Step 4 - Custom Database Keys (Optional)
Access the types of database keys page to learn more about how the Custom Database Keys works.

Field
Description

Database Key Name

The name of your database key. Can be edited at any time.

Database Key Permission Level

The type of the database key you want to create. Can be edited at any time.

Database Key Description

The description of your database key. Can be edited at any time.

Columns to whitelist for this Database key

The list of columns of the database that you want to associate to the custom database key. Can be edited at any time.

Step 5 - Confirmation
Summary of all the information and configurations you defined for the new database, before you finally create it.

Once the database is created, it will be immediately available for inserting and querying data, and automatically appear on the list of databases.


How to create a database

First time checking our docs? You might want to start with the right foot by reading our Documentation Guide first.