Onboarding
After you register a new VeloDB Cloud account, the Console guides you through choosing a use case, creating your first warehouse, and running queries on sample data. You can then connect your own data and invite teammates.
This flow applies to newly registered accounts setting up their first warehouse. Use a desktop browser with the Console language set to English to follow the steps below. The guided deployment creates a SaaS warehouse, which VeloDB Cloud provisions and manages for you.
If you already have a warehouse or have skipped quick setup, follow the Quick Start instead. For deployment in your own cloud account, see Deployment Models.
Step 1. Register your account
- Open the VeloDB Cloud Console and click Sign up.
- Register with a business email address. Personal email addresses are not supported. You can use Google, Microsoft, or email registration.
- Complete the registration prompts. For email registration, enter your name, company, and password, then verify your email using the code sent to your business email address.
No credit card is required for the guided setup. Review your trial period and credit balance in the Console. The trial ends when its period expires or its credits run out, whichever happens first. See Billing Overview.
Step 2. Personalize your experience
On Let’s personalize your experience, choose your primary use case:
| Use case | What you want to explore |
|---|---|
| Real-time analytics | Analyze product activity and power live dashboards. |
| Observability | Search and troubleshoot logs, metrics, and traces. |
| RAG and GenAI | Build AI search and retrieval applications. |
| Lakehouse | Analyze streaming and warehouse data together. |
Select one use case to continue. You can also provide your intended use, role, and how you heard about VeloDB Cloud. These additional fields are optional. Click Continue.
The guided sample queries currently cover Real-time analytics and Observability. If you select RAG and GenAI or Lakehouse, the Home page initially shows the real-time analytics guide. You can switch between the two available demos on Home.
Step 3. Create your first warehouse
A warehouse holds your data and compute resources. A cluster inside the warehouse provides the compute that loads and queries data.
On Create your warehouse:
- Keep the default Warehouse Name,
My_first_warehouse, or enter your own name. - Select a Cloud Platform and Region from the available options. Choose a region near your data sources and applications. If you plan to follow the SSB-Flat Quick Start afterward, select AWS
us-east-1, the only region currently supported by that tutorial. If you cannot find the region you need, click Get help. - Review Cluster initialization. For an initial evaluation, you can keep the default compute and cache settings. Expand this section if you need to change the zone, compute capacity, or cache size.
- Review Advanced settings if you need to configure table name case sensitivity or transparent data encryption where available. Otherwise, keep the defaults.
- Click Get started to create the warehouse. The Console opens Home while the warehouse is being provisioned.
- Wait for the warehouse and its cluster to become available before running sample queries. Query actions remain disabled while the required resources are not ready.
This guided flow does not ask you to enter a warehouse administrator password. Continue with the built-in SQL Editor for the sample queries. To connect an external SQL client, follow Connection Methods.
To revise your use case before creating the warehouse, click Back to use cases. To configure a warehouse through the standard creation flow instead, click Skip quick setup and follow the Quick Start.
Step 4. Run guided sample queries
On Home, open the Setup guide tab if needed. Use the scenario selector to choose Real-time analytics or Observability, then click Run a sample query.
The SQL Editor opens with the Setup Guide panel. Expand Run a query on sample data to view the SQL tasks. Open a task to inspect its SQL, then click Do it for me to execute it in the SQL Editor. You can also copy the SQL to inspect or adapt it.
Run the tasks in the order below. Complete the first table-creation task to unlock the remaining tasks. Check the SQL Editor results after each execution.
Explore real-time analytics
This demo uses Amazon reviews to show how inverted indexes affect lookup and full-text search queries.
- Open Create a table and click Do it for me. This creates the
amazon_reviewsdatabase and anamazon_reviewstable with inverted indexes. - Open Import amazon reviews sample data and click Do it for me. Wait for the import to finish in the SQL Editor before proceeding. A completed indicator in the guide does not by itself confirm that the import has finished.
- Open Run a query without indexes and click Do it for me. The script disables inverted index queries and runs the sample queries.
- Open Run a query with an inverted index and click Do it for me. The script enables inverted index queries and runs the same queries.
- Open Compare query performance to compare the recorded execution times.
The comparison uses the table's existing indexes. It does not create indexes between the two queries. Your results depend on the dataset, compute resources, cache state, and concurrent workloads.
Explore observability
This demo loads sample OpenTelemetry logs and searches them with SQL.
- Open Create a log table and click Do it for me. This creates the
otel_demodatabase and anotel_logstable with inverted indexes andVARIANTcolumns for log attributes. - Open Ingest sample OTel logs and click Do it for me. Wait for the data to load before running the search.
- Open Search logs with SQL and click Do it for me. The query filters error logs by service attributes and returns the most recent matching records.
Inspect the results in the SQL Editor, then adapt the filters to explore the sample logs.
Step 5. Continue with your own data and team
When you are ready to use your own data:
- In the real-time analytics guide, click Import your own data to open the data integration workspace. See Import Data for source-specific setup instructions.
- Click Invite a teammate to invite someone to your organization and assign an organization role. Organization membership is separate from warehouse SQL access. See Members for invitation and permission details.
These tasks are optional for exploring the sample queries. You can return to Home to continue the setup guide later during your trial. If you collapse the SQL Editor's panel, click Setup Guide to expand it again.
Manage evaluation costs
Creating the warehouse provisions compute and cache resources, and the sample imports store data. Review your trial balance and billing details as you evaluate the service.
When you finish a session, pause the cluster if you no longer need compute. Retained storage and cache can continue to incur charges. During an active trial, clusters automatically suspend after 30 minutes of inactivity. Resume the cluster in the Console before continuing your queries.
Common errors
| Symptom | What to do |
|---|---|
| Registration rejects your email address. | Use a business email address. Personal email addresses are not supported. |
| The personalization page does not appear. | This flow is for new accounts before their first warehouse is created. Use a desktop browser and the English Console. If you have already created a warehouse or skipped quick setup, use the Quick Start. |
| Continue does not advance from the use-case page. | Select a primary use case, then try again. |
| Get started is disabled, or the configuration is not ready. | Wait for platform, region, and warehouse configuration options to load. Check the warehouse name for validation errors and select an available region. |
| Run a sample query or Do it for me is disabled. | Wait for provisioning to finish. If the cluster is paused, resume it from Clusters. Confirm that your trial is still active. |
| A query fails or returns no sample data. | Check the SQL Editor error and import result. Complete table creation and wait for the sample import to finish before retrying the query. |
| The Setup Guide panel is missing. | Open Home and click Run a sample query to reopen it. The panel is available during an active trial with an available warehouse. |
If you cannot continue, contact VeloDB Cloud support with the step and error message.
Next steps
- Follow the Quick Start for a SQL tutorial using the SSB-Flat dataset.
- Follow the User Journey to plan data ingestion, application access, and production use.