将部分Error降级为Warning的Hint

功能描述

指定执行INSERT、UPDATE语句时可将部分Error降级为Warning，且不影响语句执行完成的hint。

该hint不支持列存表，无法在列存表中生效。

将部分Error降级为Warning的Hint - 图1 注意： 与其他hint不同，此hint仅影响执行器遇到部分Error时的处理方式，不会对执行计划有任何影响。

使用该hint时，Error会被降级的场景有：

  • 违反非空约束时

若执行的SQL语句违反了表的非空约束，使用此hint可将Error降级为Warning，并根据GUC参数sql_ignore_strategy的值采用以下策略的一种继续执行：

  • sql_ignore_startegy为ignore_null时，忽略违反非空约束的行的INSERT/UPDATE操作，并继续执行剩余数据操作。

  • sql_ignore_startegy为overwrite_null时，将违反约束的null值覆写为目标类型的默认值，并继续执行剩余数据操作。

    将部分Error降级为Warning的Hint - 图2 说明： GUC参数sql_ignore_strategy相关信息请参考sql_ignore_strategy。 - 违反唯一约束时

若执行的SQL语句违反了表的唯一约束，使用此hint可将Error降级为Warning，忽略违反约束的行的INSERT/UPDATE操作，并继续执行剩余数据操作。 - 分区表无法匹配到合法分区时

在对分区表进行INSERT/UPDATE操作时，若某行数据无法匹配到表格的合法分区，使用此hint可将Error降级为Warning，忽略该行操作，并继续执行剩余数据操作。 - 更新/插入值向目标列类型转换失败时

执行INSERT/UPDATE语句时，若发现新值与目标列类型不匹配，使用此hint可将Error降级为Warning，并根据新值与目标列的具体类型采取以下策略的一种继续执行：

  • 当新值类型与列类型同为数值类型时：

    若新值在列类型的范围内，则直接进行插入/更新；若新值在列类型范围外，则以列类型的最大/最小值替代。 - 当新值类型与列类型同为字符串类型时：

    若新值长度在列类型限定范围内，则以直接进行插入/更新；若新值长度在列类型的限定范围外，则保留列类型长度限制的前n个字符。 - 若遇到新值类型与列类型不可转换时：

    插入/更新列类型的默认值。

语法格式

1. ignore_error

示例

为使用ignore_error hint，需要创建B兼容模式的数据库，名称为db_ignore。

1. create database db_ignore dbcompatibility 'B';
2. \c db_ignore
  • 忽略非空约束
1. db_ignore=# create table t_not_null(num int not null);
2. CREATE TABLE
3. -- 采用忽略策略
4. db_ignore=# set sql_ignore_strategy = 'ignore_null';
5. SET
6. db_ignore=# insert /*+ ignore_error */ into t_not_null values(null), (1);
7. WARNING:  null value in column "num" violates not-null constraint
8. DETAIL:  Failing row contains (null).
9. INSERT 0 1
10. db_ignore=# select * from t_not_null ;
11. num
12. -----
13. 1
14. (1 row)

16. db_ignore=# update /*+ ignore_error */ t_not_null set num = null where num = 1;
17. WARNING:  null value in column "num" violates not-null constraint
18. DETAIL:  Failing row contains (null).
19. UPDATE 0
20. db_ignore=# select * from t_not_null ;
21. num
22. -----
23. 1
24. (1 row)

27. -- 采用覆写策略
28. db_ignore=# delete from t_not_null;
29. db_ignore=# set sql_ignore_strategy = 'overwrite_null';
30. SET
31. db_ignore=# insert /*+ ignore_error */ into t_not_null values(null), (1);
32. WARNING:  null value in column "num" violates not-null constraint
33. DETAIL:  Failing row contains (null).
34. INSERT 0 2
35. db_ignore=# select * from t_not_null ;
36. num
37. -----
38. 0
39. 1
40. (2 rows)

42. db_ignore=# update /*+ ignore_error */ t_not_null set num = null where num = 1;
43. WARNING:  null value in column "num" violates not-null constraint
44. DETAIL:  Failing row contains (null).
45. UPDATE 1
46. db_ignore=# select * from t_not_null ;
47. num
48. -----
49. 0
50. 0
51. (2 rows)
  • 忽略唯一约束
1. db_ignore=# create table t_unique(num int unique);
2. NOTICE:  CREATE TABLE / UNIQUE will create implicit index "t_unique_num_key" for table "t_unique"
3. CREATE TABLE
4. db_ignore=# insert into t_unique values(1);
5. INSERT 0 1
6. db_ignore=# insert /*+ ignore_error */ into t_unique values(1),(2);
7. WARNING:  duplicate key value violates unique constraint in table "t_unique"
8. INSERT 0 1
9. db_ignore=# select * from t_unique;
10. num
11. -----
12. 1
13. 2
14. (2 rows)

16. db_ignore=# update /*+ ignore_error */ t_unique set num = 1 where num = 2;
17. WARNING:  duplicate key value violates unique constraint in table "t_unique"
18. UPDATE 0
19. db_ignore=# select * from t_unique ;
20. num
21. -----
22. 1
23. 2
24. (2 rows)
  • 忽略分区表无法匹配到合法分区
1. db_ignore=# CREATE TABLE t_ignore
2. db_ignore-# (
3. db_ignore(#     col1 integer NOT NULL,
4. db_ignore(#     col2 character varying(60)
5. db_ignore(# ) WITH(segment = on) PARTITION BY RANGE (col1)
6. db_ignore-# (
7. db_ignore(#     PARTITION P1 VALUES LESS THAN(5000),
8. db_ignore(#     PARTITION P2 VALUES LESS THAN(10000),
9. db_ignore(#     PARTITION P3 VALUES LESS THAN(15000)
10. db_ignore(# );
11. CREATE TABLE
12. db_ignore=# insert /*+ ignore_error */ into t_ignore values(20000);
13. WARNING:  inserted partition key does not map to any table partition
14. INSERT 0 0
15. db_ignore=# select * from t_ignore ;
16. col1 | col2
17. ------+------
18. (0 rows)

20. db_ignore=# insert into t_ignore values(3000);
21. INSERT 0 1
22. db_ignore=# select * from t_ignore ;
23. col1 | col2
24. ------+------
25. 3000 |
26. (1 row)
27. db_ignore=# update /*+ ignore_error */ t_ignore set col1 = 20000 where col1 = 3000;
28. WARNING:  fail to update partitioned table "t_ignore".new tuple does not map to any table partition.
29. UPDATE 0
30. db_ignore=# select * from t_ignore ;
31. col1 | col2
32. ------+------
33. 3000 |
34. (1 row)
  • 更新/插入值向目标列类型转换失败
1. -- 当新值类型与列类型同为数值类型
2. db_ignore=# create table t_tinyint(num tinyint);
3. CREATE TABLE
4. db_ignore=# insert /*+ ignore_error */ into t_tinyint values(10000);
5. WARNING:  tinyint out of range
6. CONTEXT:  referenced column: num
7. INSERT 0 1
8. db_ignore=# select * from t_tinyint;
9. num
10. -----
11. 255
12. (1 row)

14. -- 当新值类型与列类型同为字符类型时
15. db_ignore=# create table t_varchar5(content varchar(5));
16. CREATE TABLE
17. db_ignore=# insert /*+ ignore_error */ into t_varchar5 values('abcdefghi');
18. WARNING:  value too long for type character varying(5)
19. CONTEXT:  referenced column: content
20. INSERT 0 1
21. db_ignore=# select * from t_varchar5 ;
22. content
23. ---------
24. abcde
25. (1 row)