DESIGNER_ADD_DESIGN_QUERIES

读取并评估某个输入文件中的查询,并将其接受的查询添加到指定设计中。所有接受的查询均分配了权重 1。

需要满足以下要求:

  • 所有查询的表都必须预先添加到包含 DESIGNER_ADD_DESIGN_TABLES 的设计中。

  • 如果设计类型为增量类型,Database Designer 将仅读取输入文件中的前 100 个查询,并忽略该数量以外的所有查询。

所有接受的查询都必须添加到系统表 DESIGN_QUERIES 中。

这是元函数。您必须在顶级 SELECT 语句中调用元函数。

行为类型

易变

语法

DESIGNER_ADD_DESIGN_QUERIES ( 'design‑name', 'queries‑file' [, return‑results] )

参数

design‑name
目标设计的名称。
queries‑file
包含要评估的查询的文件的绝对路径和名称,位于连接会话的节点的本地文件系统上,或 Vertica 支持的其他文件系统或对象存储上。
return‑results
布尔值,选择性地指定是否将添加操作的结果返回到标准输出。如果设置为 true,Database Designer 将返回以下结果:
  • 已接受的查询数

  • 引用非设计表的查询数

  • 不受支持的查询数

  • 非法查询数

特权

非超级用户:设计创作者 具有执行 input‑file 中的查询所需的所有权限。

在以下情况下 Database Designer 会返回错误:

  • 查询包含非法语法。

  • 查询参考:

    • 仅限外部或系统表

    • 本地临时表或其他非设计表

  • DELETE 或 UPDATE 包含一个或多个子查询。

  • INSERT 查询不包含 SELECT 子句的。

  • Database Designer 无法优化查询。

示例

以下示例将来自 vmart_queries.sql 的查询添加到 VMART_DESIGN 设计中。该文件包含九个查询。该语句包含第三个实参 true,因此 Database Designer 将返回添加操作的结果:

=> SELECT DESIGNER_ADD_DESIGN_QUERIES ('VMART_DESIGN', '/tmp/examples/vmart_queries.sql', 'true');
...
 DESIGNER_ADD_DESIGN_QUERIES
----------------------------------------------------
 Number of accepted queries                      =9
 Number of queries referencing non-design tables =0
 Number of unsupported queries                   =0
 Number of illegal queries                       =0
(1 row)

另请参阅

通过编程方式运行 Database Designer