华为云用户手册

autovacuum_mode 参数说明：该参数仅在autovacuum设置为on的场景下生效，它控制autoanalyze和autovacuum的打开情况。 参数类型：枚举类型 参数单位：无 取值范围：analyze、vacuum、mix、none analyze：表示只做autoanalyze。 vacuum：表示只做autovacuum。 mix：表示autoanalyze和autovacuum都做。 none：表示autoanalyze和autovacuum都不做。 默认值：mix 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：建议设置为默认值。

GS_GET_LISTEN_ADDRESS_EXT_INFO GS_GET_LISTEN_ADDRESS_EXT_INFO视图描述了查询当前DN实例扩展IP配置信息。具体使用场景参见gs_get_listen_address_ext_info()。 表1 GS_GET_LISTEN_ADDRESS_EXT_INFO字段 名称 类型 描述 node_name text DN实例名。 host text DN实例侦听IP。 port bigint DN实例侦听的port。 ext_listen_ip text DN实例配置扩展IP。 父主题： 通信

执行没有结果集的语句 执行EXECUTE IMMEDIATE命令示例如下： EXEC SQL BEGIN DECLARE SECTION; const char *stmt = "CREATE TABLE test1 (...);"; EXEC SQL END DECLARE SECTION; EXEC SQL EXECUTE IMMEDIATE :stmt; EXECUTE IMMEDIATE可以用于不返回结果集的SQL语句，比如：DDL、INSERT、UPDATE和DELETE语句。但不能用这种方式执行检索数据的语句，比如：SELECT语句。 父主题： 执行动态SQL语句

maintenance_work_mem 参数说明：设置在维护性操作（比如VACUUM、CREATE INDEX等）中可使用的最大的内存。该参数的设置会影响VACUUM、VACUUM FULL、CLUSTER、CREATE INDEX的执行效率。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，1024~2147483647‬，单位为KB。 默认值： 独立部署： CN：1GB（60核CPU/480G内存）；512MB（32核CPU/256G内存）；256MB（16核CPU/128G内存）；128MB（8核CPU/64G内存）；64MB（4核CPU/32G内存）；32MB（4核CPU/16G内存） DN：2GB（60核CPU/480G内存）；1GB（32核CPU/256G内存）；512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存）；128MB（4核CPU/32G内存）；64MB（4核CPU/16G内存） 金融版（标准型）： CN：1GB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存）；512MB（72核CPU/576G内存，64核CPU/512G内存）；256MB（60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存） DN：2GB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）；1GB（32核CPU/256G内存）；512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存） 企业版： CN：1GB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存）；512MB（72核CPU/576G内存，64核CPU/512G内存）；256MB（60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存） DN：2GB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）；1GB（32核CPU/256G内存）；512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存） 金融版（数据计算型）： CN：1GB（196核CPU/1536G内存，128核CPU/1024G内存，96核CPU/768G内存）；256MB（72核CPU/576G内存，64核CPU/512G内存）；128MB（32核CPU/256G内存） DN：2GB（196核CPU/1536G内存，128核CPU/1024G内存，96核CPU/768G内存）；1GB（72核CPU/576G内存，64核CPU/512G内存）；512MB（32核CPU/256G内存） 设置建议： 建议设置此参数的值大于work_mem，可以改进清理和恢复数据库转储的速度。因为在一个数据库会话里，任意时刻只有一个维护性操作可以执行，并且在执行维护性操作时不会有太多的会话。 当自动清理线程运行时，autovacuum_max_workers倍数的内存将会被分配，所以此时设置maintenance_work_mem的值应该不小于work_mem。 如果进行大数据量的cluster等，可以在session中调大该值。

max_stack_depth 参数说明：设置GaussDB执行堆栈的最大安全深度。需要这个安全界限是因为在服务器里，并非所有程序都检查了堆栈深度，只是在可能递规的过程，比如表达式计算这样的过程里面才进行检查。 参数类型：整型 参数单位：KB 取值范围：100~2147483647 默认值： （ulimit -s的设置）- 640 KB的值大于等于2MB时，此参数的默认值为2MB。 （ulimit -s的设置）- 640 KB的值小于2MB时，此参数的默认值为（ulimit -s的设置）- 640 KB。 设置方式：该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。 设置建议： 数据库需要预留640KB堆栈深度，因此此参数可设置的最大值等于操作系统内核允许的最大值（就是ulimit -s的设置）- 640KB。 数据库未运行前设置的该参数值大于（ulimit -s的设置）- 640 KB时会导致数据库启动失败；数据库运行阶段设置该参数值大于（ulimit -s的设置）- 640 KB时该值不生效。 若（ulimit -s的设置）-640KB小于此参数取值范围的最小值时会导致数据库启动失败。 如果设置此参数的值大于实际的内核限制，则一个正在运行的递归函数可能会导致一个独立的服务器进程崩溃。 因为并非所有的操作都能够检测，所以建议用户在此设置一个明确的值。 默认值最大为2MB，这个值相对比较小，不容易导致系统崩溃。

resilience_escape_user_permissions 参数说明：设置用户权限，以逗号分隔，可以设置多个，设置多个则表示多个特殊权限的用户都支持逃生能力，只设置一个则只针对一个特权用户进行逃生。sysadmin控制sysadmin用户的作业是否会被该逃生功能进行cancel处理；monadmin控制monadmin用户的作业是否会被该逃生功能进行cancel处理；默认为空，表示关闭sysadmin和monadmin用户的逃生能力。当前取值仅支持sysadmin，monadmin或者空字符串。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，长度大于0。 该参数目前只支持三个取值：sysadmin，monadmin或''，这几个值的具体含义如下： sysadmin：控制sysadmin用户的作业是否会被该逃生功能进行cancel处理。 monadmin：控制monadmin用户的作业是否会被该逃生功能进行cancel处理。 ''：关闭sysadmin和monadmin用户的逃生能力。 默认值：''，关闭sysadmin和monadmin用户的逃生能力。 示例： resilience_escape_user_permissions = 'sysadmin,monadmin' 表示同时开启sysadmin和monadmin用户的逃生功能。 该参数可以同时设置多个值，以逗号分隔，例如resilience_escape_user_permissions = 'sysadmin,monadmin'，也可以只设置一个值，例如resilience_escape_user_permissions = 'monadmin'。 若该参数多次设置，以最新的设置生效。 该参数设置为取值范围中的任意值，普通用户都支持该逃生功能。 当用户同时具有sysadmin和monadmin时，resilience_escape_user_permissions必须要同时设置'sysadmin,monadmin'才能触发该用户的逃生功能。

resilience_memory_reject_percent 参数说明：用于控制内存过载逃生的动态内存占用百分比。该参数仅在GUC参数use_workload_manager和enable_memory_limit打开时生效。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，长度大于0。 该参数分为recover_memory_percent、overload_memory_percent两个部分： recover_memory_percent：内存从过载状态恢复正常状态的动态内存使用占最大动态内存的百分比，当动态内存使用小于最大动态内存乘以该值对应的百分比后，停止过载逃生并放开新连接接入，取值为0~100，设置为多少表示百分之多少。 overload_memory_percent：内存过载时动态内存使用占最大动态内存的百分比，当动态内存使用大于最大动态内存乘以该值对应的百分比后，表示当前内存已经过载，触发过载逃生kill会话并禁止新连接接入，取值为0~100，设置为多少表示百分之多少。 默认值：'0,0'，表示关闭内存过载逃生功能。 示例： resilience_memory_reject_percent = '70,90' 表示内存使用超过最大内存上限的90%后禁止新连接接入并kill堆积的会话，kill会话过程中内存恢复到最大内存的70%以下时停止kill会话并允许新连接接入。 最大动态内存和已使用的动态内存可以通过pv_total_memory_detail视图查询获得，最大动态内存：max_dynamic_memory，已使用的动态内存：dynamic_used_memory。 该参数如果设置的百分比过小，则会频繁触发内存过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际内存使用情况慎重设置。 use_workload_manager参数关闭的情况下，如果打开bypass_workload_manager，则该参数也会生效，但是因为bypass_workload_manager是SIGHUP类型，reload方式设置后需要重启数据库才会使得当前功能生效。 recover_memory_percent和overload_memory_percent的值可以同时为0，除此之外，recover_memory_percent的值必须要小于overload_memory_percent，否则会设置不生效。

page_version_partitions 参数说明：内存中缓存页面版本信息的哈希表分区数量，分区数量直接影响哈希查询效率和哈希冲突概率。 参数类型：整型 参数单位：个 取值范围：0 ~ 2097152 0：page_version_check非OFF情况下，根据page_version_max_num自动计算，page_version_partitions=page_version_max_num/512。若自动计算结果小于4，则强制设置为4。 非0：将强制使用手动配置的数值。page_version_check非OFF情况下，最小值为4。如果取值小于4，则会被强制设置为4。 默认值：0 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：对性能较高要求的情况，建议手动设置为page_version_max_num的256分之一到1024分之一左右。

temp_buffers 参数说明：设置每个数据库会话使用的LOCAL临时缓冲区的大小。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 在每个会话的第一次使用临时表之前可以改变temp_buffers的值，之后的设置将是无效的。 一个会话将按照temp_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。 取值范围：整型，100~1073741823，单位为8KB。 默认值：1MB

page_version_recycler_thread_num 参数说明：控制回收和校验页面版本信息的线程数量，只在page_version_check非OFF情况下生效。 参数类型：整型 参数单位：个 取值范围：0 ~ 16 page_version_check参数值为memory时： 0：根据page_version_partitions自动计算，page_version_recycler_thread_num=page_version_partitions/16384。若自动计算结果大于4，则强制设置为4。 非0：将强制使用手动配置的数值。 不允许大于page_version_partitions，如果大于，则会被强制设置为page_version_partitions的值。 page_version_check参数值为persistence时： 小于2时将设置为2，大于等于2时强制使用手动配置的参数。 默认值：0 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议设置为默认值0。

work_mem 参数说明：设置内部排序操作和Hash表在开始写入临时磁盘文件之前使用的内存大小。ORDER BY、DISTINCT和merge joins都要用到排序操作。Hash表在散列连接、散列为基础的聚集、散列为基础的IN子查询处理中都要用到。 对于复杂的查询，可能会同时并发运行好几个排序或者散列操作，每个都可以使用此参数所声明的内存量，不足时会使用临时文件。同样，好几个正在运行的会话可能会同时进行排序操作。因此使用的总内存可能是work_mem的好几倍。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，64~2147483647，单位为KB。 默认值： 独立部署： 128MB（60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存）；64MB（8核CPU/64G内存）；32MB（4核CPU/32G内存）；16MB（4核CPU/16G内存） 金融版（标准型）： CN：128MB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存）；64MB（8核CPU/64G内存） DN：256MB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存）；128MB（80核CPU/640G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存）；64MB（8核CPU/64G内存） 企业版： 128MB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存）；64MB（8核CPU/64G内存） 金融版（数据计算型）： 128MB（196核CPU/1536G内存，128核CPU/1024G内存，96核CPU/768G内存，72核CPU/576G内存，64核CPU/512G内存）；64MB（32核CPU/256G内存） 设置建议：依据查询特点和并发来确定，一旦work_mem限定的物理内存不够，算子运算数据将写入临时表空间，带来5-10倍的性能下降，查询响应时间从秒级下降到分钟级。 对于串行无并发的复杂查询场景，平均每个查询有5-10关联操作，建议work_mem=50%内存/10。 对于串行无并发的简单查询场景，平均每个查询有2-5个关联操作，建议work_mem=50%内存/5。 对于并发场景，建议work_mem=串行下的work_mem/物理并发数。 对于BitmapScan的哈希表也会受到work_mem的限制，但不会被严格管控下盘。完全Lossify的情况下，哈希表每占用1MB的内存，对应一次BitmapHeapScan的16GB的页面，达到work_mem上限后，会按此比例随数据访问量线性增长。

max_prepared_transactions 参数说明：设置可以同时处于“预备”状态的事务的最大数目。增加此参数的值会使GaussDB比系统默认设置需要更多的System V共享内存。 当GaussDB部署为主备双机时，在备机上此参数的设置必须要高于或等于主机上的，否则无法在备机上进行查询操作。 参数类型：整型 参数单位：无 取值范围：0 ~ 262143 默认值： 独立部署： 1200（60核CPU/480G内存，32核CPU/256G内存）；800（16核CPU/128G内存）；400（8核CPU/64G内存）；300（4核CPU/32G内存）；200（4核CPU/16G内存） 金融版（标准型）： CN：1200（196核CPU/1536G内存）；900（128核CPU/1024G内存，104核CPU/1024G内存）；800（96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）：400（32核CPU/256G内存，16核CPU/128G内存）；200（8核CPU/64G内存） DN：4200（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）：2200（32核CPU/256G内存）；1200（16核CPU/128G内存）；800（8核CPU/64G内存） 企业版： CN：1200（196核CPU/1536G内存）；900（128核CPU/1024G内存，104核CPU/1024G内存）；800（96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）；400（32核CPU/256G内存，16核CPU/128G内存）；200（8核CPU/64G内存） DN：1800（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存）；1200（96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）：800（32核CPU/256G内存）；400（16核CPU/128G内存，8核CPU/64G内存） 金融版（数据计算型）： CN：1200（196核CPU/1536G内存）；800（128核CPU/1024G内存，96核CPU/768G内存）；400（72核CPU/576G内存，64核CPU/512G内存）；200（32核CPU/256G内存） DN：2400（196核CPU/1536G内存，128核CPU/1024G内存，96核CPU/768G内存）；1200（72核CPU/576G内存）；800（64核CPU/512G内存）；400（32核CPU/256G内存）

verify_log_buffers 参数说明：控制verifyLog buffer大小，只在page_version_check为persistence情况下生效。verifyLog buffer内存按页面管理，每页8kB。 参数类型：整型 参数单位：页（8kB） 取值范围：4 ~ 262144 默认值：4（32kB） 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。例如，取值131072表示verify_log_buffers为131072 * 8 kB = 1GB；取值131072kB表示verify_log_buffers为131072kB。取值如果带单位，必须为kB、MB、GB，且必须为8kB整数倍。 设置建议：根据系统硬件规格，进行相应的设置。 1GB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存）；512MB（16核CPU/128G内存）；256MB（8核CPU/64G内存）；128MB（4核CPU/32G内存）；16MB（4核CPU/16G内存）。

enable_memory_limit 参数说明：启用逻辑内存管理模块。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示启用逻辑内存管理模块。 off表示不启用逻辑内存管理模块。 默认值：on 由于存在固定开销，即shared_buffers和元数据（大约200MB），若max_process_memory减去固定开销小于2GB，GaussDB强制把enable_memory_limit设置为off。其中元数据是GaussDB内部使用的内存，和部分并发参数，如max_connections，thread_pool_attr，max_prepared_transactions等参数相关。 当该值为off时，不对数据库使用的内存做限制，在大并发或者复杂查询时，使用内存过多，可能导致操作系统OOM问题。

max_process_memory 参数说明：设置一个数据库节点可用的最大物理内存。 参数类型：整型 参数单位：kB 取值范围：2097152 ~ 2147483647 默认值： 独立部署：360GB（60核CPU/480G内存）；192GB（32核CPU/256G内存）；96GB（16核CPU/128G内存）；40GB（8核CPU/64G内存）；20GB（4核CPU/32G内存）；10GB（4核CPU/16G内存） 金融版（标准型）： CN：300GB（196核CPU/1536G内存）；200GB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；160GB（96核CPU/768G内存）；130GB（80核CPU/640G内存）；120GB（72核CPU/576G内存）；100GB（64核CPU/512G内存，60核CPU/480G内存）；50GB（32核CPU/256G内存）；20GB（16核CPU/128G内存）；10GB（8核CPU/64G内存） DN：550GB（196核CPU/1536G内存）；350GB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；260GB（96核CPU/768G内存）；220GB（80核CPU/640G内存）；200GB（72核CPU/576G内存）；180GB（64核CPU/512G内存）；160GB（60核CPU/480G内存）；80GB（32核CPU/256G内存）；40GB（16核CPU/128G内存）；20GB（8核CPU/64G内存） 企业版： CN：200GB（196核CPU/1536G内存）；150GB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；110GB（96核CPU/768G内存）；90GB（80核CPU/640G内存）；80GB（72核CPU/576G内存）；75GB（80核CPU/512G内存，64核CPU/512G内存）；70GB（60核CPU/480G内存）；35GB（32核CPU/256G内存）；15GB（16核CPU/128G内存）；9GB（8核CPU/64G内存） DN：400GB（196核CPU/1536G内存）；250GB（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；190GB（96核CPU/768G内存）；160GB（80核CPU/640G内存）；140GB（72核CPU/576G内存）；125GB（80核CPU/512G内存，64核CPU/512G内存）；120GB（60核CPU/480G内存）；60GB（32核CPU/256G内存）；25GB（16核CPU/128G内存）；15GB（8核CPU/64G内存） 金融版（数据计算型）： CN：160GB（196核CPU/1536G内存）；120GB（128核CPU/1024G内存）；100GB（96核CPU/768G内存）；60GB（72核CPU/576G内存，64核CPU/512G内存）；20GB（32核CPU/256G内存） DN：300GB（196核CPU/1536G内存）；200GB（128核CPU/1024G内存）；150GB（96核CPU/768G内存）；110GB（72核CPU/576G内存）；100GB（64核CPU/512G内存）；40GB（32核CPU/256G内存） 当该值设置不合理，即大于服务器物理内存，可能导致操作系统OOM问题。

page_version_max_num 参数说明：内存中所能缓存的页面版本信息的最大数量，在page_version_check非OFF情况下生效。合理的数量应该是shared_buffers数量的2倍到4倍。每个page_version内存占用36字节，请注意内存使用量。 参数类型：整型 参数单位：个 取值范围：0 ~ 2147483647。 0：page_version_check非OFF情况下，根据shared_buffers大小自动计算，page_version_max_num=shared_buffers*2。例如，32M shared_buffers对应4096个buffer，所以页面版本信息数量设置为8192个。 非0：将强制使用手动配置的数值。 page_version_check非OFF情况下，不允许小于page_version_partitions的16倍，如果小于，则会被强制设置为page_version_partitions*16。 默认值：0 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：对性能有较高要求且内存足够的情况，建议手动设置为shared_buffers数量的4倍且与page_version_partitions的比值范围为[256, 1024]。

local_syscache_threshold 参数说明：系统表cache在单个session缓存的大小。如果enable_global_plancache已打开，为保证GPC生效，local_syscache_threshold设置值小于16MB时不会生效，最小为16MB。如果enable_global_syscache和enable_thread_pool打开，该参数描述的是当前线程和绑定到当前线程上的session缓存的总大小。 参数类型：整型 参数单位：kB 取值范围： 方式一：设置为不带单位的整数，整数范围为1*1024～512*1024。建议设置为1024的整数倍。例如设置为2048，表示2048kB。 方式二：设置为带单位的值，范围为1*1024kB～512*1024kB。例如设置为32MB，表示32MB的大小。单位仅限于“kB”、“MB”和“GB”。 默认值： 独立部署：16MB 金融版（标准型）： 32MB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存）；16MB（72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存） 企业版： 32MB（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存）；16MB（60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存） 金融版（数据计算型）：16MB

page_missing_dirty_check 参数说明：页面漏置脏校验的功能开关，检测被修改页面是否忘记置脏。page_missing_dirty_check受控于page_version_check，page_version_check如果设置为off，则page_missing_dirty_check设置on不生效。 参数类型：布尔型 参数单位：无 取值范围： on：表示进行页面漏置脏校验。 off：表示不进行页面漏置脏校验。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议在测试场景中开启此开关，能够最大限度在非生产环境中排查出漏置脏代码BUG。在现网时默认关闭页面漏置脏，避免带来额外开销，进而影响性能。

page_version_check 参数说明：基于页面版本信息，开启底层存储故障校验和页面漏置脏校验功能的总开关，page_version_check是一个三级开关。其中，底层存储故障校验功能是检测从底层存储读取的页面是否为正确版本，防止磁盘掉电等故障情况导致的页面版本信息丢失；页面漏置脏校验功能用于检测被修改页面是否忘记置脏，它由单独开关page_missing_dirty_check进行控制。 参数类型：枚举类型 参数单位：无 取值范围： off：表示完全关闭底层存储故障校验和页面漏置脏校验的功能开关。 memory：表示打开纯内存态的页面版本校验功能（即底层存储故障校验和页面漏置脏校验），页面版本信息只缓存在内存当中，重启丢失。 persistence：表示打开持久态的页面版本校验功能（即底层存储故障校验和页面漏置脏校验），页面版本信息会持久化到文件中，重启不丢失。 默认值：memory 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据不同机器规格，建议如下设置：off（4核CPU/16GB内存、4核CPU32GB内存、8核CPU/64GB内存）；memory（16核CPU/128GB内存、32核CPU/256GB内存、60核CPU/480GB内存、64核CPU/512GB内存、72核CPU/576GB内存、80核CPU/640GB内存、96核CPU/768GB内存、96核CPU/1024GB内存、104核CPU/1024GB内存、128核CPU/1024GB内存、196核CPU/1536GB内存）。开关设置为memory，对性能有一定影响，机器规格越小，影响越大（参考：16核CPU/128GB内存，TPCC模型影响7%左右）。在系统需要频繁重启的场景下，建议设置为persistence，能够确保页面版本信息不丢失，但会进一步影响性能。

boolvector 场景1： 功能说明：数组数据转换为向量数据。 入参类型：anyarray 出参类型：boolvector 代码示例： gaussdb=# SELECT boolvector(ARRAY[1,0,1]); 场景2： 功能说明：boolvector转换，对维度进行检测。 入参1的类型：boolvector 入参2的类型：integer 出参类型：boolvector 代码示例： gaussdb=# SELECT boolvector(boolvector('[1,0,1]'),3);

floatvector 功能说明：数组数据转换为向量数据。 场景1： 入参类型：anyarray 出参类型：floatvector 代码示例： gaussdb=# SELECT floatvector(ARRAY[1,2,9.3]); 场景2： 入参1的类型：floatvector 入参2的类型：integer 出参类型：floatvector 代码示例： gaussdb=# SELECT floatvector(floatvector('[1,2,9.3]'),3);

gs_vector_index_options 功能说明：显示相关向量索引的超参取值。 入参类型：text 出参类型：text 代码示例： --创建表。 gaussdb=# CREATE TABLE t1 (id int unique,repr floatvector(960)) with (storage_type=astore); 插入数据： gaussdb=# copy t1 from '/data/gist1w.txt' delimiter '^'; 创建索引: gaussdb=# CREATE INDEX test1v on t1 using gsdiskann (repr l2) with (pq_nseg=120,pq_nclus=64,queue_size=120,num_parallels=30,enable_pq=true,using_clustering_for_parallel=false); gaussdb=# SELECT gs_vector_index_options('test1v');

+ 功能说明：计算两个维度相同的向量按位相加。 左参数类型：floatvector 右参数类型：floatvector 返回值类型：floatvector 代码示例： gaussdb=# SELECT floatvector('[1,1,3,2]') + floatvector('[1,1,3,2]'); gaussdb=# SELECT '[1,2,3,2]'+ floatvector('[1,1,3,2]');

- 功能说明：计算两个维度相同的向量按位相减。 左参数类型：floatvector 右参数类型：floatvector 返回值类型：floatvector 代码示例： gaussdb=# SELECT floatvector('[1,1,3,2]') + floatvector('[1,1,3,2]'); gaussdb=# SELECT '[1,2,3,2]'+ floatvector('[1,1,3,2]');

= 场景1： 功能说明：判断两个维度相同的向量是否相等。 左参数类型：floatvector 右参数类型：floatvector 返回值类型：BOOLEAN 代码示例： gaussdb=# SELECT floatvector('[1,1,3,2]') = floatvector('[1,1,3,2]'); gaussdb=# SELECT '[1,2,3,2]'= floatvector('[1,1,3,2]'); 场景2： 功能说明：判断两个维度相同的布尔向量是否一致。 左参数类型：boolvector 右参数类型：boolvector 返回值类型：BOOLEAN 代码示例： gaussdb=# SELECT boolvector('[1,0,1,0]') = boolvector('[1,1,1,0]'); gaussdb=# SELECT '[1,0,1,0]' = boolvector('[1,1,1,0]');

注意事项 当enable_access_server_directory=off时，只允许初始用户删除directory对象。 当enable_access_server_directory=on时，具有SYSADMIN权限的用户、directory对象的属主、被授予了该directory的DROP权限的用户或者继承了内置角色gs_role_directory_drop权限的用户可以删除directory对象。

示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 BEGIN DBE_OUTPUT.SET_BUFFER_SIZE(50); DBE_OUTPUT.PRINT('hello, '); DBE_OUTPUT.PRINT_LINE('database!');--输出hello, database! END; / -- 预期结果为： hello, database! ANONYMOUS BLOCK EXECUTE -- 测试disable禁用put、put_line、new_line、get_line、get_lines调用,测试put_line不输出 BEGIN dbe_output.disable(); dbe_output.put_line('1'); END; / -- 预期结果为： ANONYMOUS BLOCK EXECUTE -- 测试enable启用put、put_line、new_line、get_line、get_lines调用，测试put_line输出1 BEGIN dbe_output.enable(); dbe_output.put_line('1'); END; / -- 预期结果为： 1 ANONYMOUS BLOCK EXECUTE -- 测试put，输入字符串a放入到缓冲区，末尾不加换行符，a不输出 BEGIN dbe_output.enable(); dbe_output.put('a'); END; / -- 预期结果为： ANONYMOUS BLOCK EXECUTE -- 测试new_line,添加换行，输出a BEGIN dbe_output.enable(); dbe_output.put('a'); dbe_output.new_line; END; / -- 预期结果为： a ANONYMOUS BLOCK EXECUTE -- 测试get_line获取缓冲区数据保存到变量，使用put_line输出 DECLARE line VARCHAR(32672); status INTEGER := 0; BEGIN dbe_output.put_line('hello'); dbe_output.get_line(line, status); dbe_output.put_line('-----------'); dbe_output.put_line(line); dbe_output.put_line(status); END; / -- 预期结果为： ----------- hello 0 ANONYMOUS BLOCK EXECUTE -- 测试get_lines获取缓冲区多行内容，使用put_line输出 DECLARE lines varchar[]; linenum integer; BEGIN dbe_output.put_line('line 1'); dbe_output.put_line('line 2'); dbe_output.put_line('line 3'); linenum := 100; dbe_output.get_lines(lines, linenum); dbe_output.put_line('num: ' || linenum); FOR i IN 1 .. linenum LOOP dbe_output.put_line(lines[i]); END LOOP; END; / -- 预期结果为： num: 3 line 1 line 2 line 3 ANONYMOUS BLOCK EXECUTE 当服务端的字符编码类型server_encoding不为UTF8时，如果数据中存在字符编码属于合法的UTF8编码，DBE_OUTPUT.PUTLINE函数和DBE_OUTPUT.PUT函数在处理该字符编码时会将其按照UTF8编码逻辑进行处理，将其先转换成server_encoding的编码格式后再进行后续操作，这样可能会导致函数返回值不符合预期或发生报错；当开启GUC参数enable_convert_illegal_char后，DBE_OUTPUT.PUTLINE函数和DBE_OUTPUT.PUT函数在处理此类编码的表现与参数关闭时保持一致，特殊字符不会以占位符形式输出，因此不建议用户对含有特殊字符的数据使用DBE_OUTPUT.PUTLINE函数和DBE_OUTPUT.PUT函数。

接口介绍 高级功能包DBE_OUTPUT支持的所有接口请参见表 DBE_OUTPUT。 表1 DBE_OUTPUT 接口名称 描述 DBE_OUTPUT.PRINT_LINE 输出指定的文本，并添加换行符。 DBE_OUTPUT.PRINT 输出指定的文本，不添加换行符。 DBE_OUTPUT.SET_BUFFER_SIZE 设置输出缓冲区的大小，如果不指定则缓冲区最大能容纳20000字节，如果指定小于等于2000字节，则缓冲区允许容纳2000字节。 DBE_OUTPUT.DISABLE 禁用PUT、PUT_LINE、NEW_LINE、GET_LINE、GET_LINES调用，并清空输出缓冲区。 DBE_OUTPUT.ENABLE 开启缓冲区，允许对PUT、PUT_LINE、NEW_LINE、GET_LINE和GET_LINES的调用，设置缓冲区大小。 DBE_OUTPUT.GET_LINE 从缓冲区中以换行符作为分界获取一行数据，获取的数据将不会输出到客户端。 DBE_OUTPUT.GET_LINES 以VARCHAR数组的形式获取缓冲区的指定行数的字符串，被取出的内容将会在缓冲区中清除，不会输出到客户端。 DBE_OUTPUT.NEW_LINE 放置一行在缓冲区末尾，放置行尾标记，空出新的一行。 DBE_OUTPUT.PUT 将输入字符串放入到缓冲区，末尾不加换行符，在匿名块执行结束时会将以换行符结尾的行输出显示。 DBE_OUTPUT.PUT_LINE 将输入字符串放入到缓冲区，并末尾添加换行符，在匿名块执行结束时会将以换行符结尾的行输出显示。 DBE_OUTPUT.PRINT_LINE 存储过程PRINT_LINE输出指定的文本，并添加换行符。DBE_OUTPUT.PRINT_LINE函数原型为： 1 2 DBE_OUTPUT.PRINT_LINE ( format IN VARCHAR2); 表2 DBE_OUTPUT.PRINT_LINE接口参数说明 参数 描述 format 输出的文本。 DBE_OUTPUT.PRINT 存储过程PRINT输出指定的文本，不添加换行符。DBE_OUTPUT.PRINT函数原型为： 1 2 DBE_OUTPUT.PRINT ( format IN VARCHAR2); 表3 DBE_OUTPUT.PRINT接口参数说明 参数 描述 format 输出的文本。 DBE_OUTPUT.SET_BUFFER_SIZE 存储过程SET_BUFFER_SIZE设置输出缓冲区的大小，如果不指定的话缓冲区最大只能容纳20000字节。DBE_OUTPUT.SET_BUFFER_SIZE函数原型为： 1 2 DBE_OUTPUT.SET_BUFFER_SIZE ( size IN INTEGER default 20000); 表4 DBE_OUTPUT.SET_BUFFER_SIZE接口参数说明 参数 描述 size 设置输出缓冲区的大小。 DBE_OUTPUT.DISABLE 存储过程DISABLE禁用PUT、PUT_LINE、NEW_LINE、GET_LINE、GET_LINES调用，并清空输出缓冲区。DBE_OUTPUT.DISABLE函数原型为： 1 DBE_OUTPUT.DISABLE;

LOCAL_THREADPOOL_STATUS LOCAL_THREADPOOL_STATUS视图显示线程池下工作线程及会话的状态信息，如表1所示。该视图仅在线程池开启（enable_thread_pool=on）时生效。 表1 LOCAL_THREADPOOL_STATUS字段 名称 类型 描述 node_name text 数据库进程名称。 group_id integer 线程池组ID。 bind_numa_id integer 该线程池组绑定的NUMA ID。 bind_cpu_number integer 该线程池组绑定的CPU信息。如果未绑定CPU，该值为NULL。 listener integer 该线程池组的Listener线程数量。 worker_info text 线程池中线程相关信息，包括以下信息： default：该线程池组中的初始线程数量。 new：该线程池组中新增线程的数量。 expect：该线程池组中预期线程的数量。 actual：该线程池组中实际线程的数量。 idle：该线程池组中空闲线程的数量。 pending：该线程池组中等待线程的数量。 session_info text 线程池中会话相关信息，包括以下信息： total：该线程池组中所有的会话数量。 waiting：该线程池组中等待调度的会话数量。 running：该线程池中正在执行的会话数量。 idle：该线程池组中空闲的会话数量。 stream_info text stream池相关信息，包含以下信息： total：该stream池组中所有的线程数量。 running：该stream池中正在执行的线程数量。 idle：该stream池组中空闲的线程数量。 父主题： Session/Thread

PG_STATIO_ALL_INDEXES PG_STATIO_ALL_INDEXES视图可用来查询当前数据库中的每个索引行的信息，显示特定索引的I/O的统计信息。具体字段信息如表1所示。 表1 PG_STATIO_ALL_INDEXES字段 名称 类型 描述 relid oid 该索引所在的表的OID。 indexrelid oid 该索引的OID。 schemaname name 该索引的模式名。 relname name 该索引的表名。 indexrelname name 索引名称。 idx_blks_read bigint 从索引中读取的磁盘块数。 idx_blks_hit bigint 索引命中缓存数。 父主题： 其他系统视图