From 9b8d5701583b19ecb2bddaca3141f565d17d1783 Mon Sep 17 00:00:00 2001 From: SisMaker <1713699517@qq.com> Date: Sun, 21 Mar 2021 23:52:23 +0800 Subject: [PATCH] =?UTF-8?q?ft=EF=BC=9A=E9=83=A8=E5=88=86=E4=BB=A3=E7=A0=81?= =?UTF-8?q?=E6=95=B4=E7=90=86=20=E4=B8=8E=20=E6=97=A5=E5=BF=97=E6=B7=BB?= =?UTF-8?q?=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- rebar.config | 1 + src/docs/arangodb/agDocs/Aql语法.md | 293 + src/docs/arangodb/agDocs/funs.md | 1165 ++++ src/docs/arangodb/agDocs/graph语法.md | 0 src/docs/arangodb/agDocs/启动相关.md | 8 + src/docs/arangodb/agDocs/命名规范.md | 44 + .../arangodb/agDocs/类型和值的顺序.md | 22 + src/docs/arangodb/agDocs/索引.md | 237 + src/docs/arangodb/agDocs/运算符.md | 240 + .../arangodb/arandodb初始化配置相关.md | 34 + src/docs/arangodb/arangod.conf | 77 + src/docs/arangodb/arangodb主要特特点.md | 16 + src/docs/arangodb/arangodb服务器选项.md | 507 ++ src/docs/arangodb/arangodb程序与工具.md | 32 + .../减少服务器的内存占用.md | 159 + ...安装与启动停止状态系统服务.md | 20 + ...基础配置与系统优化选项配置.md | 0 src/docs/centos/centos8换源.md | 26 + src/docs/centos/centosGcc升级.md | 34 + .../centos不能显示中文解决办法.md | 3 + src/docs/centos/centos同步时间.md | 9 + src/docs/centos/ssh安装与配置.md | 14 + src/docs/erlang/elangtrycatch说明.md | 19 + src/docs/erlang/erlang-DsBenchMark.txt | 5600 +++++++++++++++++ src/docs/erlang/erlangApp相关.md | 88 + ...if中内存分配推荐使用enif_alloc.md | 3 + src/docs/erlang/erlangNif编程相关.md | 64 + src/docs/erlang/erlangSupervisor相关.md | 243 + src/docs/erlang/erlangVS环境编译nifdll.md | 44 + src/docs/erlang/erlang二进制.md | 95 + src/docs/erlang/erlang套接字编程.md | 448 ++ src/docs/erlang/erlang性能优化.md | 220 + src/docs/erlang/erlang数据结构相关.md | 300 + src/docs/erlang/erlang规范.md | 1159 ++++ src/docs/erlang/erlang进程.md | 344 + src/docs/erlang/erlang集群相关.md | 333 + .../picture/erlang参数传递讲解.png | Bin 0 -> 56079 bytes .../erlang/picture/erlang数据复制.png | Bin 0 -> 21177 bytes .../erlang汇编识别为递归标识符.png | Bin 0 -> 23623 bytes .../erlang/picture/erlang进程状态图.png | Bin 0 -> 47938 bytes .../列表推导与二进制推导.png | Bin 0 -> 309430 bytes src/docs/erlang/time相关的日志.md | 181 + src/docs/erlang/ubuntu安装erlang.md' | 10 + .../erlang/编译安装与简单安装.md | 72 + src/docs/svnGit/svnGit相关.md | 24 + src/docs/代码规范/提交规范.md | 11 + src/stackStrace/utParseStack.erl | 26 +- 47 files changed, 12208 insertions(+), 17 deletions(-) create mode 100644 src/docs/arangodb/agDocs/Aql语法.md create mode 100644 src/docs/arangodb/agDocs/funs.md create mode 100644 src/docs/arangodb/agDocs/graph语法.md create mode 100644 src/docs/arangodb/agDocs/启动相关.md create mode 100644 src/docs/arangodb/agDocs/命名规范.md create mode 100644 src/docs/arangodb/agDocs/类型和值的顺序.md create mode 100644 src/docs/arangodb/agDocs/索引.md create mode 100644 src/docs/arangodb/agDocs/运算符.md create mode 100644 src/docs/arangodb/arandodb初始化配置相关.md create mode 100644 src/docs/arangodb/arangod.conf create mode 100644 src/docs/arangodb/arangodb主要特特点.md create mode 100644 src/docs/arangodb/arangodb服务器选项.md create mode 100644 src/docs/arangodb/arangodb程序与工具.md create mode 100644 src/docs/arangodb/减少服务器的内存占用.md create mode 100644 src/docs/arangodb/基本安装与启动停止状态系统服务.md create mode 100644 src/docs/arangodb/基础配置与系统优化选项配置.md create mode 100644 src/docs/centos/centos8换源.md create mode 100644 src/docs/centos/centosGcc升级.md create mode 100644 src/docs/centos/centos不能显示中文解决办法.md create mode 100644 src/docs/centos/centos同步时间.md create mode 100644 src/docs/centos/ssh安装与配置.md create mode 100644 src/docs/erlang/elangtrycatch说明.md create mode 100644 src/docs/erlang/erlang-DsBenchMark.txt create mode 100644 src/docs/erlang/erlangApp相关.md create mode 100644 src/docs/erlang/erlangNif中内存分配推荐使用enif_alloc.md create mode 100644 src/docs/erlang/erlangNif编程相关.md create mode 100644 src/docs/erlang/erlangSupervisor相关.md create mode 100644 src/docs/erlang/erlangVS环境编译nifdll.md create mode 100644 src/docs/erlang/erlang二进制.md create mode 100644 src/docs/erlang/erlang套接字编程.md create mode 100644 src/docs/erlang/erlang性能优化.md create mode 100644 src/docs/erlang/erlang数据结构相关.md create mode 100644 src/docs/erlang/erlang规范.md create mode 100644 src/docs/erlang/erlang进程.md create mode 100644 src/docs/erlang/erlang集群相关.md create mode 100644 src/docs/erlang/picture/erlang参数传递讲解.png create mode 100644 src/docs/erlang/picture/erlang数据复制.png create mode 100644 src/docs/erlang/picture/erlang汇编识别为递归标识符.png create mode 100644 src/docs/erlang/picture/erlang进程状态图.png create mode 100644 src/docs/erlang/picture/列表推导与二进制推导.png create mode 100644 src/docs/erlang/time相关的日志.md create mode 100644 src/docs/erlang/ubuntu安装erlang.md' create mode 100644 src/docs/erlang/编译安装与简单安装.md create mode 100644 src/docs/svnGit/svnGit相关.md create mode 100644 src/docs/代码规范/提交规范.md diff --git a/rebar.config b/rebar.config index 8a4a4a1..79f2aaf 100644 --- a/rebar.config +++ b/rebar.config @@ -1,5 +1,6 @@ {erl_opts, [no_debug_info, {i, "include"}]}. {deps, [ + {eFmt, ".*", {git, "http://192.168.0.88:53000/SisMaker/eFmt.git", {branch, "master"}}}, {eSync, ".*", {git, "http://192.168.0.88:53000/SisMaker/eSync.git", {branch, "master"}}} ]}. diff --git a/src/docs/arangodb/agDocs/Aql语法.md b/src/docs/arangodb/agDocs/Aql语法.md new file mode 100644 index 0000000..d008d4c --- /dev/null +++ b/src/docs/arangodb/agDocs/Aql语法.md @@ -0,0 +1,293 @@ + # for语法 + 一般语法 + FOR variableName IN expression + 图遍历 + FOR vertexVariableName, edgeVariableName, pathVariableName IN traversalExpression + 视图 特殊关键字 + FOR variableName IN viewName SEARCH searchExpression + 需要注意 视图不能用作遍历中的边集合 + FOR v IN 1..3 ANY startVertex viewName /* 错误的用法 */ + 选项 对于集合和视图，该FOR构造支持可选的OPTIONS 后缀以修改行为。通用语法为： + FOR variableName IN expression OPTIONS {option: value, ...} + + 示例 + 表达式返回的每个数组元素仅被访问一次。在所有情况下，表达式都必须返回一个数组。空数组也是允许的。当前数组元素可用于由variableName指定的变量中的进一步处理。 + + FOR u IN users + RETURN u + 这将遍历数组用户中的所有元素（注意：在这种情况下，此数组由名为“ users”的集合中的所有文档组成），并使当前数组元素在变量u中可用。在此示例中，不对u进行修改，而只是使用RETURN关键字将其推入结果中。 + + 注意：如此处所示，在基于集合的数组上进行迭代时，除非使用SORT 语句定义了明确的排序顺序，否则文档的顺序是不确定的。 + + 引入的变量在关闭放置FOR范围之前一直可用FOR。 + + 另一个示例使用静态声明的值数组进行迭代： + + FOR year IN [ 2011, 2012, 2013 ] + RETURN { "year" : year, "isLeapYear" : year % 4 == 0 && (year % 100 != 0 || year % 400 == 0) } + FOR也允许嵌套多个语句。当FOR语句嵌套时，FOR 将创建由各个语句返回的数组元素的叉积。 + + FOR u IN users + FOR l IN locations + RETURN { "user" : u, "location" : l } + + 索引提示 + 对于集合，通过此内联选项机制提供了索引提示。提示可以两种不同的格式指定。 + 第一个格式选项是最简单的，只有一个索引名称。对于许多情况，这应该足够了。只要有可能在该FOR循环中使用索引的选择，优化器就会首先检查是否可以使用指定的索引。 + 如果是这样，它将使用它，而不管它通常是否使用其他索引。如果它不能使用该索引，则它将退回到其正常逻辑以选择另一个索引。 + 如果forceIndexHint: true指定了可选参数，那么它将不会回退，而是会产生错误。 + OPTIONS {indexHint: 'byName'[, forceIndexHint: ]} + 第二个是按优先顺序排列的索引名称数组。以这种方式指定时，优化器的行为将与上述相同，但是将按照给定的顺序检查每个指定索引的可行性，并退回其正常逻辑或仅在未指定指定条件时失败指标是可行的。 + OPTIONS {indexHint: ['byName', 'byColor'][, forceIndexHint: ]} + +# return语法 + 该RETURN语句可用于产生查询结果。必须RETURN在数据选择查询的每个块的末尾指定一条语句，否则查询结果将是不确定的。RETURN在数据修改查询的主级别使用 是可选的。 + 一般语法为RETURN： + RETURN expression or RETURN DISTINCT(如果查询的顶层没有FOR 循环，则不允许在查询的顶层。) + 另外 arangodb3.3开始 return distinct 将不会改变其应用结果的顺序 + + 注意：RETURN将关闭当前作用域并消除其中的所有局部变量。在处理子查询时，记住这一点很重要。 + +# filter语法 + 一般语法 + FILTER expression + expression必须是评估为false或true的条件。如果条件结果为false，则将跳过当前元素，因此将不对其进行进一步处理，也不将其作为结果的一部分。 + 如果条件为true，则不跳过当前元素，可以对其进行进一步处理。有关条件中可以使用的比较运算符，逻辑运算符等的列表，请参见运算符。\ + 另外注意filter的位置 他会影响查询的结果 + + # search语法 + 该SEARCH关键字开始语言结构类型为ArangoSearch的过滤器视图。从概念上讲，视图只是另一个文档数据源，类似于数组或文档/边缘集合，您可以在其上使用AQL中的FOR操作进行迭代： + 可选SEARCH操作提供以下功能： + 1. 根据AQL布尔表达式和函数过滤文档 + 2. 匹配位于由快速索引支持的不同集合中的文档 + 3. 根据每个文档与搜索条件的匹配程度对结果集进行排序 + + 一般语法 + FOR doc IN viewName + SEARCH expression OPTIONS {…} + ... + SEARCH与相比FILTER，该语句被视为FOR操作的一部分 ，而不是单独的语句。它不能随意放置在查询中，也不能多次放置在FOR循环体内。 + FOR ... IN必须紧随其后的是View的名称，而不是集合的名称。该SEARCH操作必须遵循接下来，其他操作之前SEARCH，如FILTER， + COLLECT等没有在这个位置上允许的。SEARCH在表达式之后，可以进行后续操作， 但包括SORT根据ArangoSearch View计算的排名值对搜索结果进行排序。 + expression必须是ArangoSearch表达式。在搜索和排序阶段，ArangoSearch的全部功能都通过特殊的ArangoSearch功能加以利用和公开。最重要的是，支持常见的AQL运算符： + + AND， && + OR， || + NOT， ! + == + <= + >= + < + > + != + IN （数组或范围），也 NOT IN + ArangoSearch不会考虑字母的字母顺序，即针对视图的SEARCH操作中的范围查询将不会遵循已定义的Analyzer语言环境或服务器语言（启动选项--default-language）的语言规则！另请参阅已知问题。 + + FOR doc IN viewName + SEARCH ANALYZER(doc.text == "quick" OR doc.text == "brown", "text_en") + RETURN doc + 支持数组比较运算符（在v3.6.0中引入）： + + LET tokens = TOKENS("some input", "text_en") // ["some", "input"] + FOR doc IN myView SEARCH tokens ALL IN doc.title RETURN doc // dynamic conjunction + FOR doc IN myView SEARCH tokens ANY IN doc.title RETURN doc // dynamic disjunction + FOR doc IN myView SEARCH tokens NONE IN doc.title RETURN doc // dynamic negation + FOR doc IN myView SEARCH tokens ALL > doc.title RETURN doc // dynamic conjunction with comparison + FOR doc IN myView SEARCH tokens ANY <= doc.title RETURN doc // dynamic disjunction with comparison + 请注意，不支持内联表达式和其他一些功能 SEARCH。如果表达式无效，服务器将引发查询错误。 + + 所述OPTIONS关键字和一个对象可以任选地按照搜索表达式来设置搜索选项。 + + 处理非索引字段固定链接 + 未配置为由视图索引的文档属性被SEARCH视为不存在。这会影响仅从视图发出的文档的测试。 + 如果需要，可以使用特殊的includeAllFields View属性为源文档的所有（子）字段建立索引。 + +# sort语法 + SORT expression direction(ASC or DESC)(默认升序ASC) + +# limit语法 + LIMIT count + LIMIT offset, count + +# let语法 + 该LET语句可用于为变量分配任意值。然后将该变量引入LET放置该语句的作用域中。 + 通用语法为： + LET variableName = expression + 变量在AQL中是不可变的，这意味着它们不能重新分配： + +# collect语法 + COLLECT关键字可用来组由一个或多个基团的标准阵列。 + 该COLLECT语句将消除当前范围内的所有局部变量。之后，COLLECT只有由COLLECT自身引入的变量才可用。 + 操作有几种语法变体COLLECT： + COLLECT variableName = expression + COLLECT variableName = expression INTO groupsVariable + COLLECT variableName = expression INTO groupsVariable = projectionExpression + COLLECT variableName = expression INTO groupsVariable KEEP keepVariable + COLLECT variableName = expression WITH COUNT INTO countVariable + COLLECT variableName = expression AGGREGATE variableName = aggregateExpression + COLLECT variableName = expression AGGREGATE variableName = aggregateExpression INTO groupsVariable + COLLECT AGGREGATE variableName = aggregateExpression + COLLECT AGGREGATE variableName = aggregateExpression INTO groupsVariable + COLLECT WITH COUNT INTO countVariable + 所有变体都可以选择以OPTIONS { … }子句结尾。 + +# remove语法 + REMOVE keyExpression IN collection options + REMOVE keyExpression IN collection options RETURN OLD + +# udpate语法 + 更新操作的两种语法是： + UPDATE document IN collection options + UPDATE keyExpression WITH document IN collection options + + UPDATE document IN collection options RETURN OLD + UPDATE document IN collection options RETURN NEW + UPDATE keyExpression WITH document IN collection options RETURN OLD + UPDATE keyExpression WITH document IN collection options RETURN NEW、 + +# replace语法 + REPLACE document IN collection options + REPLACE keyExpression WITH document IN collection options + + REPLACE document IN collection options RETURN OLD + REPLACE document IN collection options RETURN NEW + REPLACE keyExpression WITH document IN collection options RETURN OLD + REPLACE keyExpression WITH document IN collection options RETURN NEW + + 以下查询使用NEW伪值返回替换的文档（不包含某些系统属性）： + FOR u IN users + REPLACE u WITH { value: "test" } IN users + LET replaced = NEW + RETURN UNSET(replaced, '_key', '_id', '_rev') + +# insert语法 + INSERT document INTO collection [ OPTIONS options ] + INSERT document INTO collection RETURN NEW + IN关键字可以代替INTO并具有相同的含义。 + +# upsert语法 + UPSERT searchExpression INSERT insertExpression UPDATE updateExpression IN collection options + UPSERT searchExpression INSERT insertExpression REPLACE updateExpression IN collection options + 当使用UPDATEupsert操作的变体时，找到的文档将被部分更新，这意味着仅updateExpression中指定的属性将被更新或添加。使用REPLACEupsert 的变体时，现有文档将被updateExpression的上下文替换。 + 更新文档将使用服务器生成的值来修改文档的修订号。系统属性_id，_key和_rev无法更新，_from和_to可以更新。 + +# with语法 + WITH managers + FOR v, e, p IN OUTBOUND 'users/1' usersHaveManagers + RETURN { v, e, p } + + + 插入文档 + 语法是INSERT document INTO collectionName。该文档是一个对象，您可以从JavaScript或JSON中了解它，它由属性键和值对组成。 + 属性键周围的引号在AQL中是可选的。键总是字符序列（字符串），而属性值可以有不同的类型： + 空值 + 布尔值（true，false） + 数字（整数和浮点数） + 串 + 排列 + 宾语 + + 该LET关键字定义一个带有名称数据的变量和一个对象数组作为值，因此LET variableName = valueExpression表达式是一个文字数组定义[ {...}, {...}, ... ]。 + + FOR variableName IN expression用于迭代数据数组的每个元素 。在每个循环中，将一个元素分配给变量d。然后在INSERT语句中使用此变量而不是文字对象定义。基本上是做什么的： + + INSERT { + "name": "Robert", + "surname": "Baratheon", + "alive": false, + "traits": ["A","H","C"] + } INTO Characters + + INSERT { + "name": "Jaime", + "surname": "Lannister", + "alive": true, + "age": 36, + "traits": ["A","F","B"] + } INTO Characters + + ... + 注意：AQL不允许INSERT在单个查询中针对同一集合的多个操作。然而， 允许它作为FOR循环体，插入多个文档，就像我们对上面的查询所做的那样。 + + + FOR c IN Characters_1 RETURN c + 循环的语法是FOR variableName IN collectionName。对于集合中的每个文档，将为c分配一个文档，然后根据循环体返回该文档。查询返回我们先前存储的所有字符。 + 该文档包含我们存储的四个属性，以及数据库系统添加的另外三个属性。每个文档都需要一个唯一的文档_key，用于在集合中标识它。它_id是计算属性，集合名称， + 正斜杠/和文档键的串联。它唯一标识数据库中的文档。_rev是系统管理的修订版ID。 + + 用户可以在创建文档时提供文档键，也可以自动分配唯一值。它以后不能改变。以下划线开头的所有三个系统属性_都是只读的。 + + 我们可以使用文档密钥或文档ID在AQL函数的帮助下检索特定文档DOCUMENT() + +更新文档 + UPDATE documentKey WITH object IN collectionName l列出的属性更新指定的文档（存在则添加它们） + 要更新整个文档 整个用replace + + 可以用循环 更新或者替换属性 + FOR c IN Character + UPDATE c with {swason: 1} IN Character + +删除文件 + 要从集合中删除文档 执行 REMOVE + REMOVE "201213" IN Character + + FOR C IN Characters + REMOVE c IN Characters + +匹配条件 + 为了查找满足条件的文档 FILTER AQL + FOR c IN Characters + FILTER c.age >= 12 + RETURN c.name + + 多种条件 + FOR c IN Characters + FILTER c.age 《 13 + FILTER c.age != null + RETURN {name: c.name, age: c.age} 可以用AND运算符 + 同时也有OR运算符 + +限制结果计数 + FOR c IN Characters_1 + LIMIT 5 + RETURN c.name + FOR c IN Characters + LIMIT 2,5 + RETURN c.name + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/docs/arangodb/agDocs/funs.md b/src/docs/arangodb/agDocs/funs.md new file mode 100644 index 0000000..762f79e --- /dev/null +++ b/src/docs/arangodb/agDocs/funs.md @@ -0,0 +1,1165 @@ +# 函数名不区分大小写 + +# ArangoSearch函数 + +# 数值函数 + AQL提供了一些用于计算的数值函数。支持以下功能： + +## ABS（） + ABS(value) → unsignedValue + + 返回值的绝对部分。 + + 值（数字）：任何数字，正数或负数 + 返回unsignedValue（数字）：不带+或-号的数字 + ABS(-5) // 5 + ABS(+5) // 5 + ABS(3.5) // 3.5 +## ACOS（） + ACOS(value) → num + + 返回value的反余弦值。 + + 值（数字）：输入值 + 返回NUM（数|空）：的反余弦值，或空如果值是在有效范围之外-1和1（含） + ACOS(-1) // 3.141592653589793 + ACOS(0) // 1.5707963267948966 + ACOS(1) // 0 + ACOS(2) // null +## ASIN（） + ASIN(value) → num + + 返回value的反正弦值。 + + 值（数字）：输入值 + 返回NUM（数|空）：的反正弦值或空值如果值是在有效范围之外-1和1（含） + ASIN(1) // 1.5707963267948966 + ASIN(0) // 0 + ASIN(-1) // -1.5707963267948966 + ASIN(2) // null +## ATAN（） + ATAN(value) → num + + 返回value的反正切值。 + + 值（数字）：输入值 + 返回num（数字）：值的反正切 + ATAN(-1) // -0.7853981633974483 + ATAN(0) // 0 + ATAN(10) // 1.4711276743037347 +## ATAN2（） + ATAN2(y, x) → num + + 返回y和x的商的反正切。 + + ATAN2(0, 0) // 0 + ATAN2(1, 0) // 1.5707963267948966 + ATAN2(1, 1) // 0.7853981633974483 + ATAN2(-10, 20) // -0.4636476090008061 +## AVERAGE（） + AVERAGE(numArray) → mean + + 返回array中值的平均值（算术平均值）。 + + numArray（数组）：数字数组，将忽略空值 + 返回均值（number | null）：numArray的平均值。如果数组为空或仅包含null值，则将返回null。 + AVERAGE( [5, 2, 9, 2] ) // 4.5 + AVERAGE( [ -3, -5, 2 ] ) // -2 + AVERAGE( [ 999, 80, 4, 4, 4, 3, 3, 3 ] ) // 137.5 +## AVG（） + 这是AVERAGE（）的别名。 + +## CEIL（） + CEIL(value) → roundedValue + + 返回最接近但不小于value的整数。 + + 要向下舍入，请参见FLOOR（）。 + 要舍入到最接近的整数值，请参见ROUND（）。 + + 值（数字）：任意数字 + 返回roundedValue（数字）：将值四舍五入到上限 + CEIL(2.49) // 3 + CEIL(2.50) // 3 + CEIL(-2.50) // -2 + CEIL(-2.51) // -2 +## COS（） + COS(value) → num + + 返回值的余弦值。 + + 值（数字）：输入值 + 返回num（数字）：值的余弦值 + COS(1) // 0.5403023058681398 + COS(0) // 1 + COS(-3.141592653589783) // -1 + COS(RADIANS(45)) // 0.7071067811865476 +## DEGREES（） + DEGREES(rad) → num + + 返回从弧度转换为角度的角度。 + + rad（数字）：输入值 + 返回num（数字）：以度为单位的角度 + DEGREES(0.7853981633974483) // 45 + DEGREES(0) // 0 + DEGREES(3.141592653589793) // 180 +## EXP（） + EXP(value) → num + + 将欧拉常数（2.71828…）提高到value的幂。 + + 值（数字）：输入值 + 返回num（数字）：欧拉常数提高到价值的幂 + EXP(1) // 2.718281828459045 + EXP(10) // 22026.46579480671 + EXP(0) // 1 +## EXP2（） + EXP2(value) → num + + 返回2提高到价值的力量。 + + 值（数字）：输入值 + 返回num（数字）：2提高到价值的幂 + EXP2(16) // 65536 + EXP2(1) // 2 + EXP2(0) // 1 +# FLOOR（） + FLOOR(value) → roundedValue + + 返回最接近但不大于value的整数。 + + 要向上舍入，请参见CEIL（）。 + 要舍入到最接近的整数值，请参见ROUND（）。 + + 值（数字）：任意数字 + 返回roundedValue（数字）：向下舍入的值 + FLOOR(2.49) // 2 + FLOOR(2.50) // 2 + FLOOR(-2.50) // -3 + FLOOR(-2.51) // -3 +## LOG（） + LOG(value) → num + + 返回value的自然对数。基数是欧拉常数（2.71828…）。 + + 值（数字）：输入值 + 返回num（number | null）：value的自然对数；如果value等于或小于0 ，则返回null + LOG(2.718281828459045) // 1 + LOG(10) // 2.302585092994046 + LOG(0) // null +## LOG2（） + LOG2(value) → num + + 返回value以2为底的对数。 + + 值（数字）：输入值 + 返回num（number | null）：value的以2为底的对数；如果value等于或小于0 ，则返回null + LOG2(1024) // 10 + LOG2(8) // 3 + LOG2(0) // null +## LOG10（） + LOG10(value) → num + + 返回value以10为底的对数。 + + 值（数字）：输入值 + 返回num（数字）：value的以10为底的对数；如果value等于或小于0 ，则返回null + LOG10(10000) // 10 + LOG10(10) // 1 + LOG10(0) // null +## MAX（） + MAX(anyArray) → max + + 返回anyArray的最大元素。数组不限于数字。另请参阅类型和值顺序。 + + anyArray（数组）：数字数组，将忽略空值 + 返回max（any | null）：具有最大值的元素。如果数组为空或仅包含空值，则该函数将返回null。 + MAX( [5, 9, -2, null, 1] ) // 9 + MAX( [ null, null ] ) // null + MEDIAN（） + MEDIAN(numArray) → median + + 返回array中值的中间值。 + + 对数组进行排序，然后返回中间的元素。如果数组的元素长度均匀，则通过计算平均值（算术平均值）对两个最中心的元素进行插值。 + + numArray（数组）：数字数组，将忽略空值 + 返回中位数（number | null）：numArray的中位数。如果数组为空或仅包含空值，则该函数将返回null。 + MEDIAN( [ 1, 2, 3] ) // 2 + MEDIAN( [ 1, 2, 3, 4 ] ) // 2.5 + MEDIAN( [ 4, 2, 3, 1 ] ) // 2.5 + MEDIAN( [ 999, 80, 4, 4, 4, 3, 3, 3 ] ) // 4 +## MIN（） + MIN(anyArray) → min + + 返回anyArray的最小元素。数组不限于数字。另请参阅类型和值顺序。 + + anyArray（数组）：数字数组，将忽略空值 + 返回min（any | null）：最小值的元素。如果数组为空或仅包含空值，则该函数将返回null。 + MIN( [5, 9, -2, null, 1] ) // -2 + MIN( [ null, null ] ) // null +## PERCENTILE（） + PERCENTILE(numArray, n, method) → percentile + + 返回numArray中值的n个百分点。 + + numArray（数组）：数字数组，将忽略空值 + n（数字）：必须介于0（排除）和100（包括）之间 + 方法（字符串，可选）：“等级”（默认）或“插值” + 返回百分（数|空）：在Ñ百分位数，或空如果数组为空或仅空值包含在它或不能计算百分 + PERCENTILE( [1, 2, 3, 4], 50 ) // 2 + PERCENTILE( [1, 2, 3, 4], 50, "rank" ) // 2 + PERCENTILE( [1, 2, 3, 4], 50, "interpolation" ) // 2.5 +## PI（） + PI() → pi + + 返回pi。 + + 返回pi（数字）：pi的前几个有效数字（3.141592653589793） + PI() // 3.141592653589793 +## POW（） + POW(base, exp) → num + + 将基数返回指数exp。 + + 基本（数字）：基本值 + exp（数字）：指数值 + 返回num（数字）：幂值 + POW( 2, 4 ) // 16 + POW( 5, -1 ) // 0.2 + POW( 5, 0 ) // 1 +## RADIANS（） + RADIANS(deg) → num + + 将角度转换为弧度。 + + deg（数字）：输入值 + 返回num（数字）：以弧度为单位的角度 + RADIANS(180) // 3.141592653589793 + RADIANS(90) // 1.5707963267948966 + RADIANS(0) // 0 +## RAND（） + RAND() → randomNumber + + 返回介于0和1之间的伪随机数。 + + 返回randomNumber（数字）：大于0且小于1的数字 + RAND() // 0.3503170117504508 + RAND() // 0.6138226173882478 + 复杂的例子： + + LET coinFlips = ( + FOR i IN 1..100000 + RETURN RAND() > 0.5 ? "heads" : "tails" + ) + RETURN MERGE( + FOR flip IN coinFlips + COLLECT f = flip WITH COUNT INTO count + RETURN { [f]: count } + ) + 结果： + + [ + { + "heads": 49902, + "tails": 50098 + } + ] +## RANGE（） + RANGE(start, stop, step) → numArray + + 返回指定范围内的数字数组，可以选择以1以外的增量返回。除非提供了step参数，否则start和stop参数将被截断为整数。 + + 另请参见范围运算符，以了解整数范围和步长为1的范围。 + + start（数字）：起始范围（包括）的值 + 停止（数字）：以（包括）结束范围的值 + step（数字，可选）：每步增加多少，默认值为1.0 + 返回numArray（数组）：范围内所有数字作为数组 + RANGE(1, 4) // [ 1, 2, 3, 4 ] + RANGE(1, 4, 2) // [ 1, 3 ] + RANGE(1, 4, 3) // [ 1, 4 ] + RANGE(1.5, 2.5) // [ 1, 2 ] + RANGE(1.5, 2.5, 1) // [ 1.5, 2.5 ] + RANGE(1.5, 2.5, 0.5) // [ 1.5, 2, 2.5 ] + RANGE(-0.75, 1.1, 0.5) // [ -0.75, -0.25, 0.25, 0.75 ] +## ROUND（） + ROUND(value) → roundedValue + + 返回最接近value的整数。 + + 值（数字）：任意数字 + 返回roundedValue（数字）：将值四舍五入到最接近的整数 + ROUND(2.49) // 2 + ROUND(2.50) // 3 + ROUND(-2.50) // -2 + ROUND(-2.51) // -3 + 舍入到零，也称为TRUNC（）在C / C ++，可与组合来实现三元操作， CEIL（） 和FLOOR（） ： + + value >= 0 ? FLOOR(value) : CEIL(value) +## SIN（） + SIN(value) → num + + 返回值的正弦值。 + + 值（数字）：输入值 + 返回num（数字）：值的正弦值 + SIN(3.141592653589783 / 2) // 1 + SIN(0) // 0 + SIN(-3.141592653589783 / 2) // -1 + SIN(RADIANS(270)) // -1 +## SQRT（） + SQRT(value) → squareRoot + + 返回值的平方根。 + + 值（数字）：一个数字 + 返回squareRoot（数字）：值的平方根 + SQRT(9) // 3 + SQRT(2) // 1.4142135623730951 + 其他根可以使用POW（）计算，例如POW(value, 1/n)： + + // 4th root of 8*8*8*8 = 4096 + POW(4096, 1/4) // 8 + + // cube root of 3*3*3 = 27 + POW(27, 1/3) // 3 + + // square root of 3*3 = 9 + POW(9, 1/2) // 3 +## STDDEV_POPULATION（） + STDDEV_POPULATION(numArray) → num + + 返回array中值的总体标准差。 + + numArray（数组）：数字数组，将忽略空值 + 返回num（number | null）：numArray的总体标准偏差。如果数组为空，或者数组中仅包含空值， 则将返回null。 + STDDEV_POPULATION( [ 1, 3, 6, 5, 2 ] ) // 1.854723699099141 + STDDEV_SAMPLE（） + STDDEV_SAMPLE(numArray) → num + + 返回array中值的样本标准偏差。 + + numArray（数组）：数字数组，将忽略空值 + 返回num（number | null）：numArray的样本标准差。如果数组为空，或者数组中仅包含空值， 则将返回null。 + STDDEV_SAMPLE( [ 1, 3, 6, 5, 2 ] ) // 2.0736441353327724 +## STDDEV（） + 这是STDDEV_POPULATION（）的别名。 + +## SUM（） + SUM(numArray) → sum + + 返回array中的值之和。 + + numArray（数组）：数字数组，将忽略空值 + 返回sum（number）：numArray中所有值的总和。如果数组为空或仅包含空值，则将返回0。 + SUM( [1, 2, 3, 4] ) // 10 + SUM( [null, -5, 6] ) // 1 + SUM( [ ] ) // 0 +## TAN（） + TAN(value) → num + + 返回值的正切值。 + + 值（数字）：输入值 + 返回num（数字）：值的正切值 + TAN(10) // 0.6483608274590866 + TAN(5) // -3.380515006246586 + TAN(0) // 0 + VARIANCE_POPULATION（） + VARIANCE_POPULATION(numArray) → num + + 返回array中值的总体方差。 + + numArray（数组）：数字数组，将忽略空值 + 返回num（number | null）：numArray的总体方差。如果数组为空，或者数组中仅包含空值， 则将返回null。 + VARIANCE_POPULATION( [ 1, 3, 6, 5, 2 ] ) // 3.4400000000000004 + VARIANCE_SAMPLE（） + VARIANCE_SAMPLE(array) → num + + 返回array中值的样本方差。 + + numArray（数组）：数字数组，将忽略空值 + 返回num（number | null）：numArray的样本方差。如果数组为空，或者数组中仅包含空值， 则将返回null。 + VARIANCE_SAMPLE( [ 1, 3, 6, 5, 2 ] ) // 4.300000000000001 +## VARIANCE（） + 这是VARIANCE_POPULATION（）的别名。 + +# 字符串函数 +## CHAR_LENGTH（）永久链接 + CHAR_LENGTH(value) → length + 返回的字符数值（未字节长度）。 + 输入值 长度 + 串 Unicode字符数 + 数 代表数字的Unicode字符数 + 数组 结果字符串化中的Unicode字符数 + 宾语 结果字符串化中的Unicode字符数 + 真正 4 + 假 5 + 空值 0 + +## CONCAT（） + CONCAT(value1, value2, ... valueN) → str + + 将作为value1传递的值连接到valueN。 + + 值（任意，可重复）：任意类型的元素（至少1个） + 返回str（字符串）：元素的串联。空值将被忽略。 + CONCAT("foo", "bar", "baz") // "foobarbaz" + CONCAT(1, 2, 3) // "123" + CONCAT("foo", [5, 6], {bar: "baz"}) // "foo[5,6]{\"bar\":\"baz\"}" + CONCAT(anyArray) → str + + 如果将单个数组传递给CONCAT（），则将其成员连接在一起。 + + anyArray（array）：具有任意类型元素的数组 + 返回str（字符串）：数组元素的串联。空值将被忽略。 + CONCAT( [ "foo", "bar", "baz" ] ) // "foobarbaz" + CONCAT( [1, 2, 3] ) // "123" + +## CONCAT_SEPARATOR（）永久链接 + CONCAT_SEPARATOR(separator, value1, value2, ... valueN) → joinedString + + 使用 分隔符字符串将作为参数value1传递的字符串连接到valueN。 + + 分隔符（字符串）：任意分隔符字符串 + 值（字符串|数组，可重复）：字符串或字符串数​​组作为多个参数（至少1个） + 返回joindString（字符串）：元素的连接字符串，使用 分隔符作为分隔符字符串。空值将被忽略。数组值参数将自动展开，并且它们的各个成员将被串联。嵌套数组也将被扩展，但是如果它们具有多个元素，则其元素之间用逗号分隔。 + CONCAT_SEPARATOR(", ", "foo", "bar", "baz") + // "foo, bar, baz" + + CONCAT_SEPARATOR(", ", [ "foo", "bar", "baz" ]) + // "foo, bar, baz" + + CONCAT_SEPARATOR(", ", [ "foo", [ "b", "a", "r" ], "baz" ]) + // [ "foo, b,a,r, baz" ] + + CONCAT_SEPARATOR("-", [1, 2, 3, null], [4, null, 5]) + // "1-2-3-4-5" + +## CONTAINS（） + CONTAINS(text, search, returnIndex) → match + + 检查字符串是否搜索包含在字符串文本。CONTAINS执行的字符串匹配区分大小写。 + + 文本（字符串）：大海捞针 + 搜索（字符串）：针 + returnIndex（布尔型，可选）：如果设置为true，则返回匹配项的字符位置，而不是布尔值。默认值为false。 + 返回匹配（布尔|号码）：默认情况下，真正的如果返回搜索 包含在文本和假否则。与returnIndex设置为真，第一次出现的位置搜索中的文本被返回（在偏移0开始），或-1，如果搜索未在包含文本。 + CONTAINS("foobarbaz", "bar") // true + CONTAINS("foobarbaz", "horse") // false + CONTAINS("foobarbaz", "ba", true) // 3 + CONTAINS("foobarbaz", "horse", true) // -1 + 要确定值是否包含在数组中或在数组的哪个位置，请参见 POSITION（）数组函数。 + +## COUNT（） + 这是LENGTH（）的别名。 + +## CRC32（） + CRC32(text) → hash + + 计算文本的CRC32校验和，并以十六进制字符串表示形式返回。使用的多项式为0x1EDC6F41。使用的初始值为0xFFFFFFFF，最终的异或值也是0xFFFFFFFF。 + + 文字（字串）：字串 + 返回哈希（字符串）：CRC32校验和为十六进制字符串 + CRC32("foobar") // "D5F5C7F" + +## ENCODE_URI_COMPONENT（） + ENCODE_URI_COMPONENT(value) → encodedURIComponentString + + 返回value的已编码uri分量。 + + 值（字符串）：字符串 + 返回已编码的URIComponentString（字符串）：值的已编码的uri组件 + +## FIND_FIRST（） + FIND_FIRST(text, search, start, end) → position + + 返回字符串文本中第一次出现的字符串搜索的位置。位置从0开始。 + + 文本（字符串）：大海捞针 + 搜索（字符串）：针 + 启动（数，可选）：限制搜索到的文本的一个子集，在开始启动 + end（数字，可选）：将搜索限制为文本的子集，以end结尾 + 返回位置（数字）：匹配的字符位置。如果text中 不包含搜索，则返回-1。如果搜索为空，则返回开始。 + FIND_FIRST("foobarbaz", "ba") // 3 + FIND_FIRST("foobarbaz", "ba", 4) // 6 + FIND_FIRST("foobarbaz", "ba", 0, 3) // -1 + +## FIND_LAST（） + FIND_LAST(text, search, start, end) → position + + 返回字符串文本中最后一次出现字符串搜索的位置。位置从0开始。 + + 文本（字符串）：大海捞针 + 搜索（字符串）：针 + 启动（数，可选）：限制搜索到的文本的一个子集，在开始启动 + end（数字，可选）：将搜索限制为文本的子集，以end结尾 + 返回位置（数字）：匹配的字符位置。如果text中 不包含搜索，则返回-1。如果搜索为空，则返回字符串长度，或结束 + 1。 + FIND_LAST("foobarbaz", "ba") // 6 + FIND_LAST("foobarbaz", "ba", 7) // -1 + FIND_LAST("foobarbaz", "ba", 0, 4) // 3 + +## FNV64（） + FNV64(text) → hash + + 计算文本的FNV-1A 64位哈希，并以十六进制字符串表示形式返回。 + + 文字（字串）：字串 + 返回哈希（字符串）：FNV-1A哈希作为十六进制字符串 + FNV64("foobar") // "85944171F73967E8" + +## JSON_PARSE（） + JSON_PARSE(text) → value + + 返回由JSON编码的输入字符串描述的AQL值。 + + text（字符串）：要解析为JSON的字符串 + 返回值（混合）：与给定JSON文本对应的值。对于不是有效JSON字符串的输入值，该函数将返回null。 + JSON_PARSE("123") // 123 + JSON_PARSE("[ true, false, 2 ]") // [ true, false, 2 ] + JSON_PARSE("\\\"abc\\\"") // "abc" + JSON_PARSE("{\\\"a\\\": 1}") // { a : 1 } + JSON_PARSE("abc") // null + +## JSON_STRINGIFY（） + JSON_STRINGIFY(value) → text + + 返回输入值的JSON字符串表示形式。 + + 值（混合）：要转换为JSON字符串的值 + 返回text（string）：表示value的JSON字符串。对于无法转换为JSON的输入值，该函数将返回null。 + JSON_STRINGIFY("1") // "1" + JSON_STRINGIFY("abc") // "\"abc\"" + JSON_STRINGIFY("[1, 2, 3]") // "[1,2,3]" + +## LEFT（） + LEFT(value, n) → substring + + 返回字符串值的最左边的n个字符。 + + 要返回最右边的字符，请参见RIGHT（）。 + 要从字符串的任意位置移开一部分，请参见SUBSTRING（）。 + + 值（字符串）：字符串 + n（数字）：要返回的字符数 + 返回子字符串（字符串）：从字符串的左侧开始，最多为n个value字符 + LEFT("foobar", 3) // "foo" + LEFT("foobar", 10) // "foobar" + +## LENGTH（） + LENGTH(str) → length + + 确定字符串的字符长度。 + + str（字符串）：字符串。如果传递了一个数字，它将首先转换为字符串。 + 返回长度（数字）：str的字符长度（不是字节长度） + LENGTH("foobar") // 6 + LENGTH("电脑坏了") // 4 + LENGTH（）还可以确定数组中元素的数量，对象/文档的属性键的数量以及集合中文档的数量。 + +## LEVENSHTEIN_DISTANCE（） + LEVENSHTEIN_DISTANCE(value1, value2) → levenshteinDistance + + 计算 两个字符串之间的Levenshtein距离。 + + value1（字符串）：一个字符串 + value2（字符串）：字符串 + 返回levenshteinDistance（数字）：计算输入字符串value1和value2之间的Levenshtein距离 + LEVENSHTEIN_DISTANCE("foobar", "bar") // 3 + LEVENSHTEIN_DISTANCE(" ", "") // 1 + LEVENSHTEIN_DISTANCE("The quick brown fox jumps over the lazy dog", "The quick black dog jumps over the brown fox") // 13 + LEVENSHTEIN_DISTANCE("der mötör trötet", "der trötet") // 6 + +## LIKE（） + LIKE(text, search, caseInsensitive) → bool + + 使用通配符匹配，检查模式搜索是否包含在字符串文本中。 + + 文本（字符串）：要搜索的字符串 + 搜索（字符串）：一种搜索模式，可以包含通配符 %（意味着任何字符序列，包括无字符）和_（任何单个字符）。从字面来看%，_必须使用两个反斜杠（在arangosh中为四个反斜杠）进行转义。 搜索不能是变量或文档属性。实际值必须已经存在于查询解析时。 + caseInsensitive（布尔型，可选）：如果设置为true，则匹配将不区分大小写。默认值为false。 + 返回bool类型：（布尔）真如果该模式包含在文本和虚假，否则 + LIKE("cart", "ca_t") // true + LIKE("carrot", "ca_t") // false + LIKE("carrot", "ca%t") // true + + LIKE("foo bar baz", "bar") // false + LIKE("foo bar baz", "%bar%") // true + LIKE("bar", "%bar%") // true + + LIKE("FoO bAr BaZ", "fOo%bAz") // false + LIKE("FoO bAr BaZ", "fOo%bAz", true) // true + +## LOWER（） + LOWER(value) → lowerCaseString + + 将值中的大写字母转换为小写字母。其他所有字符均保持不变。 + + 值（字符串）：字符串 + 返回lowerCaseString（字符串）值与大写字符转换为小写字符 +## LTRIM（） + LTRIM(value, chars) → strippedString + + 返回仅从开头去除空格的字符串值。 + + 要仅从末尾剥离，请参见RTRIM（）。 + 要剥离两侧，请参见TRIM（）。 + + 值（字符串）：字符串 + chars（字符串，可选）：覆盖应从字符串中删除的字符。它默认为\r\n \t（即0x0d，0x0a， 0x20和0x09）。 + 返回strippedString（字符串）：左侧不带字符的值 + LTRIM("foo bar") // "foo bar" + LTRIM(" foo bar ") // "foo bar " + LTRIM("--==[foo-bar]==--", "-=[]") // "foo-bar]==--" + +## MD5（） + MD5(text) → hash + + 计算文本的MD5校验和，并以十六进制字符串表示形式返回。 + + 文字（字串）：字串 + 返回哈希（字符串）：MD5校验和为十六进制字符串 + MD5("foobar") // "3858f62230ac3c915f300c664312c63f" + +## RANDOM_TOKEN（） + RANDOM_TOKEN(length) → randomString + + 生成具有指定长度的伪随机令牌字符串。令牌生成算法应视为不透明。 + + length（数字）：令牌所需的字符串长度。它必须大于或等于0，并且最大为65536。长度为0会返回一个空字符串。 + 返回randomString（字符串）：生成的令牌，由小写字母，大写字母和数字组成 + RANDOM_TOKEN(8) // "zGl09z42" + RANDOM_TOKEN(8) // "m9w50Ft9" +## REGEX_MATCHES（） + REGEX_MATCHES(text, regex, caseInsensitive) → stringArray + + 使用正则表达式返回给定字符串文本中的匹配项。 + + 文本（字符串）：要搜索的字符串 + regex（字符串）：用于匹配文本的正则表达式 + 返回stringArray（array）：包含匹配项的字符串数组 + 正则表达式可以由文字字符以及以下字符和序列组成： + + .–点匹配除行终止符之外的任何单个字符。包括行终止符，使用[\s\S]替代模拟.与DOTALL标志。 + \d –匹配一个数字，等于 [0-9] + \s –匹配单个空格字符 + \S –匹配一个非空白字符 + \t –匹配制表符 + \r –匹配回车 + \n –匹配换行符 + [xyz]–字符集。匹配任何封闭的字符（此处为x，y或z） + [^xyz]–否定的字符集。匹配除封闭字符以外的任何其他字符（在这种情况下，即x，y或z以外的任何其他字符） + [x-z]–字符范围。匹配指定范围内的[0-9A-F]任何字符，例如，匹配0123456789ABCDEF中的任何字符 + [^x-z]–字符范围取反。匹配范围内指定字符以外的任何其他字符 + (xyz) –定义并匹配模式组 + (x|y)–匹配x或y + ^–匹配字符串的开头（例如^xyz） + $–匹配字符串的结尾（例如xyz$） + 需要注意的是人物.，*，?，[，]，(，)，{，}，^，和$在正则表达式特殊含义，可能需要使用反斜杠进行转义，这需要转义本身（\\）。文字反斜杠需要使用另一个转义的反斜杠进行转义\\\\。在arangosh中，反斜杠的数量需要加倍。 + + 可以使用以下量词来重复字符和序列： + + x*–匹配x的零个或多个出现 + x+–匹配x的一个或多个出现 + x?–匹配x的一次或零次出现 + x{y}–精确匹配x的y个出现 + x{y,z}–匹配x的y和z出现 + x{y,}–匹配至少y次出现的x + 请注意，它xyz+匹配xyzzzzz，但是如果要匹配xyzxyz，则需要通过将子表达式包装在括号中并将量词放在其后面来定义模式组(xyz)+。 + + 如果regex中的正则表达式无效，则会引发警告，并且该函数将返回null。 + + REGEX_MATCHES("My-us3r_n4m3", "^[a-z0-9_-]{3,16}$", true) // ["My-us3r_n4m3"] + REGEX_MATCHES("#4d82h4", "^#?([a-f0-9]{6}|[a-f0-9]{3})$", true) // null + REGEX_MATCHES("john@doe.com", "^([a-z0-9_\.-]+)@([\da-z-]+)\.([a-z\.]{2,6})$", false) // ["john@doe.com", "john", "doe", "com"] +## REGEX_SPLIT（） + REGEX_SPLIT(text, splitExpression, caseInsensitive, limit) → stringArray + + 使用分隔符将给定的字符串文本拆分为字符串列表。 + + 文本（字符串）：要分割的字符串 + splitExpression（字符串）：用于拆分文本的正则表达式 + 限制（数字，可选）：限制结果中分割值的数量。如果未给出限制，则返回的拆分数不受限制。 + 返回stringArray（array）：字符串数组 + 正则表达式可以由文字字符以及以下字符和序列组成： + + .–点匹配除行终止符之外的任何单个字符。包括行终止符，使用[\s\S]替代模拟.与DOTALL标志。 + \d –匹配一个数字，等于 [0-9] + \s –匹配单个空格字符 + \S –匹配一个非空白字符 + \t –匹配制表符 + \r –匹配回车 + \n –匹配换行符 + [xyz]–字符集。匹配任何封闭的字符（此处为x，y或z） + [^xyz]–否定的字符集。匹配除封闭字符以外的任何其他字符（在这种情况下，即x，y或z以外的任何其他字符） + [x-z]–字符范围。匹配指定范围内的[0-9A-F]任何字符，例如，匹配0123456789ABCDEF中的任何字符 + [^x-z]–字符范围取反。匹配范围内指定字符以外的任何其他字符 + (xyz) –定义并匹配模式组 + (x|y)–匹配x或y + ^–匹配字符串的开头（例如^xyz） + $–匹配字符串的结尾（例如xyz$） + 需要注意的是人物.，*，?，[，]，(，)，{，}，^，和$在正则表达式特殊含义，可能需要使用反斜杠进行转义，这需要转义本身（\\）。文字反斜杠需要使用另一个转义的反斜杠进行转义\\\\。在arangosh中，反斜杠的数量需要加倍。 + + 可以使用以下量词来重复字符和序列： + + x*–匹配x的零个或多个出现 + x+–匹配x的一个或多个出现 + x?–匹配x的一次或零次出现 + x{y}–精确匹配x的y个出现 + x{y,z}–匹配x的y和z出现 + x{y,}–匹配至少y次出现的x + 请注意，它xyz+匹配xyzzzzz，但是如果要匹配xyzxyz，则需要通过将子表达式包装在括号中并将量词放在其后面来定义模式组(xyz)+。 + + 如果splitExpression中的正则表达式无效，则会引发警告，并且该函数将返回null。 + + REGEX_SPLIT("This is a line.\n This is yet another line\r\n This again is a line.\r Mac line ", "\.?(\n|\r|\r\n)", true, 4) // ["This is a line", "\n", " This is yet another lin", "\r"] + REGEX_SPLIT("hypertext language, programming", "[\s, ]+") // ["hypertext", "language", "programming"] + REGEX_SPLIT("ca,bc,a,bca,bca,bc", "a,b", true, 5) // ["c", "c,", "c", "c", "c"] +## REGEX_TEST（） + REGEX_TEST(text, search, caseInsensitive) → bool + + 使用正则表达式匹配检查模式搜索是否包含在字符串文本中。 + + 文本（字符串）：要搜索的字符串 + 搜索（字符串）：正则表达式搜索模式 + 返回bool类型：（布尔）真如果该模式包含在文本和虚假，否则 + caseInsensitive（布尔型，可选）：如果设置为true，则匹配将不区分大小写。默认值为false。 + 正则表达式可以由文字字符以及以下字符和序列组成： + + .–点匹配除行终止符之外的任何单个字符。包括行终止符，使用[\s\S]替代模拟.与DOTALL标志。 + \d –匹配一个数字，等于 [0-9] + \s –匹配单个空格字符 + \S –匹配一个非空白字符 + \t –匹配制表符 + \r –匹配回车 + \n –匹配换行符 + [xyz]–字符集。匹配任何封闭的字符（此处为x，y或z） + [^xyz]–否定的字符集。匹配除封闭字符以外的任何其他字符（在这种情况下，即x，y或z以外的任何其他字符） + [x-z]–字符范围。匹配指定范围内的[0-9A-F]任何字符，例如，匹配0123456789ABCDEF中的任何字符 + [^x-z]–字符范围取反。匹配范围内指定字符以外的任何其他字符 + (xyz) –定义并匹配模式组 + (x|y)–匹配x或y + ^–匹配字符串的开头（例如^xyz） + $–匹配字符串的结尾（例如xyz$） + 需要注意的是人物.，*，?，[，]，(，)，{，}，^，和$在正则表达式特殊含义，可能需要使用反斜杠进行转义，这需要转义本身（\\）。文字反斜杠需要使用另一个转义的反斜杠进行转义\\\\。在arangosh中，反斜杠的数量需要加倍。 + + 可以使用以下量词来重复字符和序列： + + x*–匹配x的零个或多个出现 + x+–匹配x的一个或多个出现 + x?–匹配x的一次或零次出现 + x{y}–精确匹配x的y个出现 + x{y,z}–匹配x的y和z出现 + x{y,}–匹配至少y次出现的x + 请注意，它xyz+匹配xyzzzzz，但是如果要匹配xyzxyz，则需要通过将子表达式包装在括号中并将量词放在其后面来定义模式组(xyz)+。 + + 如果搜索中的正则表达式无效，则会引发警告，并且该函数将返回null。 + + REGEX_TEST("the quick brown fox", "the.*fox") // true + REGEX_TEST("the quick brown fox", "^(a|the)\s+(quick|slow).*f.x$") // true + REGEX_TEST("the\nquick\nbrown\nfox", "^the(\n[a-w]+)+\nfox$") // true +## REGEX_REPLACE（） + REGEX_REPLACE(text, search, replacement, caseInsensitive) → string + + 使用正则表达式匹配，将模式搜索替换为字符串 文本中的字符串替换。 + + 文本（字符串）：要搜索的字符串 + 搜索（字符串）：正则表达式搜索模式 + 替换（字符串）：用替换搜索模式的字符串 + 返回字符串（字符串）：具有搜索正则表达式模式的字符串文本，无论该模式存在于文本中的何处，均被替换字符串替换 + caseInsensitive（布尔型，可选）：如果设置为true，则匹配将不区分大小写。默认值为false。 + 有关字符和序列规则的更多详细信息，请参见 REGEX_TEST（）。 + + 如果搜索中的正则表达式无效，则会引发警告，并且该函数将返回null。 + + REGEX_REPLACE("the quick brown fox", "the.*fox", "jumped over") // jumped over + REGEX_REPLACE("the quick brown fox", "o", "i") // the quick briwn fix +## REVERSE（） + REVERSE(value) → reversedString + + 返回字符串值的反方向。 + + 值（字符串）：字符串 + 返回reversedString（string）：一个新字符串，其中字符的顺序相反 + REVERSE("foobar") // "raboof" + REVERSE("电脑坏了") // "了坏脑电" +## RIGHT（） + RIGHT(value, length) → substring + + 返回字符串值的最右边字符的长度。 + + 要返回最左边的字符，请参见LEFT（）。 + 要从字符串的任意位置移开一部分，请参见SUBSTRING（）。 + + 值（字符串）：字符串 + 长度（数字）：返回多少个字符 + 返回子字符串（字符串）：最长为value的字符，从字符串的右侧开始 + RIGHT("foobar", 3) // "bar" + RIGHT("foobar", 10) // "foobar" +## RTRIM（） + RTRIM(value, chars) → strippedString + + 返回仅从末尾去除空格的字符串值。 + + 要仅从头开始剥离，请参见LTRIM（）。 + 要剥离两侧，请参见TRIM（）。 + + 值（字符串）：字符串 + chars（字符串，可选）：覆盖应从字符串中删除的字符。它默认为\r\n \t（即0x0d，0x0a， 0x20和0x09）。 + 返回strippedString（string）：右侧不带字符的值 + RTRIM("foo bar") // "foo bar" + RTRIM(" foo bar ") // " foo bar" + RTRIM("--==[foo-bar]==--", "-=[]") // "--==[foo-bar" +## SHA1（） + SHA1(text) → hash + + 计算文本的SHA1校验和，并以十六进制字符串表示形式返回。 + + 文字（字串）：字串 + 返回哈希（字符串）：SHA1校验和为十六进制字符串 + SHA1("foobar") // "8843d7f92416211de9ebb963ff4ce28125932878" +## SHA512（） + SHA512(text) → hash + + 计算文本的SHA512校验和，并以十六进制字符串表示形式返回。 + + 文字（字串）：字串 + 返回哈希（字符串）：SHA512校验和作为十六进制字符串 + SHA512("foobar") // "0a50261ebd1a390fed2bf326f2673c145582a6342d523204973d0219337f81616a8069b012587cf5635f6925f1b56c360230c19b273500ee013e030601bf2425" +## SPLIT（） + SPLIT(value, separator, limit) → strArray + + 使用分隔符将给定的字符串值拆分为字符串列表。 + + 值（字符串）：字符串 + 分隔符（字符串）：字符串或字符串列表。如果分隔符是一个空字符串，则值将被分成一个字符列表。如果未 指定分隔符，则值将作为数组返回。 + 限制（数字，可选）：限制结果中分割值的数量。如果未给出限制，则返回的拆分数不受限制。 + 返回strArray（array）：字符串数组 + SPLIT( "foo-bar-baz", "-" ) // [ "foo", "bar", "baz" ] + SPLIT( "foo-bar-baz", "-", 1 ) // [ "foo" ] + SPLIT( "foo, bar & baz", [ ", ", " & " ] ) // [ "foo", "bar", "baz" ] +## SOUNDEX（） + SOUNDEX(value) → soundexString + + 返回值的soundex指纹。 + + 值（字符串）：字符串 + 返回soundexString（字符串）：值的soundex指纹 + SOUNDEX( "example" ) // "E251" + SOUNDEX( "ekzampul") // "E251" + SOUNDEX( "soundex" ) // "S532" + SOUNDEX( "sounteks" ) // "S532" +## SUBSTITUTE（） + SUBSTITUTE(value, search, replace, limit) → substitutedString + + 将搜索值替换为字符串值。 + + 值（字符串）：字符串 + 搜索（字符串|数组）：如果搜索是字符串，则所有出现的 搜索都将替换为value。如果search是字符串数组，则每次在search中包含的值都将替换为replace中的相应数组元素。如果replace的列表项少于search，则未映射的搜索项的出现将由空字符串替换。 + replace（字符串|数组，可选）：替换字符串，或用于替换搜索中相应元素的字符串数组。元素可以少于搜索，或者可以删除以删除匹配项。如果search是一个数组，而replace是一个字符串，则所有匹配项都将替换为replace。 + 限制（数量，可选）：将替换数量限制为该值 + 返回replaceString（string）：一个新字符串，其中匹配项已替换（或移除） + SUBSTITUTE( "the quick brown foxx", "quick", "lazy" ) + // "the lazy brown foxx" + + SUBSTITUTE( "the quick brown foxx", [ "quick", "foxx" ], [ "slow", "dog" ] ) + // "the slow brown dog" + + SUBSTITUTE( "the quick brown foxx", [ "the", "foxx" ], [ "that", "dog" ], 1 ) + // "that quick brown foxx" + + SUBSTITUTE( "the quick brown foxx", [ "the", "quick", "foxx" ], [ "A", "VOID!" ] ) + // "A VOID! brown " + + SUBSTITUTE( "the quick brown foxx", [ "quick", "foxx" ], "xx" ) + // "the xx brown xx" + SUBSTITUTE(value, mapping, limit) → substitutedString + + 或者，可以在组合值中指定搜索和替换。 + + 值（字符串）：字符串 + 映射（对象）：查找图，其中搜索字符串为键，替换字符串为值。空字符串和null（作为值）将删除匹配项。请注意，由此不能保证搜索字符串的顺序；意思是，如果搜索结果重叠，则前者可能会赢一次，而第二则可能会赢。如果需要确保序列的优先级，请选择基于数组的调用方法。 + 限制（数量，可选）：将替换数量限制为该值 + 返回replaceString（string）：一个新字符串，其中匹配项已替换（或移除） + SUBSTITUTE("the quick brown foxx", { + "quick": "small", + "brown": "slow", + "foxx": "ant" + }) + // "the small slow ant" + + SUBSTITUTE("the quick brown foxx", { + "quick": "", + "brown": null, + "foxx": "ant" + }) + // "the ant" + + SUBSTITUTE("the quick brown foxx", { + "quick": "small", + "brown": "slow", + "foxx": "ant" + }, 2) + // "the small slow foxx" +## SUBSTRING（） + SUBSTRING(value, offset, length) → substring + + 返回value的子字符串。 + + 要返回最右边的字符，请参见RIGHT（）。 + 要返回最左边的字符，请参见LEFT（）。 + + 值（字符串）：字符串 + 偏移量（数字）：从偏移量开始，偏移量从位置0开始 + 长度（数字，可选）：最多为长度个字符，省略以获取从偏移量到字符串末尾的子字符串 + 返回子字符串（字符串）：值的子字符串 +## TOKENS（） + 请参阅ArangoSearch函数。 + +## TO_BASE64（） + TO_BASE64(value) → toBase64String + + 返回value的base64表示形式。 + + 值（字符串）：字符串 + 返回toBase64String（字符串）：值的base64表示形式 +## TO_HEX（） + TO_HEX(value) → toHexString + + 返回value的十六进制表示形式。 + + 值（字符串）：字符串 + 返回toHexString（字符串）：值的十六进制表示 +## TRIM（） + TRIM(value, type) → strippedString + + 返回从开头和/或结尾去除空格的字符串值。 + + 可选的type参数指定从字符串的哪一部分除去空白。但是，首选LTRIM（） 和RTRIM（）。 + + 值（字符串）：字符串 + 类型（数字，可选）：从 + 0 –字符串的开头和结尾（默认） + 1 –仅字符串开头 + 2 –仅字符串结尾 + TRIM(value, chars) → strippedString + + 返回从开头和结尾去除空格的字符串值。 + + 值（字符串）：字符串 + chars（字符串，可选）：覆盖应从字符串中删除的字符。它默认为\r\n \t（即0x0d，0x0a， 0x20和0x09）。 + 返回strippedString（字符串）：两端均不带字符的值 + TRIM("foo bar") // "foo bar" + TRIM(" foo bar ") // "foo bar" + TRIM("--==[foo-bar]==--", "-=[]") // "foo-bar" + TRIM(" foobar\t \r\n ") // "foobar" + TRIM(";foo;bar;baz, ", ",; ") // "foo;bar;baz" +## UPPER（） + UPPER(value) → upperCaseString + + 将值中的小写字母转换为大写字母。其他所有字符均保持不变。 + + 值（字符串）：字符串 + 返回upperCaseString（字符串）值与小写字符转换为大写字符 +## UUID（） + UUID() → UUIDString + + 返回一个通用的唯一标识符值。 + + 返回UUIDString（字符串）：通用唯一标识符 + +# 类型检查和转换 + +## TO_BOOL（） + TO_BOOL(value) → bool + + 接受任何类型的输入值，并将其转换为适当的布尔值。 + + 值（任意）：任意类型的输入 + 返回布尔值（布尔值）： + null转换为false + 数字将转换为true，但0除外，该数字将转换为false + 字符串转化成真正的，如果他们都是非空的，并假以其他方式 + 数组始终转换为true（即使为空） + 对象/文档始终转换为true + 也可以使用双重否定转换为布尔值： + + !!1 // true + !!0 // false + !!-0.0 // false + not not 1 // true + !!"non-empty string" // true + !!"" // false + TO_BOOL() 但是，“首选”是首选，因为它可以使意图更清晰。 + +## TO_NUMBER() + TO_NUMBER(value) → number + + 取任何类型的输入值并将其转换为数字值。 + + 值（任意）：任意类型的输入 + 返回数字（数字）： + null和false转换为值0 + true转换为1 + 数字保持其原始价值 + 如果字符串包含数字的有效表示形式，则将字符串转换为它们的数字等效形式。字符串开头和结尾的空格是允许的。不包含任何有效数字表示形式的字符串值将转换为数字0。 + 将空数组转换为0，将具有一个成员的数组转换TO_NUMBER()为其唯一成员的结果。具有两个或更多成员的数组将转换为数字0。 + 对象/文档将转换为数字0。 + + 一元加号也会强制转换为数字，但这TO_NUMBER()是首选方式： + + +'5' // 5 + +[8] // 8 + +[8,9] // 0 + +{} // 0 + 一元减号的工作原理与此类似，但数值也取反： + + -'5' // -5 + -[8] // -8 + -[8,9] // 0 + -{} // 0 + +## TO_STRING() + TO_STRING(value) → str + + 接受任何类型的输入值，并将其转换为字符串值。 + + 值（任意）：任意类型的输入 + 返回str（字符串）： + null转换为空字符串"" + false转换为字符串“ false”，true转换为字符串“ true” + 数字将转换为其字符串表示形式。这也可以是科学记数法（例如“ 2e-7”） + 数组和对象/文档将转换为字符串表示形式，这意味着JSON编码的字符串没有额外的空格 + TO_STRING(null) // "" + TO_STRING(true) // "true" + TO_STRING(false) // "false" + TO_STRING(123) // "123" + TO_STRING(+1.23) // "1.23" + TO_STRING(-1.23) // "-1.23" + TO_STRING(0.0000002) // "2e-7" + TO_STRING( [1, 2, 3] ) // "[1,2,3]" + TO_STRING( { foo: "bar", baz: null } ) // "{\"foo\":\"bar\",\"baz\":null}" + +## TO_ARRAY() + TO_ARRAY(value) → array + + 接受任何类型的输入值并将其转换为数组值。 + + 值（任意）：任意类型的输入 + 返回数组（array）： + null转换为空数组 + 布尔值，数字和字符串将转换为包含原始值作为其单个元素的数组 + 数组保留其原始值 + 对象/文档将转换为包含其属性 值作为数组元素的数组，就像VALUES（）一样 + TO_ARRAY(null) // [] + TO_ARRAY(false) // [false] + TO_ARRAY(true) // [true] + TO_ARRAY(5) // [5] + TO_ARRAY("foo") // ["foo"] + TO_ARRAY([1, 2, "foo"]) // [1, 2, "foo"] + TO_ARRAY({foo: 1, bar: 2, baz: [3, 4, 5]}) // [1, 2, [3, 4, 5]] + +## TO_LIST() + TO_LIST(value) → array + 这是TO_ARRAY（）的别名。 + +# 类型检查功能 + AQL还提供了在运行时检查值的数据类型的功能。以下类型检查功能可用。这些函数中的每一个都接受任何数据类型的参数，如果值具有要检查的类型，则返回true，否则返回false。 + +## IS_NULL（） + IS_NULL(value) → bool + + 检查value是否为null。与相同value == null。 + + 要测试属性是否存在，请参阅HAS（）。 + + 值（任意）：要测试的值 + 返回布尔值（布尔值）：如果value是true，则返回true， 否则返回falsenull +## IS_BOOL（） + IS_BOOL(value) → bool + + 检查值是否为布尔值 + + 值（任意）：要测试的值 + 返回布尔值（布尔值）：如果value为or ，则为true， 否则为falsetruefalse +## IS_NUMBER（） + IS_NUMBER(value) → bool + + 检查值是否为数字 + + 值（任意）：要测试的值 + 返回bool类型（布尔）：真，如果值是一个数字， 假否则 +## IS_STRING（） + IS_STRING(value) → bool + + 检查值是否为字符串 + + 值（任意）：要测试的值 + 返回布尔值（布尔值）：如果value是字符串，则返回true， 否则返回false +## IS_ARRAY（） + IS_ARRAY(value) → bool + + 检查值是否为数组/列表 + + 值（任意）：要测试的值 + 返回bool的（布尔值）：真，如果值是数组/列表中， 假否则 +## IS_LIST（） + IS_LIST(value) → bool + + 这是IS_ARRAY（）的别名 + +## IS_OBJECT（） + IS_OBJECT(value) → bool + + 检查值是否为对象/文档 + + 值（任意）：要测试的值 + 返回bool的（布尔值）：真，如果值是一个对象/文件， 假否则 +## IS_DOCUMENT（） + IS_DOCUMENT(value) → bool + + 这是IS_OBJECT（）的别名 + +## IS_DATESTRING（） + IS_DATESTRING(str) → bool + + 检查value是否是可以在日期函数中使用的字符串。这包括部分日期，例如“ 2015”或“ 2015-10”，以及包含格式正确但无效的日期的字符串，例如“ 2015-02-31”。 + + str（字符串）：要测试的日期字符串 + 返回bool的（布尔值）：真，如果STR是正确格式的日期字符串， 假否则包括所有非字符串值，即使它们中的一些可以是日期函数可用（数字时间戳） +## IS_KEY（） + IS_KEY(str) → bool + + 检查value是否是可以用作文档密钥的字符串，即_key属性的值。请参阅文档密钥的命名约定。 + + str（字符串）：要测试的文档密钥 + 返回布尔值（布尔值）：str是否可以用作文档键 + +## TYPENAME（） + TYPENAME(value) → typeName + + 返回值的数据类型名称。 + + 值（任意）：任意类型的输入 + 返回的typeName（字符串）的数据类型名称值 （"null"，"bool"，"number"，"string"，"array"或"object"） + 范例值 数据类型名称 + null "null" + true "bool" + false "bool" + 123 "number" + -4.56 "number" + 0 "number" + "foobar" "string" + "123" "string" + "" "string" + [ 1, 2, 3 ] "array" + ["foo",true] "array" + [ ] "array" + {"foo":"bar"} "object" + {"foo": null} "object" + { } "object" + + + \ No newline at end of file diff --git a/src/docs/arangodb/agDocs/graph语法.md b/src/docs/arangodb/agDocs/graph语法.md new file mode 100644 index 0000000..e69de29 diff --git a/src/docs/arangodb/agDocs/启动相关.md b/src/docs/arangodb/agDocs/启动相关.md new file mode 100644 index 0000000..2904d29 --- /dev/null +++ b/src/docs/arangodb/agDocs/启动相关.md @@ -0,0 +1,8 @@ +Start ArangoDB shell client: + > /usr/bin/arangosh + +Start ArangoDB service: + > systemctl start arangodb3.service + +Enable ArangoDB service: + > systemctl enable arangodb3.service \ No newline at end of file diff --git a/src/docs/arangodb/agDocs/命名规范.md b/src/docs/arangodb/agDocs/命名规范.md new file mode 100644 index 0000000..ccc7bc7 --- /dev/null +++ b/src/docs/arangodb/agDocs/命名规范.md @@ -0,0 +1,44 @@ +数据库名称 + ArangoDB将始终从名为_system的默认数据库启动。用户可以在ArangoDB中创建其他数据库，前提是数据库名称符合以下约束： + 数据库名称只能由字母a到z（允许大小写），数字0到9以及下划线（_）或破折号（-）符号组成。这也意味着，任何非ASCII数据库名称都不是允许的 + 数据库名称必须始终以字母开头。下划线开头的数据库名称被认为是系统数据库，用户不应创建或删除这些名称 + 数据库名称允许的最大长度为64个字节 + 数据库名称区分大小写 + +集合名称和视图名称 + 用户可以根据需要选择其集合和视图的名称，前提是不违反以下命名约束： + 名称只能由字母a到z（大小写），数字0到9以及下划线（_）或破折号（-）符号组成。这也意味着不允许使用任何非ASCII名称。 + 视图名称必须始终以字母开头。 + 用户定义的集合名称必须始终以字母开头。系统集合名称必须以下划线开头。 + 所有以下划线开头的集合名称均被视为仅用于ArangoDB内部使用的系统集合。最终用户不应将系统集合名称用于自己的集合。 + 名称的最大允许长度为256个字节。 + 集合名称和视图名称区分大小写。 + +文档_key + 用户可以为保存的文档定义自己的密钥。文档密钥将与文档一起保存在_key属性中。用户可以根据需要选择键值，只要这些键值符合以下限制： + 键必须是字符串值。不允许使用数字键，但是可以将任何数字值放入字符串中，然后用作文档键。 + 密钥必须至少为1个字节，最大为254个字节。指定时不允许使用空键（尽管从文档中完全省略_key属性可能是有效的 ） + 它必须由字母az（小写或大写），数字0-9或以下任何标点字符组成： _ - : . @ ( ) + , = ; $ ! * ' % + 键值内不能使用任何其他字符，尤其是多字节UTF-8序列，空格或标点字符 + 该密钥在使用的集合中必须唯一 + 键区分大小写，即myKey和MyKEY被认为是不同的键。 + 创建新文档时，指定文档密钥是可选的。如果用户未指定文档密钥，则ArangoDB将自己创建文档密钥，因为每个文档都必须具有密钥。 + 除上述限制外，无法保证自动生成的文档密钥的格式和模式。因此，客户应将自动生成的文档密钥视为不透明的值，而不应依赖于其格式。 + 生成密钥的当前格式是包含数字的字符串。从后面生成的_key值将包含比之前生成的_key值更高的数字的意义上，数字值反映了时间顺序。但是服务器将生成的确切值是不可预测的。请注意，如果按_key属性排序，则将使用字符串比较，这意味着"100"小于"99"。 + +属性名称 + 用户可以根据需要选择文档属性的属性名称，前提是不违反以下属性命名约束： + 以下划线开头的属性名称被视为ArangoDB内部使用的系统属性。此类属性名称已被ArangoDB用于特殊目的： + _id用于包含文档的句柄 + _key用于包含文档的用户定义键 + _rev用于包含文档的修订号 + 在边缘收藏中， + _from + _to + 属性用于引用其他文档。 + 将来可能会添加更多系统属性，恕不另行通知，因此最终用户应尽量避免使用以下划线开头的自己的属性名称。 + 从理论上讲，属性名称可以根据需要包括标点符号和特殊字符，前提是该名称是有效的UTF-8字符串。为了获得最大的可移植性，应避免使用特殊字符。例如，属性名称可能包含点符号，但是点在JavaScript和AQL中具有特殊含义，因此当以这些语言中的一种使用此类属性名称时，最终用户需要用引号引起来。总的来说，最好使用不需要使用所有语言进行任何引用/转义的属性名称。如果属性映射到客户端的对象成员，则包括客户端使用的语言（例如Ruby，PHP）。 + 当在AQL查询中使用属性名称时，以加号（@）开头的属性名称必须用反引号括起来，以区别绑定变量。因此，我们建议您不要使用以at-标记开头的属性，尽管它们在正确使用后仍然可以使用。 + ArangoDB不对属性名称实施长度限制。但是，长属性名称可能会在结果集中使用更多的内存等。因此，不建议使用长属性名称。 + 属性名称区分大小写。 + 不允许使用名称为空（字符串为空）的属性。 \ No newline at end of file diff --git a/src/docs/arangodb/agDocs/类型和值的顺序.md b/src/docs/arangodb/agDocs/类型和值的顺序.md new file mode 100644 index 0000000..fe9fa60 --- /dev/null +++ b/src/docs/arangodb/agDocs/类型和值的顺序.md @@ -0,0 +1,22 @@ +类型和值顺序 + 在检查是否相等或不相等或确定值的排序顺序时，AQL使用确定性算法，该算法同时考虑数据类型和实际值。 + 比较的操作数首先按其数据类型进行比较，如果操作数具有相同的数据类型，则仅按其数据值进行比较。 + 比较数据类型时，使用以下类型顺序： + null < bool < number < string < array/list < object/document + 这意味着null是AQL中最小的类型，而document是具有最高顺序的类型。如果比较的操作数具有不同的类型，则确定比较结果并完成比较。 + 如果两个比较的操作数具有相同的数据类型，则将比较操作数的值。对于基本类型（null，布尔值，数字和字符串），结果定义如下： + null：null等于null + 布尔值：false小于true + 数字：数值按基数排序 + 字符串：使用本地化比较对字符串值进行排序，使用配置的 服务器语言 根据该语言的字母顺序规则进行排序 + 注意：与SQL不同，可以将null与任何值进行比较，包括null 本身，而不会自动将结果转换为null。 + + 对于化合物，将应用以下特殊规则： + + 从第一个元素开始，通过逐个位置比较它们的各个元素来比较两个数组值。对于每个位置，首先比较元素类型。如果类型不相等，则确定比较结果，并且比较结束。如果类型相等，则将比较两个元素的值。如果其中一个数组已完成，而另一个数组在比较位置仍然有一个元素，则将null用作完全遍历数组的元素值。 + + 如果数组元素本身是复合值（数组或对象/文档），则比较算法将递归检查元素的子值。递归比较元素的子元素。 + + 通过检查属性名称和值来比较两个对象/文档操作数。首先比较属性名称。在比较属性名称之前，将创建两个操作数的所有属性名称的组合数组，并按字典顺序进行排序。这意味着在比较两个对象/文档时，在对象/文档中声明属性的顺序无关紧要。 + + 然后遍历组合和排序的属性名称数组，然后从两个比较的操作数中查找相应的属性。如果对象/文档之一不具有具有所寻找名称的属性，则其属性值被视为null。最后，使用前面提到的数据类型和值比较来比较两个对象/文档的属性值。对所有对象/文档属性执行比较，直到明确的比较结果为止。如果找到明确的比较结果，则比较结束。如果没有明确的比较结果，则将两个比较的对象/文档视为相等。 \ No newline at end of file diff --git a/src/docs/arangodb/agDocs/索引.md b/src/docs/arangodb/agDocs/索引.md new file mode 100644 index 0000000..32e9766 --- /dev/null +++ b/src/docs/arangodb/agDocs/索引.md @@ -0,0 +1,237 @@ +索引基础 +索引允许快速访问文档，前提是在查询中使用了索引属性。尽管ArangoDB自动为某些系统属性建立索引，但用户可以自由地在文档的非系统属性上创建额外的索引。 + +可以在集合级别上创建用户定义的索引。可以通过指定索引属性的名称来创建大多数用户定义的索引。一些索引类型只允许索引一个属性（例如全文本索引），而其他索引类型只允许同时索引多个属性。 + +通过学习ArangoDB性能课程，学习如何有效地使用不同的索引 。 + +该系统属性_id，_key，_from并且_to通过ArangoDB会自动建立索引，而不需要用户为他们创造额外的索引。 _id并且_key被集合的主键 覆盖，_from并且_to被边缘集合的边缘索引自动覆盖。 + +使用该系统属性_id在用户定义的索引是不可能的，但索引_key，_rev，_from，和_to是。 + +默认情况下，创建新索引是在独占集合锁下完成的。创建索引时，该集合不可用。如果您必须在没有专用维护窗口的实时系统上执行索引创建，那么“前景”索引可能是不可取的。 + +对于可能长时间运行的索引创建操作，RocksDB存储引擎还支持在“后台”创建索引。该集合在索引创建期间仍然（大部分）可用，请参阅“ 在后台创建索引 ”部分以获取更多信息。 + +ArangoDB提供以下索引类型： + +主要指标 +对于每个集合，总会有一个主索引，该主索引是集合中所有文档的文档关键字（_key属性）的持久索引。主索引允许使用_key或_id属性快速选择集合中的文档。在_key或上执行相等查找时，将自动在AQL查询中使用它 _id。 + +还有一些专用功能来查找给定的文档，_key或者_id 始终使用主索引的文档： + +db.collection.document(""); +db._document(""); +当对持久性索引进行排序时，主索引可用于范围查询和排序。 + +集合的主索引不能删除或更改，也没有创建用户定义的主索引的机制。 + +边缘指数 +每个边缘集合还具有一个自动创建的边缘索引。边缘索引可通过文档的_from或_to属性快速访问文档。因此，它可用于快速查找顶点文档之间的连接，并在查询顶点的连接边时调用。 + +对边缘集合_from 或_to边缘集合中的值执行相等查找时，会从AQL中使用边缘索引。还有一些专用函数可以找到给定的边_from或边_to值，这些边将始终利用边索引： + +db.collection.edges(""); +db.collection.edges(""); +db.collection.outEdges(""); +db.collection.outEdges(""); +db.collection.inEdges(""); +db.collection.inEdges(""); +边缘索引存储所有_from和_to属性的并集。它可以用于相等查找，但不能用于范围查询或排序。将自动为边缘集合创建边缘索引。 + +无法创建用户定义的边缘索引。但是，可以在用户定义的索引中自由使用_from和_to属性。 + +不能删除或更改边缘索引。 + +持久指数 +持久索引是具有持久性的排序索引。存储或更新文档时，索引条目将写入磁盘。这意味着在重新启动服务器或初始加载索引的集合时，不需要从集合数据中重建索引条目。因此，使用持久索引可以减少集合加载时间。 + +持久索引类型目前可用于二级索引。这意味着持久性索引当前不能成为集合的唯一索引，因为该集合将始终存在内存中的主索引，并且可能还有更多的索引（例如Edge集合的edge索引）。 + +索引实现使用的是RocksDB引擎，它为插入，更新和删除操作提供了对数复杂性。由于持久索引不是内存索引，因此它不像所有内存索引一样将指针存储到主索引中，而是存储文档的主键。为了通过索引值查找通过持久索引检索文档，因此将在主索引中进行额外的O（1）查找以获取实际文档。 + +在对持久索引进行排序时，它可以用于点查找，范围查询和排序操作，但前提是必须在查询中提供所有索引属性，或者指定索引属性的最左前缀。 + +TTL（生存时间）索引 +ArangoDB提供的TTL索引类型可用于自动从集合中删除过期的文档。 + +通过设置expireAfter值并选择包含文档创建日期和时间的单个文档属性来设置TTL索引。文档expireAfter在创建时间后几秒钟后过期。创建时间被指定为数字时间戳（Unix时间戳）或格式的日期字符串YYYY-MM-DDTHH:MM:SS，可以选择使用格式 的小数点后的毫秒数YYYY-MM-DDTHH:MM:SS.MMM和可选的时区偏移量。所有没有时区偏移的日期字符串都将被解释为UTC日期。 + +例如，如果expireAfter将设置为600秒（10分钟），并且索引属性为“ creationDate”，则存在以下文档： + +{ "creationDate" : 1550165973 } +该文档将使用创建日期时间值索引，该值1550165973将转换为人类可读的date 2019-02-14T17:39:33.000Z。此文档将在时间戳记1550166573（或 2019-02-14T17:49:33.000Z人类可读版本）之后的600秒后过期。 + +实际删除过期文件并不一定会立即发生。过期的文档最终将由后台线程删除，该线程定期遍历所有TTL索引并删除过期的文档。可以使用--ttl.frequency 启动选项配置调用此后台线程的频率。 + +无法保证何时将完全删除过期的文档，因此查询仍然可以找到并返回已经过期的文档。这些文件最终将在后台线程启动并具有删除过期文档的能力时被删除。但是可以保证，只有超过其到期时间的文档才会被真正删除。 + +请注意，自1970年1月1日（Unix时间戳）以来，必须以秒为单位指定index属性的数字日期时间值。要以这种格式从JavaScript计算当前时间戳，可以使用Date.now() / 1000;。要从任意Date实例计算它，有Date.getTime() / 1000。在AQL中，您可以 DATE_NOW() / 1000将任意Unix时间戳（以毫秒为单位）除以1000，以将其转换为秒。 + +另外，可以将index属性值指定为date字符串，格式为 YYYY-MM-DDTHH:MM:SS，可选的格式是小数点后的毫秒YYYY-MM-DDTHH:MM:SS.MMM和可选的时区偏移量。所有没有时区偏移的日期字符串都将被解释为UTC日期。 + +上面使用datestring属性值的示例文档为 + +{ "creationDate" : "2019-02-14T17:39:33.000Z" } +如果index属性不包含数字值或正确的日期字符串，则该文档将不会存储在TTL索引中，因此不会成为过期和删除的候选对象。为索引属性提供非数字值或什至不提供值是防止文档过期和删除的一种受支持方法。 + +地理索引 +用户可以在集合中的一个或多个属性上创建其他地理索引。地理索引用于快速找到地球表面的位置。 + +地理索引存储二维坐标。它可以在两个单独的文档属性（纬度和经度）上创建，也可以在包含纬度和经度的单个数组属性上创建。纬度和经度必须是数字值。 + +地理索引提供了以下操作：查找坐标最接近给定比较坐标的文档，以及查找坐标在围绕比较坐标的指定半径内的文档。 + +地理位置索引是通过AQL中的专用功能（简单查询功能）使用的，当在AQL中将SORT或FILTER与距离功能一起使用时，它会隐式应用。否则，它将不会用于其他类型的查询或条件。 + +全文索引 +全文索引可用于在文档中查找单词或单词前缀。全文索引只能在单个属性上创建，并且将对文档中包含的具有该属性文本值的所有单词进行索引。仅索引（指定）最小长度的单词。使用libicu提供的单词边界分析来完成单词标记化，该分析考虑了服务器启动时提供的所选语言。单词以小写形式索引。该指数支持完全匹配的查询（满语）和前缀查询，加上基本的逻辑操作，例如 and，or和not用于组合部分结果。 + +全文索引是稀疏的，这意味着它只会索引设置了index属性且包含字符串值的文档。此外，索引中仅包含具有可配置的最小长度的单词。 + +全文索引通过AQL中的专用功能或简单查询使用，但不会为其他类型的查询或条件启用。 + +对于高级全文搜索功能，请考虑ArangoSearch。 + +索引属性和子属性 +顶级以及嵌套属性都可以建立索引。对于顶级属性，仅需要属性名称。要为单个字段建立索引，请将具有单个元素（属性键的字符串）的数组传递给sureIndex（）方法的fields参数 。要在多个字段上创建组合索引，只需将更多成员添加到fields数组中： + +// { name: "Smith", age: 35 } +db.posts.ensureIndex({ type: "persistent", fields: [ "name" ] }) +db.posts.ensureIndex({ type: "persistent", fields: [ "name", "age" ] }) +要索引子属性，请使用点符号指定属性路径： + +// { name: {last: "Smith", first: "John" } } +db.posts.ensureIndex({ type: "persistent", fields: [ "name.last" ] }) +db.posts.ensureIndex({ type: "persistent", fields: [ "name.last", "name.first" ] }) +索引数组值 +如果索引属性包含一个数组，则默认情况下，ArangoDB将整个数组存储为索引值。这样就无法通过索引访问数组的各个成员。 + +若要使索引将单个数组成员而不是整个数组值插入到索引中，需要为该属性创建一个特殊的数组索引。使用该collection.ensureIndex()函数可以像常规持久性索引一样设置数组索引。为了使持久索引成为数组索引，[*] 在创建索引以及使用IN运算符在AQL查询中进行过滤时，需要扩展索引属性名称。 + +以下示例tags在名为的集合中的属性 上创建持久数组索引posts： + +db.posts.ensureIndex({ type: "persistent", fields: [ "tags[*]" ] }); +db.posts.insert({ tags: [ "foobar", "baz", "quux" ] }); +然后，该数组索引可用于tags通过IN运算符从AQL查询中查找单个值： + +FOR doc IN posts + FILTER 'foobar' IN doc.tags + RETURN doc +可以添加数组扩展运算符 [*]，但这不是强制性的。您可以使用它来表示已使用数组索引，但是它纯粹是修饰性的： + +FOR doc IN posts + FILTER 'foobar' IN doc.tags[*] + RETURN doc +以下FILTER条件将不使用数组索引： + +FILTER doc.tags ANY == 'foobar' +FILTER doc.tags ANY IN 'foobar' +FILTER doc.tags IN 'foobar' +FILTER doc.tags == 'foobar' +FILTER 'foobar' == doc.tags +也可以在数组值的子属性上创建索引。如果index属性是一个对象数组，例如： + +db.posts.ensureIndex({ type: "persistent", fields: [ "tags[*].name" ] }); +db.posts.insert({ tags: [ { name: "foobar" }, { name: "baz" }, { name: "quux" } ] }); +然后，以下查询将使用数组索引（这确实需要 数组扩展运算符）： + +FOR doc IN posts + FILTER 'foobar' IN doc.tags[*].name + RETURN doc +如果存储的文档中的数组确实包含不具有子属性的元素，则该文档也将被索引为value null，该值在ArangoDB中等于不存在的属性。 + +ArangoDB支持使用[*]每个索引属性使用单个运算符来创建数组索引。例如，不支持如下创建索引： + +db.posts.ensureIndex({ type: "persistent", fields: [ "tags[*].name[*].value" ] }); +数组值在插入数组索引之前将自动进行重复数据删除。例如，如果将以下文档插入到集合中，则重复的数组值bar将仅被插入一次： + +db.posts.insert({ tags: [ "foobar", "bar", "bar" ] }); +这样做是为了避免对同一文档重复存储相同索引值，这不会带来任何好处。 + +如果将数组索引声明为unique，则会在将数组值插入索引之前对数组值进行重复数据删除，因此上述具有两个相同值的插入操作 bar不一定会失败 + +如果索引已经包含该bar值的实例，它将总是失败。但是，如果bar索引中不存在该值，则对数组值进行重复数据删除将实际上导致bar仅插入一次。 + +要关闭数组值的重复数据删除，可以将数组索引的重复数据删除属性设置为false。但是，重复数据删除的默认值为true，因此，如果未明确关闭重复数据删除，则会进行重复数据删除。 + +db.posts.ensureIndex({ type: "persistent", fields: [ "tags[*]" ], deduplicate: false }); + +// will fail now +db.posts.insert({ tags: [ "foobar", "bar", "bar" ] }); +如果声明了数组索引，并且您在指定的属性中存储没有数组的文档，则该文档不会插入索引中。因此，以下对象将不被索引： + +db.posts.ensureIndex({ type: "persistent", fields: [ "tags[*]" ] }); +db.posts.insert({ something: "else" }); +db.posts.insert({ tags: null }); +db.posts.insert({ tags: "this is no array" }); +db.posts.insert({ tags: { content: [1, 2, 3] } }); +数组索引能够索引显式null值。当查询null值时，它将仅返回那些已明确null存储在数组中的文档，而不会返回任何根本没有数组的文档。 + +db.posts.ensureIndex({ type: "persistent", fields: [ "tags[*]" ] }); +db.posts.insert({tags: null}) // Will not be indexed +db.posts.insert({tags: []}) // Will not be indexed +db.posts.insert({tags: [null]}); // Will be indexed for null +db.posts.insert({tags: [null, 1, 2]}); // Will be indexed for null, 1 and 2 +将数组索引声明为稀疏对索引的数组部分没有影响，这尤其意味着null在稀疏版本中也对显式值进行索引。如果将索引与数组和常规属性组合在一起，则稀疏性将适用于该属性，例如： + +db.posts.ensureIndex({ type: "persistent", fields: [ "tags[*]", "name" ], sparse: true }); +db.posts.insert({tags: null, name: "alice"}) // Will not be indexed +db.posts.insert({tags: [], name: "alice"}) // Will not be indexed +db.posts.insert({tags: [1, 2, 3]}) // Will not be indexed +db.posts.insert({tags: [1, 2, 3], name: null}) // Will not be indexed +db.posts.insert({tags: [1, 2, 3], name: "alice"}) +// Will be indexed for [1, "alice"], [2, "alice"], [3, "alice"] +db.posts.insert({tags: [null], name: "bob"}) +// Will be indexed for [null, "bob"] +请注意，仅在查询使用IN操作符对索引属性进行过滤时，使用数组索引的过滤仅在AQL查询中有效。其它比较运算符（==，!=，>，>=，<，<=，ANY，ALL，NONE）不能目前使用阵列的索引。 + +顶点中心索引 +如上所述，图形最重要的索引是边缘索引，它索引边缘集合的_from和_to属性。它们提供了对源自或到达给定顶点的所有边的非常快速的访问，这允许快速找到图中顶点的所有邻居。 + +在许多情况下，我们希望运行更具体的查询，例如，在给定顶点起源的边中仅查找那些时间戳大于或等于某个日期和时间的边。确切地说，这是通过“以顶点为中心的索引”实现的。从某种意义上讲，它们是每个单个顶点处的边缘集合的局部索引。 + +从技术上说，他们在ArangoDB实现为索引，其排序完整边集合首先_from，然后通过其他属性出境遍历，或者先通过_to，然后由其他属性入境遍历。对于在ANY方向上的遍历，需要两个索引，一个索引与_from另一个_to索引作为第一个索引字段。 + +例如，如果我们在属性_from和 timestamp边缘集合上有一个持久索引，则可以通过在索引中进行一次范围查找来非常快速地回答上述问题。 + +从ArangoDB 3.0开始，可以创建排序索引（类型为“持久”）来索引特殊边缘属性_from或_to 其他属性。从ArangoDB 3.1开始，当FILTER优化器找到适当的语句时，这些将用于图遍历。 + +例如，要创建上述类型的顶点中心索引，您只需 + +db.edges.ensureIndex({"type":"persistent", "fields": ["_from", "timestamp"]}); +在阿兰戈什。然后，查询如 + +FOR v, e, p IN 1..1 OUTBOUND "V/1" edges + FILTER e.timestamp >= "2018-07-09" + RETURN p +如果有许多来自顶点的边，"V/1"但是只有少数带有最近时间戳记的边，则速度会更快。请注意，即使顶点中心索引实际上可能更快，优化器也可能会基于估计的成本而选择默认边缘索引而不是顶点中心索引。对于高度连接的图形和RocksDB存储引擎，更可能选择以顶点为中心的索引。 + +在后台创建索引 +在v3.5.0中引入 + +默认情况下，创建新索引是在独占集合锁下完成的。这意味着只要创建索引，集合（或相应的分片）就不可用于写操作。如果您必须在没有专用维护窗口的实时系统上执行索引创建，那么“前景”索引可能是不可取的。 + +索引也可以在“后台”中创建，而不在整个索引创建过程中使用排他锁。该集合基本上保持可用，因此在创建索引时其他CRUD操作可以在该集合上运行。这可以通过在创建索引时设置inBackground属性来实现。 + +要在arangosh中在后台创建索引，只需指定inBackground: true，如以下示例所示： + +// create the persistent index in the background +db.collection.ensureIndex({ type: "persistent", fields: [ "value" ], unique: false, inBackground: true }); +db.collection.ensureIndex({ type: "persistent", fields: [ "email" ], unique: true, inBackground: true }); + +// also supported for geo and fulltext indexes +db.collection.ensureIndex({ type: "geo", fields: [ "latitude", "longitude"], inBackground: true }); +db.collection.ensureIndex({ type: "geo", fields: [ "latitude", "longitude"], inBackground: true }); +db.collection.ensureIndex({ type: "fulltext", fields: [ "text" ], minLength: 4, inBackground: true }) +行为 +仍在构建过程中的索引将无法通过ArangoDB API看到。但是，在仍然开始创建索引的同时，不可能通过sureIndex API 两次创建相同的索引。AQL查询也不会使用这些索引，直到索引报告已完全创建。请注意，在索引完全准备好之前，最初的sureIndex调用或HTTP请求仍将阻塞。因此，现有的单线程客户端程序可以安全地将inBackground选项设置为true并继续像以前一样工作。 + +如果要在后台建立索引，则不能重命名或删除集合。这些操作将阻塞，直到索引创建完成。前景索引也是如此。 + +在索引构建中断之后（即由于服务器崩溃），部分构建的索引将被删除。然后，在ArangoDB集群中，可能会在受影响的分片上自动重新创建索引。 + +性能 +后台索引创建可能比“前景”索引创建慢，并且需要更多RAM。在繁重的写操作（特别是许多删除，更新或替换操作）下，后台索引创建需要在RAM中保留已删除文档的列表。如果此列表增加到数千万个条目，这可能变得难以为继。 + +建立索引始终（内部）是繁重的写操作，在负载较少的时候建立索引始终是一个好主意。 \ No newline at end of file diff --git a/src/docs/arangodb/agDocs/运算符.md b/src/docs/arangodb/agDocs/运算符.md new file mode 100644 index 0000000..e68ddc8 --- /dev/null +++ b/src/docs/arangodb/agDocs/运算符.md @@ -0,0 +1,240 @@ +经营者 +AQL支持许多可在表达式中使用的运算符。有比较，逻辑，算术和三元运算符。 + +比较运算符 +比较（或关系）运算符比较两个操作数。它们可以与任何输入数据类型一起使用，并将返回布尔结果值。 + +支持以下比较运算符： + +操作员 描述 +== 平等 +!= 不等式 +< 少于 +<= 小于或等于 +> 比...更棒 +>= 大于或等于 +IN 测试值是否包含在数组中 +NOT IN 测试值是否不包含在数组中 +LIKE 测试字符串值是否与模式匹配 +NOT LIKE 测试字符串值是否与模式不匹配 +=~ 测试字符串值是否与正则表达式匹配 +!~ 测试字符串值是否与正则表达式不匹配 +如果可以评估比较结果，则每个比较运算符都将返回一个布尔值；如果比较结果为true，则返回true；否则返回false 。 + +比较运算符接受第一和第二操作数的任何数据类型。但是，IN并且NOT IN仅在其右侧操作数是数组的情况下才会返回有意义的结果。LIKE并且NOT LIKE仅在两个操作数均为字符串值时才执行。如果比较的操作数具有不同或不合理的类型，则比较运算符将不执行任何隐式类型转换。 + +AQL中比较操作的一些示例： + + 0 == null // false + 1 > 0 // true + true != null // true + 45 <= "yikes!" // true + 65 != "65" // true + 65 == 65 // true + 1.23 > 1.32 // false + 1.5 IN [ 2, 3, 1.5 ] // true + "foo" IN null // false +42 NOT IN [ 17, 40, 50 ] // true + "abc" == "abc" // true + "abc" == "ABC" // false + "foo" LIKE "f%" // true + "foo" NOT LIKE "f%" // false + "foo" =~ "^f[o].$" // true + "foo" !~ "[a-z]+bar$" // true +该LIKE运营商检查是否其左操作数以其右操作数指定的模式相匹配。该模式可以包含常规字符和通配符。支持的通配符_将匹配单个任意字符，并%匹配任意数量的任意字符。文字%，_需要以反斜杠转义。反斜杠需要自己转义，这实际上意味着两个反斜线字符必须在文字百分号或下划线之前。在arangosh中，需要进行额外的转义，使其在要转义的字符之前总共加四个反斜杠。 + + "abc" LIKE "a%" // true + "abc" LIKE "_bc" // true +"a_b_foo" LIKE "a\\_b\\_foo" // true +LIKE操作员执行的模式匹配区分大小写。 + +该NOT LIKE经营者具有相同特性的LIKE运营商，但与否定的结果。因此，它与相同NOT (… LIKE …)。请注意括号，这对于某些表达式是必需的： + +FOR doc IN coll + RETURN NOT doc.attr LIKE "…" +return表达式将转换为LIKE(!doc.attr, "…")，从而产生意外结果。NOT(doc.attr LIKE "…")变得更加合理! LIKE(doc.attr, "…")。 + +正则表达式运算符=~并!~期望它们的左手操作数是字符串，而期望它们的右手操作数是包含有效的正则表达式的字符串，如AQL函数REGEX_TEST（）的文档中所指定 。 + +数组比较运算符 +比较运算符也作为数组变量存在。在阵列变型中，操作者的前缀的关键字之一ALL，ANY 或NONE。使用这些关键字之一可以更改操作员的行为，以便对其所有，任何或不使用其左手参数值执行比较操作。因此，期望数组运算符的左手参数是一个数组。 + +例子： + +[ 1, 2, 3 ] ALL IN [ 2, 3, 4 ] // false +[ 1, 2, 3 ] ALL IN [ 1, 2, 3 ] // true +[ 1, 2, 3 ] NONE IN [ 3 ] // false +[ 1, 2, 3 ] NONE IN [ 23, 42 ] // true +[ 1, 2, 3 ] ANY IN [ 4, 5, 6 ] // false +[ 1, 2, 3 ] ANY IN [ 1, 42 ] // true +[ 1, 2, 3 ] ANY == 2 // true +[ 1, 2, 3 ] ANY == 4 // false +[ 1, 2, 3 ] ANY > 0 // true +[ 1, 2, 3 ] ANY <= 1 // true +[ 1, 2, 3 ] NONE < 99 // false +[ 1, 2, 3 ] NONE > 10 // true +[ 1, 2, 3 ] ALL > 2 // false +[ 1, 2, 3 ] ALL > 0 // true +[ 1, 2, 3 ] ALL >= 3 // false +["foo", "bar"] ALL != "moo" // true +["foo", "bar"] NONE == "bar" // false +["foo", "bar"] ANY == "foo" // true +请注意，这些运算符尚未优化。索引将不被使用。 + +逻辑运算符 +AQL支持以下逻辑运算符： + +&& 逻辑与运算符 +|| 逻辑或运算符 +! 逻辑非/否定运算符 +AQL还支持逻辑运算符的以下替代形式： + +AND 逻辑与运算符 +OR 逻辑或运算符 +NOT 逻辑非/否定运算符 +替代形式是别名，在功能上等同于常规运算符。 + +AQL中的两个操作数逻辑运算符将使用短路求值执行（除非其中一个操作数是子查询或包含子查询。在这种情况下，子查询将在逻辑运算符之前被提取一个求值）。 + +AQL中逻辑运算符的结果定义如下： + +lhs && rhslhs如果是false或将false转换为布尔值时将返回。如果将lhsis true或be true转换为布尔值， rhs则将返回。 +lhs || rhslhs如果是true或将true转换为布尔值时将返回。如果将lhsis false或be false转换为布尔值， rhs则将返回。 +! value将返回value转换为布尔值的取反值 +AQL中逻辑操作的一些示例： + +u.age > 15 && u.address.city != "" +true || false +NOT u.isInvalid +1 || ! 0 +允许将非布尔值传递给逻辑运算符。任何非布尔操作数都将由运算符隐式转换为布尔值，而不会使查询中止。 + +在一个布尔值转换的工作原理如下： + +null 将被转换为 false +布尔值保持不变 +所有不等于零的数字为true，零为false +空字符串是false，所有其他字符串是true +数组（[ ]）和对象/文档（{ }）是true不论其内容如何 +逻辑和与逻辑或运算的结果现在可以具有任何数据类型，并且不一定是布尔值。 + +例如，以下逻辑运算将返回布尔值： + +25 > 1 && 42 != 7 // true +22 IN [ 23, 42 ] || 23 NOT IN [ 22, 7 ] // true +25 != 25 // false +…，而以下逻辑运算将不会返回布尔值： + + 1 || 7 // 1 +null || "foo" // "foo" +null && true // null +true && 23 // 23 +算术运算符 +算术运算符对两个数字操作数执行算术运算。算术运算的结果还是一个数值。 + +AQL支持以下算术运算符： + ++ 加成 +- 减法 +* 乘法 +/ 师 +% 模数 +一元加号和一元减号也受支持： + +LET x = -5 +LET y = 1 +RETURN [-x, +y] +// [5, 1] +为了求幂，有一个数字函数 POW（）。base ** exp不支持语法。 + +对于字符串连接，必须使用字符串函数 CONCAT（）。将两个字符串与加号（"foo" + "bar"）结合使用将不起作用！另请参阅常见错误。 + +一些算术运算示例： + +1 + 1 +33 - 99 +12.4 * 4.5 +13.0 / 0.1 +23 % 7 +-15 ++9.99 +算术运算符接受任何类型的操作数。将非数字值传递给算术运算符将使用TO_NUMBER（）函数应用的类型转换规则将操作数转换为数字： + +null 将被转换为 0 +false将转换为0，将true转换为1 +有效数值保持不变，但NaN和Infinity将转换为 0 +如果字符串值包含数字的有效字符串表示形式，则将它们转换为数字。字符串开头或结尾的所有空格都将被忽略。具有其他内容的字符串将转换为数字0 +将一个空数组转换为0，将具有一个成员的数组转换为其唯一成员的数字表示形式。具有更多成员的数组将转换为number 0。 +对象/文档将转换为数字0。 +产生无效值的算术运算，例如1 / 0（除以零）也将产生结果值null。该查询不会终止，但是您可能会看到警告。 + +这里有一些例子： + + 1 + "a" // 1 + 1 + "99" // 100 + 1 + null // 1 +null + 1 // 1 + 3 + [ ] // 3 + 24 + [ 2 ] // 26 + 24 + [ 2, 4 ] // 0 + 25 - null // 25 + 17 - true // 16 + 23 * { } // 0 + 5 * [ 7 ] // 35 + 24 / "12" // 2 + 1 / 0 // 0 +三元运算符 +AQL还支持可用于条件评估的三元运算符。三元运算符期望布尔条件作为其第一个操作数，如果条件的计算结果为true，则返回第二个操作数的结果，否则返回第三个操作数。 + +例子 + +u.age > 15 || u.active == true ? u.userId : null +还有只有两个操作数的三元运算符的快捷方式。当布尔条件的表达式和返回值应该相同时，可以使用此变体： + +例子 + +u.value ? : 'value is null, 0 or not present' +范围运算符 +AQL支持使用..运算符表达简单的数字范围。该运算符可用于轻松地迭代数字序列。 + +所述..操作者将产生整数值的阵列在所定义的范围内，与两个边界值包括在内。 + +例子 + +2010..2013 +将产生以下结果： + +[ 2010, 2011, 2012, 2013 ] +使用范围运算符等效于编写一个整数值的数组，该整数值在范围的边界所指定的范围内。如果范围运算符的边界为非整数，则它们将首先转换为整数值。 + +还有一个RANGE（）函数。 + +数组运算符 +AQL提供阵列运营商[*]为 数组变量扩展和 [**]用于阵列收缩。 + +运算符优先级 +AQL中的运算符优先级与其他熟悉的语言相似（最低优先级优先）： + +运营商 描述 +, 逗号分隔符 +DISTINCT 独特修饰符（返回操作） +? : 三元运算符 += 变量赋值（LET操作） +WITH 与运算符一起（WITH / UPDATE / REPLACE / COLLECT操作） +INTO 进入运算符（INSERT / UPDATE / REPLACE / REMOVE / COLLECT操作） +|| 逻辑或 +&& 逻辑与 +OUTBOUND，INBOUND，ANY，ALL，NONE 图遍历方向，数组比较运算符 +==，!=，LIKE，NOT LIKE，=~，!~ （in）相等，通配符（非）匹配，正则表达式（非）匹配 +IN， NOT IN （不是）在运算符中 +<，<=，>=，> 小于，小于等于，大于等于，大于 +.. 范围运算符 ++， - 加，减 +*，/，% 乘法，除法，模 +!，+，- 逻辑否定，一元加，一元减 +() 函数调用 +. 会员访问 +[] 索引值访问 +[*] 扩张 +:: 范围 +括号(和)可用于强制执行不同的操作员评估顺序。 \ No newline at end of file diff --git a/src/docs/arangodb/arandodb初始化配置相关.md b/src/docs/arangodb/arandodb初始化配置相关.md new file mode 100644 index 0000000..ebf2236 --- /dev/null +++ b/src/docs/arangodb/arandodb初始化配置相关.md @@ -0,0 +1,34 @@ + +Updating / installing... + 1:arangodb3e-3.5.3-1.0 ################################# [100%] + +ArangoDB 3 (https://www.arangodb.com) + The multi-model NoSQL database: distributed free and open-source database + with a flexible data model for documents, graphs, and key-values. Build + high performance applications using a convenient SQL-like query language + or JavaScript extensions. + +First Steps with ArangoDB: + https://docs.arangodb.com/latest/Manual/GettingStarted/ + +Configuring the storage Engine: + https://docs.arangodb.com/latest/Manual/Administration/Configuration/GeneralArangod.html#storage-engine + +Configuration file: + /etc/arangodb3/arangod.conf + +Start ArangoDB shell client: + > /usr/bin/arangosh + +Start ArangoDB service: + > systemctl start arangodb3.service + +Enable ArangoDB service: + > systemctl enable arangodb3.service + +SECURITY HINT: +run 'arango-secure-installation' to set a root password +the current password is '7c8329a66d35a624bcfedfae0c944938' +(You should do this for a FRESH install! For an UPGRADE the password does not need to be changed) +2019-12-13T15:41:20Z [1134] INFO [a1c60] {syscall} file-descriptors (nofiles) hard limit is 65535, soft limit is 65535 +2019-12-13T15:41:21Z [1134] INFO [7da27] {startup} server will now shut down due to upgrade, database initialization or admin restoration. diff --git a/src/docs/arangodb/arangod.conf b/src/docs/arangodb/arangod.conf new file mode 100644 index 0000000..d197385 --- /dev/null +++ b/src/docs/arangodb/arangod.conf @@ -0,0 +1,77 @@ +# ArangoDB configuration file +# +# Documentation: +# https://docs.arangodb.com/latest/Manual/Administration/Configuration/ +# + +[database] +directory = /var/lib/arangodb3 + +# maximal-journal-size = 33554432 + +[server] +# Specify the iendpoint for HTTP requests by clients. +# tcp://ipv4-address:port +# tcp://[ipv6-address]:port +# ssl://ipv4-address:port +# ssl://[ipv6-address]:port +# unix:///path/to/socket +# +# Examples: + endpoint = tcp://0.0.0.0:8529 +# endpoint = tcp://171.221.139.17:8529 +# endpoint = tcp://localhost:8529 +# endpoint = tcp://myserver.arangodb.com:8529 +# endpoint = tcp://[::]:8529 +# endpoint = tcp://[fe80::21a:5df1:aede:98cf]:8529 +# +# endpoint = tcp://127.0.0.1:8529 +storage-engine = rocksdb + +# reuse a port on restart or wait until it is freed by the operating system +# reuse-address = false + +authentication = true + +# number of maximal server threads. use 0 to make arangod determine the +# number of threads automatically, based on available CPUs +# maximal-threads = 0 + +# gather server statistics +statistics = true + +# the user and group are normally set in the start script +# uid = arangodb +# gid = arangodb + +uid = arangodb + + +[javascript] +startup-directory = /usr/share/arangodb3/js +app-path = /var/lib/arangodb3-apps +# app-path = //arangodb3/apps + +# number of V8 contexts available for JavaScript execution. use 0 to +# make arangod determine the number of contexts automatically. +# v8-contexts = 0 + +[foxx] +# enable Foxx queues in the server +# queues = true + +# interval (seconds) to use for polling jobs in Foxx queues +# queues-poll-interval = 1 + +[log] +level = info +file = /var/log/arangodb3/arangod.log + +[cluster] + +[rocksdb] +# encryption-keyfile=/your-encryption-file +# +[http] +keep-alive-timeout = 5000000 +hide-product-header = true diff --git a/src/docs/arangodb/arangodb主要特特点.md b/src/docs/arangodb/arangodb主要特特点.md new file mode 100644 index 0000000..895ab26 --- /dev/null +++ b/src/docs/arangodb/arangodb主要特特点.md @@ -0,0 +1,16 @@ +# 主要特点 + ArangoDB是本机多模型，开源数据库，具有用于文档，图形和键值的灵活数据模型。使用方便的类似SQL的查询语言或JavaScript扩展来构建高性能应用程序。如果需要，请使用ACID交易。只需单击几下鼠标，即可水平和垂直缩放。 + + 主要功能包括： + + 在群集上安装ArangoDB与在移动设备上安装应用程序一样容易 + 灵活的数据建模：将您的数据建模为键值对，文档或图表的组合-非常适合社交关系 + 强大的查询语言（AQL）来检索和修改数据 + 将ArangoDB用作应用程序服务器，并将应用程序和数据库融合在一起，以实现最大吞吐量 + 事务：对多个文档或集合运行查询，并具有可选的事务一致性和隔离性 + 复制和分片：在多个服务器建立数据库以主-从配置或传播更大的数据集 + 可配置的耐久性：让应用程序决定是否需要更高的耐久性或更高的性能 + 轻松的存储：ArangoDB使用了现代存储硬件的所有功能，例如SSD和大型缓存 + 面向所有人的JavaScript：您可以从浏览器到后端使用一种语言 + ArangoDB可以轻松地部署为容错的分布式状态机，可以充当分布式设备的动物大脑 + 它是开源的（Apache License 2.0） \ No newline at end of file diff --git a/src/docs/arangodb/arangodb服务器选项.md b/src/docs/arangodb/arangodb服务器选项.md new file mode 100644 index 0000000..ae85800 --- /dev/null +++ b/src/docs/arangodb/arangodb服务器选项.md @@ -0,0 +1,507 @@ +# 服务器用法 + arangod [