CREATE TABLE 文を実行して、既存のテーブルまたは検索インデックスのマッピングテーブルを作成できます。マッピングテーブルを作成する際は、ビジネス要件に基づいて、フィールド名と型、プライマリキー情報、およびデータクエリに使用する実行エンジンを指定します。
Tablestore は、データテーブル用の SQL マッピングテーブルを自動的に作成しません。SQL を使用してデータテーブルにアクセスするには、まず CREATE TABLE ステートメントを実行してマッピングテーブルを作成する必要があります。
詳細については、「テーブル用のマッピングテーブルの作成」および「多次元インデックス用のマッピングテーブルの作成」をご参照ください。
前提条件
開始する前に、次の要件が満たされていることを確認してください。
クライアントが初期化されていること。詳細については、「Tablestore クライアントの初期化」をご参照ください。
データテーブルが作成されていること。
多次元インデックス用のマッピングテーブルを作成する場合は、まず多次元インデックスを作成してください。
パラメーター
パラメーター | 説明 |
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文を使用してマッピングテーブルを変更してください。
関連ドキュメント
マッピングテーブルの作成後、その属性列の更新、マッピングテーブル情報のクエリ、マッピングテーブル名の一覧表示、インデックス情報のクエリ、およびマッピングテーブルの削除を実行できます。詳細については、「マッピングテーブルの属性列の更新」、「テーブルに関する情報のクエリ」、「テーブル名の一覧表示」、「テーブルに関するインデックス情報のクエリ」、または「マッピングテーブルの削除」をご参照ください。
SELECT ステートメントを使用して、マッピングテーブル内のデータをクエリおよび分析します。詳細については、「データのクエリ」をご参照ください。