通过create table语句为已存在的表或者多元索引创建映射关系。创建映射关系时需要配置表的字段名称、字段类型和主键信息以及根据需要配置查询数据时的执行引擎。
关于create table语句的更多信息，请参见创建表的映射关系和创建多元索引的映射关系。
前提条件
已初始化Client。具体操作，请参见初始化OTSClient。
已创建数据表。
如果要使用多元索引映射关系，则需要已创建多元索引。
注意事项
表格存储Java SDK从5.13.0版本开始支持SQL查询功能。使用SQL查询功能时，请确保获取了正确的Java SDK版本。关于Java SDK历史迭代版本的更多信息，请参见Java SDK历史迭代版本。
参数
参数 | 说明 |
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表的映射关系。
private static void createTable(SyncClient client) {
// 创建SQL请求。
SQLQueryRequest request = new SQLQueryRequest("create table test_table (pk varchar(1024), long_value bigint(20), double_value double, string_value mediumtext, bool_value bool, primary key(pk))");
client.sqlQuery(request);
}常见问题
相关文档
创建映射关系后，您可以通过SELECT语句查询与分析表中数据。更多信息，请参见查询数据。
如果数据表的属性列有增加或删除，您可以通过
ALTER TABLE语句同步修改映射表。更多信息，请参见更新映射表属性列。如果需要查询表的描述信息，您可以通过
DESCRIBE语句实现。更多信息，请参见查询表的描述信息。如果不再需要使用表或者多元索引的映射关系，您可以通过
DROP MAPPING TABLE语句删除映射关系。更多信息，请参见删除映射关系。如果需要查看表的索引信息，您可以通过
SHOW INDEX语句实现。更多信息，请参见查询索引描述信息。如果需要列出当前数据库中的表名称列表，您可以通过
SHOW TABLES语句实现。更多信息，请参见列出映射表名称列表。