Tablestore:SQL クエリ

背景情報

Tablestore は、構造化データを保存できる従来の NoSQL ストレージタイプと、クラウドネイティブ SQL エンジン機能を提供します。これにより、ビジネスを Tablestore にスムーズに移行し、SQL ステートメントを実行して Tablestore にアクセスできます。SQL クエリ機能は MySQL クエリ構文と互換性があり、DDL ステートメントを実行してテーブルを作成できます。既存のデータテーブルの場合、CREATE TABLE ステートメントを実行して、データテーブルのマッピングテーブルを作成できます。その後、SQL ステートメントを実行して、既存のデータテーブル内のデータにアクセスできます。

SQL クエリ機能を使用すると、検索インデックスを使用して、クエリ条件を満たすデータをすばやくクエリできます。SQL クエリ機能を使用すると、システムは SQL ステートメントに基づいて、SQL アクセスを高速化する適切な方法を自動的に選択します。

SQL クエリ機能は、大量のデータが保存されていて、オンラインでデータにアクセスしたい場合に適しています。SQL クエリ機能を使用する場合、アクセスレイテンシはミリ秒から分までです。SQL クエリ機能は、データテーブルのプライマリキーに基づくポイントクエリ (GetRow 操作)、検索インデックスに基づくタームクエリ (TermQuery)、および特定の条件を満たす行数や列の値の合計など、検索インデックスの集計機能に基づくクエリをサポートします。

用語

SQL の使用には、従来のデータベースの多くの用語が関係します。次の表は、従来のデータベースの特定の用語と、用語と Tablestore 用語間のマッピングを示しています。

機能

• SQL 機能

  • 単一の SQL ステートメントを実行することで、単一の要求を開始できます。

  • CREATE TABLE、ALTER TABLE、DROP MAPPING TABLE、DESCRIBE ステートメントなどの基本的な DDL ステートメントをサポートしています。詳細については、テーブルのマッピングテーブルを作成する、検索インデックスのマッピングテーブルを作成する、マッピングテーブルの属性列を更新する、マッピングテーブルを削除する、テーブルに関する情報をクエリするをご参照ください。

  • SELECT ステートメントを含むデータクエリ言語 (DQL) ステートメントをサポートしています。SELECT ステートメントを実行して、基本的なデータクエリ、集計、条件に基づくフィルタリング、ページごとのクエリを実行できます。詳細については、データをクエリするをご参照ください。

  • SHOW TABLES ステートメントと SHOW INDEX ステートメントなどの基本的なデータベース管理ステートメントをサポートしています。詳細については、マッピングテーブル名の一覧表示とテーブルのインデックス情報をクエリするをご参照ください。

  • 全文検索、ARRAY 列に基づくクエリ、NESTED 列に基づくクエリ、仮想列に基づくクエリなど、検索インデックスを使用してデータクエリを実行できます。詳細については、全文検索、検索インデックスでサポートされている ARRAY、検索インデックスでサポートされている NESTED、検索インデックスの仮想列をご参照ください。

  • 2 つ以上のテーブルを結合し、結合条件とクエリ条件を満たすデータを返すことができます。詳細については、結合をご参照ください。

  • 次の JSON 関数をサポートしています。->>、JSON_UNQUOTE、JSON_EXTRACT。詳細については、JSON 関数をご参照ください。

• 文字セットと照合

  • 文字セット：UTF-8

  • 照合：バイナリ照合

• 演算子

  算術演算子、関係演算子、論理演算子などの SQL 演算子をサポートしています。詳細については、SQL 演算子をご参照ください。

• 既存のテーブルのマッピングテーブル

  CREATE TABLE ステートメントを実行して、既存のテーブルのマッピングテーブルを作成できます。マッピングテーブルを作成する場合は、マッピングテーブルのプライマリキーが既存のテーブルのプライマリキーと同じであり、マッピングテーブルの属性列のタイプが既存のテーブルの属性列と事前定義された列と同じであることを確認してください。データタイプのマッピングについては、SQL でのデータタイプのマッピングをご参照ください。

使用上の注意

• SQL クエリ機能は、ワイドカラムモデルと時系列モデルに適しています。詳細については、ワイドカラムモデルと時系列モデルをご参照ください。

• SQL クエリ機能を使用する場合、トランザクション機能を使用することはできません。

• Tablestore は、SQL ステートメントのキーワードを予約語として使用します。キーワードを使用してテーブルまたは列に名前を付ける場合は、`` 記号を追加してキーワードをエスケープします。キーワードは大文字と小文字を区別しません。詳細については、予約語とキーワードをご参照ください。

• Tablestore SQL エンジンは、一般的な SQL 規則に従います。さらに、Tablestore SQL エンジンの列名は大文字と小文字を区別しません。たとえば、SELECT Aa FROM exampletable; ステートメントは、SELECT aa FROM exampletable; ステートメントと同じです。

  Tablestore の列名は大文字と小文字を区別します。SQL を使用する場合、Tablestore の列名は照合のために小文字に変換されます。たとえば、Tablestore テーブルの Aa 列で操作を実行する場合は、SQL で AA、aa、aA、または Aa を使用できます。したがって、Tablestore の列名を同時に AA、aa、aA、Aa にすることはできません。

• SQL クエリ機能は、中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (ウランチャブ)、中国 (深セン)、中国 (成都)、中国 (香港)、シンガポール、インドネシア (ジャカルタ)、日本 (東京)、マレーシア (クアラルンプール)、英国 (ロンドン)、米国 (シリコンバレー)、ドイツ (フランクフルト)、SAU (リヤド - パートナーリージョン)、米国 (バージニア) の各リージョンで使用できます。

制限

詳細については、SQL の制限をご参照ください。

手順

SQL クエリ機能を使用してデータのクエリと分析を実行する手順は、データの保存に使用されるデータモデルによって異なります。SQL クエリ機能を使用して、ワイドカラムモデルまたは時系列モデルのデータをクエリおよび分析できます。使用するデータモデルに基づいて、データのクエリと分析の手順を実行します。

方法

SQL クエリ機能は、Tablestore コンソール、Tablestore CLI、Tablestore SDK、JDBC ドライバー、および Go 用 Tablestore ドライバーで使用できます。

• Tablestore コンソールで SQL クエリ機能を使用する

• Tablestore CLI で SQL クエリ機能を使用する

• Tablestore SDK を使用して SQL クエリ機能を使用する

• JDBC を使用する

  • JDBC を使用して Tablestore にアクセスする

  • Hibernate を使用して SQL ステートメントを実行することでデータをクエリする

  • MyBatis を使用して SQL ステートメントを実行することでデータをクエリする

• Go 用 Tablestore ドライバーを使用して SQL ステートメントを実行することでデータをクエリする

料金

SQL クエリ機能の使用には料金はかかりません。ただし、SQL クエリ機能を使用すると、テーブルスキャンやインデックスベースのクエリなどの操作によって生成される読み取りおよび書き込みスループットに対して課金されます。詳細については、SQL クエリの課金対象項目をご参照ください。

FAQ

• SQL を使用してデータをクエリする場合、クエリ方法をどのように選択しますか?

• SQL クエリの一般的なエラーをどのようにトラブルシューティングしますか?

• SQL を使用してデータをクエリするときに「メインテーブルの SQL スキャン行がクォータを超えています。メインテーブルの行クォータは 100000 です」というエラーメッセージが表示された場合はどうすればよいですか?

参考資料

• SQL ステートメントを実行することでデータクエリと計算を高速化するには、セカンダリインデックスまたは検索インデックスを作成できます。詳細については、インデックス選択ポリシーと計算プッシュダウンをご参照ください。

• MaxCompute、Spark、Hive、HadoopMR、Function Compute、Flink、PrestoDB などの計算エンジンを使用して、テーブル内のデータの計算と分析を行うこともできます。詳細については、概要をご参照ください。

• データを視覚化するには、Grafana を使用できます。たとえば、Grafana を使用して Tablestore データをグラフに表示できます。詳細については、Tablestore を Grafana に接続するをご参照ください。

付録: SQL クエリ機能と検索インデックス機能の違い

SQL クエリ機能と検索インデックス機能は、特定のデータクエリおよび分析機能を提供します。次の表は、SQL クエリ機能と検索インデックス機能の機能を示し、機能間のマッピングを提供します。