华为云用户手册

enable_limit_stop 参数说明：控制LIMIT语句是否启用early stop优化。对于LIMIT n语句，若使用early stop优化则CN收取到n条数据后会传递请求使DN提前结束执行，适用于复杂查询且带有LIMIT的场景。该参数仅8.1.3.320及以上集群版本支持。 参数类型：USERSET 取值范围：布尔型 on表示允许LIMIT语句使用early stop优化。 off表示不允许LIMIT语句使用early stop优化。 默认值：on

ignore_checksum_failure 参数说明： 设置读取数据时是否忽略校验信息检查失败（但仍然会告警），继续执行。该参数仅在enable_crc_check为on时有效。继续执行可能导致崩溃，传播或隐藏损坏数据，无法从远程节点恢复数据及其他严重问题。不建议用户修改设置。 参数类型：SUSET 取值范围：布尔型 on表示忽略数据校验错误。 off表示数据校验错误正常报错。 默认值：off

enable_force_vector_engine 参数说明：对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。当打开enable_force_vector_engine开关时，无论是行存表、列存表或者是行列混存，如果plantree中不包含不支持向量化的场景，则强制走向量化执行引擎。 参数类型：USERSET 取值范围：布尔型 默认值：off

join_num_distinct 参数说明：控制应用场景中Join列或表达式的默认distinct值。 参数类型：USERSET 取值范围：双精度浮点型，大于或等于-100，客户端显示小数时可能会有截断。 值大于0时，表示使用该值作为默认distinct值。 值大于等于-100且小于0时，表示估算默认distinct时使用的百分比。 值为0时，表示使用200作为默认distinct值。 默认值：-20

qual_num_distinct 参数说明：控制应用场景中过滤列或表达式的默认distinct值。 参数类型：USERSET 取值范围：双精度浮点型，大于或等于-100，客户端显示小数时可能会有截断。 值大于0时，表示使用该值作为默认distinct值。 值大于等于-100且小于0时，表示估算默认distinct时使用的百分比。 值为0时，表示使用200作为默认distinct值。 默认值：200

zero_damaged_pages 参数说明：控制检测导致 GaussDB (DWS)报告错误的损坏的页头，中止当前事务。 参数类型：SUSET 取值范围：布尔型 on表示打开控制功能。 off表示关闭控制功能。 设置为on时，系统报告一个警告，把损坏的页面填充为零然后继续处理。该行为会破坏数据，即被损坏页面上的所有行。但是它允许绕开损坏页面然后从表中存在的未损坏页面上继续检索数据行。因此该参数在硬件或者软件错误导致的数据损坏中进行恢复是有作用的。通常不建议该参数设置为on，除非不需要从损坏的页面中恢复数据。 对于列存表，会将整个CU跳过然后继续处理。支持的场景包括crc校验失败、magic校验失败以及读取的CU长度错误。 默认值：off

cost_param 参数说明：该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 当cost_param & 1 不为0，表示对于求不等值连接选择率时选择一种改良机制，此方法在自连接（两个相同的表之间连接）的估算中更加准确，V300R002C00版本开始，已弃用cost_param & 1 不为0时的路径，默认选择更优的估算公式； 当cost_param & 2 不为0，表示求多个过滤条件（Filter）的选择率时，选择最小的作为总的选择率，而非两者乘积，此方法在过滤条件的列之间关联性较强时估算更加准确； 当cost_param & 4 不为0，表示在进行stream节点估算时，选用调试模型，该模型不推荐用户使用。 当cost_param & 16不为0，表示在计算两个及以上过滤条件或Join条件的综合选择率时，采用介于完全相关和完全不相关之间的一种模型，过滤条件较多时倾向于相关性较强的模型。 参数类型：USERSET 取值范围：整型，1～INT_MAX 默认值：16

enable_light_colupdate 参数说明：控制是否使用列存轻量化UPDATE。 参数类型：USERSET 取值范围：布尔型 on表示开启列存轻量化UPDATE。 off表示关闭列存轻量化UPDATE。 默认值：off 列存轻量化UPDATE与后台列存AUTOVACUUM并发会小概率报错，可以通过ALTER TABLE设置表级参数enable_column_autovacuum_garbage为off来避免。需要注意的是设置表级参数enable_column_autovacuum_garbage为off会关闭该表的后台列存AUTOVACUUM。

debug_assertions 参数说明：控制打开各种断言检查。能够协助调试，当遇到奇怪的问题或者崩溃，请把此参数打开，因为它能暴露编程的错误。要使用这个参数，必须在编译GaussDB(DWS)的时候定义宏USE_ASSERT_CHECKING（通过configure选项 --enable-cassert完成）。 参数类型：USERSET 取值范围：布尔型 on表示打开断言检查。 off表示不打开断言检查。 当启用断言选项编译GaussDB(DWS)时，debug_assertions缺省值为on 。 默认值：off

default_table_behavior 参数说明：支持设置默认表的行为类型，该参数仅8.2.1及以上集群版本支持。 参数类型：USERSET 取值范围：column_btree_index、column_high_compress、column_middle_compress、column_low_compress column_btree_index，表示列存表默认创建索引为btree。 column_high_compress，表示列存表默认压缩级别为high。 column_middle_compress，表示列存表默认压缩级别为middle。 column_low_compress，表示列存表默认压缩级别为low。 默认值：空字符串

cost_model_version 参数说明：控制应用场景中估算时cost使用的模型。该参数的影响范围主要涵盖：表达式distinct估算、HashJoin代价模型、行数估算、重分布时分布键的选择及Aggregate的行数估算等。 参数类型：USERSET 取值范围：0、1、2、3、4 0表示使用原始的cost估算模型。 1表示在0的基础上，使用增强的表达式distinct估算、HashJoin代价模型、行数估算、重分布时分布键的选择及Aggregate的行数估算。 2表示在1的基础上，使用随机性更优的analyze采样算法，以提高统计信息准确性。 3表示在2的基础上，优化大集群场景下的broadcast代价估算，以便优化器选择更优计划。该选项仅8.3.0及以上集群版本支持。 4表示在3的基础上，优化了hashjoin并行化代价、倾斜代价、列存索引有序性代价的代价估算以及coalesce表达式的行数估算，并支持子查询常量输出列进行join时的倾斜优化识别。 默认值：4

distribute_test_param 参数说明：控制分布式测试框架打桩点是否生效。通常开发人员在进行故障注入测试时会在代码中预埋一些打桩点，使用唯一的名称进行标识，使用此参数可以控制代码中预埋的打桩点是否生效。参数采用逗号分隔的三元组形式，分别指定线程级别、测试桩名称和注入故障的错误级别。 参数类型：USERSET 取值范围：字符串，任一个已预埋的测试桩名称。 默认值：-1, default, default

查询hudi外表最大时间线 查询OBS上hudi数据最大时间线，即最新的提交记录： 1 SELECT * FROM hudi_get_max_commit('SCHEMA.FOREIGN_TABLE'); 示例：查询当前schema下的OBS外表rtd_mfdt_int_unit_ft的最大时间线： 1 SELECT * FROM hudi_get_max_commit('rtd_mfdt_int_unit_ft');

增量查询 针对hudi增量查询功能，可以通过设置增量查询参数实现增量查询。 1234 SET hoodie.SCHEMA.FOREIGN_TABLE.consume.mode=incremental;SET hoodie.SCHEMA.FOREIGN_TABLE.consume.start.timestamp=起始时间戳;SET hoodie.SCHEMA.FOREIGN_TABLE.consume.ending.timestamp=结束时间戳;SELECT * FROM SCHEMA.FOREIGN_TABLE;

PG_MATVIEW PG_MATVIEW系统表提供获取当前节点的物化视图信息。 表1 PG_MATVIEW字段 字段名称 字段类型 描述 mvid oid 物化视图OID。 build_mode char 物化视图的build模式。 'd'：代表deferred，表示创建物化视图时需要等到第一次refresh时才会包含数据。 'i'：代表immediate，表示创建物化视图时即包含最新数据。 refresh_method char 'c' ：表示完全刷新。 refresh_mode char 物化视图的刷新模式。 'd'：表示手动刷新。 'a'：表示物化视图一直是活跃的，后台会自动刷新。 rewrite_enable boolean 是否支持物化视图的查询重写。 active boolean 物化视图是否需要刷新。 relnum Int 物化视图基表个数。 start_time timestamptz 物化视图第一次定时刷新的时间，为空则第一次刷新时间是当前时间+interval。 interval interval 物化视图定时刷新时间的间隔。 refresh_time timestamptz 物化视图的最后一次刷新时间。 refresh_finish_time timestamptz 物化视图的最后一次刷新结束时间。 父主题： 系统表

查询hudi外表属性(hoodie.properties) 查询OBS上hudi数据的hoodie.properties： 1 SELECT * FROM hudi_get_options('SCHEMA.FOREIGN_TABLE'); 示例：查询当前schema下的OBS外表rtd_mfdt_int_unit_ft的hudi属性： 1 SELECT * FROM hudi_get_options('rtd_mfdt_int_unit_ft');

示例 创建表t1、t2、t3： 123 create table t1(a1 int,b1 int,c1 int,d1 int);create table t2(a2 int,b2 int,c2 int,d2 int);create table t3(a3 int,b3 int,c3 int,d3 int); 原语句为： 1 explain select * from t3, (select a1,b2,c1,d2 from t1,t2 where t1.a1=t2.a2) s1 where t3.b3=s1.b2; 上述查询中，可以使用以下两种方式禁止子查询s1进行提升： 方式一： 1 explain select /*+ no merge(s1) */ * from t3, (select a1,b2,c1,d2 from t1,t2 where t1.a1=t2.a2) s1 where t3.b3=s1.b2; 方式二： 1 explain select * from t3, (select /*+ no merge */ a1,b2,c1,d2 from t1,t2 where t1.a1=t2.a2) s1 where t3.b3=s1.b2; 提升后效果：

应用示例 查看所有订阅： 12345 SELECT * FROM pg_subscription; subdbid | subname | subowner | subenabled | subconninfo | subslotname | subpublications ---------+---------+----------+------------+------------------------------------------------------------------------------------------+-------------+----------------- 15992 | mysub | 10 | t | host=1.1.1.1,2.2.2.2 port=10000,20000 dbname=postgres user=repusr1 password=password_123 | mysub | {mypub}(1 row)

PG_SEQUEN CES PG_SEQUENCES视图显示当前用户有权限的序列属性信息。该视图仅9.1.0及以上集群版本支持。 表1 PG_SEQUENCES字段 名称 类型 描述 schemaname name 命名空间的名称。 sequencename name 序列的名称。 sequenceowner name 序列的所有者。 start_value bigint 序列的起始值。 min_value bigint 序列生成的最小值。 max_value bigint 序列生成的最大值。 increment_by bigint 序列生成的步长，即每次生成的值增加的量。 cycle boolean 如果设置为true，则在达到最大值后重新开始从最小值生成序列值；如果设置为false，则在达到最大值后停止生成序列值。 cache_size bigint 序列缓存值的大小。 last_value bigint 序列最近一次生成的值。 父主题： 系统视图

PG_STAT_OBJECT PG_STAT_OBJECT系统表存储当前实例上表的统计信息和autovacuum效率信息，并且对于databaseid, relid, partid字段创建索引。该系统表的更新受enable_pg_stat_object参数控制。该系统表仅8.2.1及以上集群版本支持。 表1 PG_STAT_OBJECT字段 名称 类型 引用 描述 databaseid oid PG_DATABASE.oid 数据库OID。 relid oid PG_CLASS.oid 表OID，分区表为主表OID。 partid oid PG_PARTITION .oid 分区OID，普通表此列为0。 numscans bigint - 启动顺序扫描的次数。 tuples_returned bigint - 顺序扫描抓取的可见元组条数。 tuples_fetched bigint - 抓取的可见元组条数。 tuples_inserted bigint - 插入条数。 tuples_updated bigint - 更新条数。 tuples_deleted bigint - 删除条数。 tuples_hot_updated bigint - HOT更新条数。 n_live_tuples bigint - 可见元组数。 last_autovacuum_begin_n_dead_tuple bigint - Autovacuum执行前删除元组数。 n_dead_tuples bigint - Autovacuum成功后删除元组数。 changes_since_analyze bigint - Analyze后最近一次数据修改时间。 blocks_fetched bigint - 选中的页面数。 blocks_hit bigint - 扫描过的页面数。 cu_mem_hit bigint - CU内存命中次数。 cu_hdd_sync bigint - 从磁盘同步读取CU次数。 cu_hdd_asyn bigint - 从磁盘异步读取CU次数。 data_changed_timestamp timestamp with time zone - 最近一次数据修改时间。 data_access_timestamp timestamp with time zone - 表的最后一次访问时间。 analyze_timestamp timestamp with time zone - 最近一次analyze时间。 analyze_count bigint - Analyze总次数。 autovac_analyze_timestamp timestamp with time zone - 最近一次autoanalyze时间。 autovac_analyze_count bigint - Autoanalyze总次数。 vacuum_timestamp timestamp with time zone - 最近一次vacuum的时间。 vacuum_count bigint - vacuum总次数。 autovac_vacuum_timestamp timestamp with time zone - 最近一次autovacuum时间。 autovac_vacuum_count bigint - Autovacuum总次数。 autovacuum_success_count bigint - 成功执行的autovacuum总次数。 last_autovacuum_time_cost bigint - 最近一次成功的autovacuum花费时间，单位：微秒。 avg_autovacuum_time_cost bigint - 成功执行autovacuum的平均执行时间，单位：微秒。 last_autovacuum_failed_count bigint - 从上一次autovacuum成功到现在，autovacuum总失败次数。 last_autovacuum_trigger smallint - 最近一次autovacuum触发方式，用于辅助维护人员进行vacuum情况的判断。 last_autovacuum_oldestxmin bigint - 最近一次autovacuum成功执行后的oldestxmin。如果表级oldestxmin特性开启，此字段记录此表最近一次(auto)vacuum使用的oldestxmin值。 last_autovacuum_scan_pages bigint - 最近一次autovacuum扫描的页面数（仅针对行存表）。 last_autovacuum_dirty_pages bigint - 最近一次autovacuum修改的页面数（仅针对行存表）。 last_autovacuum_clear_deadtuples bigint - 最近一次autovacuum清理的deadtuple数（仅针对行存表）。 sum_autovacuum_scan_pages bigint - 从数据库初始化开始到现在，autovacuum累计扫描的页面数（仅针对行存表）。 sum_autovacuum_dirty_pages bigint - 从数据库初始化开始到现在，autovacuum累计修改的页面数（仅针对行存表）。 sum_autovacuum_clear_deadtuples bigint - 从数据库初始化开始到现在，autovacuum累计清理的deadtuple数（仅针对行存表）。 last_autovacuum_begin_cu_size bigint - 最近一次autovacuum前的CU文件大小（仅针对列存表）。 last_autovacuum_cu_size bigint - 最近一次autovacuum后的CU文件大小（仅针对列存表）。 last_autovacuum_rewrite_size bigint - 最近一次autovacuum重写的列存文件大小（仅针对列存表）。 last_autovacuum_clear_size bigint - 最近一次autovacuum清理的列存文件大小（仅针对列存表）。 last_autovacuum_clear_cbtree_tuples bigint - 最近一次autovacuum清理的cbtree tuple数（仅针对列存表）。 sum_autovacuum_rewrite_size bigint - 从数据库初始化开始到现在，autovacuum累计重写的列存文件大小（仅针对列存表）。 sum_autovacuum_clear_size bigint - 从数据库初始化开始到现在，autovacuum累计清理的列存文件大小（仅针对列存表）。 sum_autovacuum_clear_cbtree_tuples bigint - 从数据库初始化开始到现在，autovacuum累计清理的cbtree tuple数（仅针对列存表）。 last_autovacuum_csn bigint - 如果表级oldestxmin特性打开，此字段记录此表最近一次(auto)vacuum使用的oldestxmin值对应的 CS N值。 last_automerge_timestamp timestamp with time zone - 上次表发生automerge的时间（目前仅针对HStore_opt表），该字段仅9.1.0.100及以上版本支持。 last_automerge_time_cost bigint - 上次表发生automerge的耗时（目前仅针对HStore_opt表），该字段仅9.1.0.100及以上版本支持。 last_automerge_count bigint - 上次表automerge的记录数（目前仅针对HStore_opt表），该字段仅9.1.0.100及以上版本支持。 extra1 bigint - 预留字段1。 父主题： 系统表

PGXC_POOLER_STATUS PGXC_POOLER_STATUS视图显示当前集群中各CN节点的pooler中缓存连接状态。该视图只能在CN上执行查询，显示所有CN的pooler模块的连接缓存信息。PGXC_POOLER_STATUS视图仅8.3.0及以上集群版本支持。 表1 PGXC_POOLER_STATUS字段 名称 类型 描述 coorname text CN节点名称。 database text 数据库名称。 user_name text 用户名。 tid bigint 连接CN的线程ID。 node_oid bigint 连接的实例节点OID。 node_name name 连接的实例节点名称。 in_use boolean 连接是否正被使用。 t（true）：表示连接正在使用。 f（false）：表示连接没有使用。 fdsock bigint 对端socket。 remote_pid bigint 对端线程号。 session_params text 由此连接下发的GUC会话参数。 父主题： 系统视图

GS_OBS_LATENCY GS_OBS_LATENCY记录logtime之前10分钟内OBS的平均延迟信息，延迟数据是根据相关OBS的操作进行估算的结果。该视图仅8.2.0及以上集群版本支持。 表1 GS_OBS_LATENCY字段 名称 类型 描述 nodename text 集群节点。 hostname text 主机节点。 latency_ms double precision logtime之前10分钟内OBS的平均延迟，单位ms。 reqcount bigint logtime之前10分钟内OBS的请求次数。 logtime timestamp with time zone 记录延迟信息的时刻。 父主题： 系统视图

PG_RELFILENODE_SIZE PG_RELFILENODE_SIZE系统表存储文件级空间统计信息，表中的每一条记录则对应磁盘上相应的物理文件和该文件的文件大小。 表1 PG_RELFILENODE_SIZE字段 名称 类型 描述 databaseid oid 物理文件所属database对应的OID。如果是跨库共享系统表，该值为0。 tablespaceid oid 物理文件所属表空间对应的OID。 relfilenode oid 物理文件的物理文件编号。 backendid integer 创建物理文件的后台线程号，通常为-1。 type integer 物理文件的文件类型。 0为数据类型。 1为FSM文件类型。 2为VM文件类型。 3为BCM文件类型。 大于4为列存表对应列的数据文件和BCM文件大小之和。 filesize bigint 物理文件的文件大小，单位Byte。 父主题： 系统表

示例 查询文件缓存所使用的硬盘的信息： 123456789 SELECT * FROM pgxc_disk_cache_path_info order by 1; path_name | node_name | cache_size | disk_available | disk_size | disk_use_ratio----------------+--------------+------------+----------------+--------------+------------------ dn_6001_6002_0 | dn_6001_6002 | 19619 | 137401716736 | 160982630400 | .146481105479564 dn_6001_6002_1 | dn_6001_6002 | 35968 | 137401716736 | 160982630400 | .146481105479564 dn_6003_6004_0 | dn_6003_6004 | 27794 | 121600655360 | 160982630400 | .244634933235629 dn_6003_6004_1 | dn_6003_6004 | 26158 | 121600655360 | 160982630400 | .244634933235629 dn_6005_6006_0 | dn_6005_6006 | 24533 | 134394839040 | 160982630400 | .165159379579873 dn_6005_6006_1 | dn_6005_6006 | 31065 | 134394839040 | 160982630400 | .165159379579873

示例 查询OBS IO Scheduler在每个节点读请求相关的统计信息。 SELECT * FROM pgxc_obs_io_scheduler_stats WHERE io_type = 'r' ORDER BY node_name; node_name | io_type | current_bps | best_bps | waiting_request_num | mean_request_size | total_token_num | available_token_num | total_worker_num | idle_worker_num--------------+---------+-------------+----------+---------------------+-------------------+-----------------+---------------------+------------------+----------------- dn_6001_6002 | r | 26990 | 26990 | 0 | 215 | 18 | 16 | 12 | 10 dn_6003_6004 | r | 21475 | 21475 | 10 | 190 | 30 | 30 | 20 | 20 dn_6005_6006 | r | 12384 | 12384 | 36 | 133 | 30 | 27 | 20 | 17 查询结果显示，这是当前IO Scheduler在进行读取IO操作时的某个时刻统计信息的快照（snapshot），此时带宽处于上升阶段，current_bps与best_bps相等。以dn_6003_6004为例，可以观察到该DN当前队列中存在排队的请求，total_token_num与available_token_num相等，说明查询视图的时刻IO Scheduler还未开始处理这些请求。 等待一段时间后，再次发起查询。 SELECT * FROM pgxc_obs_io_scheduler_stats WHERE io_type = 'r' ORDER BY node_name; node_name | io_type | current_bps | best_bps | waiting_request_num | mean_request_size | total_token_num | available_token_num | total_worker_num | idle_worker_num--------------+---------+-------------+----------+---------------------+-------------------+-----------------+---------------------+------------------+----------------- dn_6001_6002 | r | 13228 | 26990 | 0 | 609 | 18 | 18 | 12 | 12 dn_6003_6004 | r | 15717 | 21475 | 0 | 622 | 30 | 30 | 20 | 20 dn_6005_6006 | r | 18041 | 21767 | 0 | 609 | 30 | 30 | 20 | 20 此时队列中已经没有了排队的请求，且available_token_num等于total_token_num，说明IO Scheduler已经处理完所有请求，且没有新的请求需要被处理；但观察到current_bps不为零，是因为统计bps的周期为3秒，此时显示的是3秒前的结果。 短暂间隔后再次查询结果如下，current_bps会更新为0。 SELECT * FROM pgxc_obs_io_scheduler_stats WHERE io_type = 'r' ORDER BY node_name; node_name | io_type | current_bps | best_bps | waiting_request_num | mean_request_size | total_token_num | available_token_num | total_worker_num | idle_worker_num--------------+---------+-------------+----------+---------------------+-------------------+-----------------+---------------------+------------------+----------------- dn_6001_6002 | r | 0 | 26990 | 0 | 609 | 18 | 18 | 12 | 12 dn_6003_6004 | r | 0 | 21475 | 0 | 622 | 30 | 30 | 20 | 20 dn_6005_6006 | r | 0 | 21767 | 0 | 609 | 30 | 30 | 20 | 20

PG_STAT_DATABASE PG_STAT_DATABASE视图显示当前节点上每个数据库的状态和统计信息。 表1 PG_STAT_DATABASE字段 名称 类型 描述 datid oid 数据库OID。 datname name 数据库名。 numbackends integer 当前节点上连接到该数据库的后端数。 这是该视图中唯一一个反映目前状态值的列；所有列均返回自上次重置以来的累积值。 xact_commit bigint 当前节点上该数据库中已经提交的事务数。 xact_rollback bigint 当前节点上该数据库中已经回滚的事务数。 blks_read bigint 当前节点上该数据库中读取的磁盘块的数量。 blks_hit bigint 当前节点上高速缓存中发现的磁盘块的个数，即缓存中命中的块数（只包括GaussDB(DWS)缓冲区高速缓存，不包括文件系统的缓存）。 tup_returned bigint 当前节点上该数据库查询返回的行数。 tup_fetched bigint 当前节点上该数据库查询抓取的行数。 tup_inserted bigint 当前节点上该数据库插入的行数。 tup_updated bigint 当前节点上该数据库更新的行数。 tup_deleted bigint 当前节点上该数据库删除的行数。 conflicts bigint 当前节点上由于数据库恢复冲突取消的查询数量（只在备用服务器上发生）。可参见PG_STAT_DATABASE_CONFLI CTS 。 temp_files bigint 当前节点上该数据库创建的临时文件个数。计算所有临时文件，不论为什么创建临时文件（比如排序或者哈希），而且不考虑log_temp_files设置。 temp_bytes bigint 当前节点上该数据库写入临时文件的大小。计算所有临时文件，不论为什么创建临时文件，而且不考虑log_temp_files设置。 deadlocks bigint 当前节点上该数据库中发生的死锁数量。 blk_read_time double precision 当前节点上该数据库后端读取数据文件块花费的时间，以毫秒计算。 blk_write_time double precision 当前节点上该数据库后端写入数据文件块花费的时间，以毫秒计算。 stats_reset timestamp with time zone 当前节点上该数据库统计重置的时间。 父主题： 系统视图

常见问题处理 Server common name "xxxx" does not match host name "xxxxx" 此问题的原因是使用了SSL加密的“verify-full”选项，这时驱动程序会验证证书中的主机名与实际部署数据库的主机名是否一致。碰到此问题可以使用“verify-ca”选项，不再校验主机名；或者重新生成一套与数据库所在主机名相同的CA证书。 connect to server failed: no such file or directory 此问题可能的原因： 配置了错误的/不可达的数据库地址，或者端口 请检查数据源配置中的Servername及Port配置项。 服务器监听不正确 如果确认Servername及Port配置正确，请根据“操作步骤”中数据库服务器的相关配置，确保数据库监听了合适的网卡及端口。 防火墙及网闸设备 请确认防火墙设置，将数据库的通信端口添加到可信端口中。 如果有网闸设备，请确认一下相关的设置。 在指定的DSN中，驱动程序和应用程序之间的体系结构不匹配 此问题可能的原因：在64位程序中使用了32位驱动，或者相反。 C:\Windows\SysWOW64\odbcad32.exe：这是32位ODBC驱动管理器。 C:\Windows\System32\odbcad32.exe：这是64位ODBC驱动管理器。 The password-stored method is not supported. 此问题可能原因： 数据源中未配置sslmode配置项，请调整此项至allow或以上级别，允许SSL连接，此选项的更多说明，请见表1。 authentication method 10 not supported. 使用开源客户端碰到此问题，可能原因： 数据库中存储的口令校验只存储了SHA256格式哈希，而开源客户端只识别MD5校验，双方校验方法不匹配报错。 数据库并不存储用户口令，只存储用户口令的哈希码。 早期版本（V100R002C80SPC300之前的版本）的数据库只存储了SHA256格式的哈希，并未存储MD5的哈希，所以无法使用MD5做用户口令校验。 新版本（V100R002C80SPC300及之后版本）的数据库当用户更新用户口令或者新建用户时，会同时存储两种格式的哈希码，这时将兼容开源的认证协议。 但是当老版本升级到新版本时，由于哈希的不可逆性，所以数据库无法还原用户口令，进而生成新格式的哈希，所以仍然只保留了SHA256格式的哈希，导致仍然无法使用MD5做口令认证。 要解决该问题，参见以下操作： 新建一个数据库用户用于连接，或者重置准备使用的数据库用户的密码。 如果您使用的是管理员账号，参见重置密码。 如果是普通用户，可以先通过其他客户端工具（例如Data Studio）连接数据库后，使用ALTER USER语句来修改密码。 再尝试连接数据库。 unsupported frontend protocol 3.51: server supports 1.0 to 3.0 目标数据库版本过低，或者目标数据库为开源数据库。请使用对应版本的数据库驱动连接目标数据库。 FATAL: GSS authentication method is not allowed because XXXX user password is not disabled. 或：GSSAPI authentication not supported. 目标CN的pg_hba.conf里配置了当前客户端IP使用“gss”方式来做认证，该认证算法不支持用作客户端的身份认证，请修改到“sha256”后再试。 同时请注意，数据库当前不支持在集群内跨节点连接数据库，如果是在集群内跨节点连接CN出现此问题，请将业务程序调整到集群外后重试。

DDL 【建议】在GaussDB(DWS)中，建议DDL（建表、comments等）操作统一执行，在批处理作业中尽量避免DDL操作。避免大量并发事务对性能的影响。 【建议】在非日志表（unlogged table）使用完后，立即执行数据清理（truncate）操作。因为在异常场景下，GaussDB(DWS)不保证非日志表(unlogged table)数据的安全性。 【建议】临时表和非日志表的存储方式建议和基表相同。当基表为行存（列存）表时，临时表和非日志表也推荐创建为行存（列存）表，可以避免行列混合关联带来的高计算代价。 【建议】索引字段的总长度不超过50字节。否则，索引大小会膨胀比较严重，带来较大的存储开销，同时索引性能也会下降。 【建议】不要使用DROP…CASCADE方式删除对象，除非已经明确对象间的依赖关系，以免误删。

数据加载和卸载 【建议】在insert语句中显式给出插入的字段列表。例如： 1 INSERT INTO task(name,id,comment) VALUES ('task1','100','第100个任务'); 【建议】在批量数据入库之后，或者数据增量达到一定阈值后，建议对表进行analyze操作，防止统计信息不准确而导致的执行计划劣化。 【建议】如果要清理表中的所有数据，建议使用truncate table方式，不要使用delete table方式。delete table方式删除性能差，且不会释放那些已经删除了的数据占用的磁盘空间。

总体开发设计规范 下表是GaussDB(DWS)开发过程中需遵循的开发设计规范全集列表，可以单击链接跳转到对应的规则下了解详细说明。 表1 GaussDB(DWS)开发设计规范全集列表 编号 类别 规则/建议 1 连接管理规范 - 规则1.1 GaussDB(DWS)集群必须配置负载均衡 2 规则1.2 连接数据库完成所需操作后，必须关闭数据库连接（连接池场景除外） 3 规则1.3 开启的事务最后必须提交或回滚 4 规则1.4 应用侧使用连接池场景，其空闲超时配置必须小于服务侧的SESSION_TIMEOUT配置 5 规则1.5 应用侧使用连接池场景，如使用连接SET设置过参数，当将连接归还连接池前，必须进行参数重置 6 规则1.6 应用侧使用连接池场景，如使用连接创建过临时表，当将连接归还连接池前，必须手动清理所创建的临时表 7 对象设计规范 DATABASE对象设计 规则2.1 避免直接使用内置的DATABASE（如postgres、gaussdb等） 8 规则2.2 创建DATABASE时必须选择正确的数据库编码 9 规则2.3 创建DATABASE时必须选择正确的数据库兼容模式 10 建议2.4 存在关联计算的对象放在同一个DATABASE中 11 USER对象设计 规则2.5 禁止使用特殊权限用户运行业务，需遵循权限最小分配原则 12 规则2.6 禁止使用一个数据库用户运行所有业务 13 SCHEMA对象设计 建议2.7 不在其他USER的私有SCHEMA下创建对象 14 TABLESPACE对象设计 规则2.8 禁止自定义TABLESPACE表空间 15 TABLE对象设计（重点） 规则2.9 创建表时必须选择正确的分布方式和分布列 16 规则2.10 创建表时必须选择正确的存储方式 17 规则2.11 创建表时必须选择正确的分区策略 18 建议2.12 表字段的设计要遵循高效、准确原则 19 建议2.13 避免使用自增列或自增数据类型 20 INDEX对象设计（重点） 规则2.14 只创建必要的索引，创建索引必须选择合适的列和顺序 21 建议2.15 列存表通常可不建索引，极致性能场景需正确选择索引类型 22 VIEW对象设计 建议2.16 视图的嵌套需避免超过三层 23 SQL开发规范 DDL操作规范 建议3.1 DDL操作（CREATE除外）避免在业务高峰期和长事务中执行 24 规则3.2 DROP删除对象操作必须明确删除对象范围 25 INSERT操作规范 规则3.3 INSERT多VALUES批插场景使用COPY替代 26 建议3.4 禁止针对普通列存表进行实时INSERT操作 27 UPDATE/DELETE操作规范 建议3.5 避免并发UPDATE/DELETE行存表的同一行 28 建议3.6 避免对列存表频繁或并发执行UPDATE/DELETE 29 SELECT操作（含所有语法中的查询部分）规范 规则3.7 禁止执行不下推的SQL 30 规则3.8 禁止多表关联时缺少关联条件 31 规则3.9 多表关联字段数据类型要保持一致 32 建议3.10 尽量避免对关联条件字段和过滤条件字段进行函数运算 33 建议3.11 资源高消耗型SQL需做好压测和并发管控 34 规则3.12 禁止针对行存大表的频繁COUNT 35 建议3.13 避免查询返回超大结果集（数据导出场景除外） 36 建议3.14 查询时避免使用“SELECT *”写法 37 建议3.15 谨慎使用递归语句(WITH RECURSIVE)，明确终止条件，确保递归可终止 38 建议3.16 访问对象（表，函数等）时带上SCHEMA名称 39 建议3.17 针对SQL标记注释，唯一标识SQL的归属 40 建议3.18 SQL语句的长度不要超过64K 41 外表功能开发规范 GDS外表 规则4.1 GDS服务须单独使用服务器部署在DWS集群外 42 协同分析外表 规则4.2 避免同时对多个协同分析外表进行跨集群并发访问 43 存储过程开发规范 - 建议5.1 避免使用复杂的存储过程，避免存储过程嵌套 44 规则5.2 存储过程内避免执行非CREATE类的DDL操作