SAP HANA含UTF-8字符SQL查询异常及编码修改咨询

现象原因 #

1. SQL语句编码识别错误：SAP HANA不会自动检测SQL语句的编码，完全依赖客户端连接时传递的编码参数。即使会话LOCALE设为ko_KR.UTF8，如果客户端未明确告知服务器SQL语句采用UTF-8编码，HANA会默认按ASCII解析字符串常量。韩文“한글”是多字节UTF-8字符，被ASCII解析后会被拆分为无效单字节，导致存储的字符数据错误。
2. CHAR_AS_UTF8参数影响：当CHAR_AS_UTF8=true时，HANA将CHAR类型数据以UTF-8编码返回给客户端，但SQL解析阶段已经生成错误的字节序列，因此返回数据显示异常；当CHAR_AS_UTF8=false时，HANA按会话默认单字节编码返回数据，客户端UTF-8环境巧合性地将错误字节重新解析为原韩文（并非正确逻辑，仅为临时表象）。
3. ODBC SQLPrepare文本损坏：ODBC驱动在Prepare阶段若未正确配置编码参数，会导致SQL语句中的UTF-8字符被错误转码，传递至HANA服务器时已损坏，加剧乱码问题。

临时解决方法（客户端配置） #

• 明确ODBC连接编码参数：在ODBC数据源连接字符串中添加NLS_USE_UTF8=YES、CHAR_AS_UTF8=true，同时设置LOCALE=ko_KR.UTF8。此配置会让客户端明确告知HANA服务器SQL语句采用UTF-8编码，确保服务器正确解析韩文常量。
• 优化ODBC执行方式：避免使用SQLPrepare的隐式转码，优先使用SQLExecDirect直接执行SQL语句，减少中间转码环节的错误。
• 统一客户端编码环境：确保客户端操作系统默认编码为UTF-8，避免ODBC驱动在传递SQL语句时进行不必要的编码转换。

永久修改SAP HANA服务器编码为UTF-8 #

SAP HANA服务器字符集为安装时确定的不可逆配置，需通过数据迁移实现编码变更：

1. 全量备份数据库：使用HANA Studio或hdbsql工具执行完整数据库备份，覆盖所有数据、元数据及配置。
2. 重新安装HANA服务器：在安装向导的“Database Settings”环节，选择UTF-8作为服务器默认字符编码。
3. 恢复备份数据：将备份数据恢复至新安装的UTF-8编码HANA服务器，恢复前需确认备份数据字符集与UTF-8兼容，避免恢复过程中出现乱码。
4. 验证编码配置：登录HANA服务器，执行以下SQL语句确认编码设置：

   SELECT * FROM M_SYSTEM_OVERVIEW WHERE KEY = 'DEFAULT_CHARSET';
   

   确认返回值为UTF-8。

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