环境准备

请申请和下载TigerGraph终身免费开发者版本Developer Edition

建议加入官方论坛：

下载安装后，一个小时轻松搞定大图数据。

在本教程中，我们将向您展示如何创建图模式、在图中加载数据、编写简单的参数化查询以及运行查询。在开始之前，您需要安装TigerGraph系统，验证它正在工作，并清除以前的任何数据。这也有助于熟悉我们的图术语。

图是什么?

图是数据实体的集合和它们之间的连接。也就是说，它是一个数据实体的网络。

许多人把数据实体称为节点;在TigerGraph，我们称它为顶点。复数是顶点。我们称连接为边。顶点和边都可以有属性或属性。下图是一个包含7个顶点(以圆圈表示)和7条边(以直线表示)的图的可视化表示。

图模式是描述可以出现在图中的顶点(节点)和边(连接)类型的模型。上面的图有一种顶点(person)和一种边(friendship)。

模式图看起来像一个小图，除了每个节点代表一种顶点类型，每个链接代表一种边类型。

Friendship的循环表明Friendship是人与人之间的关系

数据集

对于本教程，我们将创建并查询如图1所示的简单社交图。此图的数据由csv(逗号分隔值)格式的两个文件组成。要继续学习本教程，请保存这两个文件，person.csv和freindship.csv，到你的TigerGraph本地磁盘。在我们的运行示例中，我们使用/home/tigergraph/文件夹来存储两个csv文件:

person.csv

name,gender,age,state
Tom,male,40,ca
Dan,male,34,ny
Jenny,female,25,tx
Kevin,male,28,az
Amily,female,22,ca
Nancy,female,20,ky
Jack,male,26,fl

friendship.csv

person1,person2,date
Tom,Dan,2017-06-03
Tom,Jenny,2015-01-01
Dan,Jenny,2016-08-03
Jenny,Amily,2015-06-08
Dan,Nancy,2016-01-03
Nancy,Jack,2017-03-02
Dan,Kevin,2015-12-30

准备TigerGraph环境

首先，让我们检查一下您是否可以访问GSQL。

1. 打开一个Linux shell。

2. 下面类型的空间。GSQL shell提示符应该如下所示。

#Linux shell

$ gsql
GSQL >

如果GSQL shell没有启动，请尝试使用“gadmin restart all”重新设置系统。如果您需要进一步的帮助，请参阅TigerGraph知识库和常见问题。

如果这是您第一次使用GSQL，那么TigerGraph数据存储可能是空的。但是，如果您或其他人已经在系统上工作，那么可能已经有一个数据库了。您可以使用“ls”命令列出数据库目录来进行检查。如果它是空的，应该是这样:

#GSQL shell - an empty database catalog

GSQL > ls
---- Global vertices, edges, and all graphs
Vertex Types:
Edge Types:
 
Graphs:
Jobs:
 
Json API version: v2

如果数据目录不是空的，您将需要清空它以启动本教程。我们假定你得到了你同事的许可。使用命令DROP ALL删除所有数据库数据、它的模式和所有相关的定义。这个命令运行大约需要一分钟。

#GSQL shell - DROP ALL

GSQL > drop all
Dropping all, about 1 minute ...
Abort all active loading jobs
[ABORT_SUCCESS] No active Loading Job to abort.
 
Shutdown restpp gse gpe ...
Graph store /usr/local/tigergraph/gstore/0/ has been cleared!
Everything is dropped.

重新启动TigerGraph

如果由于任何原因需要重新启动TigerGraph，请使用以下命令序列:

#Linux shell - Restarting TigerGraph services

# Switch to the user account set up during installation
# The default is user=tigergraph, password=tigergraph
$ su tigergraph
Password:tigergraph

提示:运行来自Linux的GSQL命令

您还可以从Linux shell中运行GSQL命令。要运行单个命令，只需使用“gsql”，后面跟着用单引号括起来的命令行。(如果没有解析歧义，则不需要引号;使用它们更安全。例如:

#Linux shell - GSQL commands from a Linux shell

# "-g graphname" is need for a given graph
gsql -g social 'ls'
gsql 'drop all'
gsql 'ls'

您还可以执行您在文件中存储的一系列命令，只需按文件的名称调用“gsql”。

完成之后，可以使用“quit”命令(不带引号)退出GSQL shell。

对于本教程，我们将主要在GSQL shell中以交互模式工作。一些命令将来自Linux shell。创建GSQL图的第一步是定义它的模式。GSQL提供了一组DDL(数据定义语言)命令，类似于SQL DLL命令，用于建模顶点类型、边缘类型和图形。

创建一个顶点类型

使用CREATE VERTEX命令定义一个名为person的顶点类型。这里，PRIMARY_ID是必需的:每个人都必须有一个唯一的标识符。其余部分是描述每个人顶点的可选属性列表，格式为attribute_name data_type, attribute_name data_type，...

#GSQL command
CREATE VERTEX person (PRIMARY_ID name STRING, name STRING, age INT, gender STRING, state STRING)

我们在所有的大写中显示GSQL关键字以突出显示它们，但是它们是不区分大小写的。