快速入门

欢迎使用GraphScope交互式系统！本指南将带您了解如何设置并运行您的首个查询。

准备工作

在继续之前，请确保已安装GraphScope Interactive。如果尚未安装，请按照installation指引安装最新版本。

  • 管理工具: GraphScope Interactive 提供了一个名为 gsctl 的管理工具来帮助管理交互式服务。如需详细了解如何使用该工具，请访问管理工具页面（待办：添加gsctl文档）。

  • 图数据: 默认情况下，GraphScope Interactive使用Tinkerpop的modern graph作为入门示例。不过，如果您想配置自己的图数据并加载数据，可以参考使用自定义graph_data页面了解详细步骤。

  • 配置项: 该服务可通过yaml文件进行配置。如需了解所有可配置项的详细说明，请参阅配置页面。

  • 存储过程: GraphScope Interactive 支持用户通过Cypher和C++文件注册存储过程。更多详情请参阅存储过程页面。

安装交互式

查看安装指南了解如何安装和部署Interactive。

连接到交互式服务

您可以通过gsctl连接到coordinator。

gsctl connect --coordinator-endpoint http://127.0.0.1:8080
# change the port number if you have customized the coordinator port.

检查服务状态

连接到交互式服务后，您现在可以查看我们为您准备的初始内容。

gsctl ls -l

实际上，系统内置了一个名为gs_interactive_default_graph的图。现在您可以切换到该图上下文：

gsctl use GRAPH gs_interactive_default_graph
gsctl service status # show current service status

从输出可以看出，Interactive服务已经在内置图上运行。

提交Cypher查询

GraphScope Interactive 与 Neo4j 生态系统无缝集成。您可以使用 Neo4j 的 Bolt 连接器建立与 Interactive 服务的连接并执行 Cypher 查询。我们对 Cypher 查询的实现遵循 openCypher 项目制定的标准。有关支持的 Cypher 查询的详细概述，请访问 supported_cypher。

按照Connect-to-cypher-service中的指引，使用Python客户端或cypher-shell连接到Cypher服务。

使用cypher-shell提交简单查询：

下载 cypher-shell

wget https://dist.neo4j.org/cypher-shell/cypher-shell-4.4.19.zip
unzip cypher-shell-4.4.19.zip && cd cypher-shell

连接到服务

./cypher-shell
# or -a neo4j://localhost:<port> to connect to the customized port

运行一个简单查询

@neo4j> MATCH (n) RETURN n LIMIT 10;

您也可以利用交互式SDK，Java SDK或[Python SDK](./development/python/, 通过python_sdk.md连接到交互式服务)来提交查询。

关闭连接

如果想断开与协调器的连接，只需输入

gsctl close

销毁交互式实例

如果您想关闭并卸载Interactive实例，

gsctl instance destroy --type interactive

这将删除Interactive实例中的所有图和数据。