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

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

最終更新日:Oct 23, 2026

Tablestore SDK for PHP は、既存のテーブルまたは検索インデックスに対してマッピングテーブルを作成し、SQL によるデータアクセスを可能にします。

使用上の注意

SQL クエリは、Tablestore SDK for PHP V5.1.0 以降でサポートされています。サポートされているバージョンがインストールされていることを確認してください。

Tablestore SDK for PHP のバージョン履歴については、Tablestore SDK for PHP のバージョン履歴をご参照ください。

前提条件

パラメーター

SQLQueryRequest には、次のパラメーターがあります。

名前

タイプ

説明

query (必須)

String

マッピングテーブル名、フィールド、プライマリキー、クエリエンジンを定義する CREATE TABLE ステートメント。 データテーブルのマッピングと検索インデックスのマッピングでは、異なる構文が使用されます。

例

説明

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

次の例は、CREATE TABLE `tableName` (`PK0` BIGINT(20),`PK1` VARCHAR(1024),`geo` MEDIUMTEXT,`boolean` BOOL,`array` MEDIUMTEXT,`double` DOUBLE,`text` MEDIUMTEXT,`keyword` MEDIUMTEXT,`nested` MEDIUMTEXT,`long` BIGINT(20),PRIMARY KEY(`PK0`,`PK1`)); ステートメントを使用して、tableName テーブル用のマッピングテーブルを作成する方法を示しています:

$request = array(
    'query' => 'CREATE TABLE `tableName` (`PK0` BIGINT(20),`PK1` VARCHAR(1024),`geo` MEDIUMTEXT,`boolean` BOOL,`array` MEDIUMTEXT,`double` DOUBLE,`text` MEDIUMTEXT,`keyword` MEDIUMTEXT,`nested` MEDIUMTEXT,`long` BIGINT(20),PRIMARY KEY(`PK0`,`PK1`));',
);
$response = $otsClient->sqlQuery($request);
print json_encode($response, JSON_PRETTY_PRINT);

よくある質問

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

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

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

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

原因:マッピングテーブルがすでに存在します。 CREATE TABLE ステートメントによって作成されたか、明示的なマッピングテーブルなしで DESCRIBE または SELECT ステートメントが実行されたときに自動的に作成された可能性があります。 自動的に作成されたマッピングテーブルには、データテーブルのプライマリキー列のみが含まれます。

解決策:

  • マッピングテーブルがすでに存在する場合にエラーが発生しないようにするには、CREATE TABLE ステートメントに IF NOT EXISTS を追加してください。

  • マッピングテーブルのスキーマを変更する場合は、まず DESCRIBE ステートメントを実行してスキーマを表示してください。 CREATE TABLE ステートメントで作成されたマッピングテーブルは、ALTER TABLE ステートメントを使用して変更できます。 自動的に作成されたマッピングテーブルは変更できません。 ワークロードへの影響を評価した後、DROP TABLE ステートメントを実行してマッピングテーブルを削除し、再作成してください。

関連ドキュメント