ArangoDB 数据库 - AQL 使用示例
绑定参数
AQL支持使用绑定参数,从而允许将查询文本与查询中使用的文字值分开。将查询文本与文字值分开是一种很好的做法,因为这会阻止(恶意)将关键字和其他集合名称注入到现有查询中。这种注入会很危险,因为它可能会改变现有查询的含义。
使用绑定参数,现有查询的含义无法更改。绑定参数可以在可以使用文字的查询中的任何地方使用。
绑定参数的语法是@name,其中@表示这是一个绑定参数,name是实际的参数名称。参数名称必须以字母a到z(大写或小写)或数字(0到9)中的任何一个字符开头,后面可以跟任何字母,数字或下划线符号。
FOR u IN users
FILTER u.id == @id && u.name == @name
RETURN u
绑定参数值在执行时需要与查询一起传递,但不作为查询文本本身的一部分。在Web界面中,可以输入绑定参数的查询编辑器旁边有一个窗格。当使用db._query()(例如在arangosh中)时,可以为参数传递一个键值对的对象。这样的对象也可以_api/cursor作为键绑定变量的属性值传递给HTTP API端点:
{
"query": "FOR u IN users FILTER u.id == @id && u.name == @name RETURN u",
"bindVars": {
"id": 123,
"name": "John Smith"
}
}
在查询中声明的绑定参数也必须传递参数值,否则查询将失败。指定查询中未声明的参数也会导致错误。
绑定变量表示一个类似于字符串的值,并且不得放入AQL代码中的引号中:
FILTER u.name == "@name" // wrong
FILTER u.name == @name // correct
如果您需要在查询中执行字符串处理(连接等),则需要使用字符串函数来执行此操作:
FOR u IN users
FILTER u.id == CONCAT('prefix', @id, 'suffix') && u.name == @name
RETURN u
绑定参数可以用于点符号以及用于子属性访问的方括号符号。他们也可以被链接:
LET doc = { foo: { bar: "baz" } }
RETURN doc.@attr.@subattr
// or
RETURN doc[@attr][@subattr]
{
"attr": "foo",
"subattr": "bar"
}
上述示例中的两个变体均是将[ "baz" ]作为查询结果返回。
通过传递一个字符串数组作为参数值,也可以使用点表示法和单个绑定参数来指定整个属性路径,特别是高度嵌套的数据。数组的元素表示路径的属性键:
LET doc = { a: { b: { c: 1 } } }
RETURN doc.@attr
{ "attr": [ "a", "b", "c" ] }
示例查询返回[ 1 ]结果。请注意,{ "attr": "a.b.c" } 会返回一个名为abc的属性的值,而不会像父项a和b那样返回属性c的值。[ "a", "b", "c" ]
用于注入集合名称的特殊类型的绑定参数。这种类型的绑定参数的名称前面带有一个附加的@符号(因此,在查询中使用绑定参数时,必须使用两个@符号)。
FOR u IN @@collection
FILTER u.active == true
RETURN u
{ "@collection": "myCollection" }
关键字不能被bind-values取代; 即FOR,FILTER,IN,INBOUND或函数调用。
访问集合中的数据
通过在查询中指定集合名称可以访问集合数据。一个集合可以理解为一系列文档,这就是它们在AQL中的存储方式。通常使用FOR关键字访问来自集合的文档 。请注意,在迭代集合中的文档时,文档的顺序是未定义的。为了以明确和确定的顺序遍历文档,还应该使用SORT关键字。
集合中的数据存储在文档中,每个文档可能具有与其他文档不同的属性。即使是同一collection文件也是如此。
因此遇到没有在AQL查询中查询的某些或全部属性的文档是非常正常的。在这种情况下,文档中的不存在的属性将被视为存在的值为null。这意味着,如果文档具有特定属性并且属性的值为null,或者文档根本没有特定属性,则将文档属性与null进行比较 将返回true 。
例如,以下查询将返回集合 用户中属性名称中值为null的所有文档,以及根本没有name属性的用户的所有文档:
FOR u IN users
FILTER u.name == null
RETURN u
此外,null小于任何其他值(不包括null本身)。这意味着在比较属性值与少于或少于等于运算符时,具有不存在属性的文档可能会包含在结果中。
例如,以下查询将返回集合 用户中属性年龄值小于39的所有文档,并且还返回集合中根本没有属性年龄的所有文档。
FOR u IN users
FILTER u.age < 39
RETURN u
编写查询时应始终考虑这种行为。需要加上条件
FOR u IN users
FILTER u.age < 39 and u.age!=null
RETURN u
或者
FOR u IN users
FILTER u.age
FILTER u.age < 39
RETURN u
查询结果
结果集
AQL查询的结果是一组值。根据实际查询的内容,结果数组中的各个值可能有也可能不具有均匀结构。
例如,当从具有非均质文档的集合返回数据(集合中的单个文档具有不同的属性名称)而不进行修改时,结果值也将具有非均匀结构。每个结果值本身都是一个文档:
FOR u IN users
RETURN u
[ { "id": 1, "name": "John", "active": false },
{ "age": 32, "id": 2, "name": "Vanessa" },
{ "friends": [ "John", "Vanessa" ], "id": 3, "name": "Amy" } ]
但是,如果查询集合中是一组固定属性,则查询结果值将具有同构结构。每个结果值仍然是一个文档:
FOR u IN users
RETURN { "id": u.id, "name": u.name }
[ { "id": 1, "name": "John" },
{ "id": 2, "name": "Vanessa" },
{ "id": 3, "name": "Amy" } ]
也可以只查询标量值。在这种情况下,结果集是一个标量数组,每个结果值都是一个标量值:
FOR u IN users
RETURN u.id
[ 1, 2, 3 ]
如果查询没有产生任何结果,因为找不到匹配的数据,它将产生一个空的结果数组:
[ ]
查询错误
如果查询语法无效,向服务器发出无效查询将导致解析错误。ArangoDB将在查询检查期间检测到这些错误并中止进一步的处理。并返回错误号和错误消息,以便纠正错误。
如果查询通过解析阶段,则将打开查询中引用的所有集合。如果任何引用的集合不存在,则查询执行将再次中止,并返回相应的错误消息。
在某些情况下,执行查询也可能产生运行时错误,这些错误无法通过单独检查查询文本来预测。这是因为查询可能会使用不均匀的集合中的数据。一些会导致运行时错误的例子是:
除以零:当尝试在算术除法或模数运算中使用值0作为除数时将触发
算术运算的无效操作数:当尝试在算术运算中使用任何非数字值作为操作数时将触发。这包括一元(一元减,一元加)和二元运算(加,减,乘,除和模)
逻辑操作的无效操作数:尝试在逻辑操作中使用任何非布尔值作为操作数时触发。这包括一元(逻辑非/否定),二元(逻辑和,逻辑或)和三元运算符
推荐阅读
-
使用Android Studio创建一个实战级别的应用示例(包含完整源代码与数据库链接)
-
如何在Java中使用Maven搭建与PostgreSQL数据库的连接示例代码
-
ArangoDB 教程(二)--使用 AQL 语句、使用图形、结合 WEB 界面结束
-
ArangoDB 数据库 - AQL 使用示例
-
ArangoDb 学习笔记 ----AQL 教程(一) - Document:可以类似于 Oracle 表中的一条记录。 Edge:可以类似于 Oracle 表中的一条记录,与 Document 不同,这种存储关系就是 Document。 ---------------------------------------------- split line ------------------------------------------------ 对于一个数据库来说,主要功能是添加、删除、修改和检查数据,对于 arangodb 也是一样。 以 AQL 教程章节中的新字符为例,总结一下添加、删除、修改和查询的用法 添加
-
数据库设计工具 Navicat Data Modeler 的使用(附设计示例)
-
MySQL数据库,从入门到精通:第十七部分:如何使用MySQL触发器和注释--2.2代码示例
-
Clickhouse MPPDB 数据库 - 新功能使用示例
-
使用Node.js后端、微信小程序前端配合MongoDB数据库的 CRUD 操作示例
-
Grid++Report 锐浪报表开发常见问题解答集锦-报表设计 问:怎样在设计时打印预览报表? 答:为了及时查看报表的设计效果,Grid++Report 报表设计应用程序提供了四种查看视图:普通视图、页面视图、预览视图与查询视图。通过窗口下边的 Tab 按钮可以在四种视图中任意切换。在预览视图中查看报表的打印预览效果,在查询视图中查看报表的查询显示效果。如果在报表的记录集提供了数据源连接串与查询 SQL,在进入预览视图与查询视图时会利用数据源连接串与查询 SQL 从数据源中自动取数,否则 Grid++Report 将自动生成模拟数据进行模拟打印预览与查询显示。注意:在预览视图与查询视图中看到的报表运行结果有可能与在你程序中的最终运行结果有差异,因为在报表的生成过程中我们可以在程序中对报表的生成行为进行一定的控制。 问:怎样用 Grid++Report 设计交叉表? 答:Grid++Report 没有提供专门实现交叉表的功能,其它的报表构件提供的交叉表功能一般也比较死板和功能有限。利用 Grid++Report 的编程接口可以做出灵活多变,功能丰富的交叉表。示例程序 CrossTab 就是一个实现交叉表的例子程序,认真领会此例子程序,你就可以做出自己想要各种交叉表,并能提取一些共用代码,便于重复使用。 问:怎样设置整个报表的缺省字体? 答:设置报表主对象的字体属性,也就是设置了整个报表的缺省字体。如果改变报表主对象的字体属性,则没有专门的设置字体属性的子对象的字体属性也跟随改变。同样每个报表节与明细网格也有字体属性,他们的字体属性也就是其拥有的子对象的缺省字体。 问:怎样在打印时限制一页的输出行数? 答:设定明细网格的内容行的‘每页行数(RowsPerPage)’属性即可。另外要注意‘调节行高(AdjustRowHeight)’属性值:为真时根据页面的输出高度自动调整行的高度,使整个页面的输出区域充满。为假时按设计时的高度输出行。 问:怎样显示中文大写金额? 答:将对象的“格式(Format)”属性设为 “$$” 及可,可以设置格式的对象有:字段(IGRField)、参数(IGRParameter)、系统变量(IGRSystemVarBox)与综合文字框(IGRMemoBox),其中综合文字框是在报表式上设格式。 问:能否实现自定义纸张与票据打印? 答:Grid++Report 完全支持自定义纸张的打印,只要在报表设定时在页面设置中选定自定义纸张,并指定准确的纸张尺寸。当然要在最终输出时得道合适的打印结果,输出打印机必须支持自定义纸张打印。Windows2000/XP/2003 操作系统上可以在打印机上定义自定义纸张,也可以采用这种方式实现自定义纸张打印。 问:怎样实现 0 值不打印? 答:直接设置格式串就可以,在“数字格式”设置对话框中选定“0 不显示”,就会得到合适的格式串。也可以通过直接录入格式串来指定 0 不显示,但格式串必须符合 Grid++Report 的规定格式。另一种实现办法是在报表获取明细记录数据时,在 BeforePostRecord 事件中将值为零的字段设为空,调用字段的 Clear 方法将字段置为空。 问:怎样实现多栏报表? 答:在明细网格上设‘页栏数(PageColumnCount)’属性值大于 1 即可。通过 Grid++Report 的“页栏输出顺序”还可以指定多栏报表的输出顺序是“先从上到下”还是“先从左到右”。 问:如何实现票据套打? 答:Grid++Report 为实现票据套打做了很多专门的安排:报表设计器提供了页面设计模式,按照设定的纸张尺寸显示设计面板,如果将空白票据的扫描图设为设计背景图,在定位报表内容的输出位置会非常方便。报表部件可以设定打印类别,非套打输出的内容在套打打印模式下就不会输出。 问:Grid++Report 有没有横向分页功能? 答:回答是肯定的,在列的总宽度超过打印页面的输出宽度时,Grid++Report 可以另起新页输出剩余的列,如果左边存在锁定列,锁定列可以在后面的新页中重复输出,这样可以保证关键数据列在每一页都有输出。仔细体会 Grid++Report 提供的多种打印适应策略,选用最合适的方式。Grid++Report 的多种打印适应策略为开发动态报表提供了很好的支持。 问:怎样实现报表本页小计功能? 答:定义一个报表分组,将本分组定义为页分组,在本分组的分组头与分组尾上定义统计。页分组就是在每页产生一个分组项,在每页的上端与下端都会分别显示页分组的分组头与分组尾,页分组不用定义分组依据字段。 报表运行 问:怎样与数据库建立连接? 答:如果在设计报表时指定了数据集的数据源连接串与查询 SQL 语句,Grid++Report 采用拉模式直接从数据源取得报表数据,Grid++Report 利用 OLE DB 从数据源取数,OLE DB 提供了广泛的数据源操作能力。如果 Grid++Report 的数据来源采用推模式,即 Grid++Report 不直接与数据库建立连接,各种编程语言/平台都提供了很好的数据库连接方式,并且易于操作,应用程序在报表主对象(IGridppReport)的 FetchRecord 事件中将数据传入,例子程序提供了各种编程语言填入数据的通用方法,对C++Builder 和 Delphi 还进行了专门的包装,直接关联 TDataSet 对象也可以将 TDataSet 对象中的数据传给报表。 问:打印时能否对打印纸张进行自适应?支持表格的折行打印吗? 答:Grid++Report 在打印时采用多种适应策略,通过设置明细网格(IGRDetailGrid)的‘打印策略(PrintAdaptMethod)’属性指定打印策略。(1)丢弃:按设计时列的宽度输出,超出范围的内容不显示。(2)绕行:按设计时列的宽度输出,如果在当前行不能完整输出,则另起新行进行输出。(3)缩放适应:对所有列的输出宽度进行按比例地缩放,使总宽度等于页面的输出宽度。(4)缩小适应:如果列的总宽度小于页面的输出宽度,对所有列的输出宽度进行按比例地缩小,使总宽度等于页面的输出宽度。(5)横向分页:超范围的列在新页中输出。(6)横向分页并重复锁定列。 问:如何改变缺省打印预览窗口的窗口标题? 答:改变报表主对象的‘标题(Title)’属性即可。 问:利用集合对象的编程接口取子对象的接口引用,但不是自己期望的结果。 答:Grid++Report中所有集合对象的下标索引都是从 1 开始,另按对象的名称查找对象的接口引用时,名称字符是不区分大小写的。 问:怎样在运行时控制报表中各个对象的可见性?即怎样在运行时显示或隐藏对象? 答:在报表主对象(GridppReport)的 SectionFormat 事件中设定相应报表子对象的可见(Visible)属性即可。 问:报表主对象重新载入数据,设计器中为什么没有反映新载入的数据? 答:应调用 IGRDesigner 的 Reload 方法。 问:怎样实现不进入打印预览界面,直接将报表打印出来?