メインコンテンツまでスキップ
バージョン: 2.5

テーブルを作成する

このクイックスタートチュートリアルでは、StarRocks でテーブルを作成するための必要な手順を説明し、StarRocks の基本的な機能を紹介します。

StarRocks インスタンスがデプロイされた後（詳細は Deploy StarRocks を参照）、データベースとテーブルを作成して データをロードおよびクエリ する必要があります。データベースとテーブルの作成には、対応する ユーザー権限 が必要です。このクイックスタートチュートリアルでは、StarRocks インスタンスで最高の権限を持つデフォルトの root ユーザーを使用して、以下の手順を実行できます。

NOTE

既存の StarRocks インスタンス、データベース、テーブル、およびユーザー権限を使用してこのチュートリアルを完了することもできます。ただし、簡単のために、チュートリアルが提供するスキーマとデータを使用することをお勧めします。

ステップ 1: StarRocks にログインする​

MySQL クライアントを介して StarRocks にログインします。デフォルトのユーザー root でログインでき、パスワードはデフォルトで空です。

mysql -h <fe_ip> -P<fe_query_port> -uroot

NOTE

  • 異なる FE MySQL サーバーポート (query_port、デフォルト: 9030) を割り当てた場合は、-P の値を適宜変更してください。
  • FE 設定ファイルで priority_networks という設定項目を指定した場合は、-h の値を適宜変更してください。

ステップ 2: データベースを作成する​

CREATE DATABASE を参照して、sr_hub という名前のデータベースを作成します。

CREATE DATABASE IF NOT EXISTS sr_hub;

この StarRocks インスタンス内のすべてのデータベースを表示するには、SHOW DATABASES SQL を実行します。

ステップ 3: テーブルを作成する​

USE sr_hub を実行して sr_hub データベースに切り替え、CREATE TABLE を参照して sr_member という名前のテーブルを作成します。

USE sr_hub;
CREATE TABLE IF NOT EXISTS sr_member (
    sr_id            INT,
    name             STRING,
    city_code        INT,
    reg_date         DATE,
    verified         BOOLEAN
)
PARTITION BY RANGE(reg_date)
(
    PARTITION p1 VALUES [('2022-03-13'), ('2022-03-14')),
    PARTITION p2 VALUES [('2022-03-14'), ('2022-03-15')),
    PARTITION p3 VALUES [('2022-03-15'), ('2022-03-16')),
    PARTITION p4 VALUES [('2022-03-16'), ('2022-03-17')),
    PARTITION p5 VALUES [('2022-03-17'), ('2022-03-18'))
)
DISTRIBUTED BY HASH(city_code);

NOTE

  • StarRocks でテーブルを作成するには、DISTRIBUTED BY HASH 句でバケットキーを指定し、テーブルのデータ分散計画を策定する必要があります。デフォルトでは、データは 10 個の tablet に分散されます。詳細は Data Distribution を参照してください。
  • データレプリカの数を表すテーブルプロパティ replication_num を 1 として指定する必要があります。これは、デプロイした StarRocks インスタンスに BE ノードが 1 つしかないためです。
  • テーブルタイプ が指定されていない場合、デフォルトで重複キーテーブルが作成されます。詳細は Duplicate Key table を参照してください。
  • テーブルのカラムは、データのロードとクエリ のチュートリアルで StarRocks にロードするデータのフィールドに正確に対応しています。
  • 本番環境での高パフォーマンス を保証するために、PARTITION BY 句を使用してテーブルのデータパーティショニング計画を策定することを強くお勧めします。詳細は Design partitioning and bucketing rules を参照してください。

テーブルが作成された後、DESC ステートメントを使用してテーブルの詳細を確認し、SHOW TABLES を実行してデータベース内のすべてのテーブルを表示できます。StarRocks のテーブルはスキーマ変更をサポートしています。詳細は ALTER TABLE を参照してください。

次に何をするか​

StarRocks テーブルの概念的な詳細について学ぶには、StarRocks Table Design を参照してください。

このチュートリアルで示した機能に加えて、StarRocks は以下もサポートしています：