![精通Neo4j](https://wfqqreader-1252317822.image.myqcloud.com/cover/113/47216113/b_47216113.jpg)
3.3.21 CALL语句
CALL语句用于调用数据库中的过程(Procedure)。使用CALL语句调用过程时,需要指定所需要的参数。可以通过在过程名的后面使用逗号分隔的列表来显式地指定,也可以使用查询参数来作为过程调用的实参。后者仅适用于在单独的过程调用中作为参数,即整个查询语句只包含一个单一的CALL调用。
大多数的过程返回固定列的记录流,类似于Cypher查询返回的记录流。YIELD子句用于显式地选择返回结果集中的哪些部分并绑定到一个变量以供后续的查询引用。在一个更大的查询内部,过程调用返回的结果可以显式地使用YIELD引入一个WHERE子句来过滤结果(类似WITH …WHERE …)。
Neo4j支持VOID过程。VOID过程既没有声明任何结果字段,也不返回任何结果记录。调用VOID过程可能有一个副作用,就是它既不允许也不需要使用YIELD。在一个大的查询中调用VOID过程,就像WITH *在记录流的作用那样简单地传递输入的每一个结果。
下面的例子显示了如何传递实参并从一个过程中返回结果字段,所有的例子将使用下面的过程:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P199_102813.jpg?sign=1739035243-8y31ZHbuKLsnPGiILFhkg3cpHuXsiCnO-0-803fc896cc75f9fec6a6cf83720e8866)
3.3.21.1 调用过程
本例调用数据库内嵌的过程db.labels,它可列出数据库中的所有标签。
查询:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P200_92368.jpg?sign=1739035243-KVYooFLzhQSpaMKItTocW9J6n8MflLiN-0-d09a263ca1327a7a69f9fcd5c518b562)
结果:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P200_92398.jpg?sign=1739035243-YP1qBhhKsXqHxEpr2j4OJJKZ9XyO6UEZ-0-9f5096b20c73c07bb9030f858860428a)
3.3.21.2 使用命名空间和名字调用过程
本例调用数据库内嵌的过程db.labels,它可列出数据库中的所有标签。
查询:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P200_92375.jpg?sign=1739035243-anYTm2xiNKlWuiarBwAmxGfUkLIMf421-0-7ec9488ea70d2286638dcb17f7f1e2e6)
结果:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P200_101933.jpg?sign=1739035243-r2xdjcdd89nmGImIVxY9fhlMl0VPPQ0f-0-0f3388f5289cb06c9ed3a7ec9558da6b)
3.3.21.3 使用字面值参数调用过程
下面使用字面值参数调用了例子中的过程org.neo4j.procedure.example.addNodeToIndex,参数直接写在语句中。
查询:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P200_92382.jpg?sign=1739035243-y9PeYZWkAu5kBu2XGfEZWHI5I1t6QxI0-0-4b910609f70f71e80e80919eba4326e2)
因为例子中的过程不返回任何结果,因此结果将返回空。
结果:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P200_101936.jpg?sign=1739035243-4wqApfXBk6ZRbZZwiE6ECdWm8Tn6l7dK-0-38aab9ec22e4841689e9f62c7ce377c7)
3.3.21.4 使用参数作为实参调用过程
这里使用参数作为实参调用了例子中的过程org.neo4j.procedure.example.addNodeToIndex。每个过程的实参所取的值为参数语句中同名的参数对应的值(如果没有这个参数,则值为null)。
参数:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P201_102815.jpg?sign=1739035243-DaIybTtpSS0p3NPxd7jl9Vt7FYo1mKIa-0-52d3b3e3a0da4949f023e09266dc2553)
查询:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P201_92425.jpg?sign=1739035243-G860ktN4IuOhOIgg73e7MfFpM46Y4hmj-0-7a93a970a76d359f078903229fdc003a)
因为例子中的过程不返回任何结果,因此结果将为空。
结果:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P201_101938.jpg?sign=1739035243-1xKvr4AMVX0GseNyXY5QQjWbd8kXK9Ip-0-0a965f0658254c301f933b0e75272ee7)
3.3.21.5 混合使用字面值和参数调用过程
这里,混合使用字面值和参数来作为过程的参数来调用例子中的过程org.neo4j.procedure.example.addNodeToIndex。
参数:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P201_102816.jpg?sign=1739035243-X9NZpf0EWqmkWMwrO5TVFIrCJGGWlgN7-0-a6fbdc0fca08b3057f1f0238686e14af)
查询:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P201_92452.jpg?sign=1739035243-XlwO36R3Zn1vdsFq3S1SFKhB8bf758wX-0-cb96c46b6e550bec89cf6b4dd43ef602)
因为例子中的过程不返回任何结果,因此结果将为空。
结果:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P201_101941.jpg?sign=1739035243-4GiqqYna6Mhg87NPqZdaiMmxSvlEqr3k-0-307c549b3742bb621a4add1740da8a56)
3.3.21.6 使用字面值和默认实参调用过程
这里使用字面值和过程本身提供的默认值作为参数,调用例子中的过程org.neo4j.procedure.example.addNodeToIndex。
查询:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P201_92459.jpg?sign=1739035243-J6Y6IdH1w3FDBcSAB6yOejllspBffBuF-0-107e69b16b6cf631a71daba063de068c)
因为例子中的过程不返回任何结果,因此结果将为空。
结果:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P201_101944.jpg?sign=1739035243-otKDXBDoQFQwLUIKodDiGCEQiPj4zcPq-0-c40c653c2a2d1814d07aaef581917e65)
3.3.21.7 在复杂查询中调用过程
这里调用数据库内嵌的过程db.labels,计算数据库中的总标签数。
查询:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P202_102820.jpg?sign=1739035243-AJqyGJSJcqLTR3EGxwGSNm7aMwKkK4yW-0-bb526776878d2fb48e5269fea9451156)
因为过程调用是大的查询的一部分,所以所有的输出都必须显式地命名。
结果:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P202_101947.jpg?sign=1739035243-GgA3RXWtvroInzB3jEF3ouqBDuJJIlYp-0-7042b30dc17abb1a56ff72c29780bfea)
3.3.21.8 调用过程并过滤结果
这里调用数据库内嵌的过程db.labels,并计算数据库中所有在用的包含“User”词的标签。
查询:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P202_102821.jpg?sign=1739035243-9dLFfaZRsyoezrljE7Kszjz6MBQbcmB3-0-839db79c4177633c965a6d28fedb0cf9)
因为过程调用是大的查询的一部分,所以所有的输出都必须显式地命名。
结果:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P202_101950.jpg?sign=1739035243-3FPy8imStY1eTNQdltpIA0mC5GRH8yh4-0-f9601169fcab3f4f878fb2d71ac9b1f8)
3.3.21.9 在复杂查询中调用过程并重命名结果
这里调用内嵌过程db.propertyKeys作为一部分,计算数据库中包含每个属性键的节点数。
查询:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P202_102822.jpg?sign=1739035243-HB0ddjCWUqxvYKoaa33REmSXQGvfyOD6-0-6cb3e5898a912d1690e165e23a8c5a05)
因为过程调用是大的查询的一部分,所以,所有的输出都必须显式地命名。
结果:
![](https://epubservercos.yuewen.com/84FE89/26581284601284906/epubprivate/OEBPS/Images/Figure-P202_102823.jpg?sign=1739035243-Osr0aZGBdWaJ60tgf18zMZGYH2IOFQEQ-0-3c266f12350175a07fafe88f88bfa060)