v2.1

关于MogDB
- MogDB简介
- MogDB与openGauss
- MogDB发布说明
  - MogDB 2.1.1
  - MogDB 2.1.0
- 开源组件
- 使用限制
- 法律声明
快速入门
- MogDB实训平台
- 容器化安装
- 单节点安装
- 访问数据库
  - 使用命令行访问MogDB
    - gsql
    - pgcli
  - 使用图形工具访问MogDB
    - Data Studio
    - DBeaver
  - 使用中间件访问MogDB
    - WebLogic配置MogDB数据源参考
    - WebSphere配置MogDB数据源参考
  - 使用编程语言访问MogDB
    - Java
    - C/C++
    - Python
    - Go
    - Rust
    - NodeJS
- 使用样本数据集Mogila
特性描述
安装指南
- 容器化安装
- 极简安装
- 标准安装
- 手动安装
管理指南
- 日常运维
- 主备管理
- MOT内存表管理
- 列存表管理
- 备份与恢复
- 数据导出导入
  - 导入数据
  - 导出数据
- 升级指南
AI特性指南
- 概述
- Predictor：AI查询时间预测
- X-Tuner：参数调优与诊断
- SQLdiag：慢SQL发现
- Anomaly-detection：数据库指标采集、预测与异常监控
- Index-advisor：索引推荐
- DeepSQL：库内AI算法
- DB4AI：数据库原生AI引擎
安全指南
- 数据库安全管理
开发者指南
- 应用程序开发教程
  - 开发规范
  - 基于JDBC开发
  - 基于ODBC开发
  - 基于libpq开发
    - 基于libpq开发
    - libpq接口参考
      - 数据库连接控制函数
        说明
        PQconnectdbParams
        PQconnectdb
        PQconninfoParse
        PQconnectStart
        PQerrorMessage
        PQsetdbLogin
        PQfinish
        PQreset
        PQstatus
      - 数据库执行语句函数
        PQclear
        PQexec
        PQexecParams
        PQexecParamsBatch
        PQexecPrepared
        PQexecPreparedBatch
        PQfname
        PQgetvalue
        PQnfields
        PQntuples
        PQprepare
        PQresultStatus
      - 异步命令处理
        说明
        PQsendQuery
        PQsendQueryParams
        PQsendPrepare
        PQsendQueryPrepared
        PQflush
      - 取消正在处理的查询
        PQgetCancel
        PQfreeCancel
        PQcancel
      - 示例
      - 链接字符
  - 基于Psycopg开发
  - 调试
  - 附录
- 存储过程
- 用户自定义函数
- PL/pgSQL-SQL过程语言
- 定时任务
  - PKG_SERVICE接口
- 自治事务
- 逻辑复制
  - 逻辑解码
    - 逻辑解码概述
    - 使用SQL函数接口进行逻辑解码
- Foreign Data Wrapper
- 物化视图
  - 物化视图概述
  - 全量物化视图
  - 增量物化视图
- 资源负载管理
  - 资源负载管理概述
  - 资源管理准备
性能优化指南
参考指南
故障诊断指南
- 常见故障定位手段
- 常见故障定位案例
  - core问题定位
  - 权限/会话/数据类型问题定位
  - 服务/高可用/并发问题定位
  - 表/分区表问题定位
    - VACUUM FULL一张表后，表文件大小无变化
    - 执行修改表分区操作时报错
  - 文件系统/磁盘/内存问题定位
  - SQL问题定位
  - 索引问题定位
源码解析
常见问题解答 (FAQs)
术语表

GAUSS-01201 - GAUSS-01300

GAUSS-01201 - GAUSS-01210

GAUSS-01201: "can not specify EOL in BINARY mode"

SQLSTATE: 0A000

错误原因: 不能在BINARY模式下指定终止符。

解决办法: 请勿在BINARY模式下使用终止符。

GAUSS-01202: "FIX specification only available using COPY FROM or READ ONLY foreign table"

SQLSTATE: 42000

错误原因: 指定FIX参数只能在copy from和只读外表的场景中使用。

解决办法: 请在copy from或外表场景使用指定FIX参数的操作。

GAUSS-01203: "FILEHEADER specification only available using HEAD"

SQLSTATE: 42601

错误原因: 用户在导出的时候指定从哪个文件来读取HEAD信息，但是并没有指定是否真正需要HEAD信息。

解决办法: 在导出语句中明确指定HEADER项，或者去掉读取的文件名信息。

GAUSS-01204: "table '%s' does not have OIDs"

SQLSTATE: 42703

错误原因: 导入数据时指定了文本中存在OID项，但是用户表并不存在OID列。

解决办法: 检查要导入的数据是否与用户表的定义在OID上是否一致，要么删除导入的OID项，要么对用户表增加OID列。

GAUSS-01206: "unexpected rewrite result"

SQLSTATE: XX000

错误原因: 系统内部错误。导入SQL语句的重写结果非预期。

解决办法: 运行时错误，请联系技术支持工程师提供技术支持。

GAUSS-01207: "COPY (SELECT INTO) is not supported"

SQLSTATE: 0A000

错误原因: 不支持COPY中SELECT INTO语法。

解决办法: COPY中不建议使用SELECT INTO语法。

GAUSS-01208: "FORCE QUOTE column '%s' not referenced by COPY"

SQLSTATE: 42P10

错误原因: 在CSV COPY TO模式下，在每个声明的字段周围对所有非NULL值没有使用引号包围。

解决办法: 在CSV COPY TO模式下，强制在每个声明的字段周围对所有非NULL值都使用引号包围。NULL输出不会被引号包围。

GAUSS-01209: "FORCE NOT NULL column '%s' not referenced by COPY"

SQLSTATE: 42P10

错误原因: 在CSV COPY FROM模式下，指定的字段输入为空。

解决办法: 在CSV COPY FROM模式下，指定的字段输入不能为空。

GAUSS-01210: "could not close file '%s': %m"

SQLSTATE: XX000

错误原因: 无法关闭指定文件。

解决办法: 检查指定文件是否被破坏或权限问题。

GAUSS-01211 - GAUSS-01220

GAUSS-01211: "cannot copy from view '%s'"

SQLSTATE: 42809

错误原因: 无法从视图中COPY数据。

解决办法: 请勿从视图中COPY数据。

GAUSS-01212: "cannot copy from foreign table '%s'"

SQLSTATE: 42809

错误原因: 无法从外表中COPY数据。

解决办法: 请勿从外表中COPY数据。

GAUSS-01213: "cannot copy from sequence '%s'"

SQLSTATE: 42809

错误原因: 无法从序列中COPY数据。

解决办法: 请勿从序列中COPY数据。

GAUSS-01214: "cannot copy from non-table relation '%s'"

SQLSTATE: 42809

错误原因: 无法从非表关系中COPY数据。

解决办法: 请勿从非表关系中COPY数据。

GAUSS-01215: "relative path not allowed for COPY to file"

SQLSTATE: 42602

错误原因: COPY目的文件不能用相对路径格式。

解决办法: COPY目的文件使用绝对路径格式。

GAUSS-01216: "could not open file '%s' for writing: %m"

SQLSTATE: XX000

错误原因: 无法打开指定文件。

解决办法: 请检查指定文件是否被破坏或权限问题。

GAUSS-01217: "'%s' is a directory"

SQLSTATE: 42809

错误原因: 期望为文件的参数是目录。

解决办法: 请指定COPY的文件名而非目录名。

GAUSS-01218: "could not chmod file '%s' : %m"

SQLSTATE: XX000

错误原因: 无法给文件变更权限。

解决办法: 请检查文件目前的权限及所属用户是否正常。

GAUSS-01219: "Invalid file format"

SQLSTATE: XX000

错误原因: 不支持的文件格式。

解决办法: 请使用COPY支持的文本、二进制、CSV格式。

GAUSS-01220: "null value in column '%s' violates not-null constraint"

SQLSTATE: 23502

错误原因: 向有非空约束的列插入空值。

解决办法: 修改与非空约束冲突的空值为有效值。

GAUSS-01221 - GAUSS-01230

GAUSS-01221: "Column Store unsupport CHECK constraint"

SQLSTATE: XX000

错误原因: 当前列存不支持CHECK约束。

解决办法: 删除CHECK约束。

GAUSS-01222: "cannot copy to view '%s'"

SQLSTATE: 42809

错误原因: 无法COPY数据到视图。

解决办法: 请勿COPY数据到视图中。

GAUSS-01223: "cannot copy to foreign table '%s'"

SQLSTATE: 42809

错误原因: 无法COPY数据到外表。

解决办法: 请勿COPY数据到外表中。

GAUSS-01224: "cannot copy to sequence '%s'"

SQLSTATE: 42809

错误原因: 无法COPY数据到序列。

解决办法: 请勿COPY数据到序列中。

GAUSS-01225: "cannot copy to non-table relation '%s'"

SQLSTATE: 42809

错误原因: 无法COPY数据非正规表。

解决办法: 请勿COPY数据非正规表中。

GAUSS-01226: "invalid COPY file header (COPY SEND)"

SQLSTATE: 22P04

错误原因: 无效COPY操作文件头。

解决办法: COPY数据文件被破坏，请检查文件。

GAUSS-01227: "Copy failed on a Datanode"

SQLSTATE: 08000

错误原因: 导入数据失败。

解决办法: 需要查看数据节点上的日志来找出发生的错误类型，视具体问题采用不同的措施。

GAUSS-01228: "Missing data when batch insert compressed data !"

SQLSTATE: XX000

错误原因: 向行存表导入压缩数据的过程中，出现了数据丢失的现象。

解决办法: 使用alter table关闭行存表的压缩特性，重新导入数据。

GAUSS-01229: "Non-shippable ROW triggers not supported with COPY"

SQLSTATE: 0A000

错误原因: COPY操作不支持行触发器。

解决办法: 请勿在COPY中使用行触发器。

GAUSS-01230: "could not open file '%s' for reading: %m"

SQLSTATE: XX000

错误原因: 打开文件失败。

解决办法: 通过错误码，检查文件打开失败的原因并进行修正（不存在，无权限，磁盘空间满等）。

GAUSS-01231 - GAUSS-01240

GAUSS-01231: "COPY file signature not recognized"

SQLSTATE: 22P04

错误原因: COPY数据文件签名无法识别。

解决办法: COPY数据文件被破坏，请检查文件。

GAUSS-01232: "invalid COPY file header (missing flags)"

SQLSTATE: 22P04

错误原因: COPY数据丢失文件头。

解决办法: COPY数据文件被破坏，请检查文件。

GAUSS-01233: "unrecognized critical flags in COPY file header"

SQLSTATE: 22P04

错误原因: COPY数据文件头无法识别。

解决办法: COPY数据文件被破坏，请检查文件。

GAUSS-01236: "missing data for OID column"

SQLSTATE: 22P04

错误原因: copy时OID为空值。

解决办法: 检查数据文件首列是否有空值。

GAUSS-01237: "null OID in COPY data"

SQLSTATE: 22P04

错误原因: copy操作时对应的OID为空。

解决办法: 检查copy语句，确保需要导入数据的表的OID不为空。

GAUSS-01238: "invalid OID in COPY data"

SQLSTATE: 22P04

错误原因: 数据所对应的OID是一个无效的OID。

解决办法: 检查copy语句中属性列与实际数据是否相对应。

GAUSS-01239: "missing data for column '%s'"

SQLSTATE: 22P04

错误原因: copy语句中希望导入的列数大于实际的数据列数，使得其中的某列没有数据。

解决办法: 检查copy语句中的属性列与导入的数据量列数是否一致。

GAUSS-01240: "received copy data after EOF marker"

SQLSTATE: 22P04

错误原因: 在EOF标记后仍然读取了数据，这是因为在旧协议中没有定义EOF标记。

解决办法: 确保按照当前协议书写的数据不会超过预期想要的。

GAUSS-01241 - GAUSS-01250

GAUSS-01241: "row field count is %d, expected %d"

SQLSTATE: 22P04

错误原因: 属性个数期望的与实际不一致。

解决办法: "1、从DN端返回给CN端的属性个数出错，属于内部错误，请联系技术支持工程师提供技术支持。 2、目标表属性个数与要拷贝的源文件属性个数不一致。需要检查待copy文件的列数和表中指定的列数是否一致。"

GAUSS-01242: "literal carriage return found in data"

SQLSTATE: 22P04

错误原因: copy的数据中包含回车符。

解决办法: 确保数据中不包含回车符。

GAUSS-01243: "literal newline found in data"

SQLSTATE: 22P04

错误原因: 在CSV文件中发现不可识别的数据格式。

解决办法: 请检查文件格式及文件数据内容规范性。

GAUSS-01244: "end-of-copy marker does not match previous newline style"

SQLSTATE: 22P04

错误原因: 文件中出现异常字符。