Skip to main content

查询定义

报告框架管理控制台的查询定义标签页,显示创建查询定义按钮以及类型、句柄、名称、描述、数据源、修改、删除。以及导出栏。

查询定义标签允许用户创建新查询,并查看和管理之前创建的查询。

类型

标准:你订阅的报告中使用的查询。

自定义:基于你的系统构建查询。

处理

通常是一个 guid(一些较早的查询可能带有描述性句柄),由系统生成并用作查询的唯一标识符。

名称

查询名称供参考。

描述

简要介绍一下查询。

数据源

查询所用的连接源;标准连接有BBLEARN、CMSDOC和BBSTATS。

修改

一个编辑查询的链接。

删除

一个删除查询的链接。

导出

一个链接,可以导出查询定义作为JSON文本文件。

创建查询定义工具允许具备SQL查询编写知识的用户编写并保存查询,最终用户可以执行以填充报告。该工具内置了一些安全功能,可以防止恶意代码被编写(例如,你不能用它来更新 Blackboard 数据),但您仍然是在编写 SQL 语句来操作数据库。在开发查询时请记住这一点,因为你可能会写出糟糕的查询,导致系统崩溃。这个工具很基础,但确实有强大功能。

糟糕的查询会消耗数据库资源,导致系统宕机。这一点再强调不为过。您可以编写针对 Blackboard 事务数据库的查询,这将影响系统性能。最佳实践是用其他工具对非生产数据库(例如,Snowflake或pgAdmin针对测试实例)开发查询。

查询一旦执行,服务器上没有停止的机制。这也是在另一个系统上开发并粘贴查询定义的好理由,因为你确定它能正常运行。

如需了解更多关于写作查询的信息,请访问Anthology Support并登录。搜索条目89873并下载报告框架扩展报告管理器的用户指南。