CREATE TABLE 文を実行して、既存のテーブルまたは検索 インデックス のマッピングテーブルを作成できます。マッピングテーブルを作成する際は、ビジネス要件に基づいて、フィールド名と タイプ、プライマリキー情報、およびデータクエリに使用する実行エンジンを指定します。
詳細については、「テーブルのマッピングテーブルを作成する」および「検索 インデックス のマッピングテーブルを作成する」をご参照ください。
前提条件
クライアントが初期化されていること。詳細については、「Tablestore クライアントを初期化する」をご参照ください。
検索 インデックス のマッピングテーブルを作成する場合は、最初に 検索 インデックス を作成する必要があります。
パラメーター
パラメーター | 説明 |
query | SQL 文。必要な機能に基づいて、この パラメーター を設定します。 |
例
この トピック では、テーブルのマッピングテーブルを作成する方法について説明します。検索 インデックス のマッピングテーブルを作成する場合は、サンプル コード の SQL 文を、検索 インデックス のマッピングテーブルを作成するために使用する SQL 文に置き換えてください。
次の例は、create table test_table (pk varchar(1024), long_value bigint(20), double_value double, string_value mediumtext, bool_value bool, primary key(pk)) 文を使用して、test_table テーブルのマッピングテーブルを作成する方法を示しています。
func createMappingTable(client *tablestore.TableStoreClient) {
// SQL リクエストを作成します。
request := &tablestore.SQLQueryRequest{Query: "create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk))"}
// SQL リクエストへの応答を取得します。
res, err := client.SQLQuery(request)
if err != nil {
fmt.Println(err.Error())
} else {
fmt.Println(res.ResponseInfo.RequestId)
}
}FAQ
マッピングテーブルを作成しようとすると、「Table 'instancename.tablename' doesn't exist ?」という エラーメッセージ が返される場合はどうすればよいですか？
考えられる原因
マッピングテーブルを作成しようとしているテーブルが存在しません。
ソリューション
SQL で CREATE TABLE 文を実行して、既存のテーブルまたは検索 インデックス のマッピングテーブルのみを作成できます。マッピングテーブルを作成しようとしているテーブルまたは検索 インデックス が存在することを確認してください。
マッピングテーブルを作成しようとすると、「Table 'instancename.tablename' already exist?」という エラーメッセージ が返される場合はどうすればよいですか？
考えられる原因
テーブルのマッピングテーブルが作成されています。
ユーザーが手動でテーブルのマッピングテーブルを作成しました。
Tablestore がテーブルのマッピングテーブルを自動的に作成しました。データテーブルのマッピングテーブルを作成せずに、SQL 文 (DESCRIBE、SELECT など) を直接使用してデータテーブルのデータをクエリすると、Tablestore はデータテーブルのマッピングテーブルを自動的に作成します。自動的に作成されたマッピングテーブルには、データテーブルのプライマリキー列と事前定義列のみが含まれます。マッピングテーブルの 属性 列を更新することはできません。
ソリューション
DESCRIBE文を実行して、マッピングテーブルの スキーマ をクエリできます。スキーマ がビジネス要件を満たしていない場合は、マッピングテーブルの 属性 列を更新できます。マッピングテーブルが Tablestore によって自動的に作成された場合、属性 列を更新することはできません。この場合、マッピングテーブルを削除した後にビジネスに影響がないことが確実であれば、マッピングテーブルを削除して新しいマッピングテーブルを作成できます。
SQL クエリ機能の一般的な エラー と ソリューション については、「SQL クエリの一般的な エラー をトラブルシューティングするにはどうすればよいですか？」をご参照ください。
参照
マッピングテーブルを作成した後、マッピングテーブルの 属性 列の更新、マッピングテーブルの情報のクエリ、マッピングテーブルの名前のクエリ、マッピングテーブルの インデックス 情報のクエリ、およびマッピングテーブルの削除を行うことができます。詳細については、「マッピングテーブルの 属性 列を更新する」、「テーブルに関する情報をクエリする」、「マッピングテーブルの名前をクエリする」、「テーブルに関する インデックス 情報をクエリする」、および「マッピングテーブルを削除する」をご参照ください。
SELECT 文を実行して、マッピングテーブルのデータをクエリおよび分析できます。詳細については、「データをクエリする」をご参照ください。