メインコンテンツまでスキップ

VeloDB Cloud クイックスタート

このガイドでは、数分でVeloDB Cloudを開始する手順を説明します。warehouseの作成、600万行のSSB-Flatベンチマークデータセットの読み込み、分析クエリの実行を行います。

備考

30日間無料トライアル。 VeloDB Cloud SaaSの30日間無料トライアルを開始できます。300米ドル相当のクレジットが含まれます。

1. アカウントの作成​

velodb.cloudにアクセスし、お好みの方法でサインアップしてください：

  • Google - Googleアカウントでのシングルサインオン
  • Microsoft - Microsoftアカウントでのシングルサインオン
  • Email - 従来のメールアドレスとパスワードによる登録

Sign up for VeloDB Cloud

2. warehouseの作成​

warehouseを構成するために、以下のフィールドに入力してください：

設定推奨値
Warehouse Namevelodb-quickstart
Cloud PlatformAWS
Regionお住まいの地域に最も近いリージョンを選択
  • Cluster initialization — 展開してクラスター仕様を表示・調整します。デフォルトは4 vCPU · 32 GB RAM · 200 GB Cacheです。
  • Advanced settings — 展開して暗号化やテーブル名の大文字小文字区別などの追加オプションを構成します。

Get started → をクリックしてwarehouseをプロビジョニングします。

Create warehouse configuration

備考

VeloDBは3-5分でwarehouseをプロビジョニングします。完了すると、ステータスがRunningに変わります。

Warehouse provisioning

3. warehouseへの接続​

サイドバーのConnectionsに移動して接続詳細を確認してください：

Connection information

接続方法​

VeloDB Consoleサイドバーの組み込みQueryエディターを使用して、ブラウザベースのSQLアクセスを行います。セットアップは不要です。

接続の確認​

SHOW DATABASES;

期待される出力:

+--------------------+
| Database           |
+--------------------+
| information_schema |
+--------------------+

4. SSB-Flat ベンチマークデータセットの読み込み​

SSB-Flat SF1 データセット（600万行）のパブリックデータセットを探索用に準備しました。この非正規化されたStar Schema Benchmarkデータセットは分析クエリに最適です。

備考

認証情報は不要です！ サンプルデータバケットはVeloDBから公開でアクセス可能です。

S3からのデータプレビュー​

読み込み前に、S3から直接データをプレビューします。最適なパフォーマンスを得るために、お使いのwarehouse regionに一致するタブを選択してください：

SELECT
    lo_orderkey,
    lo_orderdate,
    c_name,
    c_nation,
    lo_revenue,
    p_brand
FROM S3(
    "uri" = "s3://velodb-import-data-us-east-1/ssb-flat-sf1/ssb_flat_001.parquet",
    "format" = "parquet",
    "s3.endpoint" = "s3.us-east-1.amazonaws.com",
    "s3.region" = "us-east-1"
)
LIMIT 5;

データベースとテーブルの作成​

-- Create database
CREATE DATABASE IF NOT EXISTS ssb;
USE ssb;

-- Create the SSB flat table
CREATE TABLE IF NOT EXISTS ssb_flat (
    lo_orderkey        BIGINT NOT NULL,
    lo_linenumber      BIGINT NOT NULL,
    lo_custkey         BIGINT NOT NULL,
    lo_partkey         BIGINT NOT NULL,
    lo_suppkey         BIGINT NOT NULL,
    lo_orderdate       DATE NOT NULL,
    lo_commitdate      DATE NOT NULL,
    lo_orderpriority   VARCHAR(15) NOT NULL,
    lo_shippriority    BIGINT NOT NULL,
    lo_shipmode        VARCHAR(10) NOT NULL,
    lo_year            INT NOT NULL,
    lo_month           INT NOT NULL,
    lo_weeknum         INT NOT NULL,
    d_datekey          BIGINT NOT NULL,
    d_dayofweek        VARCHAR(10) NOT NULL,
    d_month            VARCHAR(10) NOT NULL,
    d_yearmonth        VARCHAR(10) NOT NULL,
    lo_quantity        BIGINT NOT NULL,
    lo_extendedprice   DOUBLE NOT NULL,
    lo_discount        DOUBLE NOT NULL,
    lo_revenue         DOUBLE NOT NULL,
    lo_supplycost      DOUBLE NOT NULL,
    lo_tax             DOUBLE NOT NULL,
    c_custkey          BIGINT NOT NULL,
    c_name             VARCHAR(25) NOT NULL,
    c_nation           VARCHAR(15) NOT NULL,
    c_region           VARCHAR(12) NOT NULL,
    c_city             VARCHAR(10) NOT NULL,
    c_mktsegment       VARCHAR(10) NOT NULL,
    s_suppkey          BIGINT NOT NULL,
    s_name             VARCHAR(25) NOT NULL,
    s_nation           VARCHAR(15) NOT NULL,
    s_region           VARCHAR(12) NOT NULL,
    s_city             VARCHAR(10) NOT NULL,
    p_partkey          BIGINT NOT NULL,
    p_name             VARCHAR(22) NOT NULL,
    p_brand            VARCHAR(9) NOT NULL,
    p_category         VARCHAR(7) NOT NULL,
    p_mfgr             VARCHAR(6) NOT NULL,
    p_color            VARCHAR(11) NOT NULL,
    p_type             VARCHAR(25) NOT NULL,
    p_size             BIGINT NOT NULL,
    p_container        VARCHAR(10) NOT NULL,
    INDEX idx_p_type (p_type) USING INVERTED PROPERTIES("parser" = "english")
)
DUPLICATE KEY(lo_orderkey)
DISTRIBUTED BY HASH(lo_orderkey) BUCKETS 48;

データの読み込み​

ヒント

最適なパフォーマンスを得るには、ウェアハウスと同じリージョンのS3バケットを使用してください。

INSERT INTO ssb.ssb_flat
SELECT * FROM S3(
    "uri" = "s3://velodb-import-data-us-east-1/ssb-flat-sf1/*.parquet",
    "format" = "parquet",
    "s3.endpoint" = "s3.us-east-1.amazonaws.com",
    "s3.region" = "us-east-1"
);
備考

600万行の読み込みには約30秒から1分かかります。

読み込みの確認​

SELECT COUNT(*) AS total_rows FROM ssb.ssb_flat;

期待される出力:

+------------+
| total_rows |
+------------+
|    6000000 |
+------------+

5. 分析クエリの実行​

それでは、データセットに対していくつかの分析クエリを実行してみましょう。

クエリ1: リアルタイム集計​

顧客地域別に収益と割引メトリクスを集計します：

SELECT
    c_region,
    COUNT(*) AS order_count,
    SUM(lo_revenue) AS total_revenue,
    AVG(lo_discount) AS avg_discount
FROM ssb.ssb_flat
GROUP BY c_region
ORDER BY total_revenue DESC;

Query 2: Window Functions - YoY Growth​

Window関数を使用して前年同期比の売上成長率を計算する：

SELECT
    lo_year,
    SUM(lo_revenue) AS yearly_revenue,
    LAG(SUM(lo_revenue)) OVER (ORDER BY lo_year) AS prev_year_revenue,
    ROUND(
        (SUM(lo_revenue) - LAG(SUM(lo_revenue)) OVER (ORDER BY lo_year))
        / LAG(SUM(lo_revenue)) OVER (ORDER BY lo_year) * 100,
        2
    ) AS yoy_growth_pct
FROM ssb.ssb_flat
GROUP BY lo_year
ORDER BY lo_year;

Query 3: CTEを使用した複雑なBI​

Common Table Expressionを使用して地域別利益層を分析する：

WITH regional_stats AS (
    SELECT
        c_region,
        s_region,
        SUM(lo_revenue) AS revenue,
        SUM(lo_supplycost) AS cost,
        SUM(lo_revenue - lo_supplycost) AS profit
    FROM ssb.ssb_flat
    GROUP BY c_region, s_region
)
SELECT
    c_region,
    s_region,
    revenue,
    profit,
    CASE
        WHEN profit > 1000000000 THEN 'High'
        WHEN profit > 500000000 THEN 'Medium'
        ELSE 'Low'
    END AS profit_tier
FROM regional_stats
ORDER BY profit DESC;

Query 4: セルフジョインによる期間比較​

セルフジョインを使用して1997年と1993年の収益を比較する：

SELECT
    t1.c_nation,
    t1.revenue_1997,
    t2.revenue_1993,
    ROUND((t1.revenue_1997 - t2.revenue_1993) / t2.revenue_1993 * 100, 2) AS growth_pct
FROM (
    SELECT c_nation, SUM(lo_revenue) AS revenue_1997
    FROM ssb.ssb_flat
    WHERE lo_year = 1997
    GROUP BY c_nation
) t1
JOIN (
    SELECT c_nation, SUM(lo_revenue) AS revenue_1993
    FROM ssb.ssb_flat
    WHERE lo_year = 1993
    GROUP BY c_nation
) t2 ON t1.c_nation = t2.c_nation
ORDER BY growth_pct DESC;

クエリ5: 全文検索​

転置インデックスを使用して製品タイプに"STEEL"を含む製品を検索します:

SELECT
    p_type,
    p_brand,
    COUNT(*) AS product_count,
    SUM(lo_revenue) AS total_revenue
FROM ssb.ssb_flat
WHERE p_type MATCH 'STEEL'
GROUP BY p_type, p_brand
ORDER BY total_revenue DESC
LIMIT 10;

次のステップ​

  • 独自のデータをインポートする - S3インポートガイドに従って、独自のバケットからロードしてください。
  • BIツールを接続する - Tableau、Power BI、Superset等の統合ガイドを参照してください。
  • 課金を設定する - トライアル終了前にBilling Centerで支払い方法を追加してください。
  • 本番環境向けにチューニングする - テーブル設計とパフォーマンスガイダンスについてはBefore you start the POCを確認してください。