GBASE 8C——SQL参考6 sql语法（12）

最新推荐文章于 2022-10-27 14:32:30 发布

Joe72

最新推荐文章于 2022-10-27 14:32:30 发布

阅读量390

点赞数

文章标签：数据库 database dba sql

原文链接：https://www.modb.pro/db/448435

版权

EXECUTE

功能描述

执行一个前面准备好的预备语句。因为一个预备语句只在会话的生命期里存在，那么预备语句必须是在当前会话的前些时候用PREPARE语句创建的。

语法格式

EXECUTE name [ ( parameter [, ...] ) ]

参数说明

name：要执行的预备语句的名字；
parameter：给预备语句的一个参数的具体数值，它必须是一个生成与创建这个预备语句时指定参数的数据类型相兼容的值的表达式；

注意事项

如果创建预备语句的PREPARE语句声明了一些参数，那么传递给EXECUTE语句的必须是一个兼容的参数集，否则就会生成一个错误。

范例

PREPARE insert_customer(int,varchar(200),date,varchar(50)) AS INSERT INTO customer VALUES($1,$2,$3,$4);

PREPARE

EXECUTE insert_customer(11, '马超','20200618',15974236);

INSERT 0 1

语法兼容

SQL 标准包括了一个EXECUTE语句，但是只被用于嵌入式 SQL。

相关语法

DEALLOCATE,PREPARE

EXECUTE DIRECT

功能描述

在指定的节点上执行SQL语句。

语法格式

EXECUTE DIRECT ON ( nodename [, ... ] )

query

参数说明

nodename：指定查询的节点名称，指定多个节点时用逗号分隔；
query：要执行查询语句。

注意事项

只有系统管理员才能执行EXECUTE DIRECT。

由于CN节点不存储用户表数据，不允许指定CN节点执行用户表上的SELECT查询。

范例

SELECT * FROM pgxc_node;

-----------+-----------+-----------+-----------------+----------------+------------------+--------

cn1 | C | 5432 | 192.168.142.211 | f | f | -117871

cn3 | C | 5432 | 192.168.142.213 | f | f | 110106

dn1 | D | 5433 | 192.168.142.211 | t | t | -56002

dn2 | D | 5433 | 192.168.142.212 | f | f | 35236

dn3 | D | 5433 | 192.168.142.213 | f | f | -70012

(5 rows)

EXECUTE DIRECT ON(dn1) 'select count(*) from t1';

count

--------

324900

(1 row)

SELECT COUNT(*) FROM t1;

count

---------

1000000

(1 row)

语法兼容

在 SQL 标准中没有定义EXECUTE DIRECT语句。

EXPLAIN

功能描述

显示SQL语句的执行计划。

语法格式

EXPLAIN [ ( option [, ...] ) ] statement

EXPLAIN [ ANALYZE ] [ VERBOSE ] statement

这里option可以是：

ANALYZE [ boolean ]

VERBOSE [ boolean ]

COSTS [ boolean ]

BUFFERS [ boolean ]

TIMING [ boolean ]

SUMMARY [ boolean ]

FORMAT { TEXT | XML | JSON | YAML }

参数说明

ANALYZE：显示实际运行时间和其他统计数据，默认值为FALSE；
VERBOSE：显示有关计划的额外信息，默认值为FALSE；
COSTS：包括每个规划节点的估计总成本，以及估计的行数和每行的宽度，默认值为TRUE；
BUFFERS：包括缓冲区的使用情况的信息，默认值为FALSE；
NODES：打印query执行的节点信息；
NUM_NODES：打印执行中的节点的个数信息；
TIMING：包括实际的启动时间和花费在输出节点上的时间信息，默认值为TRUE；
SUMMARY：在查询计划之后包含摘要信息（例如，总计的时间信息）；
FORMAT：指定输出格式，取值范围：TEXT、XML、JSON或者YAML，默认为TEXT；
boolean：指定被选中的选项是否应该被打开或关闭，可以指定TRUE、ON或1打开，或指定FALSE、OFF或0禁用，缺省情况下默认为TRUE；
statement：指定要分析的SQL语句。

注意事项

在指定ANALYZE选项时，语句会被执行。如果用户想使用EXPLAIN分析INSERT，UPDATE，DELETE，CREATE TABLE AS或EXECUTE语句，而不想改动数据（执行这些语句会影响数据），请使用这种方法：

START TRANSACTION;

EXPLAIN ANALYZE ...;

ROLLBACK;

范例

EXPLAIN SELECT * FROM disttab;

QUERY PLAN

------------------------------------------------------------------

Remote Fast Query Execution (cost=0.00..0.00 rows=0 width=0)

Node/s: dn1, dn2, dn3

-> Seq Scan on disttab (cost=0.00..11.70 rows=170 width=426)

(3 rows)

EXPLAIN (FORMAT JSON) SELECT * FROM disttab;

QUERY PLAN

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

--------------------------------------------------------------------------------------------------------------------------

[

{

"Plan": {

"Node Type": "c3",

"Parallel Aware": false,

"Startup Cost": 0.00,

"Total Cost": 0.00,

"Plan Rows": 0,

"Plan Width": 0,

"Node/s": "dn1, dn2, dn3",

"Remote plan": "[\n {\n \"Plan\": {\n \"Node Type\": \"Seq Scan\",\n \"Parallel Aware\": false,\n \"Relation Name\": \"disttab\",\n \"Alias\": \"disttab\",\n \"St

artup Cost\": 0.00,\n \"Total Cost\": 11.70,\n \"Plan Rows\": 170,\n \"Plan Width\": 426\n }\n }\n]\n"+

}

]

(1 row)

语法兼容

在 SQL 标准中没有定义EXPLAIN语句。

相关语法

ANALYZE

FETCH

功能描述

FETCH通过已创建的游标来检索数据。

语法格式

FETCH [ direction [ FROM | IN ] ] cursor_name

其中 direction 可以为空或者以下之一：

PRIOR

FIRST

LAST

ABSOLUTE count

RELATIVE count

count

ALL

FORWARD

FORWARD count

FORWARD ALL

BACKWARD

BACKWARD count

BACKWARD ALL

参数说明

direction：定义抓取数据的方向及行数，取值范围：
1. NEXT：从当前关联位置开始，抓取下一行，此为默认值；
2. PRIOR：从当前关联位置开始，抓取上一行；
3. FIRST：抓取查询的第一行（和ABSOLUTE 1相同）；
4. LAST：抓取查询的最后一行（和ABSOLUTE -1相同）；
5. ABSOLUTE count：抓取查询中第count行，ABSOLUTE抓取不会比用相对位移移动到需要的数据行更快，因为下层的实现必须遍历所有中间的行；
6. RELATIVE count：从当前关联位置开始，抓取随后或前面的第count行；
7. count：抓取随后的count行（和FORWARD count一样）；
8. ALL：从当前关联位置开始，抓取所有剩余的行（和FORWARD ALL一样）；
9. FORWARD：抓取下一行（和NEXT一样）；
10. FORWARD count：与RELATIVE count的效果相同，从当前关联位置开始，抓取随后或前面的第count行；
11. FORWARD ALL：从当前关联位置开始，抓取所有剩余行；
12. BACKWARD：GBase 8c当前不支持。从当前关联位置开始，抓取前面一行(和PRIOR一样)；
13. BACKWARD count：GBase 8c当前不支持。从当前关联位置开始，抓取前面的count行（向后扫描）；
14. BACKWARD ALL：GBase 8c当前不支持。从当前关联位置开始，抓取所有前面的行（向后扫描）。
count：整数常量（可以带符号），用来确定要取得的位置或行数；
cursor_name：使用关键字FROM或IN指定游标名称。

注意事项

每个游标都有一个供FETCH使用的关联位置。游标的关联位置可以在查询结果的第一行之前，或者在结果中的任意行，或者在结果的最后一行之后：

游标刚创建完之后，关联位置在第一行之前的。
在抓取了一些移动行之后，关联位置在检索到的最后一行上。
如果FETCH抓取完了所有可用行，它就停在最后一行后面，或者在反向抓取的情况下是停在第一行前面。
FETCH ALL或FETCH BACKWARD ALL将总是把游标的关联位置放在最后一行或者在第一行前面。

如果游标定义了NO SCROLL，则不允许使用例如FETCH BACKWARD之类的反向抓取。

NEXT，PRIOR，FIRST，LAST，ABSOLUTE，RELATIVE形式在恰当地移动游标之后抓取一条记录。如果后面没有数据行，就返回一个空的结果，此时游标就会停在查询结果的最后一行之后（向后查询时）或者第一行之前（向前查询时）。

FORWARD和BACKWARD形式在向前或者向后移动的过程中抓取指定的行数，然后把游标定位在最后返回的行上；或者是，如果count大于可用的行数，则在所有行之后（向后查询时）或者之前（向前查询时）。

RELATIVE 0，FORWARD 0，BACKWARD 0都要求在不移动游标的前提下抓取当前行，也就是重新抓取最近刚抓取过的行。除非游标定位在第一行之前或者最后一行之后，这个动作都应该成功，而在那两种情况下，不返回任何行。

当FETCH的游标上涉及列存表时，不支持BACKWARD、PRIOR、FIRST等涉及反向获取操作。

范例

BEGIN WORK;

BEGIN

DECLARE g_ft SCROLL CURSOR FOR SELECT * FROM customer;

DECLARE CURSOR

FETCH FORWARD 5 FROM g_ft;

id | name | birthday | tel

----+------+------------+-----------

3 | 张飞 | 2020-04-03 | 142356789

5 | 孙坚 | 2020-04-05 | 145623789

1 | 刘备 | 2020-04-01 | 123456789

4 | 曹操 | 2020-04-04 | 154623789

8 | 周瑜 | |

(5 rows)

FETCH PRIOR FROM g_ft;

id | name | birthday | tel

----+------+------------+-----------

4 | 曹操 | 2020-04-04 | 154623789

(1 row)

CLOSE g_ft;

CLOSE CURSOR

COMMIT WORK;

COMMIT

语法兼容

SQL标准只定义FETCH在嵌入式SQL中使用。

相关语法

CLOSE, DECLARE, MOVE

GRANT

功能描述

对角色和用户进行授权操作。

语法格式

GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }

[, ...] | ALL [ PRIVILEGES ] }

ON { [ TABLE ] table_name [, ...]

| ALL TABLES IN SCHEMA schema_name [, ...] }