区域和格式化

介绍时间格式设置的相关参数。

DateStyle

**参数说明：**设置日期和时间值的显示格式，以及有歧义的输入值的解析规则。

这个变量包含两个独立的加载部分：输出格式声明（ISO、Postgres、SQL、German）和输入输出的年/月/日顺序（DMY、MDY、YMD）。这两个可以独立设置或者一起设置。关键字Euro和European等价于DMY；关键字US、NonEuro、NonEuropean等价于MDY。

该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**字符串

**默认值：**ISO, MDY

区域和格式化 - 图1 说明：

gs_initdb会将这个参数初始化成与lc_time一致的值。

**设置建议：**优先推荐使用ISO格式。Postgres、SQL和German均采用字母缩写的形式来表示时区，例如“EST、WST、CST”等。这些缩写可同时指代不同的时区，比如CST可同时代表美国中部时间(Central Standard Time (USA) UT-6:00)、澳大利亚中部时间(Central Standard Time (Australia) UT+9:30)、中国标准时间(China Standard Time UT+8:00)。这种情况下在时区转化时可能会得不到正确的结果，从而引发其他问题。

IntervalStyle

**参数说明：**设置区间值的显示格式。

该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**枚举类型

  • sql_standard表示产生与SQL标准规定匹配的输出。
  • postgres表示产生与PostgreSQL 8.4版本相匹配的输出，当DateStyle参数被设为ISO时。
  • postgres_verbose表示产生与PostgreSQL 8.4版本相匹配的输出，当DateStyle参数被设为non_ISO时。
  • iso_8601表示产生与在ISO 8601中定义的“格式与代号”相匹配的输出。
  • a表示与numtodsinterval函数相匹配的输出结果，详细请参考numtodsinterval。

区域和格式化 - 图2 须知：

IntervalStyle参数也会影响不明确的间隔输入的说明。

**默认值：**postgres

TimeZone

**参数说明：**设置显示和解释时间类型数值时使用的时区。

该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**字符串，可查询视图PG_TIMEZONE_NAMES获得。

**默认值：**GMT

区域和格式化 - 图3 说明：

gs_initdb将设置一个与其系统环境一致的时区值。

timezone_abbreviations

**参数说明：**设置服务器接受的时区缩写值。

该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**字符串，可查询视图pg_timezone_names获得。

**默认值：**Default

区域和格式化 - 图4 说明：

Default表示通用时区的缩写, 适合绝大部分情况。但也可设置其他诸如 ‘Australia’ 和 ‘India’ 等用来定义特定的安装。而设置除此之外的时区缩写, 需要在建数据库之前通过相应的配置文件进行设置。

extra_float_digits

**参数说明：**这个参数为浮点数值调整显示的数据位数，浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上（FLT_DIG或DBL_DIG中合适的）。

该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**整型，-15～3

区域和格式化 - 图5 说明：

  • 设置为3，表示包括部分关键的数据位。这个功能对转储那些需要精确恢复的浮点数据特别有用。
  • 设置为负数，表示消除不需要的数据位。

**默认值：**0

client_encoding

**参数说明：**设置客户端的字符编码类型。

请根据前端业务的情况确定。尽量客户端编码和服务器端编码一致，提高效率。

该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。

区域和格式化 - 图6 说明：

  • 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
  • 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。
  • 参数建议保持默认值，不建议通过gs_guc工具或其他方式直接在postgresql.conf文件中设置client_encoding参数，即使设置也不会生效，以保证openGauss内部通信编码格式一致。

**默认值：**UTF8

**推荐值：**SQL_ASCII/UTF8

lc_messages

**参数说明：**设置信息显示的语言。

  • 可接受的值是与系统相关的。

  • 在一些系统上，这个区域范畴并不存在，不过仍然允许设置这个变量，只是不会有任何效果。同样，也有可能是所期望的语言的翻译信息不存在。在这种情况下，用户仍然能看到英文信息。

    该参数属于SUSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**字符串

区域和格式化 - 图7 说明：

  • 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
  • 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。

**默认值：**C

lc_monetary

**参数说明：**设置货币值的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。

该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**字符串

区域和格式化 - 图8 说明：

  • 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
  • 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。

**默认值：**C

lc_numeric

**参数说明：**设置数值的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。

该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**字符串

区域和格式化 - 图9 说明：

  • 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
  • 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。

**默认值：**C

lc_time

**参数说明：**设置时间和区域的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。

该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**字符串

区域和格式化 - 图10 说明：

  • 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。
  • 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。

**默认值：**C

default_text_search_config

**参数说明：**设置全文检索的配置信息。

如果设置为不存在的文本搜索配置时将会报错。如果default_text_search_config对应的文本搜索配置被删除，需要重新设置default_text_search_config，否则会报设置错误。

  • 其被文本搜索函数使用，这些函数并没有一个明确指定的配置。

  • 当与环境相匹配的配置文件确定时，gs_initdb会选择一个与环境相对应的设置来初始化配置文件。

    该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。

**取值范围：**字符串

区域和格式化 - 图11 说明：

openGauss支持pg_catalog.english、pg_catalog.simple两种配置。

**默认值：**pg_catalog.english