订阅事件

这是 GraphQL 库 7 版的文档。对于长期支持 (LTS) 的 5 版，请参阅 GraphQL 库 5 LTS。

此页面介绍了 Neo4j GraphQL 库提供的各种订阅选项。

`CREATE`

对 CREATE 事件的订阅**仅**监听新创建的节点，而不监听新关系。在这种情况下，每次创建新节点时都会触发一个新事件，其中包含其属性。

此操作通过顶级订阅 [type]Created 执行，该订阅包含以下字段：

event：触发此订阅的事件（在本例中为 CREATE）。
created<typename>：新创建节点的顶级属性，不包含关系。
timestamp：发生突变的时间戳。如果同一个查询触发多个事件，它们应具有相同的时间戳。

例如，请考虑以下类型定义：

type Movie @node {
    title: String
    genre: String
}
extend schema @subscription

对 Movie 类型任何新创建节点的订阅应如下所示：

subscription {
    movieCreated {
        createdMovie {
            title
            genre
        }
        event
        timestamp
    }
}

`UPDATE`

对 UPDATE 事件的订阅**仅**监听节点属性的更改，而不监听其他字段的更新。在这种情况下，每次修改节点顶级属性的突变都会触发一个新事件。

此操作通过顶级订阅 [type]Updated 执行，该订阅包含以下字段：

event：触发此订阅的事件（在本例中为 UPDATE）。
updated<typename>：更新节点的顶级属性，不包含关系。
previousState：UPDATE 事件发生前节点的先前顶级属性。
timestamp：发生突变的时间戳。如果同一个查询触发多个事件，它们应具有相同的时间戳。

例如，请考虑以下类型定义：

type Movie @node {
    title: String
    genre: String
}
extend schema @subscription

对 Movie 类型中其属性最近更新的任何节点的订阅应如下所示：

subscription MovieUpdated {
    movieUpdated {
        event
        previousState {
            title
            genre
        }
        updatedMovie {
            title
        }
        timestamp
    }
}

`DELETE`

对 DELETE 事件的订阅**仅**监听被删除的节点，而不监听被删除的关系。此操作通过顶级订阅 [type]Deleted 执行，该订阅包含以下字段：

event：触发此订阅的事件（在本例中为 DELETE）。
deleted<typename>：已删除节点的顶级属性，不包含关系。
timestamp：发生突变的时间戳。如果同一个查询触发多个事件，它们应具有相同的时间戳。

例如，请考虑以下类型定义：

type Movie @node {
    title: String
    genre: String
}
extend schema @subscription

对 Movie 类型中任何已删除节点的订阅应如下所示：

subscription {
    movieDeleted {
        deletedMovie {
            title
        }
        event
        timestamp
    }
}