すべてのプロダクト
Search
ドキュメントセンター

Tablestore:マッピングテーブルの作成

最終更新日:Oct 23, 2026

CREATE TABLE 文を実行して、既存のテーブルまたは検索インデックスのマッピングテーブルを作成できます。マッピングテーブルを作成する際は、ビジネス要件に基づいて、フィールド名と型、プライマリキー情報、およびデータクエリに使用する実行エンジンを指定します。

説明

Tablestore は、データテーブル用の SQL マッピングテーブルを自動的に作成しません。SQL を使用してデータテーブルにアクセスするには、まず CREATE TABLE ステートメントを実行してマッピングテーブルを作成する必要があります。

詳細については、「テーブル用のマッピングテーブルの作成」および「多次元インデックス用のマッピングテーブルの作成」をご参照ください。

前提条件

開始する前に、次の要件が満たされていることを確認してください。

パラメーター

パラメーター

説明

query

マッピングテーブルの作成に使用する SQL ステートメント。ステートメント内のカラムタイプは、データテーブル内の対応するカラムのデータ型と一致している必要があります。

例

説明

このトピックでは、データテーブル用のマッピングテーブルを作成する方法について説明します。多次元インデックス用のマッピングテーブルを作成する場合は、サンプルコード内の SQL ステートメントを多次元インデックスマッピングテーブル用の SQL ステートメントに置き換えてください。

リレーショナルデータベースの CREATE TABLE とは異なり、このステートメントは新しいテーブルを作成しません。既存の Tablestore データテーブルに SQL マッピングを作成し、NoSQL データに対する SQL ベースのクエリを可能にします。

次の例では、create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk)) というステートメントを使用して、test_table 用のマッピングテーブルを作成します。

const params = {
  // マッピングテーブルを作成する SQL ステートメント。
  // カラムタイプは、データテーブル内の対応するカラムのデータ型と一致している必要があります。
  // SQL 構文の詳細については、SQL リファレンスドキュメントを参照してください。
  query: "create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk))",
}

client.sqlQuery(params, function (err, data) {
  if (err) {
    console.log('sqlQuery error:', err.toString());
  } else {
    console.log('sqlQuery success:', data);
  }
});

よくある質問

マッピングテーブルの作成時に Table 'instance.table' doesn't exist エラーが返される

原因:指定したデータテーブルまたは検索インデックスが存在しません。CREATE TABLE 文は、既存のデータテーブルまたは検索インデックスのマッピングテーブルのみを作成します。データテーブルまたは検索インデックス自体は作成しません。

解決策:データテーブル名または検索インデックス名が正しいかを確認し、データテーブルまたは検索インデックスが存在することを確認してください。その後、CREATE TABLE 文を再度実行してください。

マッピングテーブルの作成時に Table 'instance.table' already exists エラーが返される

原因:マッピングテーブルがすでに存在します。CREATE TABLE 文によって作成されています。

解決策:

  • マッピングテーブルがすでに存在する場合にエラーを回避するには、CREATE TABLE 文に IF NOT EXISTS を追加してください。

  • マッピングテーブルのスキーマを変更する場合は、最初に DESCRIBE 文を実行してスキーマを確認し、その後 ALTER TABLE 文を使用してマッピングテーブルを変更してください。

関連ドキュメント