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

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

最終更新日:Oct 23, 2026

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

説明

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

CREATE TABLE ステートメントの構文、フィールド型、パラメーターの詳細については、「DDL 操作」をご参照ください。

注意事項

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

詳細については、「Tablestore SDK for .NET のバージョン履歴」をご参照ください。

前提条件

パラメーター

パラメーター

説明

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 クエリの一般的なエラーのトラブルシューティング」をご参照ください。

関連情報