You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hugegraph.apache.org by gi...@apache.org on 2023/05/14 12:20:59 UTC
[incubator-hugegraph-doc] branch asf-site updated: Update desgin-concept.md (#220)
This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/incubator-hugegraph-doc.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 3832f619 Update desgin-concept.md (#220)
3832f619 is described below
commit 3832f61958f3f118e39de0b39f29e151acdcb70c
Author: imbajin <im...@users.noreply.github.com>
AuthorDate: Sun May 14 12:20:53 2023 +0000
Update desgin-concept.md (#220)
Completed the English translation. 0d455a4dbb5d976f34d72e673238b75fe6ac2bcd
---
docs/_print/index.html | 41 +++++----
docs/guides/_print/index.html | 41 +++++----
docs/guides/desgin-concept/index.html | 69 +++++---------
docs/guides/index.xml | 161 +++++++++++++++++----------------
docs/index.xml | 165 +++++++++++++++++-----------------
en/sitemap.xml | 2 +-
sitemap.xml | 2 +-
7 files changed, 240 insertions(+), 241 deletions(-)
diff --git a/docs/_print/index.html b/docs/_print/index.html
index 1ecefb0f..a1f21a33 100644
--- a/docs/_print/index.html
+++ b/docs/_print/index.html
@@ -6200,40 +6200,45 @@ The <code>gremlin(groovy)</code> written by the user in <code>HugeGraph-Studio</
</span></span><span style=display:flex><span>
</span></span><span style=display:flex><span><span style=color:#000>gremlin</span><span style=color:#ce5c00;font-weight:700>></span> <span style=color:#ce5c00;font-weight:700>:></span> <span style=color:#5c35cc;font-weight:700>@script</span>
</span></span><span style=display:flex><span><span style=color:#ce5c00;font-weight:700>==></span><span style=color:#0000cf;font-weight:700>6</span>
-</span></span></code></pre></div><p>For more information on the use of gremlin-console, please refer to <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop Official Website</a></p></div><div class=td-content style=page-break-before:always><h1 id=pg-d2c6535126cca927d2a9c893abde92a0>6 - GUIDES</h1></div><div class=td-content><h1 id=pg-dcb89d888ea6f4146ace522d76fe2776>6.1 - HugeGraph Architecture Overview</h1><h3 id=1-overview>1 Overview</h3><p>As a general-purpose graph d [...]
-RDF和Property Graph都是最基础、最有名的图表示模式,都能够表示各种图的实体关系建模。
-RDF是W3C标准,而Property Graph是工业标准,受到广大图数据库厂商的广泛支持。HugeGraph目前采用Property Graph。</p><p>HugeGraph对应的存储概念模型也是参考Property Graph而设计的,具体示例详见下图:(<em>此图为旧版设计已过时,请忽略它,后续更新</em>)</p><p><img src=/docs/images/design/PropertyGraph.png alt=image></p><p>在HugeGraph内部,每个顶点 / 边由唯一的 VertexId / EdgeId 标识,属性存储在对应点 / 边内部。而顶点与顶点之间的关系 / 映射则是通过边来存储的。</p><p>顶点属性值通过边指针方式存储时,如果要更新一个顶点特定的属性值直接通过覆盖写入即可,其弊端是冗余存储了VertexId;
-如果要更新关系的属性需要通过read-and-modify方式,先读取所有属性,修改部分属性,然后再写入存储系统,更新效率较低。
-从经验来看顶点属性的修改需求较多,而边的属性修改需求较少,例如PageRank和Graph Cluster等计算都需要频繁修改顶点的属性值。</p><h3 id=2-图分区方案>2. 图分区方案</h3><p>对于分布式图数据库而言,图的分区存储方式有两种:分别是边分割存储(Edge Cut)和点分割存储(Vertex Cut),如下图所示。
-使用Edge Cut方式存储图时,任何一个顶点只会出现在一台机器上,而边可能分布在不同机器上,这种存储方式有可能导致边多次存储。
-使用Vertex Cut方式存储图时,任何一条边只会出现在一台机器上,而每相同的一个点可能分布到不同机器上,这种存储方式可能会导致顶点多次存储。</p><p><img src=/docs/images/design/GraphCut.png alt=image></p><p>采用EdgeCut分区方案可以支持高性能的插入和更新操作,而VertexCut分区方案更适合静态图查询分析,因此EdgeCut适合OLTP图查询,VertexCut更适合OLAP的图查询。
-HugeGraph目前采用EdgeCut的分区方案。</p><h3 id=3-vertexid-策略>3. VertexId 策略</h3><p>HugeGraph的Vertex支持三种ID策略,在同一个图数据库中不同的VertexLabel可以使用不同的Id策略,目前HugeGraph支持的Id策略分别是:</p><ul><li>自动生成(AUTOMATIC):使用Snowflake算法自动生成全局唯一Id,Long类型;</li><li>主键(PRIMARY_KEY):通过VertexLabel+PrimaryKeyValues生成Id,String类型;</li><li>自定义(CUSTOMIZE_STRING|CUSTOMIZE_NUMBER):用户自定义Id,分为String和Long类型两种,需自己保证Id的唯一性;</li></ul><p>默认的Id策略是AUTOMATIC,如果用户调用primaryKeys()方法并设置了正确的PrimaryKeys,则自动启用PRIMARY_KEY策略。
-启用PRIMARY_KEY策略后HugeGraph能根据PrimaryKeys实现数据去重。</p><ol><li>AUTOMATIC ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span> [...]
+</span></span></code></pre></div><p>For more information on the use of gremlin-console, please refer to <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop Official Website</a></p></div><div class=td-content style=page-break-before:always><h1 id=pg-d2c6535126cca927d2a9c893abde92a0>6 - GUIDES</h1></div><div class=td-content><h1 id=pg-dcb89d888ea6f4146ace522d76fe2776>6.1 - HugeGraph Architecture Overview</h1><h3 id=1-overview>1 Overview</h3><p>As a general-purpose graph d [...]
+Both RDF and Property Graph are the most basic and well-known graph representation modes, and both can represent entity-relationship modeling of various graphs.
+RDF is a W3C standard, while Property Graph is an industry standard and is widely supported by graph database vendors. HugeGraph currently uses Property Graph.</p><p>The storage concept model corresponding to HugeGraph is also designed with reference to Property Graph. For specific examples, see the figure below:
+( This figure is outdated for the old version design, please ignore it and update it later )</p><p><img src=/docs/images/design/PropertyGraph.png alt=image></p><p>Inside HugeGraph, each vertex/edge is identified by a unique VertexId/EdgeId, and the attributes are stored inside the corresponding vertex/edge.
+The relationship/mapping between vertices is stored through edges.</p><p>When the vertex attribute value is stored by edge pointer, if you want to update a vertex-specific attribute value, you can directly write it by overwriting.
+The disadvantage is that the VertexId is redundantly stored; if you want to update the attribute of the relationship, you need to use the read-and-modify method ,
+read all attributes first, modify some attributes, and then write to the storage system, the update efficiency is low. According to experience, there are more
+requirements for modifying vertex attributes, but less for edge attributes. For example, calculations such as PageRank and Graph Cluster require frequent
+modification of vertex attribute values.</p><h3 id=2-graph-partition-scheme>2. Graph Partition Scheme</h3><p>For distributed graph databases, there are two partition storage methods for graphs: Edge Cut and Vertex Cut, as shown in the following figure. When using the
+Edge Cut method to store graphs, any vertex will only appear on one machine, while edges may be distributed on different machines. This storage method may lead
+to multiple storage of edges. When using the Vertex Cut method to store graphs, any edge will only appear on one machine, and each same point may be distributed
+to different machines. This storage method may result in multiple storage of vertices.</p><p><img src=/docs/images/design/GraphCut.png alt=image></p><p>The EdgeCut partition scheme can support high-performance insert and update operations, while the VertexCut partition scheme is more suitable for static graph query
+analysis, so EdgeCut is suitable for OLTP graph query, and VertexCut is more suitable for OLAP graph query. HugeGraph currently adopts the partition scheme of EdgeCut.</p><h3 id=3-vertexid-strategy>3. VertexId Strategy</h3><p>Vertex of HugeGraph supports three ID strategies. Different VertexLabels in the same graph database can use different Id strategies. Currently, the Id strategies
+supported by HugeGraph are:</p><ul><li>Automatic generation (AUTOMATIC): Use the Snowflake algorithm to automatically generate a globally unique Id, Long type;</li><li>Primary Key (PRIMARY_KEY): Generate Id through VertexLabel+PrimaryKeyValues, String type;</li><li>Custom (CUSTOMIZE_STRING|CUSTOMIZE_NUMBER): User-defined Id, which is divided into two types: String and Long, and you need to ensure the uniqueness of the Id yourself;</li></ul><p>The default Id policy is AUTOMATIC, if the us [...]
+After enabling the PRIMARY_KEY strategy, HugeGraph can implement data deduplication based on PrimaryKeys.</p><ol><li>AUTOMATIC ID Policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weig [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>useAutomaticId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span>< [...]
-</span></span></code></pre></div><ol start=2><li>PRIMARY_KEY ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><span s [...]
+</span></span></code></pre></div><ol start=2><li>PRIMARY_KEY ID policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><s [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>usePrimaryKeyId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>primaryKeys</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span>< [...]
-</span></span></code></pre></div><ol start=3><li>CUSTOMIZE_STRING ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><s [...]
+</span></span></code></pre></div><ol start=3><li>CUSTOMIZE_STRING ID Policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</sp [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>useCustomizeStringId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span> [...]
-</span></span></code></pre></div><ol start=4><li>CUSTOMIZE_NUMBER ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><s [...]
+</span></span></code></pre></div><ol start=4><li>CUSTOMIZE_NUMBER ID Policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</sp [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>useCustomizeNumberId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span> [...]
-</span></span></code></pre></div><p>如果用户需要Vertex去重,有三种方案分别是:</p><ol><li>采用PRIMARY_KEY策略,自动覆盖,适合大数据量批量插入,用户无法知道是否发生了覆盖行为</li><li>采用AUTOMATIC策略,read-and-modify,适合小数据量插入,用户可以明确知道是否发生覆盖</li><li>采用CUSTOMIZE_STRING或CUSTOMIZE_NUMBER策略,用户自己保证唯一</li></ol><h3 id=4-edgeid-策略>4. EdgeId 策略</h3><p>HugeGraph的EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合而成。其中<code>sortKey</code>是HugeGraph的一个重要概念。
-在Edge中加入<code>sortKey</code>作为Edge的唯一标识的原因有两个:</p><ol><li>如果两个顶点之间存在多条相同Label的边可通过<code>sortKey</code>来区分</li><li>对于SuperNode的节点,可以通过<code>sortKey</code>来排序截断。</li></ol><p>由于EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合,多次插入相同的Edge时HugeGraph会自动覆盖以实现去重。
-需要注意的是如果批量插入模式下Edge的属性也将会覆盖。</p><p>另外由于HugeGraph的EdgeId采用自动去重策略,对于self-loop(一个顶点存在一条指向自身的边)的情况下HugeGraph认为仅有一条边,对于采用AUTOMATIC策略的图数据库(例如TitianDB
-)则会认为该图存在两条边。</p><blockquote><p>HugeGraph的边仅支持有向边,无向边可以创建Out和In两条边来实现。</p></blockquote><h3 id=5-hugegraph-transaction-overview>5. HugeGraph transaction overview</h3><h5 id=tinkerpop事务概述>TinkerPop事务概述</h5><p>TinkerPop transaction事务是指对数据库执行操作的工作单元,一个事务内的一组操作要么执行成功,要么全部失败。
-详细介绍请参考TinkerPop官方文档:http://tinkerpop.apache.org/docs/current/reference/#transactions</p><h5 id=tinkerpop事务操作接口>TinkerPop事务操作接口</h5><ul><li>open 打开事务</li><li>commit 提交事务</li><li>rollback 回滚事务</li><li>close 关闭事务</li></ul><h5 id=tinkerpop事务规范>TinkerPop事务规范</h5><ul><li>事务必须显式提交后才可生效(未提交时修改操作只有本事务内查询可看到)</li><li>事务必须打开之后才可提交或回滚</li><li>如果事务设置自动打开则无需显式打开(默认方式),如果设置手动打开则必须显式打开</li><li>可设置事务关闭时:自动提交、自动回滚(默认方式)、手动(禁止显式关闭)等3种模式</li><li>事务在提交或回滚后必须是关闭状态</li><li>事务在查询后必须是打开状态</li><li>事务(非threaded t [...]
+</span></span></code></pre></div><p>If users need Vertex deduplication, there are three options:</p><ol><li>Adopt PRIMARY_KEY strategy, automatic overwriting, suitable for batch insertion of large amount of data, users cannot know whether overwriting has occurred</li><li>Adopt AUTOMATIC strategy, read-and-modify, suitable for small data insertion, users can clearly know whether overwriting occurs</li><li>Using the CUSTOMIZE_STRING or CUSTOMIZE_NUMBER strategy, the user guarantees the uni [...]
+There are two reasons for adding Edge sortKeyas the unique ID of Edge:</p><ol><li>If there are multiple edges of the same Label between two vertices, they can be sortKeydistinguished by</li><li>For SuperNode nodes, it can be sortKeysorted and truncated by.</li></ol><p>Since EdgeId is composed of <code>srcVertexId</code> + <code>edgeLabel</code> + <code>sortKey</code> + <code>tgtVertexId</code>, HugeGraph will automatically overwrite when the same Edge is inserted
+multiple times to achieve deduplication. It should be noted that the properties of Edge will also be overwritten in the batch insert mode.</p><p>In addition, because HugeGraph’s EdgeId adopts an automatic deduplication strategy, HugeGraph considers that there is only one edge in the case of self-loop
+(a vertex has an edge pointing to itself). The graph has two edges.</p><blockquote><p>The edges of HugeGraph only support directed edges, and undirected edges can be realized by creating two edges, Out and In.</p></blockquote><h3 id=5-hugegraph-transaction-overview>5. HugeGraph transaction overview</h3><h5 id=tinkerpop-transaction-overview>TinkerPop transaction overview</h5><p>A TinkerPop transaction refers to a unit of work that performs operations on the database. A set of operations w [...]
</span></span><span style=display:flex><span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>final</span> <span style=color:#000>CountDownLatch</span> <span style=color:#000>latchUncommit</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#204a87;font-weight:700>new</span> <span style=color:#000>CountDownLatch</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>1</span><span style=color:#ce5c00;font-weight:700>);</span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>final</span> <span style=color:#000>CountDownLatch</span> <span style=color:#000>latchRollback</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#204a87;font-weight:700>new</span> <span style=color:#000>CountDownLatch</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>1</span><span style=color:#ce5c00;font-weight:700>);</span>
@@ -6284,7 +6289,7 @@ HugeGraph目前采用EdgeCut的分区方案。</p><h3 id=3-vertexid-策略>3. Ve
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>assert</span> <span style=color:#ce5c00;font-weight:700>!</span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertices</span><span style=color:#ce5c00;font-weight:700>().</span><span style=color:#c4a000>hasNext</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>assert</span> <span style=color:#ce5c00;font-weight:700>!</span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>edges</span><span style=color:#ce5c00;font-weight:700>().</span><span style=color:#c4a000>hasNext</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>}</span>
-</span></span></code></pre></div><h5 id=事务实现原理>事务实现原理</h5><ul><li>服务端内部通过将事务与线程绑定实现隔离(ThreadLocal)</li><li>本事务未提交的内容按照时间顺序覆盖老数据以供本事务查询最新版本数据</li><li>底层依赖后端数据库保证事务原子性操作(如Cassandra/RocksDB的batch接口均保证原子性)</li></ul><h6 id=注意><em>注意</em></h6><blockquote><p>RESTful API暂时未暴露事务接口</p></blockquote><blockquote><p>TinkerPop API允许打开事务,请求完成时会自动关闭(Gremlin Server强制关闭)</p></blockquote></div><div class=td-content style=page-break-before:always><h1 id=pg-96a920d19e01666d95eded506d502ab4>6.3 - HugeGraph Plu [...]
+</span></span></code></pre></div><h5 id=principle-of-transaction-realization>Principle of transaction realization</h5><ul><li>The server internally realizes isolation by binding transactions to threads (ThreadLocal)</li><li>The uncommitted content of this transaction overwrites the old data in chronological order for this transaction to query the latest version of data</li><li>The bottom layer relies on the back-end database to ensure transaction atomicity (for example, the batch interfa [...]
</span></span><span style=display:flex><span>
</span></span><span style=display:flex><span><span style=color:#204a87;font-weight:700><project</span> <span style=color:#c4a000>xmlns=</span><span style=color:#4e9a06>"http://maven.apache.org/POM/4.0.0"</span>
</span></span><span style=display:flex><span> <span style=color:#c4a000>xmlns:xsi=</span><span style=color:#4e9a06>"http://www.w3.org/2001/XMLSchema-instance"</span>
diff --git a/docs/guides/_print/index.html b/docs/guides/_print/index.html
index 37c3e9a9..6f2891bb 100644
--- a/docs/guides/_print/index.html
+++ b/docs/guides/_print/index.html
@@ -1,39 +1,44 @@
<!doctype html><html lang=en class=no-js><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=generator content="Hugo 0.102.3"><link rel=canonical type=text/html href=/docs/guides/><link rel=alternate type=application/rss+xml href=/docs/guides/index.xml><meta name=robots content="noindex, nofollow"><link rel="shortcut icon" href=/favicons/favicon.ico><link rel=apple-touch-icon href=/favicons/apple-touch-icon-180x180.png si [...]
<link rel=stylesheet href=/css/prism.css><script type=application/javascript>var doNotTrack=!1;doNotTrack||(window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)},ga.l=+new Date,ga("create","UA-00000000-0","auto"),ga("send","pageview"))</script><script async src=https://www.google-analytics.com/analytics.js></script></head><body class=td-section><header><nav class="js-navbar-scroll navbar navbar-expand navbar-dark flex-column flex-md-row td-navbar"><a class=navbar-brand href=/> [...]
-<a href=# onclick="return print(),!1">Click here to print</a>.</p><p><a href=/docs/guides/>Return to the regular view of this page</a>.</p></div><h1 class=title>GUIDES</h1><ul><li>1: <a href=#pg-dcb89d888ea6f4146ace522d76fe2776>HugeGraph Architecture Overview</a></li><li>2: <a href=#pg-3d0f9ef831ef5d7d11acfb09140359fa>HugeGraph Design Concepts</a></li><li>3: <a href=#pg-96a920d19e01666d95eded506d502ab4>HugeGraph Plugin机制及插件扩展流程</a></li><li>4: <a href=#pg-2c9db416c8d78f898d52c91ec12535d4> [...]
-RDF和Property Graph都是最基础、最有名的图表示模式,都能够表示各种图的实体关系建模。
-RDF是W3C标准,而Property Graph是工业标准,受到广大图数据库厂商的广泛支持。HugeGraph目前采用Property Graph。</p><p>HugeGraph对应的存储概念模型也是参考Property Graph而设计的,具体示例详见下图:(<em>此图为旧版设计已过时,请忽略它,后续更新</em>)</p><p><img src=/docs/images/design/PropertyGraph.png alt=image></p><p>在HugeGraph内部,每个顶点 / 边由唯一的 VertexId / EdgeId 标识,属性存储在对应点 / 边内部。而顶点与顶点之间的关系 / 映射则是通过边来存储的。</p><p>顶点属性值通过边指针方式存储时,如果要更新一个顶点特定的属性值直接通过覆盖写入即可,其弊端是冗余存储了VertexId;
-如果要更新关系的属性需要通过read-and-modify方式,先读取所有属性,修改部分属性,然后再写入存储系统,更新效率较低。
-从经验来看顶点属性的修改需求较多,而边的属性修改需求较少,例如PageRank和Graph Cluster等计算都需要频繁修改顶点的属性值。</p><h3 id=2-图分区方案>2. 图分区方案</h3><p>对于分布式图数据库而言,图的分区存储方式有两种:分别是边分割存储(Edge Cut)和点分割存储(Vertex Cut),如下图所示。
-使用Edge Cut方式存储图时,任何一个顶点只会出现在一台机器上,而边可能分布在不同机器上,这种存储方式有可能导致边多次存储。
-使用Vertex Cut方式存储图时,任何一条边只会出现在一台机器上,而每相同的一个点可能分布到不同机器上,这种存储方式可能会导致顶点多次存储。</p><p><img src=/docs/images/design/GraphCut.png alt=image></p><p>采用EdgeCut分区方案可以支持高性能的插入和更新操作,而VertexCut分区方案更适合静态图查询分析,因此EdgeCut适合OLTP图查询,VertexCut更适合OLAP的图查询。
-HugeGraph目前采用EdgeCut的分区方案。</p><h3 id=3-vertexid-策略>3. VertexId 策略</h3><p>HugeGraph的Vertex支持三种ID策略,在同一个图数据库中不同的VertexLabel可以使用不同的Id策略,目前HugeGraph支持的Id策略分别是:</p><ul><li>自动生成(AUTOMATIC):使用Snowflake算法自动生成全局唯一Id,Long类型;</li><li>主键(PRIMARY_KEY):通过VertexLabel+PrimaryKeyValues生成Id,String类型;</li><li>自定义(CUSTOMIZE_STRING|CUSTOMIZE_NUMBER):用户自定义Id,分为String和Long类型两种,需自己保证Id的唯一性;</li></ul><p>默认的Id策略是AUTOMATIC,如果用户调用primaryKeys()方法并设置了正确的PrimaryKeys,则自动启用PRIMARY_KEY策略。
-启用PRIMARY_KEY策略后HugeGraph能根据PrimaryKeys实现数据去重。</p><ol><li>AUTOMATIC ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span> [...]
+<a href=# onclick="return print(),!1">Click here to print</a>.</p><p><a href=/docs/guides/>Return to the regular view of this page</a>.</p></div><h1 class=title>GUIDES</h1><ul><li>1: <a href=#pg-dcb89d888ea6f4146ace522d76fe2776>HugeGraph Architecture Overview</a></li><li>2: <a href=#pg-3d0f9ef831ef5d7d11acfb09140359fa>HugeGraph Design Concepts</a></li><li>3: <a href=#pg-96a920d19e01666d95eded506d502ab4>HugeGraph Plugin机制及插件扩展流程</a></li><li>4: <a href=#pg-2c9db416c8d78f898d52c91ec12535d4> [...]
+Both RDF and Property Graph are the most basic and well-known graph representation modes, and both can represent entity-relationship modeling of various graphs.
+RDF is a W3C standard, while Property Graph is an industry standard and is widely supported by graph database vendors. HugeGraph currently uses Property Graph.</p><p>The storage concept model corresponding to HugeGraph is also designed with reference to Property Graph. For specific examples, see the figure below:
+( This figure is outdated for the old version design, please ignore it and update it later )</p><p><img src=/docs/images/design/PropertyGraph.png alt=image></p><p>Inside HugeGraph, each vertex/edge is identified by a unique VertexId/EdgeId, and the attributes are stored inside the corresponding vertex/edge.
+The relationship/mapping between vertices is stored through edges.</p><p>When the vertex attribute value is stored by edge pointer, if you want to update a vertex-specific attribute value, you can directly write it by overwriting.
+The disadvantage is that the VertexId is redundantly stored; if you want to update the attribute of the relationship, you need to use the read-and-modify method ,
+read all attributes first, modify some attributes, and then write to the storage system, the update efficiency is low. According to experience, there are more
+requirements for modifying vertex attributes, but less for edge attributes. For example, calculations such as PageRank and Graph Cluster require frequent
+modification of vertex attribute values.</p><h3 id=2-graph-partition-scheme>2. Graph Partition Scheme</h3><p>For distributed graph databases, there are two partition storage methods for graphs: Edge Cut and Vertex Cut, as shown in the following figure. When using the
+Edge Cut method to store graphs, any vertex will only appear on one machine, while edges may be distributed on different machines. This storage method may lead
+to multiple storage of edges. When using the Vertex Cut method to store graphs, any edge will only appear on one machine, and each same point may be distributed
+to different machines. This storage method may result in multiple storage of vertices.</p><p><img src=/docs/images/design/GraphCut.png alt=image></p><p>The EdgeCut partition scheme can support high-performance insert and update operations, while the VertexCut partition scheme is more suitable for static graph query
+analysis, so EdgeCut is suitable for OLTP graph query, and VertexCut is more suitable for OLAP graph query. HugeGraph currently adopts the partition scheme of EdgeCut.</p><h3 id=3-vertexid-strategy>3. VertexId Strategy</h3><p>Vertex of HugeGraph supports three ID strategies. Different VertexLabels in the same graph database can use different Id strategies. Currently, the Id strategies
+supported by HugeGraph are:</p><ul><li>Automatic generation (AUTOMATIC): Use the Snowflake algorithm to automatically generate a globally unique Id, Long type;</li><li>Primary Key (PRIMARY_KEY): Generate Id through VertexLabel+PrimaryKeyValues, String type;</li><li>Custom (CUSTOMIZE_STRING|CUSTOMIZE_NUMBER): User-defined Id, which is divided into two types: String and Long, and you need to ensure the uniqueness of the Id yourself;</li></ul><p>The default Id policy is AUTOMATIC, if the us [...]
+After enabling the PRIMARY_KEY strategy, HugeGraph can implement data deduplication based on PrimaryKeys.</p><ol><li>AUTOMATIC ID Policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weig [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>useAutomaticId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span>< [...]
-</span></span></code></pre></div><ol start=2><li>PRIMARY_KEY ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><span s [...]
+</span></span></code></pre></div><ol start=2><li>PRIMARY_KEY ID policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><s [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>usePrimaryKeyId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>primaryKeys</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span>< [...]
-</span></span></code></pre></div><ol start=3><li>CUSTOMIZE_STRING ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><s [...]
+</span></span></code></pre></div><ol start=3><li>CUSTOMIZE_STRING ID Policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</sp [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>useCustomizeStringId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span> [...]
-</span></span></code></pre></div><ol start=4><li>CUSTOMIZE_NUMBER ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><s [...]
+</span></span></code></pre></div><ol start=4><li>CUSTOMIZE_NUMBER ID Policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</sp [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>useCustomizeNumberId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span> [...]
-</span></span></code></pre></div><p>如果用户需要Vertex去重,有三种方案分别是:</p><ol><li>采用PRIMARY_KEY策略,自动覆盖,适合大数据量批量插入,用户无法知道是否发生了覆盖行为</li><li>采用AUTOMATIC策略,read-and-modify,适合小数据量插入,用户可以明确知道是否发生覆盖</li><li>采用CUSTOMIZE_STRING或CUSTOMIZE_NUMBER策略,用户自己保证唯一</li></ol><h3 id=4-edgeid-策略>4. EdgeId 策略</h3><p>HugeGraph的EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合而成。其中<code>sortKey</code>是HugeGraph的一个重要概念。
-在Edge中加入<code>sortKey</code>作为Edge的唯一标识的原因有两个:</p><ol><li>如果两个顶点之间存在多条相同Label的边可通过<code>sortKey</code>来区分</li><li>对于SuperNode的节点,可以通过<code>sortKey</code>来排序截断。</li></ol><p>由于EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合,多次插入相同的Edge时HugeGraph会自动覆盖以实现去重。
-需要注意的是如果批量插入模式下Edge的属性也将会覆盖。</p><p>另外由于HugeGraph的EdgeId采用自动去重策略,对于self-loop(一个顶点存在一条指向自身的边)的情况下HugeGraph认为仅有一条边,对于采用AUTOMATIC策略的图数据库(例如TitianDB
-)则会认为该图存在两条边。</p><blockquote><p>HugeGraph的边仅支持有向边,无向边可以创建Out和In两条边来实现。</p></blockquote><h3 id=5-hugegraph-transaction-overview>5. HugeGraph transaction overview</h3><h5 id=tinkerpop事务概述>TinkerPop事务概述</h5><p>TinkerPop transaction事务是指对数据库执行操作的工作单元,一个事务内的一组操作要么执行成功,要么全部失败。
-详细介绍请参考TinkerPop官方文档:http://tinkerpop.apache.org/docs/current/reference/#transactions</p><h5 id=tinkerpop事务操作接口>TinkerPop事务操作接口</h5><ul><li>open 打开事务</li><li>commit 提交事务</li><li>rollback 回滚事务</li><li>close 关闭事务</li></ul><h5 id=tinkerpop事务规范>TinkerPop事务规范</h5><ul><li>事务必须显式提交后才可生效(未提交时修改操作只有本事务内查询可看到)</li><li>事务必须打开之后才可提交或回滚</li><li>如果事务设置自动打开则无需显式打开(默认方式),如果设置手动打开则必须显式打开</li><li>可设置事务关闭时:自动提交、自动回滚(默认方式)、手动(禁止显式关闭)等3种模式</li><li>事务在提交或回滚后必须是关闭状态</li><li>事务在查询后必须是打开状态</li><li>事务(非threaded t [...]
+</span></span></code></pre></div><p>If users need Vertex deduplication, there are three options:</p><ol><li>Adopt PRIMARY_KEY strategy, automatic overwriting, suitable for batch insertion of large amount of data, users cannot know whether overwriting has occurred</li><li>Adopt AUTOMATIC strategy, read-and-modify, suitable for small data insertion, users can clearly know whether overwriting occurs</li><li>Using the CUSTOMIZE_STRING or CUSTOMIZE_NUMBER strategy, the user guarantees the uni [...]
+There are two reasons for adding Edge sortKeyas the unique ID of Edge:</p><ol><li>If there are multiple edges of the same Label between two vertices, they can be sortKeydistinguished by</li><li>For SuperNode nodes, it can be sortKeysorted and truncated by.</li></ol><p>Since EdgeId is composed of <code>srcVertexId</code> + <code>edgeLabel</code> + <code>sortKey</code> + <code>tgtVertexId</code>, HugeGraph will automatically overwrite when the same Edge is inserted
+multiple times to achieve deduplication. It should be noted that the properties of Edge will also be overwritten in the batch insert mode.</p><p>In addition, because HugeGraph’s EdgeId adopts an automatic deduplication strategy, HugeGraph considers that there is only one edge in the case of self-loop
+(a vertex has an edge pointing to itself). The graph has two edges.</p><blockquote><p>The edges of HugeGraph only support directed edges, and undirected edges can be realized by creating two edges, Out and In.</p></blockquote><h3 id=5-hugegraph-transaction-overview>5. HugeGraph transaction overview</h3><h5 id=tinkerpop-transaction-overview>TinkerPop transaction overview</h5><p>A TinkerPop transaction refers to a unit of work that performs operations on the database. A set of operations w [...]
</span></span><span style=display:flex><span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>final</span> <span style=color:#000>CountDownLatch</span> <span style=color:#000>latchUncommit</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#204a87;font-weight:700>new</span> <span style=color:#000>CountDownLatch</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>1</span><span style=color:#ce5c00;font-weight:700>);</span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>final</span> <span style=color:#000>CountDownLatch</span> <span style=color:#000>latchRollback</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#204a87;font-weight:700>new</span> <span style=color:#000>CountDownLatch</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>1</span><span style=color:#ce5c00;font-weight:700>);</span>
@@ -84,7 +89,7 @@ HugeGraph目前采用EdgeCut的分区方案。</p><h3 id=3-vertexid-策略>3. Ve
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>assert</span> <span style=color:#ce5c00;font-weight:700>!</span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertices</span><span style=color:#ce5c00;font-weight:700>().</span><span style=color:#c4a000>hasNext</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>assert</span> <span style=color:#ce5c00;font-weight:700>!</span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>edges</span><span style=color:#ce5c00;font-weight:700>().</span><span style=color:#c4a000>hasNext</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>}</span>
-</span></span></code></pre></div><h5 id=事务实现原理>事务实现原理</h5><ul><li>服务端内部通过将事务与线程绑定实现隔离(ThreadLocal)</li><li>本事务未提交的内容按照时间顺序覆盖老数据以供本事务查询最新版本数据</li><li>底层依赖后端数据库保证事务原子性操作(如Cassandra/RocksDB的batch接口均保证原子性)</li></ul><h6 id=注意><em>注意</em></h6><blockquote><p>RESTful API暂时未暴露事务接口</p></blockquote><blockquote><p>TinkerPop API允许打开事务,请求完成时会自动关闭(Gremlin Server强制关闭)</p></blockquote></div><div class=td-content style=page-break-before:always><h1 id=pg-96a920d19e01666d95eded506d502ab4>3 - HugeGraph Plugi [...]
+</span></span></code></pre></div><h5 id=principle-of-transaction-realization>Principle of transaction realization</h5><ul><li>The server internally realizes isolation by binding transactions to threads (ThreadLocal)</li><li>The uncommitted content of this transaction overwrites the old data in chronological order for this transaction to query the latest version of data</li><li>The bottom layer relies on the back-end database to ensure transaction atomicity (for example, the batch interfa [...]
</span></span><span style=display:flex><span>
</span></span><span style=display:flex><span><span style=color:#204a87;font-weight:700><project</span> <span style=color:#c4a000>xmlns=</span><span style=color:#4e9a06>"http://maven.apache.org/POM/4.0.0"</span>
</span></span><span style=display:flex><span> <span style=color:#c4a000>xmlns:xsi=</span><span style=color:#4e9a06>"http://www.w3.org/2001/XMLSchema-instance"</span>
diff --git a/docs/guides/desgin-concept/index.html b/docs/guides/desgin-concept/index.html
index 754f55cd..f5cb2643 100644
--- a/docs/guides/desgin-concept/index.html
+++ b/docs/guides/desgin-concept/index.html
@@ -1,70 +1,49 @@
<!doctype html><html lang=en class=no-js><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=generator content="Hugo 0.102.3"><meta name=robots content="index, follow"><link rel="shortcut icon" href=/favicons/favicon.ico><link rel=apple-touch-icon href=/favicons/apple-touch-icon-180x180.png sizes=180x180><link rel=icon type=image/png href=/favicons/favicon-16x16.png sizes=16x16><link rel=icon type=image/png href=/favicons [...]
-常见的图数据表示模型有两种,分别是RDF(Resource Description Framework)模型和属性图(Property Graph)模型。
-RDF和Property Graph都是最基础、最有名的图表示模式,都能够表示各种图的实体关系建模。
-RDF …"><meta property="og:title" content="HugeGraph Design Concepts"><meta property="og:description" content="1. Property Graph 常见的图数据表示模型有两种,分别是RDF(Resource Description Framework)模型和属性图(Property Graph)模型。 RDF和Property Graph都是最基础、最有名的图表示模式,都能够表示各种图的实体关系建模。 RDF是W3C标准,而Property Graph是工业标准,受到广大图数据库厂商的广泛支持。HugeGraph目前采用Property Graph。
-HugeGraph对应的存储概念模型也是参考Property Graph而设计的,具体示例详见下图:(此图为旧版设计已过时,请忽略它,后续更新)
-在HugeGraph内部,每个顶点 / 边由唯一的 VertexId / EdgeId 标识,属性存储在对应点 / 边内部。而顶点与顶点之间的关系 / 映射则是通过边来存储的。
-顶点属性值通过边指针方式存储时,如果要更新一个顶点特定的属性值直接通过覆盖写入即可,其弊端是冗余存储了VertexId; 如果要更新关系的属性需要通过read-and-modify方式,先读取所有属性,修改部分属性,然后再写入存储系统,更新效率较低。 从经验来看顶点属性的修改需求较多,而边的属性修改需求较少,例如PageRank和Graph Cluster等计算都需要频繁修改顶点的属性值。
-2. 图分区方案 对于分布式图数据库而言,图的分区存储方式有两种:分别是边分割存储(Edge Cut)和点分割存储(Vertex Cut),如下图所示。 使用Edge Cut方式存储图时,任何一个顶点只会出现在一台机器上,而边可能分布在不同机器上,这种存储方式有可能导致边多次存储。 使用Vertex Cut方式存储图时,任何一条边只会出现在一台机器上,而每相同的一个点可能分布到不同机器上,这种存储方式可能会导致顶点多次存储。
-采用EdgeCut分区方案可以支持高性能的插入和更新操作,而VertexCut分区方案更适合静态图查询分析,因此EdgeCut适合OLTP图查询,VertexCut更适合OLAP的图查询。 HugeGraph目前采用EdgeCut的分区方案。
-3. VertexId 策略 HugeGraph的Vertex支持三种ID策略,在同一个图数据库中不同的VertexLabel可以使用不同的Id策略,目前HugeGraph支持的Id策略分别是:
-自动生成(AUTOMATIC):使用Snowflake算法自动生成全局唯一Id,Long类型; 主键(PRIMARY_KEY):通过VertexLabel+PrimaryKeyValues生成Id,String类型; 自定义(CUSTOMIZE_STRING|CUSTOMIZE_NUMBER):用户自定义Id,分为String和Long类型两种,需自己保证Id的唯一性; 默认的Id策略是AUTOMATIC,如果用户调用primaryKeys()方法并设置了正确的PrimaryKeys,则自动启用PRIMARY_KEY策略。 启用PRIMARY_KEY策略后HugeGraph能根据PrimaryKeys实现数据去重。
-AUTOMATIC ID策略 schema.vertexLabel("person") .useAutomaticId() .properties("name", "age", "city") .create(); graph.addVertex(T.label, "person","name", "marko", "age", 18, "city", "Beijing"); PRIMARY_KEY ID策略 schema.vertexLabel("person") .usePrimaryKeyId() .properties("name", "age", "city") ."><meta property="og:type" content="article"><meta property="og:url" content="/docs/guide [...]
-HugeGraph对应的存储概念模型也是参考Property Graph而设计的,具体示例详见下图:(此图为旧版设计已过时,请忽略它,后续更新)
-在HugeGraph内部,每个顶点 / 边由唯一的 VertexId / EdgeId 标识,属性存储在对应点 / 边内部。而顶点与顶点之间的关系 / 映射则是通过边来存储的。
-顶点属性值通过边指针方式存储时,如果要更新一个顶点特定的属性值直接通过覆盖写入即可,其弊端是冗余存储了VertexId; 如果要更新关系的属性需要通过read-and-modify方式,先读取所有属性,修改部分属性,然后再写入存储系统,更新效率较低。 从经验来看顶点属性的修改需求较多,而边的属性修改需求较少,例如PageRank和Graph Cluster等计算都需要频繁修改顶点的属性值。
-2. 图分区方案 对于分布式图数据库而言,图的分区存储方式有两种:分别是边分割存储(Edge Cut)和点分割存储(Vertex Cut),如下图所示。 使用Edge Cut方式存储图时,任何一个顶点只会出现在一台机器上,而边可能分布在不同机器上,这种存储方式有可能导致边多次存储。 使用Vertex Cut方式存储图时,任何一条边只会出现在一台机器上,而每相同的一个点可能分布到不同机器上,这种存储方式可能会导致顶点多次存储。
-采用EdgeCut分区方案可以支持高性能的插入和更新操作,而VertexCut分区方案更适合静态图查询分析,因此EdgeCut适合OLTP图查询,VertexCut更适合OLAP的图查询。 HugeGraph目前采用EdgeCut的分区方案。
-3. VertexId 策略 HugeGraph的Vertex支持三种ID策略,在同一个图数据库中不同的VertexLabel可以使用不同的Id策略,目前HugeGraph支持的Id策略分别是:
-自动生成(AUTOMATIC):使用Snowflake算法自动生成全局唯一Id,Long类型; 主键(PRIMARY_KEY):通过VertexLabel+PrimaryKeyValues生成Id,String类型; 自定义(CUSTOMIZE_STRING|CUSTOMIZE_NUMBER):用户自定义Id,分为String和Long类型两种,需自己保证Id的唯一性; 默认的Id策略是AUTOMATIC,如果用户调用primaryKeys()方法并设置了正确的PrimaryKeys,则自动启用PRIMARY_KEY策略。 启用PRIMARY_KEY策略后HugeGraph能根据PrimaryKeys实现数据去重。
-AUTOMATIC ID策略 schema.vertexLabel("person") .useAutomaticId() .properties("name", "age", "city") .create(); graph.addVertex(T.label, "person","name", "marko", "age", 18, "city", "Beijing"); PRIMARY_KEY ID策略 schema.vertexLabel("person") .usePrimaryKeyId() .properties("name", "age", "city") ."><meta itemprop=dateModified content="2022-04-17T11:36:55+08:00"><meta itemprop=wordCoun [...]
-HugeGraph对应的存储概念模型也是参考Property Graph而设计的,具体示例详见下图:(此图为旧版设计已过时,请忽略它,后续更新)
-在HugeGraph内部,每个顶点 / 边由唯一的 VertexId / EdgeId 标识,属性存储在对应点 / 边内部。而顶点与顶点之间的关系 / 映射则是通过边来存储的。
-顶点属性值通过边指针方式存储时,如果要更新一个顶点特定的属性值直接通过覆盖写入即可,其弊端是冗余存储了VertexId; 如果要更新关系的属性需要通过read-and-modify方式,先读取所有属性,修改部分属性,然后再写入存储系统,更新效率较低。 从经验来看顶点属性的修改需求较多,而边的属性修改需求较少,例如PageRank和Graph Cluster等计算都需要频繁修改顶点的属性值。
-2. 图分区方案 对于分布式图数据库而言,图的分区存储方式有两种:分别是边分割存储(Edge Cut)和点分割存储(Vertex Cut),如下图所示。 使用Edge Cut方式存储图时,任何一个顶点只会出现在一台机器上,而边可能分布在不同机器上,这种存储方式有可能导致边多次存储。 使用Vertex Cut方式存储图时,任何一条边只会出现在一台机器上,而每相同的一个点可能分布到不同机器上,这种存储方式可能会导致顶点多次存储。
-采用EdgeCut分区方案可以支持高性能的插入和更新操作,而VertexCut分区方案更适合静态图查询分析,因此EdgeCut适合OLTP图查询,VertexCut更适合OLAP的图查询。 HugeGraph目前采用EdgeCut的分区方案。
-3. VertexId 策略 HugeGraph的Vertex支持三种ID策略,在同一个图数据库中不同的VertexLabel可以使用不同的Id策略,目前HugeGraph支持的Id策略分别是:
-自动生成(AUTOMATIC):使用Snowflake算法自动生成全局唯一Id,Long类型; 主键(PRIMARY_KEY):通过VertexLabel+PrimaryKeyValues生成Id,String类型; 自定义(CUSTOMIZE_STRING|CUSTOMIZE_NUMBER):用户自定义Id,分为String和Long类型两种,需自己保证Id的唯一性; 默认的Id策略是AUTOMATIC,如果用户调用primaryKeys()方法并设置了正确的PrimaryKeys,则自动启用PRIMARY_KEY策略。 启用PRIMARY_KEY策略后HugeGraph能根据PrimaryKeys实现数据去重。
-AUTOMATIC ID策略 schema.vertexLabel("person") .useAutomaticId() .properties("name", "age", "city") .create(); graph.addVertex(T.label, "person","name", "marko", "age", 18, "city", "Beijing"); PRIMARY_KEY ID策略 schema.vertexLabel("person") .usePrimaryKeyId() .properties("name", "age", "city") ."><link rel=preload href=/scss/main.min.ad1b0560bef9c54394313a5bc50d3313d4e56ea590ddc5cfb [...]
+There are two common graph data representation models, namely the RDF (Resource Description Framework) model and the Property Graph …"><meta property="og:title" content="HugeGraph Design Concepts"><meta property="og:description" content="1. Property Graph There are two common graph data representation models, namely the RDF (Resource Description Framework) model and the Property Graph (Property Graph) model. Both RDF and Property Graph are the most basic and well-known graph representati [...]
<link rel=stylesheet href=/css/prism.css><script type=application/javascript>var doNotTrack=!1;doNotTrack||(window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)},ga.l=+new Date,ga("create","UA-00000000-0","auto"),ga("send","pageview"))</script><script async src=https://www.google-analytics.com/analytics.js></script></head><body class=td-page><header><nav class="js-navbar-scroll navbar navbar-expand navbar-dark flex-column flex-md-row td-navbar"><a class=navbar-brand href=/><sp [...]
<a href=https://github.com/apache/incubator-hugegraph-doc/edit/master/content/en/docs/guides/desgin-concept.md class=td-page-meta--edit target=_blank rel=noopener><i class="fa fa-edit fa-fw"></i> Edit this page</a>
<a href="https://github.com/apache/incubator-hugegraph-doc/new/master/content/en/docs/guides/desgin-concept.md?filename=change-me.md&value=---%0Atitle%3A+%22Long+Page+Title%22%0AlinkTitle%3A+%22Short+Nav+Title%22%0Aweight%3A+100%0Adescription%3A+%3E-%0A+++++Page+description+for+heading+and+indexes.%0A---%0A%0A%23%23+Heading%0A%0AEdit+this+template+to+create+your+new+page.%0A%0A%2A+Give+it+a+good+name%2C+ending+in+%60.md%60+-+e.g.+%60getting-started.md%60%0A%2A+Edit+the+%22front+matter%22 [...]
<a href="https://github.com/apache/incubator-hugegraph-doc/issues/new?title=HugeGraph%20Design%20Concepts" class=td-page-meta--issue target=_blank rel=noopener><i class="fab fa-github fa-fw"></i> Create documentation issue</a>
<a href=https://github.com/apache/incubator-hugegraph/issues/new class=td-page-meta--project-issue target=_blank rel=noopener><i class="fas fa-tasks fa-fw"></i> Create project issue</a>
-<a id=print href=/docs/guides/_print/><i class="fa fa-print fa-fw"></i> Print entire section</a></div><div class=td-toc><nav id=TableOfContents><ul><li><ul><li><a href=#1-property-graph>1. Property Graph</a></li><li><a href=#2-图分区方案>2. 图分区方案</a></li><li><a href=#3-vertexid-策略>3. VertexId 策略</a></li><li><a href=#4-edgeid-策略>4. EdgeId 策略</a></li><li><a href=#5-hugegraph-transaction-overview>5. HugeGraph transaction overview</a></li></ul></li></ul></nav></div></aside><main class="col-12 col [...]
-RDF和Property Graph都是最基础、最有名的图表示模式,都能够表示各种图的实体关系建模。
-RDF是W3C标准,而Property Graph是工业标准,受到广大图数据库厂商的广泛支持。HugeGraph目前采用Property Graph。</p><p>HugeGraph对应的存储概念模型也是参考Property Graph而设计的,具体示例详见下图:(<em>此图为旧版设计已过时,请忽略它,后续更新</em>)</p><p><img src=/docs/images/design/PropertyGraph.png alt=image></p><p>在HugeGraph内部,每个顶点 / 边由唯一的 VertexId / EdgeId 标识,属性存储在对应点 / 边内部。而顶点与顶点之间的关系 / 映射则是通过边来存储的。</p><p>顶点属性值通过边指针方式存储时,如果要更新一个顶点特定的属性值直接通过覆盖写入即可,其弊端是冗余存储了VertexId;
-如果要更新关系的属性需要通过read-and-modify方式,先读取所有属性,修改部分属性,然后再写入存储系统,更新效率较低。
-从经验来看顶点属性的修改需求较多,而边的属性修改需求较少,例如PageRank和Graph Cluster等计算都需要频繁修改顶点的属性值。</p><h3 id=2-图分区方案>2. 图分区方案</h3><p>对于分布式图数据库而言,图的分区存储方式有两种:分别是边分割存储(Edge Cut)和点分割存储(Vertex Cut),如下图所示。
-使用Edge Cut方式存储图时,任何一个顶点只会出现在一台机器上,而边可能分布在不同机器上,这种存储方式有可能导致边多次存储。
-使用Vertex Cut方式存储图时,任何一条边只会出现在一台机器上,而每相同的一个点可能分布到不同机器上,这种存储方式可能会导致顶点多次存储。</p><p><img src=/docs/images/design/GraphCut.png alt=image></p><p>采用EdgeCut分区方案可以支持高性能的插入和更新操作,而VertexCut分区方案更适合静态图查询分析,因此EdgeCut适合OLTP图查询,VertexCut更适合OLAP的图查询。
-HugeGraph目前采用EdgeCut的分区方案。</p><h3 id=3-vertexid-策略>3. VertexId 策略</h3><p>HugeGraph的Vertex支持三种ID策略,在同一个图数据库中不同的VertexLabel可以使用不同的Id策略,目前HugeGraph支持的Id策略分别是:</p><ul><li>自动生成(AUTOMATIC):使用Snowflake算法自动生成全局唯一Id,Long类型;</li><li>主键(PRIMARY_KEY):通过VertexLabel+PrimaryKeyValues生成Id,String类型;</li><li>自定义(CUSTOMIZE_STRING|CUSTOMIZE_NUMBER):用户自定义Id,分为String和Long类型两种,需自己保证Id的唯一性;</li></ul><p>默认的Id策略是AUTOMATIC,如果用户调用primaryKeys()方法并设置了正确的PrimaryKeys,则自动启用PRIMARY_KEY策略。
-启用PRIMARY_KEY策略后HugeGraph能根据PrimaryKeys实现数据去重。</p><ol><li>AUTOMATIC ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span> [...]
+<a id=print href=/docs/guides/_print/><i class="fa fa-print fa-fw"></i> Print entire section</a></div><div class=td-toc><nav id=TableOfContents><ul><li><ul><li><a href=#1-property-graph>1. Property Graph</a></li><li><a href=#2-graph-partition-scheme>2. Graph Partition Scheme</a></li><li><a href=#3-vertexid-strategy>3. VertexId Strategy</a></li><li><a href=#4-edgeid-policy>4. EdgeId policy</a></li><li><a href=#5-hugegraph-transaction-overview>5. HugeGraph transaction overview</a></li></ul [...]
+Both RDF and Property Graph are the most basic and well-known graph representation modes, and both can represent entity-relationship modeling of various graphs.
+RDF is a W3C standard, while Property Graph is an industry standard and is widely supported by graph database vendors. HugeGraph currently uses Property Graph.</p><p>The storage concept model corresponding to HugeGraph is also designed with reference to Property Graph. For specific examples, see the figure below:
+( This figure is outdated for the old version design, please ignore it and update it later )</p><p><img src=/docs/images/design/PropertyGraph.png alt=image></p><p>Inside HugeGraph, each vertex/edge is identified by a unique VertexId/EdgeId, and the attributes are stored inside the corresponding vertex/edge.
+The relationship/mapping between vertices is stored through edges.</p><p>When the vertex attribute value is stored by edge pointer, if you want to update a vertex-specific attribute value, you can directly write it by overwriting.
+The disadvantage is that the VertexId is redundantly stored; if you want to update the attribute of the relationship, you need to use the read-and-modify method ,
+read all attributes first, modify some attributes, and then write to the storage system, the update efficiency is low. According to experience, there are more
+requirements for modifying vertex attributes, but less for edge attributes. For example, calculations such as PageRank and Graph Cluster require frequent
+modification of vertex attribute values.</p><h3 id=2-graph-partition-scheme>2. Graph Partition Scheme</h3><p>For distributed graph databases, there are two partition storage methods for graphs: Edge Cut and Vertex Cut, as shown in the following figure. When using the
+Edge Cut method to store graphs, any vertex will only appear on one machine, while edges may be distributed on different machines. This storage method may lead
+to multiple storage of edges. When using the Vertex Cut method to store graphs, any edge will only appear on one machine, and each same point may be distributed
+to different machines. This storage method may result in multiple storage of vertices.</p><p><img src=/docs/images/design/GraphCut.png alt=image></p><p>The EdgeCut partition scheme can support high-performance insert and update operations, while the VertexCut partition scheme is more suitable for static graph query
+analysis, so EdgeCut is suitable for OLTP graph query, and VertexCut is more suitable for OLAP graph query. HugeGraph currently adopts the partition scheme of EdgeCut.</p><h3 id=3-vertexid-strategy>3. VertexId Strategy</h3><p>Vertex of HugeGraph supports three ID strategies. Different VertexLabels in the same graph database can use different Id strategies. Currently, the Id strategies
+supported by HugeGraph are:</p><ul><li>Automatic generation (AUTOMATIC): Use the Snowflake algorithm to automatically generate a globally unique Id, Long type;</li><li>Primary Key (PRIMARY_KEY): Generate Id through VertexLabel+PrimaryKeyValues, String type;</li><li>Custom (CUSTOMIZE_STRING|CUSTOMIZE_NUMBER): User-defined Id, which is divided into two types: String and Long, and you need to ensure the uniqueness of the Id yourself;</li></ul><p>The default Id policy is AUTOMATIC, if the us [...]
+After enabling the PRIMARY_KEY strategy, HugeGraph can implement data deduplication based on PrimaryKeys.</p><ol><li>AUTOMATIC ID Policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weig [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>useAutomaticId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span>< [...]
-</span></span></code></pre></div><ol start=2><li>PRIMARY_KEY ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><span s [...]
+</span></span></code></pre></div><ol start=2><li>PRIMARY_KEY ID policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><s [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>usePrimaryKeyId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>primaryKeys</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span>< [...]
-</span></span></code></pre></div><ol start=3><li>CUSTOMIZE_STRING ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><s [...]
+</span></span></code></pre></div><ol start=3><li>CUSTOMIZE_STRING ID Policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</sp [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>useCustomizeStringId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span> [...]
-</span></span></code></pre></div><ol start=4><li>CUSTOMIZE_NUMBER ID策略</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</span><s [...]
+</span></span></code></pre></div><ol start=4><li>CUSTOMIZE_NUMBER ID Policy</li></ol><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-java data-lang=java><span style=display:flex><span><span style=color:#000>schema</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertexLabel</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"person"</sp [...]
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>useCustomizeNumberId</span><span style=color:#ce5c00;font-weight:700>()</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>properties</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#4e9a06>"name"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"age"</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"city"</span><span style=color:#ce5c00;font-weight:700>)</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>create</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>addVertex</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>T</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>label</span><span style=color:#ce5c00;font-weight:700>,</span> <span style=color:#4e9a06>"person"</span><span style=color:#ce5c00;font-weight:700>,</span> [...]
-</span></span></code></pre></div><p>如果用户需要Vertex去重,有三种方案分别是:</p><ol><li>采用PRIMARY_KEY策略,自动覆盖,适合大数据量批量插入,用户无法知道是否发生了覆盖行为</li><li>采用AUTOMATIC策略,read-and-modify,适合小数据量插入,用户可以明确知道是否发生覆盖</li><li>采用CUSTOMIZE_STRING或CUSTOMIZE_NUMBER策略,用户自己保证唯一</li></ol><h3 id=4-edgeid-策略>4. EdgeId 策略</h3><p>HugeGraph的EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合而成。其中<code>sortKey</code>是HugeGraph的一个重要概念。
-在Edge中加入<code>sortKey</code>作为Edge的唯一标识的原因有两个:</p><ol><li>如果两个顶点之间存在多条相同Label的边可通过<code>sortKey</code>来区分</li><li>对于SuperNode的节点,可以通过<code>sortKey</code>来排序截断。</li></ol><p>由于EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合,多次插入相同的Edge时HugeGraph会自动覆盖以实现去重。
-需要注意的是如果批量插入模式下Edge的属性也将会覆盖。</p><p>另外由于HugeGraph的EdgeId采用自动去重策略,对于self-loop(一个顶点存在一条指向自身的边)的情况下HugeGraph认为仅有一条边,对于采用AUTOMATIC策略的图数据库(例如TitianDB
-)则会认为该图存在两条边。</p><blockquote><p>HugeGraph的边仅支持有向边,无向边可以创建Out和In两条边来实现。</p></blockquote><h3 id=5-hugegraph-transaction-overview>5. HugeGraph transaction overview</h3><h5 id=tinkerpop事务概述>TinkerPop事务概述</h5><p>TinkerPop transaction事务是指对数据库执行操作的工作单元,一个事务内的一组操作要么执行成功,要么全部失败。
-详细介绍请参考TinkerPop官方文档:http://tinkerpop.apache.org/docs/current/reference/#transactions</p><h5 id=tinkerpop事务操作接口>TinkerPop事务操作接口</h5><ul><li>open 打开事务</li><li>commit 提交事务</li><li>rollback 回滚事务</li><li>close 关闭事务</li></ul><h5 id=tinkerpop事务规范>TinkerPop事务规范</h5><ul><li>事务必须显式提交后才可生效(未提交时修改操作只有本事务内查询可看到)</li><li>事务必须打开之后才可提交或回滚</li><li>如果事务设置自动打开则无需显式打开(默认方式),如果设置手动打开则必须显式打开</li><li>可设置事务关闭时:自动提交、自动回滚(默认方式)、手动(禁止显式关闭)等3种模式</li><li>事务在提交或回滚后必须是关闭状态</li><li>事务在查询后必须是打开状态</li><li>事务(非threaded t [...]
+</span></span></code></pre></div><p>If users need Vertex deduplication, there are three options:</p><ol><li>Adopt PRIMARY_KEY strategy, automatic overwriting, suitable for batch insertion of large amount of data, users cannot know whether overwriting has occurred</li><li>Adopt AUTOMATIC strategy, read-and-modify, suitable for small data insertion, users can clearly know whether overwriting occurs</li><li>Using the CUSTOMIZE_STRING or CUSTOMIZE_NUMBER strategy, the user guarantees the uni [...]
+There are two reasons for adding Edge sortKeyas the unique ID of Edge:</p><ol><li>If there are multiple edges of the same Label between two vertices, they can be sortKeydistinguished by</li><li>For SuperNode nodes, it can be sortKeysorted and truncated by.</li></ol><p>Since EdgeId is composed of <code>srcVertexId</code> + <code>edgeLabel</code> + <code>sortKey</code> + <code>tgtVertexId</code>, HugeGraph will automatically overwrite when the same Edge is inserted
+multiple times to achieve deduplication. It should be noted that the properties of Edge will also be overwritten in the batch insert mode.</p><p>In addition, because HugeGraph’s EdgeId adopts an automatic deduplication strategy, HugeGraph considers that there is only one edge in the case of self-loop
+(a vertex has an edge pointing to itself). The graph has two edges.</p><blockquote><p>The edges of HugeGraph only support directed edges, and undirected edges can be realized by creating two edges, Out and In.</p></blockquote><h3 id=5-hugegraph-transaction-overview>5. HugeGraph transaction overview</h3><h5 id=tinkerpop-transaction-overview>TinkerPop transaction overview</h5><p>A TinkerPop transaction refers to a unit of work that performs operations on the database. A set of operations w [...]
</span></span><span style=display:flex><span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>final</span> <span style=color:#000>CountDownLatch</span> <span style=color:#000>latchUncommit</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#204a87;font-weight:700>new</span> <span style=color:#000>CountDownLatch</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>1</span><span style=color:#ce5c00;font-weight:700>);</span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>final</span> <span style=color:#000>CountDownLatch</span> <span style=color:#000>latchRollback</span> <span style=color:#ce5c00;font-weight:700>=</span> <span style=color:#204a87;font-weight:700>new</span> <span style=color:#000>CountDownLatch</span><span style=color:#ce5c00;font-weight:700>(</span><span style=color:#000>1</span><span style=color:#ce5c00;font-weight:700>);</span>
@@ -115,7 +94,7 @@ HugeGraph目前采用EdgeCut的分区方案。</p><h3 id=3-vertexid-策略>3. Ve
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>assert</span> <span style=color:#ce5c00;font-weight:700>!</span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>vertices</span><span style=color:#ce5c00;font-weight:700>().</span><span style=color:#c4a000>hasNext</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span> <span style=color:#204a87;font-weight:700>assert</span> <span style=color:#ce5c00;font-weight:700>!</span><span style=color:#000>graph</span><span style=color:#ce5c00;font-weight:700>.</span><span style=color:#c4a000>edges</span><span style=color:#ce5c00;font-weight:700>().</span><span style=color:#c4a000>hasNext</span><span style=color:#ce5c00;font-weight:700>();</span>
</span></span><span style=display:flex><span> <span style=color:#ce5c00;font-weight:700>}</span>
-</span></span></code></pre></div><h5 id=事务实现原理>事务实现原理</h5><ul><li>服务端内部通过将事务与线程绑定实现隔离(ThreadLocal)</li><li>本事务未提交的内容按照时间顺序覆盖老数据以供本事务查询最新版本数据</li><li>底层依赖后端数据库保证事务原子性操作(如Cassandra/RocksDB的batch接口均保证原子性)</li></ul><h6 id=注意><em>注意</em></h6><blockquote><p>RESTful API暂时未暴露事务接口</p></blockquote><blockquote><p>TinkerPop API允许打开事务,请求完成时会自动关闭(Gremlin Server强制关闭)</p></blockquote><style>.feedback--answer{display:inline-block}.feedback--answer-no{margin-left:1em}.feedback--response{display:none;margi [...]
+</span></span></code></pre></div><h5 id=principle-of-transaction-realization>Principle of transaction realization</h5><ul><li>The server internally realizes isolation by binding transactions to threads (ThreadLocal)</li><li>The uncommitted content of this transaction overwrites the old data in chronological order for this transaction to query the latest version of data</li><li>The bottom layer relies on the back-end database to ensure transaction atomicity (for example, the batch interfa [...]
<script src=https://cdn.jsdelivr.net/npm/bootstrap@4.6.1/dist/js/bootstrap.min.js integrity="sha512-UR25UO94eTnCVwjbXozyeVd6ZqpaAE9naiEUBK/A+QDbfSTQFhPGj5lOR6d8tsgbBk84Ggb5A3EkjsOgPRPcKA==" crossorigin=anonymous></script>
<script src=/js/tabpane-persist.js></script>
<script src=/js/main.min.aa9f4c5dae6a98b2c46277f4c56f1673a2b000d1756ce4ffae93784cab25e6d5.js integrity="sha256-qp9MXa5qmLLEYnf0xW8Wc6KwANF1bOT/rpN4TKsl5tU=" crossorigin=anonymous></script>
diff --git a/docs/guides/index.xml b/docs/guides/index.xml
index 0ed8790e..89bbb3fa 100644
--- a/docs/guides/index.xml
+++ b/docs/guides/index.xml
@@ -18,33 +18,39 @@
<li>HugeGraph-Computer: HugeGraph-Computer is a distributed graph processing system (OLAP).</li>
</ul></description></item><item><title>Docs: HugeGraph Design Concepts</title><link>/docs/guides/desgin-concept/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/docs/guides/desgin-concept/</guid><description>
<h3 id="1-property-graph">1. Property Graph</h3>
-<p>常见的图数据表示模型有两种,分别是RDF(Resource Description Framework)模型和属性图(Property Graph)模型。
-RDF和Property Graph都是最基础、最有名的图表示模式,都能够表示各种图的实体关系建模。
-RDF是W3C标准,而Property Graph是工业标准,受到广大图数据库厂商的广泛支持。HugeGraph目前采用Property Graph。</p>
-<p>HugeGraph对应的存储概念模型也是参考Property Graph而设计的,具体示例详见下图:(<em>此图为旧版设计已过时,请忽略它,后续更新</em>)</p>
+<p>There are two common graph data representation models, namely the RDF (Resource Description Framework) model and the Property Graph (Property Graph) model.
+Both RDF and Property Graph are the most basic and well-known graph representation modes, and both can represent entity-relationship modeling of various graphs.
+RDF is a W3C standard, while Property Graph is an industry standard and is widely supported by graph database vendors. HugeGraph currently uses Property Graph.</p>
+<p>The storage concept model corresponding to HugeGraph is also designed with reference to Property Graph. For specific examples, see the figure below:
+( This figure is outdated for the old version design, please ignore it and update it later )</p>
<p><img src="/docs/images/design/PropertyGraph.png" alt="image"></p>
-<p>在HugeGraph内部,每个顶点 / 边由唯一的 VertexId / EdgeId 标识,属性存储在对应点 / 边内部。而顶点与顶点之间的关系 / 映射则是通过边来存储的。</p>
-<p>顶点属性值通过边指针方式存储时,如果要更新一个顶点特定的属性值直接通过覆盖写入即可,其弊端是冗余存储了VertexId;
-如果要更新关系的属性需要通过read-and-modify方式,先读取所有属性,修改部分属性,然后再写入存储系统,更新效率较低。
-从经验来看顶点属性的修改需求较多,而边的属性修改需求较少,例如PageRank和Graph Cluster等计算都需要频繁修改顶点的属性值。</p>
-<h3 id="2-图分区方案">2. 图分区方案</h3>
-<p>对于分布式图数据库而言,图的分区存储方式有两种:分别是边分割存储(Edge Cut)和点分割存储(Vertex Cut),如下图所示。
-使用Edge Cut方式存储图时,任何一个顶点只会出现在一台机器上,而边可能分布在不同机器上,这种存储方式有可能导致边多次存储。
-使用Vertex Cut方式存储图时,任何一条边只会出现在一台机器上,而每相同的一个点可能分布到不同机器上,这种存储方式可能会导致顶点多次存储。</p>
+<p>Inside HugeGraph, each vertex/edge is identified by a unique VertexId/EdgeId, and the attributes are stored inside the corresponding vertex/edge.
+The relationship/mapping between vertices is stored through edges.</p>
+<p>When the vertex attribute value is stored by edge pointer, if you want to update a vertex-specific attribute value, you can directly write it by overwriting.
+The disadvantage is that the VertexId is redundantly stored; if you want to update the attribute of the relationship, you need to use the read-and-modify method ,
+read all attributes first, modify some attributes, and then write to the storage system, the update efficiency is low. According to experience, there are more
+requirements for modifying vertex attributes, but less for edge attributes. For example, calculations such as PageRank and Graph Cluster require frequent
+modification of vertex attribute values.</p>
+<h3 id="2-graph-partition-scheme">2. Graph Partition Scheme</h3>
+<p>For distributed graph databases, there are two partition storage methods for graphs: Edge Cut and Vertex Cut, as shown in the following figure. When using the
+Edge Cut method to store graphs, any vertex will only appear on one machine, while edges may be distributed on different machines. This storage method may lead
+to multiple storage of edges. When using the Vertex Cut method to store graphs, any edge will only appear on one machine, and each same point may be distributed
+to different machines. This storage method may result in multiple storage of vertices.</p>
<p><img src="/docs/images/design/GraphCut.png" alt="image"></p>
-<p>采用EdgeCut分区方案可以支持高性能的插入和更新操作,而VertexCut分区方案更适合静态图查询分析,因此EdgeCut适合OLTP图查询,VertexCut更适合OLAP的图查询。
-HugeGraph目前采用EdgeCut的分区方案。</p>
-<h3 id="3-vertexid-策略">3. VertexId 策略</h3>
-<p>HugeGraph的Vertex支持三种ID策略,在同一个图数据库中不同的VertexLabel可以使用不同的Id策略,目前HugeGraph支持的Id策略分别是:</p>
+<p>The EdgeCut partition scheme can support high-performance insert and update operations, while the VertexCut partition scheme is more suitable for static graph query
+analysis, so EdgeCut is suitable for OLTP graph query, and VertexCut is more suitable for OLAP graph query. HugeGraph currently adopts the partition scheme of EdgeCut.</p>
+<h3 id="3-vertexid-strategy">3. VertexId Strategy</h3>
+<p>Vertex of HugeGraph supports three ID strategies. Different VertexLabels in the same graph database can use different Id strategies. Currently, the Id strategies
+supported by HugeGraph are:</p>
<ul>
-<li>自动生成(AUTOMATIC):使用Snowflake算法自动生成全局唯一Id,Long类型;</li>
-<li>主键(PRIMARY_KEY):通过VertexLabel+PrimaryKeyValues生成Id,String类型;</li>
-<li>自定义(CUSTOMIZE_STRING|CUSTOMIZE_NUMBER):用户自定义Id,分为String和Long类型两种,需自己保证Id的唯一性;</li>
+<li>Automatic generation (AUTOMATIC): Use the Snowflake algorithm to automatically generate a globally unique Id, Long type;</li>
+<li>Primary Key (PRIMARY_KEY): Generate Id through VertexLabel+PrimaryKeyValues, String type;</li>
+<li>Custom (CUSTOMIZE_STRING|CUSTOMIZE_NUMBER): User-defined Id, which is divided into two types: String and Long, and you need to ensure the uniqueness of the Id yourself;</li>
</ul>
-<p>默认的Id策略是AUTOMATIC,如果用户调用primaryKeys()方法并设置了正确的PrimaryKeys,则自动启用PRIMARY_KEY策略。
-启用PRIMARY_KEY策略后HugeGraph能根据PrimaryKeys实现数据去重。</p>
+<p>The default Id policy is AUTOMATIC, if the user calls the primaryKeys() method and sets the correct PrimaryKeys, the PRIMARY_KEY policy is automatically enabled.
+After enabling the PRIMARY_KEY strategy, HugeGraph can implement data deduplication based on PrimaryKeys.</p>
<ol>
-<li>AUTOMATIC ID策略</li>
+<li>AUTOMATIC ID Policy</li>
</ol>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#000">schema</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertexLabel</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;person&#34;</span>< [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">useAutomaticId</span><span style="color:#ce5c00;font-weight:bold">()</span>
@@ -52,7 +58,7 @@ HugeGraph目前采用EdgeCut的分区方案。</p>
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">create</span><span style="color:#ce5c00;font-weight:bold">();</span>
</span></span><span style="display:flex;"><span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">addVertex</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">T</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">label</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
</span></span></code></pre></div><ol start="2">
-<li>PRIMARY_KEY ID策略</li>
+<li>PRIMARY_KEY ID policy</li>
</ol>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#000">schema</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertexLabel</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;person&#34;</span>< [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">usePrimaryKeyId</span><span style="color:#ce5c00;font-weight:bold">()</span>
@@ -61,7 +67,7 @@ HugeGraph目前采用EdgeCut的分区方案。</p>
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">create</span><span style="color:#ce5c00;font-weight:bold">();</span>
</span></span><span style="display:flex;"><span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">addVertex</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">T</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">label</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
</span></span></code></pre></div><ol start="3">
-<li>CUSTOMIZE_STRING ID策略</li>
+<li>CUSTOMIZE_STRING ID Policy</li>
</ol>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#000">schema</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertexLabel</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;person&#34;</span>< [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">useCustomizeStringId</span><span style="color:#ce5c00;font-weight:bold">()</span>
@@ -69,78 +75,77 @@ HugeGraph目前采用EdgeCut的分区方案。</p>
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">create</span><span style="color:#ce5c00;font-weight:bold">();</span>
</span></span><span style="display:flex;"><span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">addVertex</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">T</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">label</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
</span></span></code></pre></div><ol start="4">
-<li>CUSTOMIZE_NUMBER ID策略</li>
+<li>CUSTOMIZE_NUMBER ID Policy</li>
</ol>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#000">schema</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertexLabel</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;person&#34;</span>< [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">useCustomizeNumberId</span><span style="color:#ce5c00;font-weight:bold">()</span>
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">properties</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;name&#34;</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="color:#4e9a06">&#34;age&#34;</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">create</span><span style="color:#ce5c00;font-weight:bold">();</span>
</span></span><span style="display:flex;"><span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">addVertex</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">T</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">label</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
-</span></span></code></pre></div><p>如果用户需要Vertex去重,有三种方案分别是:</p>
+</span></span></code></pre></div><p>If users need Vertex deduplication, there are three options:</p>
<ol>
-<li>采用PRIMARY_KEY策略,自动覆盖,适合大数据量批量插入,用户无法知道是否发生了覆盖行为</li>
-<li>采用AUTOMATIC策略,read-and-modify,适合小数据量插入,用户可以明确知道是否发生覆盖</li>
-<li>采用CUSTOMIZE_STRING或CUSTOMIZE_NUMBER策略,用户自己保证唯一</li>
+<li>Adopt PRIMARY_KEY strategy, automatic overwriting, suitable for batch insertion of large amount of data, users cannot know whether overwriting has occurred</li>
+<li>Adopt AUTOMATIC strategy, read-and-modify, suitable for small data insertion, users can clearly know whether overwriting occurs</li>
+<li>Using the CUSTOMIZE_STRING or CUSTOMIZE_NUMBER strategy, the user guarantees the uniqueness</li>
</ol>
-<h3 id="4-edgeid-策略">4. EdgeId 策略</h3>
-<p>HugeGraph的EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合而成。其中<code>sortKey</code>是HugeGraph的一个重要概念。
-在Edge中加入<code>sortKey</code>作为Edge的唯一标识的原因有两个:</p>
+<h3 id="4-edgeid-policy">4. EdgeId policy</h3>
+<p>The EdgeId of HugeGraph is composed of <code>srcVertexId</code> + <code>edgeLabel</code> + <code>sortKey</code> + <code>tgtVertexId</code>. Among them <code>sortKey</code> is an important concept of HugeGraph.
+There are two reasons for adding Edge sortKeyas the unique ID of Edge:</p>
<ol>
-<li>如果两个顶点之间存在多条相同Label的边可通过<code>sortKey</code>来区分</li>
-<li>对于SuperNode的节点,可以通过<code>sortKey</code>来排序截断。</li>
+<li>If there are multiple edges of the same Label between two vertices, they can be sortKeydistinguished by</li>
+<li>For SuperNode nodes, it can be sortKeysorted and truncated by.</li>
</ol>
-<p>由于EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合,多次插入相同的Edge时HugeGraph会自动覆盖以实现去重。
-需要注意的是如果批量插入模式下Edge的属性也将会覆盖。</p>
-<p>另外由于HugeGraph的EdgeId采用自动去重策略,对于self-loop(一个顶点存在一条指向自身的边)的情况下HugeGraph认为仅有一条边,对于采用AUTOMATIC策略的图数据库(例如TitianDB
-)则会认为该图存在两条边。</p>
+<p>Since EdgeId is composed of <code>srcVertexId</code> + <code>edgeLabel</code> + <code>sortKey</code> + <code>tgtVertexId</code>, HugeGraph will automatically overwrite when the same Edge is inserted
+multiple times to achieve deduplication. It should be noted that the properties of Edge will also be overwritten in the batch insert mode.</p>
+<p>In addition, because HugeGraph&rsquo;s EdgeId adopts an automatic deduplication strategy, HugeGraph considers that there is only one edge in the case of self-loop
+(a vertex has an edge pointing to itself). The graph has two edges.</p>
<blockquote>
-<p>HugeGraph的边仅支持有向边,无向边可以创建Out和In两条边来实现。</p>
+<p>The edges of HugeGraph only support directed edges, and undirected edges can be realized by creating two edges, Out and In.</p>
</blockquote>
<h3 id="5-hugegraph-transaction-overview">5. HugeGraph transaction overview</h3>
-<h5 id="tinkerpop事务概述">TinkerPop事务概述</h5>
-<p>TinkerPop transaction事务是指对数据库执行操作的工作单元,一个事务内的一组操作要么执行成功,要么全部失败。
-详细介绍请参考TinkerPop官方文档:http://tinkerpop.apache.org/docs/current/reference/#transactions</p>
-<h5 id="tinkerpop事务操作接口">TinkerPop事务操作接口</h5>
+<h5 id="tinkerpop-transaction-overview">TinkerPop transaction overview</h5>
+<p>A TinkerPop transaction refers to a unit of work that performs operations on the database. A set of operations within a transaction either succeeds or all fail. For a detailed introduction, please refer to the official documentation of TinkerPop: <a href="http://tinkerpop.apache.org/docs/current/reference/#transactions">http://tinkerpop.apache.org/docs/current/reference/#transactions</a>:http://tinkerpop.apache.org/docs/current/reference/#transactions</p>
+<h5 id="tinkerpop-transaction-overview-1">TinkerPop transaction overview</h5>
<ul>
-<li>open 打开事务</li>
-<li>commit 提交事务</li>
-<li>rollback 回滚事务</li>
-<li>close 关闭事务</li>
+<li>open open transaction</li>
+<li>commit commit transaction</li>
+<li>rollback rollback transaction</li>
+<li>close closes the transaction</li>
</ul>
-<h5 id="tinkerpop事务规范">TinkerPop事务规范</h5>
+<h5 id="tinkerpop-transaction-specification">TinkerPop transaction specification</h5>
<ul>
-<li>事务必须显式提交后才可生效(未提交时修改操作只有本事务内查询可看到)</li>
-<li>事务必须打开之后才可提交或回滚</li>
-<li>如果事务设置自动打开则无需显式打开(默认方式),如果设置手动打开则必须显式打开</li>
-<li>可设置事务关闭时:自动提交、自动回滚(默认方式)、手动(禁止显式关闭)等3种模式</li>
-<li>事务在提交或回滚后必须是关闭状态</li>
-<li>事务在查询后必须是打开状态</li>
-<li>事务(非threaded tx)必须线程隔离,多线程操作同一事务互不影响</li>
+<li>The transaction must be explicitly committed before it can take effect (the modification operation can only be seen by the query in this transaction if it is not committed)</li>
+<li>A transaction must be opened before it can be committed or rolled back</li>
+<li>If the transaction setting is automatically turned on, there is no need to explicitly turn it on (the default method), if it is set to be turned on manually, it must be turned on explicitly</li>
+<li>When the transaction is closed, you can set three modes: automatic commit, automatic rollback (default mode), manual (explicit shutdown is prohibited), etc.</li>
+<li>The transaction must be closed after committing or rolling back</li>
+<li>The transaction must be open after the query</li>
+<li>Transactions (non-threaded tx) must be thread-isolated, and multi-threaded operations on the same transaction do not affect each other</li>
</ul>
-<p>更多事务规范用例见:<a href="https://github.com/apache/tinkerpop/blob/master/gremlin-test/src/main/java/org/apache/tinkerpop/gremlin/structure/TransactionTest.java">Transaction Test</a></p>
-<h5 id="hugegraph事务实现">HugeGraph事务实现</h5>
+<p>For more transaction specification use cases, see: <a href="https://github.com/apache/tinkerpop/blob/master/gremlin-test/src/main/java/org/apache/tinkerpop/gremlin/structure/TransactionTest.java">Transaction Test</a></p>
+<h5 id="hugegraph-transaction-implementation">HugeGraph transaction implementation</h5>
<ul>
-<li>一个事务中所有的操作要么成功要么失败</li>
-<li>一个事务只能读取到另外一个事务已提交的内容(Read committed)</li>
-<li>所有未提交的操作均能在本事务中查询出来,包括:
+<li>All operations in a transaction either succeed or fail</li>
+<li>A transaction can only read what has been committed by another transaction (Read committed)</li>
+<li>All uncommitted operations can be queried in this transaction, including:
<ul>
-<li>增加顶点能够查询出该顶点</li>
-<li>删除顶点能够过滤掉该顶点</li>
-<li>删除顶点能够过滤掉该顶点相关边</li>
-<li>增加边能够查询出该边</li>
-<li>删除边能够过滤掉该边</li>
-<li>增加/修改(顶点、边)属性能够在查询时生效</li>
-<li>删除(顶点、边)属性能够在查询时生效</li>
+<li>Adding a vertex can query the vertex</li>
+<li>Delete a vertex to filter out the vertex</li>
+<li>Deleting a vertex can filter out the related edges of the vertex</li>
+<li>Adding an edge can query the edge</li>
+<li>Delete edge can filter out the edge</li>
+<li>Adding/modifying (vertex, edge) attributes can take effect when querying</li>
+<li>Delete (vertex, edge) attributes can take effect at query time</li>
</ul>
</li>
-<li>所有未提交的操作在事务回滚后均失效,包括:
+<li>All uncommitted operations become invalid after the transaction is rolled back, including:
<ul>
-<li>顶点、边的增加、删除</li>
-<li>属性的增加/修改、删除</li>
+<li>Adding and deleting vertices and edges</li>
+<li>Addition/modification, deletion of attributes</li>
</ul>
</li>
</ul>
-<p>示例:一个事务无法读取另一个事务未提交的内容</p>
+<p>Example: One transaction cannot read another transaction&rsquo;s uncommitted content</p>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span> <span style="color:#204a87;font-weight:bold">static</span> <span style="color:#204a87;font-weight:bold">void</span> <span style="color:#000">testUncommittedTx</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#204a87;font-weig [...]
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span> <span style="color:#204a87;font-weight:bold">final</span> <span style="color:#000">CountDownLatch</span> <span style="color:#000">latchUncommit</span> <span style="color:#ce5c00;font-weight:bold">=</span> <span style="color:#204a87;font-weight:bold">new</span> <span style="color:#000">CountDownLatch</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">1 [...]
@@ -192,18 +197,18 @@ HugeGraph目前采用EdgeCut的分区方案。</p>
</span></span><span style="display:flex;"><span> <span style="color:#204a87;font-weight:bold">assert</span> <span style="color:#ce5c00;font-weight:bold">!</span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertices</span><span style="color:#ce5c00;font-weight:bold">().</span><span style="color:#c4a000">hasNext</span><span style="color:#ce5c00;font-weight:bold" [...]
</span></span><span style="display:flex;"><span> <span style="color:#204a87;font-weight:bold">assert</span> <span style="color:#ce5c00;font-weight:bold">!</span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">edges</span><span style="color:#ce5c00;font-weight:bold">().</span><span style="color:#c4a000">hasNext</span><span style="color:#ce5c00;font-weight:bold">() [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">}</span>
-</span></span></code></pre></div><h5 id="事务实现原理">事务实现原理</h5>
+</span></span></code></pre></div><h5 id="principle-of-transaction-realization">Principle of transaction realization</h5>
<ul>
-<li>服务端内部通过将事务与线程绑定实现隔离(ThreadLocal)</li>
-<li>本事务未提交的内容按照时间顺序覆盖老数据以供本事务查询最新版本数据</li>
-<li>底层依赖后端数据库保证事务原子性操作(如Cassandra/RocksDB的batch接口均保证原子性)</li>
+<li>The server internally realizes isolation by binding transactions to threads (ThreadLocal)</li>
+<li>The uncommitted content of this transaction overwrites the old data in chronological order for this transaction to query the latest version of data</li>
+<li>The bottom layer relies on the back-end database to ensure transaction atomicity (for example, the batch interface of Cassandra/RocksDB guarantees atomicity)</li>
</ul>
-<h6 id="注意"><em>注意</em></h6>
+<h6 id="notice">Notice</h6>
<blockquote>
-<p>RESTful API暂时未暴露事务接口</p>
+<p>The RESTful API does not expose the transaction interface for the time being</p>
</blockquote>
<blockquote>
-<p>TinkerPop API允许打开事务,请求完成时会自动关闭(Gremlin Server强制关闭)</p>
+<p>TinkerPop API allows open transactions, which are automatically closed when the request is completed (Gremlin Server forces close)</p>
</blockquote></description></item><item><title>Docs: HugeGraph Plugin机制及插件扩展流程</title><link>/docs/guides/custom-plugin/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/docs/guides/custom-plugin/</guid><description>
<h3 id="背景">背景</h3>
<ol>
diff --git a/docs/index.xml b/docs/index.xml
index 7f299cd8..4327bd21 100644
--- a/docs/index.xml
+++ b/docs/index.xml
@@ -3477,33 +3477,39 @@ HugeGraph supports multi-user parallel operations. Users can enter Gremlin query
</ul>
</blockquote></description></item><item><title>Docs: HugeGraph Design Concepts</title><link>/docs/guides/desgin-concept/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/docs/guides/desgin-concept/</guid><description>
<h3 id="1-property-graph">1. Property Graph</h3>
-<p>常见的图数据表示模型有两种,分别是RDF(Resource Description Framework)模型和属性图(Property Graph)模型。
-RDF和Property Graph都是最基础、最有名的图表示模式,都能够表示各种图的实体关系建模。
-RDF是W3C标准,而Property Graph是工业标准,受到广大图数据库厂商的广泛支持。HugeGraph目前采用Property Graph。</p>
-<p>HugeGraph对应的存储概念模型也是参考Property Graph而设计的,具体示例详见下图:(<em>此图为旧版设计已过时,请忽略它,后续更新</em>)</p>
+<p>There are two common graph data representation models, namely the RDF (Resource Description Framework) model and the Property Graph (Property Graph) model.
+Both RDF and Property Graph are the most basic and well-known graph representation modes, and both can represent entity-relationship modeling of various graphs.
+RDF is a W3C standard, while Property Graph is an industry standard and is widely supported by graph database vendors. HugeGraph currently uses Property Graph.</p>
+<p>The storage concept model corresponding to HugeGraph is also designed with reference to Property Graph. For specific examples, see the figure below:
+( This figure is outdated for the old version design, please ignore it and update it later )</p>
<p><img src="/docs/images/design/PropertyGraph.png" alt="image"></p>
-<p>在HugeGraph内部,每个顶点 / 边由唯一的 VertexId / EdgeId 标识,属性存储在对应点 / 边内部。而顶点与顶点之间的关系 / 映射则是通过边来存储的。</p>
-<p>顶点属性值通过边指针方式存储时,如果要更新一个顶点特定的属性值直接通过覆盖写入即可,其弊端是冗余存储了VertexId;
-如果要更新关系的属性需要通过read-and-modify方式,先读取所有属性,修改部分属性,然后再写入存储系统,更新效率较低。
-从经验来看顶点属性的修改需求较多,而边的属性修改需求较少,例如PageRank和Graph Cluster等计算都需要频繁修改顶点的属性值。</p>
-<h3 id="2-图分区方案">2. 图分区方案</h3>
-<p>对于分布式图数据库而言,图的分区存储方式有两种:分别是边分割存储(Edge Cut)和点分割存储(Vertex Cut),如下图所示。
-使用Edge Cut方式存储图时,任何一个顶点只会出现在一台机器上,而边可能分布在不同机器上,这种存储方式有可能导致边多次存储。
-使用Vertex Cut方式存储图时,任何一条边只会出现在一台机器上,而每相同的一个点可能分布到不同机器上,这种存储方式可能会导致顶点多次存储。</p>
+<p>Inside HugeGraph, each vertex/edge is identified by a unique VertexId/EdgeId, and the attributes are stored inside the corresponding vertex/edge.
+The relationship/mapping between vertices is stored through edges.</p>
+<p>When the vertex attribute value is stored by edge pointer, if you want to update a vertex-specific attribute value, you can directly write it by overwriting.
+The disadvantage is that the VertexId is redundantly stored; if you want to update the attribute of the relationship, you need to use the read-and-modify method ,
+read all attributes first, modify some attributes, and then write to the storage system, the update efficiency is low. According to experience, there are more
+requirements for modifying vertex attributes, but less for edge attributes. For example, calculations such as PageRank and Graph Cluster require frequent
+modification of vertex attribute values.</p>
+<h3 id="2-graph-partition-scheme">2. Graph Partition Scheme</h3>
+<p>For distributed graph databases, there are two partition storage methods for graphs: Edge Cut and Vertex Cut, as shown in the following figure. When using the
+Edge Cut method to store graphs, any vertex will only appear on one machine, while edges may be distributed on different machines. This storage method may lead
+to multiple storage of edges. When using the Vertex Cut method to store graphs, any edge will only appear on one machine, and each same point may be distributed
+to different machines. This storage method may result in multiple storage of vertices.</p>
<p><img src="/docs/images/design/GraphCut.png" alt="image"></p>
-<p>采用EdgeCut分区方案可以支持高性能的插入和更新操作,而VertexCut分区方案更适合静态图查询分析,因此EdgeCut适合OLTP图查询,VertexCut更适合OLAP的图查询。
-HugeGraph目前采用EdgeCut的分区方案。</p>
-<h3 id="3-vertexid-策略">3. VertexId 策略</h3>
-<p>HugeGraph的Vertex支持三种ID策略,在同一个图数据库中不同的VertexLabel可以使用不同的Id策略,目前HugeGraph支持的Id策略分别是:</p>
-<ul>
-<li>自动生成(AUTOMATIC):使用Snowflake算法自动生成全局唯一Id,Long类型;</li>
-<li>主键(PRIMARY_KEY):通过VertexLabel+PrimaryKeyValues生成Id,String类型;</li>
-<li>自定义(CUSTOMIZE_STRING|CUSTOMIZE_NUMBER):用户自定义Id,分为String和Long类型两种,需自己保证Id的唯一性;</li>
-</ul>
-<p>默认的Id策略是AUTOMATIC,如果用户调用primaryKeys()方法并设置了正确的PrimaryKeys,则自动启用PRIMARY_KEY策略。
-启用PRIMARY_KEY策略后HugeGraph能根据PrimaryKeys实现数据去重。</p>
+<p>The EdgeCut partition scheme can support high-performance insert and update operations, while the VertexCut partition scheme is more suitable for static graph query
+analysis, so EdgeCut is suitable for OLTP graph query, and VertexCut is more suitable for OLAP graph query. HugeGraph currently adopts the partition scheme of EdgeCut.</p>
+<h3 id="3-vertexid-strategy">3. VertexId Strategy</h3>
+<p>Vertex of HugeGraph supports three ID strategies. Different VertexLabels in the same graph database can use different Id strategies. Currently, the Id strategies
+supported by HugeGraph are:</p>
+<ul>
+<li>Automatic generation (AUTOMATIC): Use the Snowflake algorithm to automatically generate a globally unique Id, Long type;</li>
+<li>Primary Key (PRIMARY_KEY): Generate Id through VertexLabel+PrimaryKeyValues, String type;</li>
+<li>Custom (CUSTOMIZE_STRING|CUSTOMIZE_NUMBER): User-defined Id, which is divided into two types: String and Long, and you need to ensure the uniqueness of the Id yourself;</li>
+</ul>
+<p>The default Id policy is AUTOMATIC, if the user calls the primaryKeys() method and sets the correct PrimaryKeys, the PRIMARY_KEY policy is automatically enabled.
+After enabling the PRIMARY_KEY strategy, HugeGraph can implement data deduplication based on PrimaryKeys.</p>
<ol>
-<li>AUTOMATIC ID策略</li>
+<li>AUTOMATIC ID Policy</li>
</ol>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#000">schema</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertexLabel</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;person&#34;</span>< [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">useAutomaticId</span><span style="color:#ce5c00;font-weight:bold">()</span>
@@ -3511,7 +3517,7 @@ HugeGraph目前采用EdgeCut的分区方案。</p>
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">create</span><span style="color:#ce5c00;font-weight:bold">();</span>
</span></span><span style="display:flex;"><span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">addVertex</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">T</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">label</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
</span></span></code></pre></div><ol start="2">
-<li>PRIMARY_KEY ID策略</li>
+<li>PRIMARY_KEY ID policy</li>
</ol>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#000">schema</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertexLabel</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;person&#34;</span>< [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">usePrimaryKeyId</span><span style="color:#ce5c00;font-weight:bold">()</span>
@@ -3520,7 +3526,7 @@ HugeGraph目前采用EdgeCut的分区方案。</p>
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">create</span><span style="color:#ce5c00;font-weight:bold">();</span>
</span></span><span style="display:flex;"><span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">addVertex</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">T</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">label</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
</span></span></code></pre></div><ol start="3">
-<li>CUSTOMIZE_STRING ID策略</li>
+<li>CUSTOMIZE_STRING ID Policy</li>
</ol>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#000">schema</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertexLabel</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;person&#34;</span>< [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">useCustomizeStringId</span><span style="color:#ce5c00;font-weight:bold">()</span>
@@ -3528,78 +3534,77 @@ HugeGraph目前采用EdgeCut的分区方案。</p>
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">create</span><span style="color:#ce5c00;font-weight:bold">();</span>
</span></span><span style="display:flex;"><span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">addVertex</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">T</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">label</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
</span></span></code></pre></div><ol start="4">
-<li>CUSTOMIZE_NUMBER ID策略</li>
+<li>CUSTOMIZE_NUMBER ID Policy</li>
</ol>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#000">schema</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertexLabel</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;person&#34;</span>< [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">useCustomizeNumberId</span><span style="color:#ce5c00;font-weight:bold">()</span>
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">properties</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#4e9a06">&#34;name&#34;</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="color:#4e9a06">&#34;age&#34;</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">create</span><span style="color:#ce5c00;font-weight:bold">();</span>
</span></span><span style="display:flex;"><span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">addVertex</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">T</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">label</span><span style="color:#ce5c00;font-weight:bold">,</span> <span style="c [...]
-</span></span></code></pre></div><p>如果用户需要Vertex去重,有三种方案分别是:</p>
+</span></span></code></pre></div><p>If users need Vertex deduplication, there are three options:</p>
<ol>
-<li>采用PRIMARY_KEY策略,自动覆盖,适合大数据量批量插入,用户无法知道是否发生了覆盖行为</li>
-<li>采用AUTOMATIC策略,read-and-modify,适合小数据量插入,用户可以明确知道是否发生覆盖</li>
-<li>采用CUSTOMIZE_STRING或CUSTOMIZE_NUMBER策略,用户自己保证唯一</li>
+<li>Adopt PRIMARY_KEY strategy, automatic overwriting, suitable for batch insertion of large amount of data, users cannot know whether overwriting has occurred</li>
+<li>Adopt AUTOMATIC strategy, read-and-modify, suitable for small data insertion, users can clearly know whether overwriting occurs</li>
+<li>Using the CUSTOMIZE_STRING or CUSTOMIZE_NUMBER strategy, the user guarantees the uniqueness</li>
</ol>
-<h3 id="4-edgeid-策略">4. EdgeId 策略</h3>
-<p>HugeGraph的EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合而成。其中<code>sortKey</code>是HugeGraph的一个重要概念。
-在Edge中加入<code>sortKey</code>作为Edge的唯一标识的原因有两个:</p>
+<h3 id="4-edgeid-policy">4. EdgeId policy</h3>
+<p>The EdgeId of HugeGraph is composed of <code>srcVertexId</code> + <code>edgeLabel</code> + <code>sortKey</code> + <code>tgtVertexId</code>. Among them <code>sortKey</code> is an important concept of HugeGraph.
+There are two reasons for adding Edge sortKeyas the unique ID of Edge:</p>
<ol>
-<li>如果两个顶点之间存在多条相同Label的边可通过<code>sortKey</code>来区分</li>
-<li>对于SuperNode的节点,可以通过<code>sortKey</code>来排序截断。</li>
+<li>If there are multiple edges of the same Label between two vertices, they can be sortKeydistinguished by</li>
+<li>For SuperNode nodes, it can be sortKeysorted and truncated by.</li>
</ol>
-<p>由于EdgeId是由<code>srcVertexId</code>+<code>edgeLabel</code>+<code>sortKey</code>+<code>tgtVertexId</code>四部分组合,多次插入相同的Edge时HugeGraph会自动覆盖以实现去重。
-需要注意的是如果批量插入模式下Edge的属性也将会覆盖。</p>
-<p>另外由于HugeGraph的EdgeId采用自动去重策略,对于self-loop(一个顶点存在一条指向自身的边)的情况下HugeGraph认为仅有一条边,对于采用AUTOMATIC策略的图数据库(例如TitianDB
-)则会认为该图存在两条边。</p>
+<p>Since EdgeId is composed of <code>srcVertexId</code> + <code>edgeLabel</code> + <code>sortKey</code> + <code>tgtVertexId</code>, HugeGraph will automatically overwrite when the same Edge is inserted
+multiple times to achieve deduplication. It should be noted that the properties of Edge will also be overwritten in the batch insert mode.</p>
+<p>In addition, because HugeGraph&rsquo;s EdgeId adopts an automatic deduplication strategy, HugeGraph considers that there is only one edge in the case of self-loop
+(a vertex has an edge pointing to itself). The graph has two edges.</p>
<blockquote>
-<p>HugeGraph的边仅支持有向边,无向边可以创建Out和In两条边来实现。</p>
+<p>The edges of HugeGraph only support directed edges, and undirected edges can be realized by creating two edges, Out and In.</p>
</blockquote>
<h3 id="5-hugegraph-transaction-overview">5. HugeGraph transaction overview</h3>
-<h5 id="tinkerpop事务概述">TinkerPop事务概述</h5>
-<p>TinkerPop transaction事务是指对数据库执行操作的工作单元,一个事务内的一组操作要么执行成功,要么全部失败。
-详细介绍请参考TinkerPop官方文档:http://tinkerpop.apache.org/docs/current/reference/#transactions</p>
-<h5 id="tinkerpop事务操作接口">TinkerPop事务操作接口</h5>
+<h5 id="tinkerpop-transaction-overview">TinkerPop transaction overview</h5>
+<p>A TinkerPop transaction refers to a unit of work that performs operations on the database. A set of operations within a transaction either succeeds or all fail. For a detailed introduction, please refer to the official documentation of TinkerPop: <a href="http://tinkerpop.apache.org/docs/current/reference/#transactions">http://tinkerpop.apache.org/docs/current/reference/#transactions</a>:http://tinkerpop.apache.org/docs/current/reference/#transactions</p>
+<h5 id="tinkerpop-transaction-overview-1">TinkerPop transaction overview</h5>
<ul>
-<li>open 打开事务</li>
-<li>commit 提交事务</li>
-<li>rollback 回滚事务</li>
-<li>close 关闭事务</li>
+<li>open open transaction</li>
+<li>commit commit transaction</li>
+<li>rollback rollback transaction</li>
+<li>close closes the transaction</li>
</ul>
-<h5 id="tinkerpop事务规范">TinkerPop事务规范</h5>
+<h5 id="tinkerpop-transaction-specification">TinkerPop transaction specification</h5>
<ul>
-<li>事务必须显式提交后才可生效(未提交时修改操作只有本事务内查询可看到)</li>
-<li>事务必须打开之后才可提交或回滚</li>
-<li>如果事务设置自动打开则无需显式打开(默认方式),如果设置手动打开则必须显式打开</li>
-<li>可设置事务关闭时:自动提交、自动回滚(默认方式)、手动(禁止显式关闭)等3种模式</li>
-<li>事务在提交或回滚后必须是关闭状态</li>
-<li>事务在查询后必须是打开状态</li>
-<li>事务(非threaded tx)必须线程隔离,多线程操作同一事务互不影响</li>
+<li>The transaction must be explicitly committed before it can take effect (the modification operation can only be seen by the query in this transaction if it is not committed)</li>
+<li>A transaction must be opened before it can be committed or rolled back</li>
+<li>If the transaction setting is automatically turned on, there is no need to explicitly turn it on (the default method), if it is set to be turned on manually, it must be turned on explicitly</li>
+<li>When the transaction is closed, you can set three modes: automatic commit, automatic rollback (default mode), manual (explicit shutdown is prohibited), etc.</li>
+<li>The transaction must be closed after committing or rolling back</li>
+<li>The transaction must be open after the query</li>
+<li>Transactions (non-threaded tx) must be thread-isolated, and multi-threaded operations on the same transaction do not affect each other</li>
</ul>
-<p>更多事务规范用例见:<a href="https://github.com/apache/tinkerpop/blob/master/gremlin-test/src/main/java/org/apache/tinkerpop/gremlin/structure/TransactionTest.java">Transaction Test</a></p>
-<h5 id="hugegraph事务实现">HugeGraph事务实现</h5>
+<p>For more transaction specification use cases, see: <a href="https://github.com/apache/tinkerpop/blob/master/gremlin-test/src/main/java/org/apache/tinkerpop/gremlin/structure/TransactionTest.java">Transaction Test</a></p>
+<h5 id="hugegraph-transaction-implementation">HugeGraph transaction implementation</h5>
<ul>
-<li>一个事务中所有的操作要么成功要么失败</li>
-<li>一个事务只能读取到另外一个事务已提交的内容(Read committed)</li>
-<li>所有未提交的操作均能在本事务中查询出来,包括:
+<li>All operations in a transaction either succeed or fail</li>
+<li>A transaction can only read what has been committed by another transaction (Read committed)</li>
+<li>All uncommitted operations can be queried in this transaction, including:
<ul>
-<li>增加顶点能够查询出该顶点</li>
-<li>删除顶点能够过滤掉该顶点</li>
-<li>删除顶点能够过滤掉该顶点相关边</li>
-<li>增加边能够查询出该边</li>
-<li>删除边能够过滤掉该边</li>
-<li>增加/修改(顶点、边)属性能够在查询时生效</li>
-<li>删除(顶点、边)属性能够在查询时生效</li>
+<li>Adding a vertex can query the vertex</li>
+<li>Delete a vertex to filter out the vertex</li>
+<li>Deleting a vertex can filter out the related edges of the vertex</li>
+<li>Adding an edge can query the edge</li>
+<li>Delete edge can filter out the edge</li>
+<li>Adding/modifying (vertex, edge) attributes can take effect when querying</li>
+<li>Delete (vertex, edge) attributes can take effect at query time</li>
</ul>
</li>
-<li>所有未提交的操作在事务回滚后均失效,包括:
+<li>All uncommitted operations become invalid after the transaction is rolled back, including:
<ul>
-<li>顶点、边的增加、删除</li>
-<li>属性的增加/修改、删除</li>
+<li>Adding and deleting vertices and edges</li>
+<li>Addition/modification, deletion of attributes</li>
</ul>
</li>
</ul>
-<p>示例:一个事务无法读取另一个事务未提交的内容</p>
+<p>Example: One transaction cannot read another transaction&rsquo;s uncommitted content</p>
<div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span> <span style="color:#204a87;font-weight:bold">static</span> <span style="color:#204a87;font-weight:bold">void</span> <span style="color:#000">testUncommittedTx</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#204a87;font-weig [...]
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span> <span style="color:#204a87;font-weight:bold">final</span> <span style="color:#000">CountDownLatch</span> <span style="color:#000">latchUncommit</span> <span style="color:#ce5c00;font-weight:bold">=</span> <span style="color:#204a87;font-weight:bold">new</span> <span style="color:#000">CountDownLatch</span><span style="color:#ce5c00;font-weight:bold">(</span><span style="color:#000">1 [...]
@@ -3651,18 +3656,18 @@ HugeGraph目前采用EdgeCut的分区方案。</p>
</span></span><span style="display:flex;"><span> <span style="color:#204a87;font-weight:bold">assert</span> <span style="color:#ce5c00;font-weight:bold">!</span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">vertices</span><span style="color:#ce5c00;font-weight:bold">().</span><span style="color:#c4a000">hasNext</span><span style="color:#ce5c00;font-weight:bold" [...]
</span></span><span style="display:flex;"><span> <span style="color:#204a87;font-weight:bold">assert</span> <span style="color:#ce5c00;font-weight:bold">!</span><span style="color:#000">graph</span><span style="color:#ce5c00;font-weight:bold">.</span><span style="color:#c4a000">edges</span><span style="color:#ce5c00;font-weight:bold">().</span><span style="color:#c4a000">hasNext</span><span style="color:#ce5c00;font-weight:bold">() [...]
</span></span><span style="display:flex;"><span> <span style="color:#ce5c00;font-weight:bold">}</span>
-</span></span></code></pre></div><h5 id="事务实现原理">事务实现原理</h5>
+</span></span></code></pre></div><h5 id="principle-of-transaction-realization">Principle of transaction realization</h5>
<ul>
-<li>服务端内部通过将事务与线程绑定实现隔离(ThreadLocal)</li>
-<li>本事务未提交的内容按照时间顺序覆盖老数据以供本事务查询最新版本数据</li>
-<li>底层依赖后端数据库保证事务原子性操作(如Cassandra/RocksDB的batch接口均保证原子性)</li>
+<li>The server internally realizes isolation by binding transactions to threads (ThreadLocal)</li>
+<li>The uncommitted content of this transaction overwrites the old data in chronological order for this transaction to query the latest version of data</li>
+<li>The bottom layer relies on the back-end database to ensure transaction atomicity (for example, the batch interface of Cassandra/RocksDB guarantees atomicity)</li>
</ul>
-<h6 id="注意"><em>注意</em></h6>
+<h6 id="notice">Notice</h6>
<blockquote>
-<p>RESTful API暂时未暴露事务接口</p>
+<p>The RESTful API does not expose the transaction interface for the time being</p>
</blockquote>
<blockquote>
-<p>TinkerPop API允许打开事务,请求完成时会自动关闭(Gremlin Server强制关闭)</p>
+<p>TinkerPop API allows open transactions, which are automatically closed when the request is completed (Gremlin Server forces close)</p>
</blockquote></description></item><item><title>Docs: Download HugeGraph</title><link>/docs/download/download/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/docs/download/download/</guid><description>
<h3 id="latest-version">Latest version</h3>
<p>The latest HugeGraph: <strong>1.0.0</strong>, released on <em>2023-02-22</em>(<a href="/docs/quickstart/hugegraph-server/">how to build from source</a>).</p>
diff --git a/en/sitemap.xml b/en/sitemap.xml
index 1fd2bf64..2e8c4cd3 100644
--- a/en/sitemap.xml
+++ b/en/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>/docs/guides/architectural/</loc><lastmod>2023-05-12T23:46:05-05:00</lastmod><xhtml:link rel="alternate" hreflang="cn" href="/cn/docs/guides/architectural/"/><xhtml:link rel="alternate" hreflang="en" href="/docs/guides/architectural/"/></url><url><loc>/docs/config/config-guide/</loc><lastmod>2023-05-10T12:08:15+08:00</last [...]
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>/docs/guides/architectural/</loc><lastmod>2023-05-12T23:46:05-05:00</lastmod><xhtml:link rel="alternate" hreflang="cn" href="/cn/docs/guides/architectural/"/><xhtml:link rel="alternate" hreflang="en" href="/docs/guides/architectural/"/></url><url><loc>/docs/config/config-guide/</loc><lastmod>2023-05-10T12:08:15+08:00</last [...]
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index e62e73a1..b2414d46 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>/en/sitemap.xml</loc><lastmod>2023-05-14T19:35:13+08:00</lastmod></sitemap><sitemap><loc>/cn/sitemap.xml</loc><lastmod>2023-05-14T19:35:13+08:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>/en/sitemap.xml</loc><lastmod>2023-05-14T07:20:21-05:00</lastmod></sitemap><sitemap><loc>/cn/sitemap.xml</loc><lastmod>2023-05-14T19:35:13+08:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file