bitflicker64 commented on code in PR #503: URL: https://github.com/apache/hugegraph-doc/pull/503#discussion_r4322277499
########## content/cn/docs/clients/restful-api/edge.md: ########## @@ -422,12 +422,23 @@ PUT http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/graph/edges/S1:ma - vertex_id: 顶点 id - direction: 边的方向 (OUT | IN | BOTH)，默认为 BOTH - label: 边的标签 -- properties: 属性键值对 (根据属性查询的前提是预先建立了索引) +- properties: 属性键值对（索引覆盖要求见下文） - keep_start_p: 默认为 false，当设置为 true 后，不会自动转义范围匹配输入的表达式，例如此时 `properties={"age":"P.gt(0.8)"}` 会被理解为精确匹配，即 age 属性等于 "P.gt(0.8)" - offset：偏移，默认为 0 - limit: 查询数目，默认为 100 - page: 页号 +未指定 `vertex_id` 时，`properties` 在全图范围查询边。指定 `label` 时，该标签需有与查询条件匹配的属性索引；若指定的是未单独建索引的子边标签，可以使用其查询可见的父标签上的匹配索引，并自动过滤掉同级其他子标签的边。 +未指定 `label` 时，候选标签是查询可见、可直接存边且声明了全部待查属性的边标签，也包括目前没有边的标签。普通查询不可见的标签（包括正在删除的标签）不需要索引覆盖。如果指定的 `label`（前提是已声明全部待查非 OLAP 属性）或全部候选标签都不可见或正在删除，查询返回空结果，不报索引错误。 +未指定 `label` 时，`base` 父边标签不直接存边，子标签全部被覆盖时，无需再为父标签单独建立索引。可以用当前查询可见的父标签上的匹配索引覆盖子标签，也可以为每个候选子标签建立匹配的索引。如果父标签因隐藏或正在删除而被当前查询排除，其索引不能用于覆盖子标签。仅有标签索引不等于属性已建立索引。 + +查询值与声明的属性类型兼容时，没有匹配索引或仅覆盖部分候选标签都会报索引错误，完整覆盖时通过索引执行。 +部分覆盖检查报错、子边标签复用父标签索引，以及候选标签不可见或正在删除时返回空结果的机制，适用于包含 [apache/hugegraph#3243](https://github.com/apache/hugegraph/pull/3243) 的版本； Review Comment: Minor: 25d1d94 split the version note after "；", so this sentence renders with a stray space: "...适用于包含 apache/hugegraph#3243 的版本； 早期版本仅使用...". `hugo.yaml` at this head still has no `markup.goldmark.extensions.cjk` setting, so Goldmark keeps the soft break as a newline and browsers show it as a space between the two Chinese clauses. This is the same rendering issue settled in the earlier line-break threads, where the Chinese paragraphs were agreed to break only after "。"; at c1aa831 this note was still one line. The same split was added in content/cn/docs/clients/restful-api/vertex.md line 430. Requested change: join lines 436 and 437 here, and lines 430 and 431 in the Chinese vertex.md, back into one line each, or end the first part with "。" instead of "；". -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
