Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

modify tagless #2192

Merged
merged 9 commits into from
Oct 27, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs-2.0/3.ngql-guide/10.tag-statements/2.drop-tag.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,16 @@

点可以有一个或多个 Tag。

- 如果某个点只有一个 Tag,删除这个 Tag 后,该点变为无 Tag 的点
- 如果某个点只有一个 Tag,删除这个 Tag 后,用户就**无法访问**这个点,下次 Compaction 操作时会删除该点,但与该点相邻的**边仍然存在**——这会造成悬挂边

- 如果某个点有多个 Tag,删除其中一个 Tag,仍然可以访问这个点,但是**无法访问**已删除 Tag 所定义的所有属性。

删除 Tag 操作仅删除 Schema 数据,硬盘上的文件或目录不会立刻删除,而是在下一次 Compaction 操作时删除。

!!! Compatibility

NebulaGraph {{nebula.release}} 中默认不支持插入无 Tag 的点。如需使用无 Tag 的点,在集群内所有 Graph 服务的配置文件(`nebula-graphd.conf`)中新增`--graph_use_vertex_key=true`;在所有 Storage 服务的配置文件(`nebula-storaged.conf`)中新增`--use_vertex_key=true`。

## 前提条件

- 登录的用户必须拥有对应权限才能执行`DROP TAG`语句。详情请参见[内置角色权限](../../7.data-security/1.authentication/3.role-list.md)。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ prop_value_list:

!!! caution

NebulaGraph {{ nebula.release }} 中支持插入无 Tag 的点。
NebulaGraph {{nebula.release}} 中默认不支持插入无 Tag 的点。如需使用无 Tag 的点,在集群内所有 Graph 服务的配置文件(`nebula-graphd.conf`)中新增`--graph_use_vertex_key=true`;在所有 Storage 服务的配置文件(`nebula-storaged.conf`)中新增`--use_vertex_key=true`。插入无 Tag 点的命令示例如`INSERT VERTEX VALUES "1":();`

- `property_name`:需要设置的属性名称。

Expand All @@ -78,9 +78,6 @@ prop_value_list:
## 示例

```ngql
# 插入不包含 Tag 的点。
nebula> INSERT VERTEX VALUES "1":();

# 插入不包含属性的点。
nebula> CREATE TAG IF NOT EXISTS t1();
nebula> INSERT VERTEX t1() VALUES "10":();
Expand Down
Original file line number Diff line number Diff line change
@@ -1,13 +1,17 @@
# 升级 NebulaGraph v3.0.x 至 v{{nebula.release}}
# 升级 NebulaGraph v3.x 至 v{{nebula.release}}

NebulaGraph v3.0.x 升级至 v{{nebula.release}},只需要使用 v{{nebula.release}}的 RPM/DEB 包进行升级操作即可,或者[编译 v{{nebula.release}}](../2.compile-and-install-nebula-graph/1.install-nebula-graph-by-compiling-the-source-code.md) 之后重新安装。
NebulaGraph v3.x 升级至 v{{nebula.release}},只需要使用 v{{nebula.release}}的 RPM/DEB 包进行升级操作即可,或者[编译 v{{nebula.release}}](../2.compile-and-install-nebula-graph/1.install-nebula-graph-by-compiling-the-source-code.md) 之后重新安装。

## RPM/DEB 包升级步骤

1. 下载 [RPM/DEB 包](https://github.com/vesoft-inc/nebula-graph/releases/tag/v{{nebula.release}})。

2. 停止所有 NebulaGraph 服务。详情请参见[管理 NebulaGraph 服务](../../2.quick-start/3.quick-start-on-premise/5.start-stop-service.md)。建议更新前备份配置文件。

!!! caution

如果用户需要保留无 Tag 的点,在集群内所有 Graph 服务的配置文件(`nebula-graphd.conf`)中新增`--graph_use_vertex_key=true`;在所有 Storage 服务的配置文件(`nebula-storaged.conf`)中新增`--use_vertex_key=true`。

3. 执行如下命令升级:

- RPM 包
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -118,45 +118,13 @@
!!! note
如果启动异常,放弃本次升级,并在[论坛](https://discuss.nebula-graph.com.cn/)或 [GitHub](https://github.com/vesoft-inc/nebula/issues) 提问。

5. 使用`bin`目录下的新版 db_upgrader 文件升级数据格式。

!!! danger
本步骤不会备份 Storage 服务中保存的数据。升级数据格式前,务必按照本文**升级准备**部分的说明备份数据。

命令语法:

```
<nebula_install_path>/bin/db_upgrader \
--src_db_path=<old_storage_data_path> \
--dst_db_path=<data_backup_path> \
--upgrade_meta_server=<meta_server_ip>:<port>[, <meta_server_ip>:<port> ...] \
--upgrade_version=2:3
```

- `old_storage_data_path`代表数据的存储路径,由 Storage 服务配置文件中的`data_path`参数定义。
- `data_backup_path`代表自定义的数据备份路径。**当前版本该设置不生效,升级数据格式时不会将原有数据备份到任何路径。**
- `meta_server_ip`和`port`分别代表 Meta 服务各节点的 IP 地址和端口号。
- `2:3`代表从 NebulaGraph 2.x 版本升级到 3.x 版本。

本文示例:

```
<nebula_install_path>/bin/db_upgrader \
--src_db_path=/usr/local/nebula/data/storage \
--dst_db_path=/home/vesoft/nebula/data-backup \
--upgrade_meta_server=192.168.8.132:9559 \
--upgrade_version=2:3
```

!!! note
如果出现异常,放弃本次升级,并在[论坛](https://discuss.nebula-graph.com.cn/)或 [GitHub](https://github.com/vesoft-inc/nebula/issues) 提问。

6. 启动所有 Graph 和 Storage 服务。
5. 启动所有 Graph 和 Storage 服务。

!!! note
如果启动异常,放弃本次升级,并在[论坛](https://discuss.nebula-graph.com.cn/)或 [GitHub](https://github.com/vesoft-inc/nebula/issues) 提问。

7. 连接新版 NebulaGraph,验证服务是否可用、数据是否正常。连接方法参见[连接服务](../connect-to-nebula-graph.md)。
6. 连接新版 NebulaGraph,验证服务是否可用、数据是否正常。连接方法参见[连接服务](../connect-to-nebula-graph.md)。

目前尚无有效方式判断升级是否完全成功,可用于测试的参考命令如下:

Expand Down
3 changes: 3 additions & 0 deletions docs-2.0/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,9 @@

本文档更新时间{{ now().year }}-{{ now().month }}-{{ now().day }},GitHub commit [{{ git.short_commit }}](https://github.com/vesoft-inc/nebula-docs/commits/v{{nebula.release}})。该版本主色系为"深粉色",色号为 #F7A7A0。

!!! Compatibility

在 NebulaGraph 3.2 的版本中,允许存在无 Tag 的点,但从 NebulaGraph 3.3.0 开始默认不支持无 Tag 的点。

NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库,能够承载数千亿个点和数万亿条边的超大规模数据集,并且提供毫秒级查询。

Expand Down