如何正确设置 Informix GLS 及 CSDK 语言环境

 CLIENT_LOCALE=en_us.8859-1 
 CLIENT_LOCALE=en_us.819 
 # 以上两个为同一字符集：819 为 8859-1 的编码
 DB_LOCALE=zh_cn.gb

GLS 字符集工作原理

Informix 数据库服务器端、客户端字符集的工作原理示意图见图 1。

图 1. IDS GLS 字符集处理过程示意图

DB_LOCALE 环境变量用途

1. 在客户机应用程序和数据库服务器交换字符数据时，如果 DB_LOCALE 环境变量（在客户机计算机上）的值与 CLIENT_LOCALE 的值不同，客户机应用程序将执行代码集转换。 代码集转换防止这两种代码集不同时发生数据破坏。
2. 在客户机应用程序请求连接时，它将包括 DB_LOCALE（如果已设置）的信息发送至数据库服务器。
3. 在确定如何设置服务器处理语言环境的数据库信息时，数据库服务器使用 DB_LOCALE。
4. 在客户机应用程序尝试打开数据库时，数据库服务器将客户机应用程序传递的 DB_LOCALE 环境变量的值与数据库中存储的数据库语言环境进行比较。
5. 当数据库服务器存取与语言环境相关的数据类型的列时，数据库服务器使用 DB_LOCALE 指定的语言环境。
6. 当数据库服务器创建新数据库时，它将检查数据库语言环境（DB_LOCALE），以确定如何在数据库的系统目录中存储字符信息。此信息包括诸如如何处理正则表达式、比较字符串以及确保代码集的正确使用的操作。

CLIENT_LOCALE 环境变量用途

1. 在客户机应用程序和数据库服务器交换字符数据时，如果 CLIENT_LOCALE 环境变量的代码集与 DB_LOCALE（在客户机计算机上）的代码集不同，客户机应用程序将执行代码集转换。代码集转换防止这两种代码集不同时发生数据破坏。
2. 在客户机应用程序请求连接时，它将包括 CLIENT_LOCALE 的信息发送至数据库服务器。
3. 在确定如何设置服务器处理语言环境的客户机应用程序信息时，数据库服务器将使用 CLIENT_LOCALE。
4. 在 Informix ESQL/C 的预处理器处理源文件时，它接受以 CLIENT_LOCALE 的代码集编写的 C 源代码。 在 Informix ESQL/C 客户机应用程序执行时，将检查 CLIENT_LOCALE 以获得客户机语言环境的名称，该语言环境将对操作系统文件名、文本文件的内容以及日期、时间和数字数据的格式产生影响。
5. 在数据库实用程序创建文件时，文件名和文件内容位于 CLIENT_LOCALE 指定的代码集中。在查找特定于产品的消息文件时，客户机应用程序将检查与客户机语言环境关联的消息目录。

四个语言环境的含义

1. 客户机语言环境— Client locale

   客户机语言环境指定客户机应用程序用于执行读和写（I/O）操作的语言、地域和代码集。在客户机应用程序中，I/O 操作包括读取键盘输入或要发送至数据库的数据文件，以及将数据库服务器从数据库中检索的数据写入屏幕、文件或打印机。 通过 CLIENT_LOCALE 来设置客户机语言环境。

2. 数据库语言环境— Database locale

   通过 DB_LOCALE 环境变量设置的数据库语言环境指定数据库服务器用于正确解释特定数据库中语言环境相关的数据类型（NCHAR 和 NVARCHAR）所需的语言、地域和代码集。DB_LOCALE 中指定的代码集确定哪些字符在任何字符列中都是有效的，并且确定数据库对象（如数据库、表、列和视图）的名称。数据库服务器使用 DB_LOCALE 环境变量指定的数据库代码集将数据传入和传出数据库。

3. 服务器语言环境— Server locale

   数据库服务器使用 SERVER_LOCALE 环境变量指定的服务器代码集写文件（如调试和警告文件）。但是，数据库服务器不使用服务器语言环境来写入采用 Informix 专用格式的文件（数据库和表文件）。

4. 服务器处理语言环境— Server processing locale

   数据库服务器使用数据库语言环境的代码集作为服务器处理语言环境的代码集 , 使用服务器处理语言环境来写入采用 Informix 专用格式的文件（数据库和表文件）。也就是说数据库服务器使用数据库语言环境（DB_LOCALE）来写入采用 Informix 专用格式的文件（数据库和表文件）。

建立数据库连接过程

在客户机应用程序请求与数据库的连接时，数据库服务器使用 GLS 语言环境执行以下步骤。

1. 客户机应用程序发送语言环境信息到数据库服务器。
   • CLIENT_LOCALE( 未设置将采用默认 en_us.819)；
   • DB_LOCALE( 未设置则不发送 )。
2. 验证是否能够在客户机应用程序及其请求的数据库之间建立连接。

   对比如下两个语言环境：

   • 由客户机应用程序发送的 DB_LOCALE 指定的语言环境；
   • 存储在请求数据库的系统目录中的数据库语言环境。
     • 匹配，则建立连接。
     • 不匹配，提示无法连接到数据库。或者可以继续进行这样的连接，但是数据库服务器可能会不正确地解释它从客户机接收到的数据，那么只能靠自己来理解交换中数据的格式。
3. 确定服务器处理语言环境，按如下顺序确定服务器处理语言环境：
   • 使用客户机定义的 DB_LOCALE；
   • 数据库语言环境中的环境变量 DB_LOCALE。

执行代码集转换

在客户机 / 服务器环境中，如果客户机或服务器计算机使用不同的代码集来表示相同的字符，那么需要将字符数据从一种代码集转换为另一种代码集。如果不进行代码集转换，那么一台计算机无法正确地处理或显示源自另一台计算机的字符数据（在这两台计算机使用不同的代码集时）。

何时执行代码集转换

只有在两个代码集（客户机和服务器处理语言环境，或服务器处理语言环境和服务器）不同时，应用程序才必须使用代码集转换。以下情况是代码集不同的可能原因：

1. 不同的操作系统可能以不同的方式对同一字符进行编码。
2. 如果客户机语言环境和数据库语言环境指定不同的代码集，客户机应用程序将执行代码集转换以便服务器计算机不会装入此类型的处理。
3. 如果服务器语言环境和服务器处理语言环境指定不同的代码集，数据库服务器将在写入和读取操作系统文件（如日志文件）时执行代码集转换。该转化不涉及到数据库数据的问题。

在图 1 中，黑点表示在客户机 / 服务器环境中可能发生代码集转换的两个时刻。

客户机应用程序代码集转换

当以下两个条件都为真时，客户机应用程序自动在客户机和数据库代码集之间执行代码集转换：

• 客户机和数据库语言环境的代码集不匹配。
• 客户机和数据库代码集之间的转换存在有效的目标代码集转换。

客户机应用程序开始执行时，它会比较客户机和数据库语言环境的名称，以确定是否执行代码集转换。如果设置了 CLIENT_LOCALE 和 DB_LOCALE 环境变量，那么客户机应用程序使用这些语言环境名称来分别确定客户机和数据库的代码集。如果未设置 CLIENT_LOCALE（且未设置 DBNLS），那么客户机应用程序假定客户机语言环境为缺省语言环境。如果未设置 DB_LOCALE（且未设置 DBNLS），那么客户机应用程序假定数据库语言环境与客户机语言环境（CLIENT_LOCALE 设置的值）相同。

如果客户机和数据库代码集相同，那么无需进行代码集转换。但是，如果代码集不匹配，客户机应用程序必须确定这两个代码集是否可转换。如果客户机可以找到关联的代码集转换文件，那么两个代码集是可转换的。这些代码集转换文件必须存在于客户机计算机上。

举例说明：

客户机应用程序：CLIENT_LOCALE=en_us.1252 DB_LOCALE=en_us.8859-1 
客户机应用程序确定它必须在 Windows 代码页 1252（客户机语言环境中）和 
ISO8859-1 代码集（数据库语言环境中）之间执行代码集转换。
若链接具有 GB(zh_cn.gb) 语言环境的数据库，那么数据库将设置 SQLWARN 警告，原因是语言、地区和代码
集不同。客户机应用程序将不正确地执行代码集转换。
它将继续在 Windows 代码页 1252 和 ISO8859-1 之间，而不是在 Windows 代码页 1252 和 zh_cn.gb 之间进行
转换。这种情况可能会导致数据破坏。应用程序将不会继续此链接。

设置字符集

Informix 通过 DB_LOCALE 和 CLIENT_LOCALE 来设置数据库的语言本地化支持设置。

数据库服务端

在创建数据库时（为了统一系统数据库与应用数据库的字符集，在创建数据库实例时），请按如下步骤设置数据库的 DB_LOCALE 值。

 1. 设置环境变量 DB_LOCALE 
 set DB_LOCALE=zh_cn.gb 
 2. 创建数据库 create database dbname 
 3. 验证当前数据库字符集
 SELECT dbs_collate FROM sysmaster:sysdbslocale 
 WHERE dbs_dbsname = ‘ dbname ’

客户端

当我们使用 ODBC,JDBC 连接数据库时，我们需要在连接信息中正确设置语言环境变量：DB_LOCALE 和 CLIENT_LOCALE。

设置语言环境变量
 DB_LOCALE=zh_cn.gb 
 CLIENT_LOCALE=zh_cn.gb

ODBC：

下图为 WINDOWS 环境下 ODBC 语言环境设置示意图。

图 2. 在 ODBC 中设置语言环境

UNIX 环境下需要在 odbc.ini 文件中定义：

在 odbc.ini 文件中定义如下两项数据库语言环境变量
 DB_LOCALE=zh_cn.gb 
 CLIENT_LOCALE=zh_cn.gb

JDBC：

在使用 JDBC 连接数据库时，我们需要在连接数据库的 URL 中设置数据库语言环境变量：DB_LOCALE 和 CLIENT_LOCALE。示例如下：

 String url = "jdbc:Informix-sqli://10.127.1.11:8001/testdb:
 InformixSERVER=servername;user=user;password=password;
 DB_LOCALE=zh_CN.gb;CLIENT_LOCALE=zh_CN.gb";

常见字符集设置问题

在 Informix 数据库字符集设置与使用过程，我们常会遇到一些字符集相关错误，知道了错误产生的原因，就可以很容易解决问题。这里我们总结了几种常见的字符集设置相关问题。

Error -23101 Unable to load locale categories

当设置的 DB_LOCALE 和 CLIENT_LOCALE 的字符集对应的以下文件不存在时，出现该错误。

• - $InformixDIR/gls/lc11/DB_LOCALE‘s( 语言 _ 地区 )/(db 的 16 进制编码 ).lco
• - $InformixDIR/gls/lc11/CLIENT_LOCALE‘s( 语言 _ 地区 )/( db 的 16 进制编码 ).lco
• - $InformixDIR/gls/lc11/CLIENT_LOCALE‘s( 语言 _ 地区 )/( client 的 16 进制编码 ).lco

举例说明：

 DB_LOCALE = en_us.utf8 #（对应的 16 进制编码为：e01c）
 CLIENT_LOCALE = zh_cn.gb18030-2000 #（对应的 16 进制编码为：1570）
 以下 3 个文件必须存在，缺任意文件将报 Error -23101。
  - $InformixDIR/gls/lc11/en_us/e01c.lco 
  - $InformixDIR/gls/lc11/zh_cn/e01c.lco 
  - $InformixDIR/gls/lc11/zh_cn/1570.lco

Error -23104 Error opening required code-set conversion object file

当设置的 DB_LOCALE 和 CLIENT_LOCALE 的字符集对应的以下转换文件不存在时，会出现该错误。当然只有当 DB_LOCALE 和 CLIENT_LOCALE 的字符集不一致时才会需要转换，如果一致则不会出现 -23104 错误。

 - $InformixDIR/gls/cv9/ccccdddd.cvo 
 - $InformixDIR/gls/cv9/ddddcccc.cvo

其中：cccc 为 CLIENT_LOCALE 字符集编码对应的 16 进制值

dddd 为 DB_LOCALE 字符集编码对应的 16 进制值

举例说明：

 DB_LOCALE = en_us.utf8 #（对应的 16 进制编码为：e01c）
 CLIENT_LOCALE = zh_cn.gb18030-2000 #（对应的 16 进制编码为：1570）
 以下 2 个文件必须存在，缺任意文件将报 Error -23104。
  - $INFOMRIXDIR/gls/cv9/e01c1570.cvo 
  - $INFOMRIXDIR/gls/cv9/1570e01c.cvo

Error -23197 Database locale information mismatch

当出现如下情况时，出现 -23197 错误。

1. 定义的 DB_LOCALE 值与数据库的使用的值（数据库创建时使用的 DB_LOCALE 值）不一致；
2. 通过 SET COLLATION 语句定义 DB_LOCALE 值与数据库的使用值不一致 ;

举例说明：

 数据库的 LOCALE= en_us.8859-1 
 可以通过如下 SQL 读取当前数据库的 LOCALE 值
 SELECT dbs_collate FROM sysmaster:sysdbslocale WHERE dbs_dbsname = ‘ dbname ’ 
 客户端 DB_LOCALE 设置如下（注意：如果没有设置 DB_LOCALE，将使用在服务器计算机上设置的 DB_LOCALE），则会出现 -23197 错误DB_LOCALE = zh_cn.gb

Error -201，-202 数据库提示语法错误

Error -201，-202 数据库提示语法错误，不支持中文对象名，如中文表名、字段别名、视图名。该类错误提示原因是当前数据库的 DB_LOCALE 设置问题。

如果数据库的 DB_LOCALE 设置为 zh_cn.GB18030-2000，则数据库就可以支持中文对象名。

举例说明：

 DB_LOCALE = zh_cn.GB18030-2000 的数据库，可以支持如下中文对象名，否则将提示语法错误。
 Select c1 第一列 from test_cn; 
 Create table 中文表名 (c1 integer, 中文列名 integer); 
 drop table 中文表名 ; 
 若类似 SQL 不能运行，请核查数据库的 DB_LOCALE 值。
 SELECT dbs_collate FROM sysmaster:sysdbslocale WHERE dbs_dbsname = ‘dbname‘

乱码问题

Informix 字符出现乱码问题，或者不能正确显示中文字符。问题的原因是客户端 CLIENT_LOCALE 设置的值与 DB_LOCALE 值不一致，而且两者对应的字符集之间不能正确进行转换。需要重新设置 CLIENT_LOCALE 与 DB_LOCALE 的值，确保两者一致或者可以正确相互转换。

时间格式问题

Informix 数据库的时间格式由数据库服务器端环境变量 GL_DATE GL_DATETIME 控制，默认的字符集下默认的时间格式为：

 GL_DATE="%m/%d/%iy" 
 DATETIME="%iY-%m-%d %H:%M:%S"

但是，当我们设置了 DB_LOCALE 为 zh_cn.gb 的情形下，而没有设置 GL_DATE,DATETIME，则时间格式会采用 CLIENT_LOCALE 的值，在 zh_cn.gb 情况下，会出现：“2009 年 10 月 2 日”的日期格式，如果我们之前系统采用默认的时间格式的情况下，就会出现时间格式不匹配的错误。如果我们仍然需要采用默认的时间格式，我们需要在数据库服务端修改时间格式环境变量即可：

 GL_DATE="%m/%d/%iy" 
 DATETIME="%iY-%m-%d %H:%M:%S"

 1. 设置环境变量 DB_LOCALE 
 set DB_LOCALE=zh_cn.GB18030-2000 
 2. 创建数据库 create database dbname 
 3. 验证当前数据库字符集
 SELECT dbs_collate FROM sysmaster:sysdbslocale 
 WHERE dbs_dbsname = ‘dbname‘

设置语言环境变量
 DB_LOCALE=zh_cn.GB18030-2000 
 CLIENT_LOCALE=zh_cn.GB18030-2000

数据库服务器端：
 1. 设置环境变量： IFMX_UNDOC_B168163=1 
 2. 将 en_us.8859-1 字符集文件拷贝到 zh_cn 目录下
     cd $INFORMIXDIR/gls/lc11 
     cp ./en_us/0333.lco ./zh_cn 
 3. 重新启动 IDS 
客户端：
设置语言环境：
     l DB_LOCALE=zh_cn.GB18030-2000 
     l CLIENT_LOCALE=zh_cn.GB18030-2000

数据库服务器端：
在创建数据库实例前，设置环境变量
 DB_LOCALE=zh_cn.GB18030-2000 
 CLIENT_LOCALE=zh_cn.GB18030-2000 
创建数据库
数据库客户端端：
需要在 setnet32、ODBC、JDBC 连接中配置
 DB_LOCALE=zh_cn.GB18030-2000 
 CLIENT_LOCALE=zh_cn.GB18030-2000

数据库服务器端：
在创建数据库实例前，设置环境变量
 DB_LOCALE=en_us.utf8 
 CLIENT_LOCALE= en_us.utf8 
创建数据库
数据库客户端端：
需要在 setnet32、ODBC、JDBC 连接中配置
 DB_LOCALE= en_us.utf8 
 CLIENT_LOCALE= en_us.utf8