Tablestore:Tablestore コンソールでの SQL クエリの使用

前提条件

• RAM ユーザーを使用する場合は、"Action": "ots:SQL*" 権限を付与してください。

• データテーブルが作成されていること。

ステップ 1: マッピングテーブルの作成

1. Tablestore コンソールにログインします。必要に応じて、ページ上部でリージョンとリソースグループを切り替えます。

2. 概要 ページで、インスタンス名または インスタンスの管理 をクリックします。

3. SQL 文を実行してクエリ タブをクリックし、左側のツリーで追加アイコンをクリックして マッピングテーブルの作成 ダイアログボックスを開きます。

   説明

   マッピングテーブルが存在しない場合、マッピングテーブルの作成 ダイアログボックスが自動的に表示されます。または、SQL エディタで CREATE TABLE 文を使用してマッピングテーブルを作成します。詳細については、「DDL 操作」をご参照ください。

4. ダイアログボックスで、次のパラメータを設定します。

   パラメータ	説明
   [テーブルタイプ]	有効な値： [一般テーブル] (デフォルト)：データテーブルのマッピングを作成します。 [時系列テーブル]：時系列テーブルのマッピングを作成します。
   [テーブル名]	マッピングを作成するデータテーブルまたは時系列テーブルを選択します。
   [マッピングモード]	このパラメーターは、テーブルタイプ が 一般テーブル に設定されている場合にのみ使用できます。有効な値: [テーブルのマッピングテーブル] (デフォルト)：既存のデータテーブルのマッピングを作成します。 [検索インデックスのマッピングテーブル]：既存の検索インデックスのマッピングを作成します。
   [詳細設定]	このパラメーターは、マッピングモード が テーブルのマッピングテーブル に設定されている場合にのみ使用できます。このスイッチをオンにすると、以下の設定を構成できます。 [整合性モード]：[結果整合性]（デフォルト。新しいデータは数秒以内にクエリ可能になります。）または[強い整合性]（新しいデータはすぐにクエリ可能になります。）。 [不正確な集計]： [可]（デフォルト。精度よりパフォーマンスを優先します。）または [いいえ]。
   [検索インデックス名]	このパラメーターは、マッピングモード が 検索インデックスのマッピングテーブル に設定されている場合にのみ使用できます。マッピングテーブルにバインドする検索インデックスを選択します。
   [マッピングテーブル名]	マッピングテーブルの名前。テーブルのマッピングモードでは、名前はデータテーブル名と一致し、変更できません。検索インデックスのマッピングモードまたは時系列テーブルモードでは、カスタム名を入力します。
   [分析ストアクエリの使用]	このパラメーターは、テーブルタイプ が 時系列テーブル に設定されている場合にのみ使用できます。このスイッチをオンにすると、分析ストアを使用して、時系列データをより低コストで保存および分析できます。 重要 分析ストアクエリの使用 を有効にして SQL マッピングテーブルを作成した場合、分析ストアを削除する前に、分析ストアの SQL マッピングテーブルを削除する必要があります。そうしないと、削除は失敗します。

5. 次のステップ：SQL の生成 をクリックします。

   マッピングテーブルを作成する SQL ステートメントが自動的に生成されます。例：

   CREATE TABLE `test_table` (
       `pk1` VARCHAR(1024),
       `pk2` BIGINT(20),
       `col_a` BIGINT(20),
       `col_b` BIGINT(20),
       `col_c` MEDIUMTEXT,
       `col_d` MEDIUMTEXT,
       PRIMARY KEY(`pk1`, `pk2`)
   );

   説明

   • スキーマには、クエリを実行する予定のすべての列を含める必要があります。

   • マッピング内のデータ型が、データテーブル内のデータ型と一致していることを確認してください。データ型マッピングの詳細については、「データ型マッピング」をご参照ください。

6. 必要に応じてマッピングテーブルスキーマを変更し、SQL 文を選択して、SQL 文の実行 をクリックします。

   ステートメントが実行されると、結果は実行結果セクションに表示されます。

   説明

   一度に選択して実行できる SQL ステートメントは 1 つだけです。ステートメントが選択されていない場合、デフォルトで最初のステートメントが実行されます。

ステップ 2: データのクエリ

マッピングテーブルを作成した後、SQL 文を実行してクエリ タブで SELECT 文を実行します。SQL 構文の詳細については、「DQL 文」をご参照ください。

例：test_table の最初の 3 行をクエリします。

SELECT * FROM test_table LIMIT 3;

出力例：

+------+-----+-------+-------+--------+--------+
| pk1  | pk2 | col_a | col_b | col_c  | col_d  |
+------+-----+-------+-------+--------+--------+
| row1 |   1 |    10 |   100 | apple  | extra1 |
| row2 |   2 |    20 |   200 | banana | extra2 |
| row3 |   3 |    30 |   300 | apple  | extra3 |
+------+-----+-------+-------+--------+--------+
3 Rows

結果をエクスポートするには、データエクスポート をクリックします。最大 2,000 行を CSV ファイルとしてエクスポートできます。

関連ドキュメント

• SQL を使用してデータの書き込み、更新、削除を行う方法については、「DML 操作」をご参照ください。

• SQL を使用して全文検索やベクトル検索などの高度なクエリを実行する方法については、「検索インデックス操作」をご参照ください。

• SQL インデックス選択と計算プッシュダウンの最適化について学ぶには、「クエリ最適化」をご参照ください。