数据仓库服务 GAUSSDB(DWS)-其它函数:copy_error_log_create()

时间:2024-09-05 10:32:17

copy_error_log_create()

描述:创建COPY FROM容错机制所需要的错误表(public.pgxc_copy_error_log)。

返回值类型:boolean

  • 此函数会尝试创建public.pgxc_copy_error_log表,表的详细信息请参见表3
  • 在relname列上创建B-tree索引,并REVOKE ALL on public.pgxc_copy_error_log FROM public对错误表进行权限控制(与COPY语句权限一致)。
  • 由于尝试创建的public.pgxc_copy_error_log定义是一张行存表,因此集群上必须支持行存表的创建才能够正常运行此函数,并使用后续的COPY容错功能。需要特别注意的是,enable_hadoop_env这个GUC参数开启后会禁止在集群内创建行存表( GaussDB (DWS)默认为off)。
  • 此函数自身权限为Sysadmin及以上(与错误表、COPY权限一致)。
  • 若创建前public.pgxc_copy_error_log表已存在或者copy_error_log_relname_idx索引已存在,则此函数会报错回滚。
表3 错误表public.pgxc_copy_error_log信息

列名称

类型

描述

relname

varchar

表名称。以模式名.表名形式显示。

begintime

timestamp with time zone

出现数据格式错误的时间。

filename

varchar

出现数据格式错误的数据源文件名。

rownum

bigint

在数据源文件中,出现数据格式错误的行号。

rawrecord

text

在数据源文件中,出现数据格式错误的原始记录。为了防止字段长度过大,限制字段的长度不超过1024 byte。

detail

text

详细错误信息。

columnname

varchar

在数据源文件中,出现数据格式错误的字段名称。仅8.2.1.100及以上版本支持。

errcode

varchar

出错信息对应的错误码,使用sqlstate错误码。仅8.2.1.100及以上版本支持。

queryid

bigint

执行copy的sql语句id,用于唯一标识一条sql语句。仅8.2.1.100及以上版本支持。

support.huaweicloud.com/sqlreference-830-dws/dws_06_0062.html