CLI
The Cube command line interface (CLI) is used for various Cube workflows. It could help you in areas such as:
- Creating a new Cube service.
- Generating a data model based on your database tables.
See the CLI command reference for details on all commands.
Quickstart
Once installed, run the following command to create new Cube service
npx cubejs-cli create <project name> -d <database type>
specifying the project name and your database using -d
flag. Available
options:
postgres
mysql
mongobi
athena
redshift
bigquery
mssql
clickhouse
snowflake
presto
For example,
npx cubejs-cli create hello-world -d postgres
Once run, the create
command will create a new project directory that contains
the scaffolding for your new Cube project. This includes all the files necessary
to spin up the Cube backend, example frontend code for displaying the results of
Cube queries in a React app, and some example data model files to highlight the
format of the Cube Data Model layer.
The .env
file in this project directory contains placeholders for the relevant
database credentials. For MySQL, Redshift, and PostgreSQL, you'll need to fill
in the target host, database name, user and password. For Athena, you'll need to
specify the AWS access and secret keys with the access necessary to run Athena
queries (opens in a new tab), and the target AWS region and S3 output
location (opens in a new tab) where query results are stored.