CREATE TABLE ステートメントを実行して、既存のテーブルまたは検索インデックスのマッピングテーブルを作成できます。 マッピングテーブルを作成する際は、ビジネス要件に基づいて、フィールド名と型、プライマリキー情報、およびデータクエリに使用する実行エンジンを指定します。
Tablestore は、データテーブルの SQL マッピングテーブルを自動的には作成しません。 SQL を使用してデータテーブルにアクセスするには、まず CREATE TABLE ステートメントを実行してマッピングテーブルを作成する必要があります。
CREATE TABLE ステートメントの構文、フィールド型、パラメーターの詳細については、「DDL 操作」をご参照ください。
注意事項
SQL クエリは、Tablestore SDK for .NET V5.0.0 以降でサポートされています。サポートされている SDK バージョンがインストールされていることを確認してください。
詳細については、「Tablestore SDK for .NET のバージョン履歴」をご参照ください。
前提条件
-
クライアントが初期化されていること。 詳細については、「Tablestore クライアントの初期化」をご参照ください。
-
検索インデックスのマッピングテーブルを作成する場合は、まず検索インデックスを作成する必要があります。
パラメーター
|
パラメーター |
説明 |
|
query |
SQL ステートメント。 必要な機能に合わせてこのパラメーターを設定します。 |
例
このトピックでは、テーブルのマッピングテーブルを作成する方法について説明します。 検索インデックスのマッピングテーブルを作成する場合は、サンプルコード内の SQL ステートメントを、検索インデックスのマッピングテーブル作成用の SQL ステートメントに置き換えてください。
次の例では、 CREATE TABLE `test_table` (`pk0` VARCHAR(1024), `pk1` BIGINT(20), `col0` MEDIUMTEXT, `col1` BIGINT(20), `col2` DOUBLE, `col3` BOOL, `col4` MEDIUMBLOB, `date_col` MEDIUMTEXT, `geo_col` MEDIUMTEXT, `col0_v1` MEDIUMTEXT, `col0_v2` MEDIUMTEXT, PRIMARY KEY(`pk0`,`pk1`)); ステートメントを使用して、test_table のマッピングテーブルを作成する方法を示します。
/// <summary>
/// データテーブルのマッピングテーブルを作成します。
/// </summary>
/// <param name="otsClient"></param>
public static void CreateMappingTable(OTSClient otsClient)
{
string sqlCommand = @"CREATE TABLE `test_table` (
`pk0` VARCHAR(1024),
`pk1` BIGINT(20),
`col0` MEDIUMTEXT,
`col1` BIGINT(20),
`col2` DOUBLE,
`col3` BOOL,
`col4` MEDIUMBLOB,
`date_col` MEDIUMTEXT,
`geo_col` MEDIUMTEXT,
`col0_v1` MEDIUMTEXT,
`col0_v2` MEDIUMTEXT,
PRIMARY KEY(`pk0`,`pk1`)
);";
SQLQueryRequest sqlQueryRequest = new SQLQueryRequest(sqlCommand);
SQLQueryResponse sqlQueryResponse = otsClient.SQLQuery(sqlQueryRequest);
}
よくある質問
マッピングテーブルを作成する際に "Table 'instancename.tablename' doesn't exist ?" というエラーメッセージが返された場合はどうすればよいですか。
-
考えられる原因
マッピングテーブルの作成対象のテーブルが存在しません。
-
解決策
SQL の CREATE TABLE ステートメントでは、既存のテーブルまたは検索インデックスに対してのみマッピングテーブルを作成できます。 マッピングテーブルを作成する対象のテーブルまたは検索インデックスが存在することを確認してください。
マッピングテーブルを作成する際に "Table 'instancename.tablename' already exist?" というエラーメッセージが返された場合はどうすればよいですか。
-
原因
このテーブルには、マッピングテーブルがすでに作成されています。
-
解決策
DESCRIBEステートメントを実行して、マッピングテーブルのスキーマを照会できます。 スキーマがビジネス要件を満たしていない場合は、マッピングテーブルの属性列を更新できます。
SQL クエリの一般的なエラーと解決策については、「SQL クエリの一般的なエラーのトラブルシューティング」をご参照ください。
関連情報
-
マッピングテーブルを作成した後、マッピングテーブルの属性列の更新、マッピングテーブル情報の照会、マッピングテーブル名の照会、マッピングテーブルのインデックス情報の照会、マッピングテーブルの削除ができます。 詳細については、「マッピングテーブルの属性列の更新」、「テーブル情報の照会」、「マッピングテーブル名の照会」、「テーブルのインデックス情報の照会」、および「マッピングテーブルの削除」をご参照ください。
-
SELECT ステートメントを使用して、マッピングテーブル内のデータを照会および分析できます。 詳細については、「データの照会」をご参照ください。