Skip to main content
Try our SQL generator tool! We’ve built an interactive SQL Assistant to help you generate SQL statements for creating sources, tables, sinks, and Iceberg tables. Check it out!

​
Step 1: Start RisingWave

RisingWave supports multiple deployment modes. For a comparison of all options, see Deployment modes overview. For convenience, this quick start guide uses the standalone deployment mode.

​
Script installation

Open a terminal and run the following curl command. 
curl -L https://risingwave.com/sh | sh
To start a RisingWave instance, run the following command. 
risingwave

​
Docker

Ensure Docker Desktop is installed and running in your environment. 
docker run -it --pull=always -p 4566:4566 -p 5691:5691 risingwavelabs/risingwave:latest single_node

​
Homebrew

Ensure Homebrew is installed, and run the following commands: 
brew tap risingwavelabs/risingwave
brew install risingwave
risingwave

​
Step 2: Connect to RisingWave

Ensure you have psql installed in your environment. To learn about how to install it, see Install psql without PostgreSQL. Open a new terminal window and run: 
psql -h localhost -p 4566 -d dev -U root
Instead of using the command line, you can also use the RisingWave Console, a web-based interface for managing and querying your RisingWave cluster. The console provides a visual way to run SQL queries, monitor cluster health, explore database schemas, and execute operational commands through an intuitive web interface.

​
Step 3: Insert some data

RisingWave supports both direct data insertion and streaming data ingestion from sources like message queues and database change streams. To keep things simple, we’ll demonstrate the approach of direct data insertion. Let’s create a table and insert some data. For instance, we can create a table named credit_card_transactions to store information about credit card usage.
Create the table
CREATE TABLE credit_card_transactions (
  card_id VARCHAR,
  amount DECIMAL,
  ts TIMESTAMP
);
Insert five rows of data
INSERT INTO credit_card_transactions (card_id, amount, ts)
VALUES
  ('card_123', 1200.00, '2022-01-01 10:00:00'),
  ('card_123', 1800.00, '2022-01-01 10:00:20'),
  ('card_123', 1900.00, '2022-01-01 10:00:40'),
  ('card_456', 4000.00, '2022-01-01 10:01:00'),
  ('card_456', 950.00,  '2022-01-01 10:01:30');

​
Step 4: Analyze and query data

Next, we will detect potentially fraudulent behavior by identifying any card that spends more than $5000 within a one-minute window. To do this, we’ll use a materialized view. A materialized view in RisingWave is not a static snapshot or a one-time query. Instead, it’s a continuously maintained result that automatically stays up to date as new data arrives. You can think of it as a live dashboard behind a SQL query.
Create a materialized view that detects high-spending cards in 1-minute windows
CREATE MATERIALIZED VIEW fraud_alerts AS
SELECT
  card_id,
  window_start,
  window_end,
  SUM(amount) AS total_amount
FROM
  TUMBLE(
    credit_card_transactions,  -- the source table
    ts,                        -- the event timestamp column
    INTERVAL '1 minute'        -- window size
  )
GROUP BY
  card_id, window_start, window_end
HAVING
  SUM(amount) > 5000;          -- only alert if total spend exceeds $5000
When this materialized view (MV) is created, RisingWave starts tracking it immediately. You don’t need to refresh or re-run the query manually. Any future insertion into credit_card_transactions will automatically update fraud_alerts.
Query the current result
SELECT * FROM fraud_alerts;
------
 card_id  |     window_start     |     window_end       | total_amount
----------+----------------------+----------------------+--------------
(0 rows)
At this point, no fraud alert is triggered yet. Let’s insert one more transaction to push card_123 over the $5000 threshold.
Insert additional data to trigger fraud alert
INSERT INTO credit_card_transactions (card_id, amount, ts)
VALUES ('card_123', 600.00, '2022-01-01 10:00:50');
Query the updated result
SELECT * FROM fraud_alerts;
------
 card_id  |     window_start     |     window_end       | total_amount
----------+----------------------+----------------------+--------------
 card_123 | 2022-01-01 10:00:00  | 2022-01-01 10:01:00  | 5500.00
(1 row)
As you can see, the MV is automatically updated when new data is inserted. You don’t need to manage any refresh logic or manual updates. RisingWave handles the incremental computation for you in the background.

​
What’s next?

Congratulations! You’ve successfully started RisingWave and conducted some initial data analysis. To explore further, you can: