使用查询参数

Knowledge Studio 中的查询支持查询参数。 写入后，查询就是静态的，查询中的参数允许查询的部分动态化。 查询参数是查询中的变量，其值在运行查询时定义。 这使得用户可以使用不同的值运行相同的查询，而无需修改查询。

例如，您可以写入一个查询来查找与某个人直接相关的所有实体：MATCH (p:Person)-[]-(n) WHERE p.Name = "John Doe" RETURN n。 查询参数用可配置为任何名称的变量 $name 替换 John Doe：MATCH (p:Person)-[]-(n) WHERE p.Name = $name RETURN n。 查询视图中的参数窗格允许您定义 $name 参数，然后更改其值而不修改查询。

参数类型	描述
字符串	任何一组的字母数字字符。
数字	匹配除大整数之外的任何数字类型的图形属性。 注： Knowledge Studio 仅支持介于 -9007199254740991（最小值）和 9007199254740991（最大值）之间的安全整数。 超出此范围的数字将由于四舍五入而不正确，因此不会与知识图谱中的大整数字段匹配。
几何	设置几何图形以用于查询中支持的任何空间运算符。 目前仅支持矩形几何图形。
仅日期	仅日期值，无时间值。 了解有关在查询中使用日期时间值的详细信息
仅时间	时间值仅精确到秒，没有日期值。 了解有关在查询中使用日期时间值的详细信息
日期	日期和时间值精度，以秒（低精度）或毫秒（高精度）为单位 了解有关在查询中使用日期时间值的详细信息
时间戳偏移	日期、时间以及与协调世界时 (UTC) 区的偏移量。 了解有关在查询中使用日期时间值的详细信息
实体	知识图谱中的实体。
关系	知识图谱中的关系。

配置新参数

配置窗格允许您定义和初始化查询中的参数。 必须配置查询中使用的每个参数才能运行查询。 参数可以是下列类型之一：

字符串参数

配置字符串参数

1. 在上下文工具栏上，单击参数。

   参数窗格随即打开。

2. 单击创建新参数

   新的参数表单将打开。

3. 命名参数。
   1. 单击参数标题旁边的选项菜单。
   2. 单击重命名。
   3. 在标题框中键入参数的描述性名称。
   4. 单击应用。

   参数的标题已更新为新名称。

4. 使用以下方法之一定义绑定参数输入中的参数：
   • 在输入框中输入参数的名称。
   • 如果您编写了包含参数的查询，请从下拉列表中选择该参数。
5. 从类型下拉菜单中选择字符串
6. 在输入框中输入字符串作为参数的初始值。 默认值为单个值，请参阅定义值列表来为参数设置值列表。
7. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

数量参数

配置数字参数

1. 在上下文工具栏上，单击参数。

   参数窗格随即打开。

2. 单击创建新参数

   新的参数表单将打开。

3. 命名参数。
   1. 单击参数标题旁边的选项菜单。
   2. 单击重命名。
   3. 在标题框中键入参数的描述性名称。
   4. 单击应用。

   参数的标题已更新为新名称。

4. 使用以下方法之一定义绑定参数输入中的参数：
   • 在输入框中输入参数的名称。
   • 如果您编写了包含参数的查询，请从下拉列表中选择该参数。
5. 从类型下拉菜单中选择数字
6. 在输入框中输入数字作为参数的初始值。 默认值为单个值，请参阅定义值列表来为参数设置值列表。
7. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

几何参数

配置几何参数。

了解有关查询中的空间运算符的更多信息。

1. 在上下文工具栏上，单击参数。

   参数窗格随即打开。

2. 单击创建新参数

   新的参数表单将打开。

3. 命名参数。
   1. 单击参数标题旁边的选项菜单。
   2. 单击重命名。
   3. 在标题框中键入参数的描述性名称。
   4. 单击应用。

   参数的标题已更新为新名称。

4. 使用以下方法之一定义绑定参数输入中的参数：
   • 在输入框中输入参数的名称。
   • 如果您编写了包含参数的查询，请从下拉列表中选择该参数。
5. 从类型下拉菜单中选择几何
6. 单击设置几何来定义参数的初始值。 默认值为单个值，请参阅定义值列表来为参数设置值列表。 。

   几何草图模式打开。

7. 单击图形工具栏中的矩形工具。
8. 单击并拖动地图，在感兴趣的区域周围绘制一个矩形。

   如果配置几何图形列表，则此步骤针对每个几何图形。

9. 或者，使用图形工具栏上的以下方法之一选择几何体。
   • 选择要素 - 单击要素以将其选中。
   • 矩形选择 - 单击地图并拖动一个矩形框住要素以选择它。
   • 套索选择 - 单击地图或链接图表并使用指针进行绘制以创建手绘形状选择。
10. 或者修改或删除要素：
    • 通过单击边缘或角落上的矩形之一并拖动来调整大小。
    • 通过单击要素的任意位置并将其拖动到地图上的新位置来移动要素。
    • 单击图形工具栏中的删除要素以删除该要素。
    • 单击清理以重置地图。
11. 单击确定。
12. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

仅日期

配置仅日期参数。

了解有关在查询中使用日期时间值的详细信息

1. 在上下文工具栏上，单击参数。

   参数窗格随即打开。

2. 单击创建新参数

   新的参数表单将打开。

3. 命名参数。
   1. 单击参数标题旁边的选项菜单。
   2. 单击重命名。
   3. 在标题框中键入参数的描述性名称。
   4. 单击应用。

   参数的标题已更新为新名称。

4. 使用以下方法之一定义绑定参数输入中的参数：
   • 在输入框中输入参数的名称。
   • 如果您编写了包含参数的查询，请从下拉列表中选择该参数。
5. 从类型下拉菜单中选择仅日期
6. 设置用于值的日期。 默认值为单个值，请参阅定义值列表来为参数设置值列表。 使用以下方法之一定义日期：
   • 以 MM/DD/YYYY 格式在输入框中输入日期。
   • 单击输入框并使用日历选择日期。
7. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

仅时间

配置仅时间参数。

了解有关在查询中使用日期时间值的详细信息

1. 在上下文工具栏上，单击参数。

   参数窗格随即打开。

2. 单击创建新参数

   新的参数表单将打开。

3. 命名参数。
   1. 单击参数标题旁边的选项菜单。
   2. 单击重命名。
   3. 在标题框中键入参数的描述性名称。
   4. 单击应用。

   参数的标题已更新为新名称。

4. 使用以下方法之一定义绑定参数输入中的参数：
   • 在输入框中输入参数的名称。
   • 如果您编写了包含参数的查询，请从下拉列表中选择该参数。
5. 从类型下拉菜单中选择仅时间
6. 设置值所使用的时间。 。 默认值为单个值，请参阅定义值列表来为参数设置值列表。 使用以下方法之一定义时间：
   • 以 HH:MM:SS.SSS 格式在输入框中输入时间。
   • 或者，使用时间选择器定义时间。
7. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

日期

配置日期参数。

了解有关在查询中使用日期时间值的详细信息

1. 在上下文工具栏上，单击参数。

   参数窗格随即打开。

2. 单击创建新参数

   新的参数表单将打开。

3. 命名参数。
   1. 单击参数标题旁边的选项菜单。
   2. 单击重命名。
   3. 在标题框中键入参数的描述性名称。
   4. 单击应用。

   参数的标题已更新为新名称。

4. 使用以下方法之一定义绑定参数输入中的参数：
   • 在输入框中输入参数的名称。
   • 如果您编写了包含参数的查询，请从下拉列表中选择该参数。
5. 从类型下拉菜单中选择日期
6. 设置值的日期和时间。 默认值为单个值，请参阅定义值列表来为参数设置值列表。 使用以下方法之一定义日期：
   • 以 MM/DD/YYYY 格式在输入框中输入日期。
   • 单击输入框并使用日历选择日期。
7. 使用以下方法之一定义时间：
   • 以 HH:MM:SS.SSS 格式在输入框中输入时间。
   • 或者，使用时间选择器定义时间。
8. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

时间戳偏移参数

配置时间戳偏移参数。

了解有关在查询中使用日期时间值的详细信息

1. 在上下文工具栏上，单击参数。

   参数窗格随即打开。

2. 单击创建新参数

   新的参数表单将打开。

3. 命名参数。
   1. 单击参数标题旁边的选项菜单。
   2. 单击重命名。
   3. 在标题框中键入参数的描述性名称。
   4. 单击应用。

   参数的标题已更新为新名称。

4. 使用以下方法之一定义绑定参数输入中的参数：
   • 在输入框中输入参数的名称。
   • 如果您编写了包含参数的查询，请从下拉列表中选择该参数。
5. 从类型下拉菜单中选择时间戳偏移
6. 设置值的日期、时间和 UTC 偏移量。 默认值为单个值，请参阅定义值列表来为参数设置值列表。 使用以下方法之一定义日期：
   • 以 MM/DD/YYYY 格式在输入框中输入日期。
   • 单击输入框并使用日历选择日期。
7. 使用以下方法之一定义时间：
   • 以 HH:MM:SS.SSS 格式在输入框中输入时间。
   • 或者，使用时间选择器定义时间。
8. 输入时区偏移量（以 UTC 偏移量为单位，以分钟为单位）。

   默认值为零。 最小值为 -720（-12:00 时），最大值为 840（+14:00 时）

9. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

实体或关系

配置实体或关系参数。 配置实体或关系参数使用实体或关系的唯一标识符作为参数。

例如 MATCH (p:Person)-[]-(m) WHERE ID(p) = $entityOrRelationshipUniqueID

1. 在上下文工具栏上，单击参数。

   参数窗格随即打开。

2. 单击创建新参数

   新的参数表单将打开。

3. 命名参数。
   1. 单击参数标题旁边的选项菜单。
   2. 单击重命名。
   3. 在标题框中键入参数的描述性名称。
   4. 单击应用。

   参数的标题已更新为新名称。

4. 使用以下方法之一定义绑定参数输入中的参数：
   • 在输入框中输入参数的名称。
   • 如果您编写了包含参数的查询，请从下拉列表中选择该参数。
5. 从类型下拉菜单中选择实体或关系。
6. 开始在输入框中输入实体的名称来定义用于值的实体或关系。 默认值为单个值，请参阅定义值列表来为参数设置值列表。

   将出现一个下拉列表，其中包含前五条匹配的记录。 该列表将随着您的输入而更新。

7. 从下拉列表中选择记录。
8. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

使用列表作为参数值

任何参数都可以是值的列表，但列表只能包含一种类型的值。 例如，要查找具有共同姓氏的所有人，您可以使用查询 MATCH (p:People) where n.lastName in $lastNameList RETURN n，并使用参数窗格将 lastNameList 定义为包含 Smith、Jones 和 Johnson 的字符串列表。

如果您有一个带分隔符的值列表，例如以逗号分隔的名称列表，请使用从文本列出将值添加到列表中。

定义值列表

您可以使用与定义值相同的步骤，通过选择值列表而不是单个值来创建值列表。 定义每个值后，将其添加到列表中，或者管理值列表以删除项目。

1. 单击值列表可以定义参数的值列表。
2. 使用与所选类型的单一值相同的输入方法（从第六步开始）。 或者参阅下表中每种类型的步骤摘要。

   字符串	在输入字段中输入字符串。
   数字	在输入字段中输入数字 注： Knowledge Studio 仅支持介于 -9007199254740991（最小值）和 9007199254740991（最大值）之间的安全整数。 超出此范围的数字将由于四舍五入而不正确，因此不会与知识图谱中的大整数字段匹配。
   几何	单击设置几何并绘制多个几何图形
   仅日期	以 MM/DD/YYYY 格式输入日期或使用日历输入日期。
   仅时间	以 HH:MM:SS.sss 格式输入时间或使用时间选择器输入时间
   日期	以 HH:MM:SS.sss 格式输入日期或使用日历输入日期。 以 MM/DD/YYYY 格式输入时间或使用时间选择器输入时间
   时间戳偏移	以 HH:MM:SS.sss 格式输入日期或使用日历输入日期。 以 MM/DD/YYYY 格式输入时间或使用时间选择器输入时间 键入 UTC 偏移量（以分钟为单位）。
   Entity	使用输入字段查找并选择一个实体。
   关系	使用输入字段查找并选择关系。

3. 单击添加
4. 重复第一步和第二步，直到所有值都添加到列表中。
5. 或者，管理列表中的值。
   • 单击值标题以显示列表中的值。
   • 单击值旁边的清除可将其从列表中删除。
   • 单击清除可清除列表。
   • 单击复制将列表中的值复制到系统剪贴板。
6. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

来自文本的自定义列表

如果要将许多值添加到列表中，则可以使用从文本列出要素来生成值列表。 文本列表接受分隔列表，例如以逗号分隔的名称列表，并为您选择的类型的参数生成值列表（参见支持的类型列表）。

1. 单击从文本列出。

   从文本列出模式打开。

2. 键入用于分隔列表中的值的一个或多个字符作为分隔符输入。 默认为逗号。 如果列表由制表符或新行 (Enter) 分隔，请单击相应的选项。
3. 将分隔列表粘贴到文本框中。

   参数类型将列在文本框上方。 列表中的所有值都必须符合此类型。

4. 单击生成列表。

   结果列表在文本框下方生成。

5. 或者单击结果列表以查看结果
   1. 或者，单击值旁边的 X 将其从列表中删除。
6. 也可以单击清除以清除列表中的所有值
7. 单击将值添加到列表将生成的值添加到参数列表。
8. 单击应用以使用配置的参数运行查询。

查询结果将根据新的参数值更新。

移除参数

可以从查询中删除已配置的参数。

1. 在上下文工具栏上，单击参数。

   参数窗格随即打开。

2. 如果窗格打开编辑选项卡，请单击配置选项卡。
3. 单击参数名称旁边的选项菜单。

   选项菜单打开。

4. 单击删除。

   该参数已被删除。

注：

如果查询仍然包含该参数，则运行时它将返回错误，除非从查询中删除或重新配置该参数。

编辑值

如果已经为存储的查询配置了参数，则打开该查询时，参数窗格会自动打开到编辑值选项卡。

1. 如果参数窗格未打开，请单击上下文工具栏上的参数。

   参数窗格随即打开。 将列出为查询配置的参数。

2. 根据参数的类型更新值。

   每个参数的类型将显示在标题下方。 如果参数使用值列表，则列表将包含在类型后。 请参阅定义值列表以更新列表中的值。 查询中使用的当前值将显示在每个参数的输入元素中。 每种类型的步骤总结如下。

   字符串	在输入字段中输入字符串。
   数字	在输入字段中输入数字 注： Knowledge Studio 仅支持介于 -9007199254740991（最小值）和 9007199254740991（最大值）之间的安全整数。 超出此范围的数字将由于四舍五入而不正确，因此不会与知识图谱中的大整数字段匹配。
   几何	单击设置几何并绘制多个几何图形
   仅日期	以 MM/DD/YYYY 格式输入日期或使用日历输入日期。
   仅时间	以 HH:MM:SS.sss 格式输入时间或使用时间选择器输入时间
   日期	以 HH:MM:SS.sss 格式输入日期或使用日历输入日期。 以 MM/DD/YYYY 格式输入时间或使用时间选择器输入时间
   时间戳偏移	以 HH:MM:SS.sss 格式输入日期或使用日历输入日期。 以 MM/DD/YYYY 格式输入时间或使用时间选择器输入时间 键入 UTC 偏移量（以分钟为单位）。
   Entity	使用输入字段查找并选择一个实体。
   关系	使用输入字段查找并选择关系。

3. 单击应用以使用更新的值运行查询。

查询结果将根据新的参数值更新。