创建知识图谱 (知识图谱)

摘要

用于在活动门户上创建知识图谱，并配置其参数。

使用情况

• 使用此工具在 ArcGIS Enterprise 中创建知识图谱。 您可通过知识图谱来创建能够以非空间方式模拟现实世界系统的模型。 起初，知识图谱是空的。 此外，使用 ArcGIS Pro，您还可以执行以下操作：

  • 定义实体类型和关系类型，以对真实世界对象（包括人、地点、事件和事物）的系统进行建模。
  • 从调查、从地图或从链接图表创建表示系统中各个人、地点、事件和事物的实体和关系。
  • 将空间和非空间数据加载到知识图谱中，以生成您要查询的系统的表示。
  • 添加文档，从而为实体或关系的属性中陈述的事实提供权威来源。
  • 添加出处，定义哪个源用于指定实体或关系的哪个属性。

  了解有关 ArcGIS Knowledge 的详细信息，并创建知识图谱

• 仅当与组织共享参数被选中，而且当门户上存在群组时，共享群组参数才可用。 只有存在于该门户上的群组才会被列出。

  了解有关如何管理群组的信息

• 知识图谱的所有者和门户管理员始终可以编辑其数据。 默认情况下，除非启用编辑功能，否则其他用户无法修改知识图谱的数据。 使用启用编辑参数，配置若干编辑操作参数。 每个编辑操作描述如下：

  • 添加 - 编辑者可以向知识图谱添加实体和关系。 他们可以定义新的属性类型和关系类型并添加属性。 通过在地图上创建实体，他们可以定义新实体的几何。
  • 删除 - 编辑者可以从知识图谱中删除要素。
  • 更新 - 编辑者也可以更新实体和关系的属性。

• 选中启用更新参数后，将默认启用更新选项参数的属性和几何选项，由此允许编辑者更新实体和关系的属性以及实体几何。 指定仅限属性以仅允许编辑者更新现有实体和关系的属性。 当使用此选项时，他们无法修改现有实体的几何。

• 数据存储参数仅列出已在 ArcGIS Knowledge Server 站点注册的 NoSQL 数据存储项目。 每个 NoSQL 数据存储都提供对支持的数据库的访问，该数据库可以存储一个知识图谱的内容。

  了解有关 ArcGIS Enterprise 中的由用户管理的数据存储的详细信息

参数

对话框

标注	说明	数据类型
知识图谱服务名称	知识图谱服务名称。	String
摘要 (可选)	知识图谱摘要描述。	String
标签 (可选)	描述知识图谱的关键字或术语。	String
门户文件夹 (可选)	将包含知识图谱的门户文件夹。	String
与组织共享 (可选)	指定是否与组织中所有经过身份验证的用户共享知识图谱。 选中 - 与组织中所有经过身份验证的用户共享知识图谱。 未选中 - 不与组织中所有经过身份验证的用户共享知识图谱。 这是默认设置。	Boolean
共享群组 (可选)	指定您所属的群组，知识图谱将与这些群组共享。 群组—将与之共享知识图谱的群组。	String
数据存储 (可选)	指定知识图的谱实体和关系将要存储在其中的数据存储。 托管图存储—知识图谱的实体和关系被创建并存储在与 Enterprise 门户关联的 ArcGIS Graph Data Store 中。	String
管理数据类型 (可选)	指定 NoSQL 数据库中数据的管理方式。 ArcGIS 管理—ArcGIS Knowledge 将创建、管理和删除存储在 NoSQL 数据库中的实体和关系。 当实体类型、关系类型及其属性更改时，图存储中存储的数据模型将自动更新。 此选项仅在 NoSQL 数据库为空时可用。 这是默认设置。 用户管理—当 ArcGIS Knowledge 访问数据和数据模型时，它们将处于只读状态。 您必须创建、管理和删除实体和关系，并使用其 NoSQL 数据库定义数据模型。	String
唯一 ID (可选)	图谱数据库中包含每个实体和关系唯一字符串值的属性。	String
启用编辑 (可选)	指定是否为具有足够权限的用户启用编辑操作。 选中 - 在知识图谱中启用编辑操作。 未选中 - 不在知识图谱中启用编辑操作。 这是默认设置。	Boolean
启用添加 (可选)	指定编辑者是否可以向知识图谱添加实体和关系，并定义新的实体类型和关系类型。 选中 - 编辑者可以向知识图谱添加实体和关系。 他们可以定义新的属性类型和关系类型并添加属性。 启用编辑参数已选中时的默认设置。 未选中 - 编辑者不可以向知识图谱添加实体和关系，并定义新的实体类型和关系类型，或添加属性。	Boolean
启用删除 (可选)	指定编辑者是否可以在知识图谱中删除要素。 选中 - 编辑者可以删除要素。 启用编辑参数已选中时的默认设置。 未选中 - 编辑者不能删除要素。	Boolean
启用更新 (可选)	指定编辑者是否可以更新实体和关系的属性以及实体几何。 选中 - 编辑者可以更新实体和关系的属性，以及实体几何。 启用编辑参数已选中时的默认设置。 未选中 - 编辑者不可以更新实体和关系的属性或实体几何。	Boolean
更新选项 (可选)	指定是否可以更新实体和关系的属性以及实体几何，还是只能更新实体和关系的属性。 属性和几何—可以更新实体和关系的属性以及实体几何。 如果编辑已启用，这就是默认设置。 仅限属性—只可以更新实体和关系的属性。	String
启用搜索选项 (可选)	指定是否为使用其属性的图谱项目启用全文本搜索。 选中 - 为使用其属性的图谱项目启用全文本搜索。 这是托管图存储或 ArcGIS 管理的 NoSQL 数据存储的默认设置。 未选中 - 不为使用其属性的图谱项目启用全文本搜索。	Boolean
文档实体名称 (可选)	数据模型中实体类型的名称，该类型表示知识图谱引用的文档。 默认设置是 Document。	String
文档关系名称 (可选)	数据模型中关系类型的名称，该关系类型表示知识图谱中的实体和实体相关文档之间的关系。 默认设置是 HasDocument。	String
文档属性 (可选)	指定为每个文档实体创建的属性集。 文本 - 已从文档中提取的文本。 默认属性值为 text。 URL - 文档位置。 默认属性名称为 url。 关键字 - 用来搜索文档的关键字。 默认属性名称为 keywords。 名称 - 文档的文件名。 默认属性名称为 name。 文档类型 - 所引用文档包含的数据类型。 此属性存储为多用途 Internet 邮件扩展 (MIME) 类型。 默认属性名称为 contentType。 标题 - 文档标题。 默认属性名称为 title。 元数据 - 描述文档的元数据。 默认属性名称为 metadata。 文件扩展名 - 当引用文档为文件时的文件扩展名。 默认属性名称为 fileExtension。	Value Table
服务器返回的最大记录数。 (可选)	openCypher 查询返回、显示的图谱项目数。 数量过多可能会导致性能降低。 默认值为 10,000。	Long
服务器在搜索操作期间返回的最大记录数。 (可选)	使用实体和关系的索引属性进行搜索时返回的图谱项目的数量。 数量过多可能会导致性能降低。 默认值为 2,000。	Long

派生输出

标注	说明	数据类型
输出知识图谱	输出知识图谱。	Workspace

Python

arcpy.kg.CreateKnowledgeGraph(service_name, {summary}, {tags}, {portal_folder}, {share_with_org}, {sharing_groups}, {data_store}, {data_managed}, {unique_id}, {enable_editing}, {enable_add}, {enable_delete}, {enable_update}, {update_options}, {enable_search}, {document_entity_name}, {has_document_relationship_name}, {document_properties}, {max_records}, {max_records_search})

名称	说明	数据类型
service_name	知识图谱服务名称。	String
summary (可选)	知识图谱摘要描述。	String
tags (可选)	描述知识图谱的关键字或术语。	String
portal_folder (可选)	将包含知识图谱的门户文件夹。	String
share_with_org (可选)	指定是否与组织中所有经过身份验证的用户共享知识图谱。 SHARE—与组织中所有经过身份验证的用户共享知识图谱。 NO_SHARE—不与组织中所有经过身份验证的用户共享知识图谱。 这是默认设置。	Boolean
sharing_groups [sharing_groups,...] (可选)	指定您所属的群组，知识图谱将与这些群组共享。 Group—将与之共享知识图谱的群组。	String
data_store (可选)	指定知识图的谱实体和关系将要存储在其中的数据存储。 Hosted graph store—知识图谱的实体和关系被创建并存储在与 Enterprise 门户关联的 ArcGIS Graph Data Store 中。	String
data_managed (可选)	指定 NoSQL 数据库中数据的管理方式。 ARCGIS_MANAGED—ArcGIS Knowledge 将创建、管理和删除存储在 NoSQL 数据库中的实体和关系。 当实体类型、关系类型及其属性更改时，图存储中存储的数据模型将自动更新。 此选项仅在 NoSQL 数据库为空时可用。 这是默认设置。 USER_MANAGED—当 ArcGIS Knowledge 访问数据和数据模型时，它们将处于只读状态。 您必须创建、管理和删除实体和关系，并使用其 NoSQL 数据库定义数据模型。	String
unique_id (可选)	图谱数据库中包含每个实体和关系唯一字符串值的属性。	String
enable_editing (可选)	指定是否为具有足够权限的用户启用编辑操作。 ENABLE_EDITING—在知识图谱中启用编辑操作。 DO_NOT_ENABLE_EDITING—不在知识图谱中启用编辑操作。 这是默认设置。	Boolean
enable_add (可选)	指定编辑者是否可以向知识图谱添加实体和关系，并定义新的实体类型和关系类型。 ENABLE_ADD—编辑者可以向知识图谱添加实体和关系。 他们可以定义新的属性类型和关系类型并添加属性。 将 enable_editing 参数设为 ENABLE_EDITING 时，这是默认设置。 DO_NOT_ENABLE_ADD—编辑者不可以向知识图谱添加实体和关系，并定义新的实体类型和关系类型，或添加属性。	Boolean
enable_delete (可选)	指定编辑者是否可以在知识图谱中删除要素。 ENABLE_DELETE—编辑者可以删除要素。 将 enable_editing 参数设为 ENABLE_EDITING 时，这是默认设置。 DO_NOT_ENABLE_DELETE—编辑者不可以删除要素。	Boolean
enable_update (可选)	指定编辑者是否可以更新实体和关系的属性以及实体几何。 ENABLE_UPDATE—编辑者可以更新实体和关系的属性以及实体几何。 将 enable_editing 参数设为 ENABLE_EDITING 时，这是默认设置。 DO_NOT_ENABLE_UPDATE—编辑者不可以更新实体和关系的属性，或实体几何。	Boolean
update_options (可选)	指定是否可以更新实体和关系的属性以及实体几何，还是只能更新实体和关系的属性。 PROPERTIES_AND_GEOMETRIES—可以更新实体和关系的属性以及实体几何。 如果编辑已启用，这就是默认设置。 PROPERTIES_ONLY—只可以更新实体和关系的属性。	String
enable_search (可选)	指定是否为使用其属性的图谱项目启用全文本搜索。 ENABLE_SEARCH—为使用其属性的图谱项目启用全文本搜索。 这是托管图存储或 ArcGIS 管理的 NoSQL 数据存储的默认设置。 DO_NOT_ENABLE_SEARCH—不为使用其属性的图谱项目启用全文本搜索。	Boolean
document_entity_name (可选)	数据模型中实体类型的名称，该类型表示知识图谱引用的文档。 默认设置是 Document。	String
has_document_relationship_name (可选)	数据模型中关系类型的名称，该关系类型表示知识图谱中的实体和实体相关文档之间的关系。 默认设置是 HasDocument。	String
document_properties [document_properties,...] (可选)	指定为每个文档实体创建的属性集。 文本 - 已从文档中提取的文本。 默认属性值为 text。 URL - 文档位置。 默认属性名称为 url。 关键字 - 用来搜索文档的关键字。 默认属性名称为 keywords。 名称 - 文档的文件名。 默认属性名称为 name。 文档类型 - 所引用文档包含的数据类型。 此属性存储为多用途 Internet 邮件扩展 (MIME) 类型。 默认属性名称为 contentType。 标题 - 文档标题。 默认属性名称为 title。 元数据 - 描述文档的元数据。 默认属性名称为 metadata。 文件扩展名 - 当引用文档为文件时的文件扩展名。 默认属性名称为 fileExtension。	Value Table
max_records (可选)	openCypher 查询返回、显示的图谱项目数。 数量过多可能会导致性能降低。 默认值为 10,000。	Long
max_records_search (可选)	使用实体和关系的索引属性进行搜索时返回的图谱项目的数量。 数量过多可能会导致性能降低。 默认值为 2,000。	Long

派生输出

名称	说明	数据类型
out_knowledge_graph_service	输出知识图谱。	Workspace

代码示例

CreateKnowledgeGraph 示例（独立脚本）

以下代码示例演示了使用默认参数创建知识图谱。

# Description: Create a knowledge graph service named 'MyKnowledgeGraph'.

# Import system modules
import arcpy

# Set local variables
service_name = 'MyKnowledgeGraph'
summary = 'A new knowledge graph with editing enabled and custom document property names.'
enable_editing = True
update_options = 'Properties_only'
document_properties = '["newText", "newURL", "newKeywords", "newName", "newContentType", "newTitle", "newMetadata", "newFileExtension"]'
document_values = arcpy.ValueTable(8)
document_values.addRow(document_properties)

# Call the CreateKnowledgeGraph tool to create a knowledge graph service with a
# summary, editing enabled, updating geometry disabled, search enabled, and custom
# document property names.
arcpy.kg.CreateKnowledgeGraph(service_name, summary, tags, portal_folder, share_with_org,
                              enable_editing, update_options,
                              document_properties=document_values)

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是