Neo4j 图数据科学应用 - 图目录和图投影（二）

3. 在目录中列出图表

可以使用gds.graph.list()过程列出有关目录中图的信息，该过程采用一个可选参数graphName：

如果给出图名称，则仅列出该图的信息。
如果没有给出图名称，将列出所有图的信息。
如果给出了图名称但未在目录中找到，则将返回一个空列表。

CALL gds.graph.list(graphName: String?
) YIELDgraphName,database,nodeProjection,relationshipProjection,nodeQuery,relationshipQuery,nodeFilter,relationshipFilter,nodeCount,relationshipCount,schema,degreeDistribution,density,creationTime,modificationTime,sizeInBytes,memoryUsage;

表 8. 结果

Name	Type	Description
`graphName`	String	Name of the graph.
`database`	String	Name of the database in which the graph has been created.
`nodeProjection`	Map	Node projection used to create the graph. If a Cypher projection was used, this will be a derived node projection.
`relationshipProjection`	Map	Relationship projection used to create the graph. If a Cypher projection was used, this will be a derived relationship projection.
`nodeQuery`	String	Node query used to create the graph. If a native projection was used, this will be `null`.
`relationshipQuery`	String	Relationship query used to create the graph. If a native projection was used, this will be `null`.
`nodeFilter`	String	The node filter used when creating this subgraph from another in-memory graph. If the graph has been created from Neo4j, this will be `null`.
`relationshipFilter`	String	The relationship filter used when creating this subgraph from another in-memory graph. If the graph has been created from Neo4j, this will be `null`.
`nodeCount`	Integer	Number of nodes in the graph.
`relationshipCount`	Integer	Number of relationships in the graph.
`schema`	Map	Node labels, Relationship types and properties contained in the in-memory graph.
`degreeDistribution`	Map	Histogram of degrees in the graph.
`density`	Float	Density of the graph.
`creationTime`	Datetime	Time when the graph was created.
`modificationTime`	Datetime	Time when the graph was last modified.
`sizeInBytes`	Integer	Number of bytes used in the Java heap to store the graph.
`memoryUsage`	String	Human readable description of `sizeInBytes`.

该信息包含有关图的基本统计信息，例如节点和关系计数。结果字段creationTime 指示图何时在内存中创建。结果字段modificationTime指示图何时被以mutate模式运行的算法更新。

database列是指在其上创建相应图的数据库的名称。在过程中引用命名图只允许在它创建的数据库上。

schema包含有关存储在图中的节点和关系的信息。对于每个节点标签，模式将标签映射到其属性键及其对应的属性类型。同样，模式将关系类型映射到它们的属性键和属性类型。属性类型是Integer, Float, List of Integer 或者 List of Float。

对于较大的图， degreeDistribution字段的计算可能相当耗时。它的计算是按图缓存的，因此同一图的后续列表速度将很快。为避免计算度分布，可以在 YIELD子句中指定忽略它。请注意，不指定 YIELD子句与请求返回所有字段的效果是相同的。

density是relationshipCount除以具有给定nodeCount的简单图的最大关系数的结果。

3.1. 例子

// 列出所有图的基本信息
CALL gds.graph.list()
YIELD graphName, nodeCount, relationshipCount, schema;

// 列出指定名称图的详细信息
CALL gds.graph.list('my-cypher-graph')
YIELD graphName, nodeQuery, relationshipQuery, nodeCount, relationshipCount, schema, creationTime, modificationTime, memoryUsage;

// 列出指定名称的图的度分布信息
CALL gds.graph.list('my-cypher-graph')
YIELD graphName, degreeDistribution;

4. 检查目录中是否存在图

我们可以通过查找其名称来检查图是否存储在目录中。

CALL gds.graph.exists('my-store-graph') YIELD exists;

5. 从命名图中删除节点属性

我们可以从目录中的命名图中删除节点属性。这对于释放主内存或删除意外创建的节点属性很有用。

CALL gds.graph.removeNodeProperties('my-graph', ['pageRank', 'communityId'])

上面的示例要求所有给定的属性都存在于至少一个节点投影上，并且这些属性将从所有此类投影中删除。

该过程可以配置为仅删除某些特定节点投影的属性。在下面的例子中，我们在子图上运行了一个算法，随后删除了新创建的属性。

CALL gds.graph.create('my-graph', ['A', 'B'], '*')
CALL gds.wcc.mutate('my-graph', {nodeLabels: ['A'], mutateProperty: 'componentId'})
CALL gds.graph.removeNodeProperties('my-graph', ['componentId'], ['A'])

当指定了非 * 的投影列表时，如上例所示，将应用不同的验证和执行；然后要求所有投影都具有所有给定的属性，并且将从所有投影中删除它们。

如果任何给定的投影是“*”，则该过程的行为与第一个示例中的一样。

6. 从命名图中删除关系类型

我们可以从目录中的命名图中删除给定类型的所有关系。这对于释放主内存或删除意外创建的关系类型很有用。

CALL gds.graph.deleteRelationships('my-graph', 'T')
YIELD graphName, relationshipType, deletedRelationships, deletedProperties

7. 从目录中删除图表

使用完命名图后，我们可以将其从目录中删除以释放内存。

CALL gds.graph.drop('my-store-graph') YIELD graphName;

如果我们希望该过程在不存在的图上静默失败，我们可以将布尔标志作为第二个参数设置为 false。对于不存在的图，这将产生一个空结果。

CALL gds.graph.drop('my-fictive-graph', false) YIELD graphName;

如果我们想删除在另一个数据库上创建的图，我们可以将数据库名称设置为第三个参数。对于不存在的图，这也将产生一个空结果。

CALL gds.graph.drop('my-fictive-graph', false, 'my-other-db') YIELD graphName;

如果我们是 GDS 管理员并且想要删除属于另一个用户的图，我们可以将用户名设置为过程的第四个参数。如果有多个用户具有相同名称的图，这将非常有用。

CALL gds.graph.drop('my-fictive-graph', false, '', 'another-user') YIELD graphName;

有关这方面的更多详细信息，请参阅管理页面。