如何将HANA SQL表转换为.hdb表并投入使用

• 导出原HANA SQL表的DDL定义，剔除原生SQL中不被XS .hdbtable语法支持的关键字（比如AUTO_INCREMENT、自定义触发器语句等），对齐字段类型、长度、非空约束与原表完全一致，确保和你已导入的CSV文件的字段结构匹配。
• 在HANA开发工具（HANA Studio / Business Application Studio）的对应XS项目包路径下，新建后缀为.hdbtable的文件，文件名与目标表名保持一致，文件内容参考如下规范编写：

table.schemaName = "替换为你的目标Schema名称";
table.tableType = COLUMNSTORE;
table.description = "替换为表的业务描述，可留空";
table.columns = [
    {name = "ID"; sqlType = NVARCHAR; length = 32; nullable = false; comment = "主键ID";},
    {name = "CREATE_TIME"; sqlType = TIMESTAMP; nullable = true; comment = "创建时间";}
    // 其余字段按照你的表结构依次补充，和CSV字段顺序完全对应
];
table.primaryKey.pkcolumns = ["ID"];

• 选中编写完成的.hdbtable文件，右键执行Activate操作，激活成功后系统会自动在目标Schema下生成对应的物理存储表，无报错则代表表结构创建完成。
• 关联你已导入的CSV数据到新生成的.hdb表：执行SQL插入语句，将CSV导入生成的临时表数据写入.hdb表，参考语句如下：

INSERT INTO "你的Schema名称"."你的XS项目包路径::目标表名"
SELECT * FROM "存放CSV导入数据的临时表名";

如果临时表和.hdb表的字段顺序不一致，手动指定字段列表即可，避免数据错位。

• 验证表可用性：执行查询语句确认数据写入正常，示例：SELECT * FROM "你的Schema名称"."你的XS项目包路径::目标表名" LIMIT 100，确认数据记录、字段值与原SQL表完全一致后，即可正常读写使用该.hdb表。

常见问题排查 #

• 激活.hdbtable文件报错：优先检查字段定义是否存在语法错误，字段类型、长度是否符合HANA规范，非空约束是否和CSV导入的数据匹配。
• 插入数据提示主键冲突：检查CSV导入的临时表是否存在重复主键值，或者原SQL表导出的CSV数据是否有重复记录。
• 表无法正常访问：给业务用户分配对应.hdb表的SELECT、INSERT等必要权限即可。

内容的提问来源于stack exchange，提问作者Jim River