Tablestore SDK for PHP は、既存のテーブルまたは検索インデックスに対してマッピングテーブルを作成し、SQL によるデータアクセスを可能にします。
詳細については、「データテーブルのマッピングテーブルの作成」および「検索インデックスのマッピングテーブルの作成」をご参照ください。
使用上の注意
SQL クエリは、Tablestore SDK for PHP V5.1.0 以降でサポートされています。サポートされているバージョンがインストールされていることを確認してください。
Tablestore SDK for PHP のバージョン履歴については、Tablestore SDK for PHP のバージョン履歴をご参照ください。
前提条件
-
クライアントが初期化されていること。詳細については、「Tablestore クライアントの初期化」をご参照ください。
-
検索インデックス用のマッピングテーブルを作成する場合は、まず検索インデックスを作成する必要があります。
パラメーター
SQLQueryRequest には、次のパラメーターがあります。
|
名前 |
タイプ |
説明 |
|
query (必須) |
String |
マッピングテーブル名、フィールド、プライマリキー、クエリエンジンを定義する |
例
このトピックでは、テーブルのマッピングテーブルを作成する方法について説明します。検索インデックスのマッピングテーブルを作成する場合は、サンプルコードの 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ステートメントを実行してマッピングテーブルを削除し、再作成してください。
関連ドキュメント
-
マッピングテーブルを作成した後、マッピングテーブルの属性列の更新、マッピングテーブル情報のクエリ、マッピングテーブル名のクエリ、マッピングテーブルのインデックス情報のクエリ、およびマッピングテーブルの削除を実行できます。詳細については、「マッピングテーブルの属性列の更新」、「テーブル情報のクエリ」、「マッピングテーブル名の一覧表示」、「テーブルのインデックス情報のクエリ」、および「マッピングテーブルの削除」をご参照ください。
-
SELECT ステートメントを使用して、マッピングテーブル内のデータをクエリおよび分析できます。詳細については、「データのクエリ」をご参照ください。