GAUSS-00501 - GAUSS-00600

GAUSS-00501 - GAUSS-00510

GAUSS-00501: "template database '%s' does not exist"

SQLSTATE: 3D000

错误原因: template1模板数据库不存在。

解决办法: 数据库系统存在异常导致模板数据库template1丢失，请重启数据库或者通过手动创建模板数据库template1。

GAUSS-00502: "permission denied to copy database '%s'"

SQLSTATE: 42501

错误原因: 创建数据库语法中，如果原数据库不是模板数据库，当前用户角色没有权限创建数据库。

解决办法: 创建数据库语法中，如果原数据库不是模板数据库，只有拥有CREATEDB权限的用户或系统管理员才可以创建新数据库，请确认用户权限是否正确。

GAUSS-00503: "invalid server encoding %d"

SQLSTATE: 42809

错误原因: 在创建数据库语法中，使用ENCODING encoding指定的编码格式无效。

解决办法: "在创建数据库语法中，使用ENCODING encoding指定的编码格式必须出现在以下编码格式中: GBK、UTF8、Latin1

GAUSS-00504: "invalid locale name: '%s'"

SQLSTATE: 42809

错误原因: 在创建数据库时，指定的数据库字符集无效。

解决办法: 在创建数据库语法中，指定新数据库使用的字符集必须与模板数据库的字符集匹配。请使用命令""show lc_collate;""检查模板数据库的字符集。

GAUSS-00505: "new encoding (%s) is incompatible with the encoding of the template database (%s)"

SQLSTATE: 22023

错误原因: 在创建数据库语法中，指定新数据库使用的字符编码与template0模板数据库的字符编码不匹配。

解决办法: 在创建数据库语法中，指定新数据库使用的字符编码与template0模板数据库的字符编码必须一致。请使用命令"show server_encoding;"检查template0模板数据库的字符编码，并修改当前创建数据库指定的字符编码。

GAUSS-00506: "new collation (%s) is incompatible with the collation of the template database (%s)"

SQLSTATE: 22023

错误原因: 在创建数据库语法中，指定新数据库使用的字符集与template0模板数据库的字符集不匹配。

解决办法: 在创建数据库语法中，指定新数据库使用的字符集与template0模板数据库的字符集必须一致，请使用命令"show lc_collate;"检查template0模板数据库的字符集，并修改当前创建数据库指定的字符集。

GAUSS-00507: "new LC_CTYPE (%s) is incompatible with the LC_CTYPE of the template database (%s)"

SQLSTATE: 22023

错误原因: 在创建数据库语法中，指定新数据库使用的字符分类与template0模板数据库的字符分类不匹配。

解决办法: 在创建数据库语法中，指定新数据库使用的字符分类与template0模板数据库的字符分类必须一致，请使用命令"show lc_ctype;"检查template0模板数据库的字符分类，并修改当前创建数据库指定的字符分类。

GAUSS-00508: "pg_global cannot be used as default tablespace"

SQLSTATE: 22023

错误原因: 在创建数据库语法中，指定新数据库使用缺省的表空间tablespace为pg_global错误。

解决办法: 在创建数据库语法中，指定新数据库使用缺省的表空间tablespace不能为pg_global，目前只支持缺省的表空间。

GAUSS-00509: "cannot assign new default tablespace '%s'"

SQLSTATE: 0A000

错误原因: 在创建数据库语法中，指定新数据库使用缺省的表空间tablespace为pg_global错误。

解决办法: 在创建数据库语法中，指定新数据库使用除缺省的表空间和全局表空间以外的其他表空间tablespace时，请确认该表空间所在目录是否为有效的目录，如果为无效目录，请创建一个有效的目录。

GAUSS-00510: "database '%s' already exists"

SQLSTATE: 42P04

错误原因: 当前创建的数据库已存在。

解决办法: 请使用命令"\l"确认当前待创建的数据库是否已经存在，如果存在，请重新命名一个不存在的数据库。

GAUSS-00511 - GAUSS-00520

GAUSS-00511: "source database '%s' is being accessed by other users"

SQLSTATE: 55006

错误原因: 当前访问的数据库正在被其他用户访问会话。

解决办法: 请检查当前访问的数据库是否正在被其他用户访问，这样会导致数据不一致的情况，需要关闭和退出其他用户访问，并重新尝试登录。

GAUSS-00512: "encoding '%s' does not match locale '%s'"

SQLSTATE: 22023

错误原因: 当前创建的数据库指定的字符编码与指定的字符分类得到的字符编码不匹配。

解决办法: 请求确认当前创建的数据库指定的字符编码是否指定的字符分类得到的字符编码一致，如果不一致，请在重新创建数据时指定为一致。

GAUSS-00513: "database '%s' does not exist"

SQLSTATE: 3D000

错误原因: DROP DATABASE语法删除一个数据库时，该数据库不存在或者是一个无效的数据库。

解决办法: DROP DATABASE语法删除一个数据库时，请确认当前删除的数据库是否为一个已经创建的有效的数据库。

GAUSS-00514: "cannot drop a template database"

SQLSTATE: 42809

错误原因: 试图删除模板数据库template0或template1，为非法操作。

解决办法: 系统默认模板数据库template0或template1不能被删除，请重新指定需要删除的数据库。

GAUSS-00515: "cannot drop the currently open database"

SQLSTATE: 55006

错误原因: 当前待删除的数据库正在被其他用户打开，不能执行删除操作。

解决办法: 请确认当前待删除的数据库是否正在被其他用户打开，并通知用户退出后再次尝试执行删除操作。

GAUSS-00516: "cannot drop the default database"

SQLSTATE: 42809

错误原因: 试图删除系统缺省的默认数据库postgres，为无效操作。

解决办法: 系统缺省的默认数据库postgres不能被删除，请确认操作是否正确。

GAUSS-00517: "database '%s' is being accessed by other users"

SQLSTATE: 55006

错误原因: 当前待删除的数据库正在被其他用户访问。

解决办法: 请检查当前待删除的数据库是否正在被其他用户访问，这样会导致数据不一致的情况，需要关闭和退出其他用户访问，并重新尝试删除该数据库。

GAUSS-00519: "permission denied to rename database"

SQLSTATE: 42501

错误原因: 当前用户没有权限修改数据库名称。

解决办法: 请确认执行当前修改数据库名称操作的用户是否为数据库所有者权限的用户或管理员用户。

GAUSS-00520: "current database cannot be renamed"

SQLSTATE: 0A000

错误原因: 非法操作: 不能修改正在使用的数据库名称。

解决办法: 请确认是否需要修改当前正在使用的数据库名称，该操作为非法操作，请勿修改正在使用的数据库名称。

GAUSS-00521 - GAUSS-00530

GAUSS-00521: "cannot change the tablespace of the currently open database"

SQLSTATE: 55006

错误原因: 通过ALTER DATABASE SET TABLESPACE语法修改数据库表空间时，该数据库正在被其他用户打开，不能执行当前操作。

解决办法: 请确认当前待执行的修改数据库表空间操作中的数据库是否正在被其他用户打开，如果已被其他用户打开，请将数据库退出后再次尝试执行该操作。

GAUSS-00522: "some relations of database '%s' are already in tablespace '%s'"

SQLSTATE: 55000

错误原因: 通过ALTER DATABASE SET TABLESPACE语法修改数据库表空间时，该数据库的表空间目录下已经存在表、索引、视图等关系对象，不能执行当前操作。

解决办法: 请确认当前待执行的修改数据库表空间操作中的数据库中是否已经存在表、索引、试图等关系对象，需要先删除已存在的对象后再次尝试执行该操作。

GAUSS-00523: "could not remove directory '%s': %m"

SQLSTATE: XX000

错误原因: 系统内部错误。

解决办法: 请联系技术支持工程师提供技术支持。

GAUSS-00524: "permission denied to change owner of database"

SQLSTATE: 42501

错误原因: 使用ALTER DATABASE name OWNER TO newowner语法修改数据库所有者时，当前用户没有权限执行该操作。

解决办法: 使用ALTER DATABASE name OWNER TO newowner语法修改数据库所有者时，请确认当前用户是否为数据库所有者权限的用户或管理员用户，其他用户没有权限执行该操作。

GAUSS-00526: "could not create directory '%s': %m"

SQLSTATE: XX000

错误原因: "创建数据库的表空间时需要创建表空间对应的目录可能存在以下异常: 1.不是管理员用户，没有权限访问该目录；2.文件系统为只读；3.该目录已经存在；4.磁盘已满，没有足够的空间创建目录；5.硬件存在问题导致I/O错误；6.MogDB数据库系统内部错误。"

解决办法: "创建数据库的表空间时需要创建表空间对应的目录存在异常，可以通过尝试如下方法排除问题: 1.确认是否为管理员用户或当前数据库创建权限；2.确认文件系统为只读，可以修改文件系统权限为可写和可执行；3.如果该目录已经存在，则不需要创建表空间；

GAUSS-00527: "could not stat directory '%s': %m"

SQLSTATE: XX000

错误原因: 创建数据库的表空间时需要创建表空间对应的目录是一个无效的非法目录。

解决办法: 确认创建数据库的表空间时需要创建表空间对应的目录名是否是一个有效的目录。

GAUSS-00528: "'%s' exists but is not a directory"

SQLSTATE: 42809

错误原因: 创建数据库的表空间时该表空间对应的目录无效。

解决办法: 确认创建数据库的表空间时需要创建表空间对应的目录名是否是一个有效的目录。

GAUSS-00529: "Permission denied to create tablespace '%s'."

SQLSTATE: 42501

错误原因: 当前用户没有权限在数据库中创建一个新的表空间。

解决办法: 只有系统管理员才能在数据库中创建一个新的表空间，请使用系统管理员权限执行创建表空间操作。

GAUSS-00530: "tablespace location cannot contain single quotes"

SQLSTATE: 42602

错误原因: 使用CREATE TABLESPACE tablespace_name …LOCATION语法指定表空间目录时，位置信息不能使用单引号标识。

解决办法: 使用CREATE TABLESPACE tablespace_name …LOCATION语法指定表空间目录时，位置信息字符串必须用双引号标识。

GAUSS-00531 - GAUSS-00540

GAUSS-00531: "tablespace location must be an absolute path"

SQLSTATE: 42P17

错误原因: 使用CREATE TABLESPACE tablespace_name …LOCATION语法指定表空间目录时，位置信息指示的路径错误。

解决办法: 使用CREATE TABLESPACE tablespace_name …LOCATION语法指定表空间目录时，位置信息字符串指定的目录必须是绝对路径。

GAUSS-00532: "tablespace location '%s' is too long"

SQLSTATE: 42P17

错误原因: 使用CREATE TABLESPACE tablespace_name …LOCATION语法指定表空间目录长度超过了最大长度1024。

解决办法: 使用CREATE TABLESPACE tablespace_name …LOCATION语法指定表空间目录时，位置信息字符串指定的目录长度必须小于系统规定的最大长度1024。

GAUSS-00533: "unacceptable tablespace name '%s'"

SQLSTATE: 42939

错误原因: 使用CREATE TABLESPACE tablespace_name创建表空间时，使用了非法的表空间名称。

解决办法: 使用CREATE TABLESPACE tablespace_name创建表空间时，表空间名称不能和数据库中的其他表空间重名，且名称不能以"pg"开头，这样的名称留给系统表空间使用。

GAUSS-00534: "tablespace '%s' already exists"

SQLSTATE: 42710

错误原因: 当前创建的表空间名称已经存在导致创建表空间失败。

解决办法: 请使用命令"\db"确认当前待创建的表空间是否已经存在，如果存在，请重新命名一个不存在的表空间名称。

GAUSS-00535: "tablespaces are not supported on this platform"

SQLSTATE: 0A000

错误原因: 不支持表空间。

解决办法: 建议不要使用表空间。

GAUSS-00536: "Tablespace '%s' does not exist."

SQLSTATE: 42704

错误原因: 通过DROP TABLESPACE删除的表空间不存在。

解决办法: 请通过"\db"查询待删除的表空间名称是否存在，系统只支持删除存在的表空间。

GAUSS-00537: "tablespace '%s' is used by partitioned table '%s'"

SQLSTATE: 0A000

错误原因: 试图删除用于分区表的表空间为非法操作。

解决办法: 请确认待删除的表空间是否被分区表使用，如果被分区表使用则系统不允许删除。

GAUSS-00538: "tablespace '%s' is not empty"

SQLSTATE: 55000

错误原因: 删除表空间时候表空间不为空。

解决办法: 请确认删除表空间时，表空间为空才能正常删除。

GAUSS-00539: "directory '%s' does not exist"

SQLSTATE: 58P01

错误原因: 在创建表空间时表空间目录"$PGDATA/pg_tblspc/"不存在。

解决办法: 在创建表空间时需要确认表空间目录"$PGDATA/pg_tblspc/"是否存在，如果不存在，需要重启数据库或单个节点。

GAUSS-00540: "could not set permissions on directory '%s': %m"

SQLSTATE: XX000

错误原因: 在创建表空间时，设置表空间目录"$PGDATA/pg_tblspc/"可读可写可执行权限失败。

解决办法: 创建数据库的表空间时设置表空间目录"$PGDATA/pg_tblspc/"目录权限存在异常，可以通过尝试如下方法排除问题: 1.确认是否为管理员用户或当前数据库创建权限；2.确认文件系统为只读，可以修改文件系统权限为可写和可执行；3.如果该目录已经存在，则不需要创建表空间。

GAUSS-00541 - GAUSS-00550

GAUSS-00541: "directory '%s' already in use as a tablespace"

SQLSTATE: 55006

错误原因: 为表空间所创建的目录已存在。

解决办法: 将表空间定义在其他目录下。

GAUSS-00542: "could not remove symbolic link '%s': %m"

SQLSTATE: XX000

错误原因: 移除符号连接文件失败。

解决办法: 确认符号连接指向的有效的文件。

GAUSS-00543: "could not create symbolic link '%s': %m"

SQLSTATE: XX000

错误原因: 创建符号连接文件失败。

解决办法: 通过检查错误码，可以判断文件操作错误原因（无权限、磁盘满、文件已存在等），并进行相应处理。

GAUSS-00544: "tablespace '%s' does not exist"

SQLSTATE: 42704

错误原因: 表空间不存在。

解决办法: 检查系统表pg_tablespace中相应表空间是否存在。

GAUSS-00546: "could not create tablespace directory '%s': %m"

SQLSTATE: XX000

错误原因: 创建表空间失败。

解决办法: 通过检查错误码，可以判断文件操作错误原因（无权限、磁盘满、文件已存在等），并进行相应处理。

GAUSS-00547: "could not access directory '%s': %m"

SQLSTATE: XX000

错误原因: 访问表空间目录失败。

解决办法: 通过检查错误码，可以判断文件操作错误原因（无权限、磁盘满、文件已存在等），并进行相应处理。

GAUSS-00548: "tblspc_redo: unknown op code %u"

SQLSTATE: XX000

错误原因: 系统内部错误。

解决办法: 请联系技术支持工程师提供技术支持。

GAUSS-00549: "'%s' is an aggregate function"

SQLSTATE: 42809

错误原因: 1.使用DROP FUNCTION删除聚集函数失败；2.使用ALTER FUNCTION修改聚集函数失败；3.pg_get_functiondef获取聚集函数定义失败。

解决办法: 1.可以使用DROP AGGREGATE删除聚集函数；2.可以使用ALTER AGGREGATE修改聚集函数；3.可以查看系统表pg_aggregate。

GAUSS-00550: "unexpected object type (%d)"

SQLSTATE: XX000

错误原因: 系统内部错误。

解决办法: 请联系技术支持工程师提供技术支持。

GAUSS-00551 - GAUSS-00560

GAUSS-00551: "could not determine which collation to use for view column '%s'"

SQLSTATE: 42P22

错误原因: 对于视图的列无法决策使用哪种排序规则。

解决办法: 使用COLLATE子句指定排序规则。

GAUSS-00552: "view must have at least one column"

SQLSTATE: 42P16

错误原因: 定义视图指定的列数少于1个。

解决办法: 定义视图至少需要包含一列。

GAUSS-00553: "'%s' is not a view"

SQLSTATE: 42809

错误原因: 对象不是一个视图。

解决办法: 检查要操作的对象是否是一个视图。

GAUSS-00554: "cannot drop columns from view"

SQLSTATE: 42P16

错误原因: 删除视图中的列失败。

解决办法: 视图定义后不能删除其中的列。

GAUSS-00555: "cannot change name of view column '%s' to '%s'"

SQLSTATE: 42P16

错误原因: 修改视图中的列名失败。

解决办法: 视图定义后不能其中的列名。

GAUSS-00556: "cannot change data type of view column '%s' from %s to %s"

SQLSTATE: 42P16

错误原因: CREATE OR REPLACE VIEW定义视图时，新视图和现有视图中列的数据类型不一致。

解决办法: 保证新视图和现有视图中列的数据类型一致。

GAUSS-00557: "unexpected parse analysis result"

SQLSTATE: XX000

错误原因: 系统内部错误。

解决办法: 请联系技术支持工程师提供技术支持。

GAUSS-00559: "views must not contain data-modifying statements in WITH"

SQLSTATE: 0A000

错误原因: 定义视图语句中包含WITH子句。

解决办法: 保证获取结果的query是单SELECT语句。

GAUSS-00560: "CREATE VIEW specifies more column names than columns"

SQLSTATE: 42601

错误原因: 定义视图指定的列比返回结果的列数多。

解决办法: 保证指定列数不多于返回结果的列数。

GAUSS-00561 - GAUSS-00570

GAUSS-00561: "views cannot be unlogged because they do not have storage"

SQLSTATE: 42601

错误原因: 定义视图时指定为UNLOGGED。

解决办法: 视图没有真正的存储，定义视图时不能指定为UNLOGGED。

GAUSS-00562: "unrecognized value for EXPLAIN option '%s': '%s'"

SQLSTATE: 22023

错误原因: EXPLAIN FORMAT的参数无法识别。

解决办法: FORMAT参数只能是text、xml、json、yaml之一。

GAUSS-00563: "unrecognized EXPLAIN option '%s'"

SQLSTATE: 42601

错误原因: EXPLAIN的参数无法识别。

解决办法: EXPLAIN支持的参数包括: analyze、verbose、costs、buffers、nodes、num_nodes、timing、CPU、detail、performance和format。

GAUSS-00564: "EXPLAIN option BUFFERS requires ANALYZE"

SQLSTATE: 22023

错误原因: EXPLAIN BUFFERS没有同时指定ANALYZE。

解决办法: EXPLAIN BUFFERS需要同时指定ANALYZE。

GAUSS-00565: "EXPLAIN option CPU requires ANALYZE"

SQLSTATE: 22023

错误原因: EXPLAIN CPU没有同时指定ANALYZE。

解决办法: EXPLAIN CPU需要同时指定ANALYZE。

GAUSS-00566: "EXPLAIN option DETAIL requires ANALYZE"

SQLSTATE: 22023

错误原因: EXPLAIN DETAIL没有同时指定ANALYZE。

解决办法: EXPLAIN DETAIL需要同时指定ANALYZE。

GAUSS-00567: "EXPLAIN option TIMING requires ANALYZE"

SQLSTATE: 22023

错误原因: EXPLAIN TIMING没有同时指定ANALYZE。

解决办法: EXPLAIN TIMING需要同时指定ANALYZE。

GAUSS-00568: "EXPLAIN %s requires ANALYZE"

SQLSTATE: 22023

错误原因: EXPLAIN CREATE TABLE AS SELECT或EXPLAIN SELECT INTO没有指定ANALYZE。

解决办法: EXPLAIN CREATE TABLE AS SELECT或EXPLAIN SELECT INTO需要指定ANALYZE。

GAUSS-00569: "no tlist entry for key %d"

SQLSTATE: XX000

错误原因: 生成的计划问题。

解决办法: 请联系技术支持工程师提供技术支持。

GAUSS-00570: "cache lookup failed for index %u"

SQLSTATE: XX000

错误原因: 系统表缓存查找索引信息失败。

解决办法: 检查索引名称是否正确。

GAUSS-00571 - GAUSS-00580

GAUSS-00571: "unrecognized DISCARD target: %d"

SQLSTATE: XX000

错误原因: 系统内部错误。

解决办法: 请联系技术支持工程师提供技术支持。

GAUSS-00572: "function '%s' was not called by trigger manager"

SQLSTATE: 39P01

错误原因: 函数没有被触发器管理器调用。

解决办法: 保证函数作为AFTER ROW trigger被调用。

GAUSS-00573: "function '%s' must be fired AFTER ROW"

SQLSTATE: 39P01

错误原因: 函数在AFTER ROW触发器触发之前就被调用。

解决办法: AFTER ROW触发器中的函数应该在触发器触发之后被调用。

GAUSS-00574: "function '%s' must be fired for INSERT or UPDATE"

SQLSTATE: 39P01

错误原因: 触发器没有被INSERT/UPDATE语句触发。

解决办法: 触发器必须被INSERT/UPDATE语句触发。

GAUSS-00575: "Permission denied to create role with option UNENCRYPTED."

SQLSTATE: XX000

错误原因: CREATE ROLE指定参数UNENCRYPTED报错。

解决办法: 密码必须加密，禁止使用密码的明文。

GAUSS-00579: "Permission denied to create role."

SQLSTATE: 42501

错误原因: 没有权限创建用户。

解决办法: 检查用户权限，是否可以创建用户，权限说明参见zh-cn_topic_0237121098.html。

GAUSS-00580: "Separation of privileges is used,user can't be created because of too many privileges."

SQLSTATE: 42501

错误原因: 使用三权分立，为用户指定的权限太多。

解决办法: 确认三权分立下为用户指定的权限没有超出范围。

GAUSS-00581 - GAUSS-00590

GAUSS-00581: "role name '%s' is reserved"

SQLSTATE: 42939

错误原因: 用户名是保留关键字。

解决办法: 用户名不能是public或none。

GAUSS-00582: "role '%s' already exists"

SQLSTATE: 42710

错误原因: 创建的用户已存在。

解决办法: 使用新的用户名。

GAUSS-00584: "The password does not satisfy the complexity requirement"

SQLSTATE: XX000

错误原因: 密码不符合复杂性要求。

解决办法: "请参照密码规则进行修改: 1. 不能和用户名相同。2. 至少包含大写字母（A-Z），小写字母（a-z），数字（0-9），非字母数字字符（限定为~!@#$%^&*()-_=+|[{}];:,<.>/?）四类字符中的三类字符"，且不少于8个字符。

GAUSS-00588: "The password could not be NULL."

SQLSTATE: XX000

错误原因: 密码为空。

解决办法: 密码不允许为空。

GAUSS-00589: "unacceptable user name: fail to create same name schema for user '%s'"

SQLSTATE: 42939

错误原因: 用户名非法，创建同名的schema失败。

解决办法: 用户名不能以'pg_'开头，'pg_'开头主要用作系统模式。

GAUSS-00590: "the relation pg_user_status is invalid"

SQLSTATE: XX000

错误原因: 系统内部错误。

解决办法: 请联系技术支持工程师提供技术支持。

GAUSS-00591 - GAUSS-00600

GAUSS-00591: "role '%s' does not exist"

SQLSTATE: 42704

错误原因: 用户不存在。

解决办法: 查看系统表pg_roles确认用户是否存在。

GAUSS-00593: "Permission denied to change privilege of the initial account."

SQLSTATE: 42501

错误原因: 修改初始用户权限失败。

解决办法: 查看系统表确认当前用户是否有权限。

GAUSS-00594: "Permission denied to change password of the initial account."

SQLSTATE: 42501

错误原因: 修改初始用户密码失败。

解决办法: 查看系统表确认当前用户是否有权限。