Créer un graphe de connaissances (Graphe de connaissances)

Synthèse

Crée un graphe de connaissances sur le portail actif et configure ses paramètres.

Utilisation

• Utilisez cet outil pour créer un graphe de connaissances dans ArcGIS Enterprise. Un graphe de connaissances permet de créer un modèle qui simule un système réel d’une manière non spatiale. Au départ, le graphe de connaissances est vide. Toutefois, avec ArcGIS Pro, vous pouvez :

  • Définir des types d’entité et des types de relation pour modéliser des systèmes d’objets réels, tels que des personnes, des lieux, des événements et des choses.
  • Créer des entités et des relations qui représentent des personnes, des lieux, des événements et des choses dans le système à partir d’une enquête, à partir d’une carte ou à partir d’un diagramme de liens.
  • Charger des données spatiales et non spatiales dans le graphe de connaissances pour générer une représentation du système à interroger.
  • Ajouter des documents fournissant une source officielle pour les faits déclarés dans les propriétés d’une entité ou d’une relation.
  • Ajouter une provenance qui définit la source utilisée pour spécifier une propriété d’une entité ou d’une relation.

  En savoir plus sur ArcGIS Knowledge et la création de graphes de connaissances

• Le paramètre Partage des groupes est disponible uniquement lorsque le paramètre Partager avec l’organisation est sélectionné et que des groupes existent sur le portail. Seuls les groupes présents sur le portail sont répertoriés.

  En savoir plus sur la gestion des groupes

• Le propriétaire du graphe de connaissances et les administrateurs du portail peuvent toujours modifier les données. Par défaut, les autres utilisateurs ne peuvent pas modifier les données du graphe de connaissances, sauf si la mise à jour est activée. Utilisez le paramètre Activer la mise à jour afin de configurer plusieurs paramètres pour les opérations de mise à jour. Chaque opération de mise à jour est décrite comme suit.

  • Ajouter : les éditeurs peuvent ajouter des entités et des relations au graphe de connaissances. Ils peuvent définir de nouveaux types d’entités et de relations, et ajouter des propriétés. Ils peuvent définir la géométrie d’une nouvelle entité en créant l’entité sur une carte.
  • Supprimer : les éditeurs peuvent supprimer des entités dans le graphe de connaissances.
  • Actualiser : les éditeurs peuvent actualiser les propriétés des entités et des relations.

• Lorsque le paramètre Activer l’actualisation est sélectionné, l’option Propriétés et géométrie du paramètre Option d’actualisation est activée par défaut, ce qui permet aux éditeurs d’actualiser les propriétés des entités et des relations, ainsi que la géométrie d’une entité. Spécifiez l’option Propriétés uniquement pour que les éditeurs ne puissent actualiser que les propriétés des entités et des relations existantes. Ils ne pourront pas modifier la géométrie d’une entité existante si cette option est utilisée.

• Le paramètre Data Store répertorie uniquement les éléments de data store NoSQL qui ont été inscrits auprès du site ArcGIS Knowledge Server. Chaque répertoire de données NoSQL donne accès à une base de données prise en charge qui peut stocker du contenu pour un graphe de connaissances.

  En savoir plus sur les data stores gérés par l’utilisateur dans ArcGIS Enterprise

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Nom du service de graphe de connaissances	Nom du service de graphe de connaissances.	String
Résumé (Facultatif)	Description récapitulative du graphe de connaissances.	String
Balises (Facultatif)	Mots-clés ou termes décrivant le graphe de connaissances.	String
Dossier du portail (Facultatif)	Dossier du portail qui contiendra le graphe de connaissances.	String
Partager avec l’organisation (Facultatif)	Indique si le graphe de connaissances sera partagé avec tous les utilisateurs authentifiés de votre organisation. Sélectionné : le graphe de connaissances sera partagé avec tous les utilisateurs authentifiés de votre organisation. Désélectionné : le graphe de connaissances ne sera pas partagé avec tous les utilisateurs authentifiés de votre organisation. Il s’agit de l’option par défaut.	Boolean
Partage des groupes (Facultatif)	Spécifie les groupes dont vous êtes membre et avec lesquels le graphe de connaissances sera partagé. Groupe—Groupe avec lequel le graphe de connaissances sera partagé.	String
Data store (Facultatif)	Spécifie le data store dans lequel les entités et les relations du graphe de connaissances seront stockées. Graph store hébergé—Les entités et les relations du graphe de connaissances seront créées et stockées dans le data store ArcGIS Graph Data Store associé au portail Enterprise.	String
Type de gestion des données (Facultatif)	Spécifie le mode de gestion des données d’une base de données NoSQL. Gérées par ArcGIS—ArcGIS Knowledge crée, gère et supprime les entités et les relations stockées dans la base de données NoSQL. Le modèle de données stocké dans le graph store est actualisé automatiquement lorsque les types d’entité et les types de relation et leurs propriétés changent. Cette option est disponible uniquement si la base de données NoSQL est vide. Il s’agit de l’option par défaut. Gérées par l’utilisateur—Les données et le modèle de données sont en lecture seule lorsque vous y accédez via ArcGIS Knowledge. Vous devez créer, gérer et supprimer les entités et les relations et définir le modèle de données à l’aide de la base de données NoSQL.	String
ID unique (Facultatif)	Propriété dans la base de données orientée graphe qui contient une valeur de chaîne unique pour chaque entité et relation.	String
Activer la mise à jour (Facultatif)	Indique si les opérations de mise à jour seront activées pour les utilisateurs disposant de privilèges suffisants. Sélectionné : les opérations de mise à jour seront activées dans le graphe de connaissances. Non sélectionné : les opérations de mise à jour ne seront pas activées dans le graphe de connaissances. Il s’agit de l’option par défaut.	Boolean
Activer l’ajout (Facultatif)	Indique si les éditeurs peuvent ajouter des entités et des relations au graphe de connaissances et définir de nouveaux types d’entité et de nouveaux types de relation. Sélectionné : les éditeurs peuvent ajouter des entités et des relations au graphe de connaissances. Ils peuvent définir de nouveaux types d’entités et de relations, et ajouter des propriétés. Il s’agit de l’option par défaut lorsque le paramètre Activer la mise à jour est sélectionné. Désélectionné : les éditeurs ne peuvent pas ajouter d’entités ni de relations au graphe de connaissances, définir de nouveaux types d’entité et de relation, et ajouter des propriétés.	Boolean
Activer la suppression (Facultatif)	Indique si les éditeurs peuvent supprimer des entités dans le graphe de connaissances. Sélectionné : les éditeurs peuvent supprimer des entités. Il s’agit de l’option par défaut lorsque le paramètre Activer la mise à jour est sélectionné. Désélectionné : les éditeurs ne peuvent pas supprimer les entités.	Boolean
Activer l’actualisation (Facultatif)	Indique si les éditeurs peuvent actualiser les propriétés des entités et des relations, ainsi que la géométrie d’une entité. Sélectionné : les éditeurs peuvent actualiser les propriétés des entités et des relations, ainsi que la géométrie d’une entité. Il s’agit de l’option par défaut lorsque le paramètre Activer la mise à jour est sélectionné. Désélectionné : les éditeurs ne peuvent pas actualiser les propriétés des entités et des relations, ni la géométrie d’une entité.	Boolean
Option de mise à jour (Facultatif)	Indique si les propriétés des entités et des relations ainsi que la géométrie des entités peuvent être actualisées ou si seules les propriétés des entités et des relations peuvent être actualisées. Propriétés et géométrie—Les propriétés des entités et des relations ainsi que la géométrie des entités peuvent être actualisées. Il s’agit de l’option par défaut si la mise à jour a été activée. Propriétés uniquement—Seules les propriétés des entités et des relations peuvent être actualisées.	String
Activer l’option de recherche (Facultatif)	Indique si la recherche en texte intégral sera activée pour les éléments de graphe à l’aide de leurs propriétés. Sélectionné : la recherche en texte intégral sera activée pour les éléments de graphe à l’aide de leurs propriétés. Il s’agit de l’option par défaut pour un graph store hébergé ou un data store NoSQL géré par ArcGIS. Désélectionné : la recherche en texte intégral ne sera pas activée pour les éléments de graphe à l’aide de leurs propriétés.	Boolean
Nom de l’entité de document (Facultatif)	Nom du type d’entité dans le modèle de données qui représente les documents référencés par le graphe de connaissances. Par défaut, il s’agit de Document.	String
Nom de la relation de document (Facultatif)	Nom du type de relation dans le modèle de données qui représente une relation entre une entité du graphe de connaissances et un document associé à cette entité. Par défaut, il s’agit de HasDocument.	String
Propriétés du document (Facultatif)	Spécifie l’ensemble de propriétés qui sera créé pour chaque entité de document. Texte : texte extrait depuis un document. Le nom de propriété par défaut est text. URL : localisation du document. Le nom de propriété par défaut est url. Mots-clés : mots-clés à utiliser pour rechercher le document. Le nom de propriété par défaut est keywords. Nom : nom de fichier du document. Le nom de propriété par défaut est name. Type de contenu : type de données que le document référencé contient. Cette propriété est stockée en tant que type MIME (Multipurpose Internet Mail Extensions). Le nom de propriété par défaut est contentType. Titre : titre du document. Le nom de propriété par défaut est title. Métadonnées : métadonnées décrivant le document. Le nom de propriété par défaut est metadata. Extension de fichier : extension de fichier lorsque le document référencé est un fichier. Le nom de propriété par défaut est fileExtension.	Value Table
Nombre maximal d’enregistrements renvoyés par le serveur (Facultatif)	Nombre d’éléments de graphe qui seront renvoyés et affichés par une requête openCypher. Un chiffre élevé peut réduire les performances. La valeur par défaut est 10 000.	Long
Nombre maximal d’enregistrements renvoyés par le serveur lors d’une recherche (Facultatif)	Nombre d’éléments de graphe qui peuvent être renvoyés par une recherche en utilisant les propriétés indexées des entités et des relations. Un chiffre élevé peut réduire les performances. La valeur par défaut est 2 000.	Long

Sortie obtenue

Étiquette	Explication	Type de données
Graphe de connaissances en sortie	Graphe de connaissances en sortie.	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})

Nom	Explication	Type de données
service_name	Nom du service de graphe de connaissances.	String
summary (Facultatif)	Description récapitulative du graphe de connaissances.	String
tags (Facultatif)	Mots-clés ou termes décrivant le graphe de connaissances.	String
portal_folder (Facultatif)	Dossier du portail qui contiendra le graphe de connaissances.	String
share_with_org (Facultatif)	Indique si le graphe de connaissances sera partagé avec tous les utilisateurs authentifiés de votre organisation. SHARE—Le graphe de connaissances sera partagé avec tous les utilisateurs authentifiés de votre organisation. NO_SHARE—Le graphe de connaissances ne sera pas partagé avec tous les utilisateurs authentifiés de votre organisation. Il s’agit de l’option par défaut.	Boolean
sharing_groups [sharing_groups,...] (Facultatif)	Spécifie les groupes dont vous êtes membre et avec lesquels le graphe de connaissances sera partagé. Group—Groupe avec lequel le graphe de connaissances sera partagé.	String
data_store (Facultatif)	Spécifie le data store dans lequel les entités et les relations du graphe de connaissances seront stockées. Hosted graph store—Les entités et les relations du graphe de connaissances seront créées et stockées dans le data store ArcGIS Graph Data Store associé au portail Enterprise.	String
data_managed (Facultatif)	Spécifie le mode de gestion des données d’une base de données NoSQL. ARCGIS_MANAGED—ArcGIS Knowledge crée, gère et supprime les entités et les relations stockées dans la base de données NoSQL. Le modèle de données stocké dans le graph store est actualisé automatiquement lorsque les types d’entité et les types de relation et leurs propriétés changent. Cette option est disponible uniquement si la base de données NoSQL est vide. Il s’agit de l’option par défaut. USER_MANAGED—Les données et le modèle de données sont en lecture seule lorsque vous y accédez via ArcGIS Knowledge. Vous devez créer, gérer et supprimer les entités et les relations et définir le modèle de données à l’aide de la base de données NoSQL.	String
unique_id (Facultatif)	Propriété dans la base de données orientée graphe qui contient une valeur de chaîne unique pour chaque entité et relation.	String
enable_editing (Facultatif)	Indique si les opérations de mise à jour seront activées pour les utilisateurs disposant de privilèges suffisants. ENABLE_EDITING—Les opérations de mise à jour seront activées dans le graphe de connaissances. DO_NOT_ENABLE_EDITING—Les opérations de mise à jour ne seront pas activées dans le graphe de connaissances. Il s’agit de l’option par défaut.	Boolean
enable_add (Facultatif)	Indique si les éditeurs peuvent ajouter des entités et des relations au graphe de connaissances et définir de nouveaux types d’entité et de nouveaux types de relation. ENABLE_ADD—Les éditeurs peuvent ajouter des entités et des relations au graphe de connaissances. Ils peuvent définir de nouveaux types d’entités et de relations, et ajouter des propriétés. Il s’agit de l’option par défaut lorsque le paramètre enable_editing est défini sur ENABLE_EDITING. DO_NOT_ENABLE_ADD—Les éditeurs ne peuvent pas ajouter d’entités ni de relations au graphe de connaissances, définir de nouveaux types d’entité et de relation, et ajouter des propriétés.	Boolean
enable_delete (Facultatif)	Indique si les éditeurs peuvent supprimer des entités dans le graphe de connaissances. ENABLE_DELETE—Les éditeurs peuvent supprimer des entités. Il s’agit de l’option par défaut lorsque le paramètre enable_editing est défini sur ENABLE_EDITING. DO_NOT_ENABLE_DELETE—Les éditeurs ne peuvent pas supprimer les entités.	Boolean
enable_update (Facultatif)	Indique si les éditeurs peuvent actualiser les propriétés des entités et des relations, ainsi que la géométrie d’une entité. ENABLE_UPDATE—Les éditeurs peuvent actualiser les propriétés des entités et des relations, ainsi que la géométrie d’une entité. Il s’agit de l’option par défaut lorsque le paramètre enable_editing est défini sur ENABLE_EDITING. DO_NOT_ENABLE_UPDATE—Les éditeurs ne peuvent pas actualiser les propriétés des entités et des relations, ni la géométrie d’une entité.	Boolean
update_options (Facultatif)	Indique si les propriétés des entités et des relations ainsi que la géométrie des entités peuvent être actualisées ou si seules les propriétés des entités et des relations peuvent être actualisées. PROPERTIES_AND_GEOMETRIES—Les propriétés des entités et des relations ainsi que la géométrie des entités peuvent être actualisées. Il s’agit de l’option par défaut si la mise à jour a été activée. PROPERTIES_ONLY—Seules les propriétés des entités et des relations peuvent être actualisées.	String
enable_search (Facultatif)	Indique si la recherche en texte intégral sera activée pour les éléments de graphe à l’aide de leurs propriétés. ENABLE_SEARCH—La recherche en texte intégral sera activée pour les éléments de graphe à l’aide de leurs propriétés. Il s’agit de l’option par défaut pour un graph store hébergé ou un data store NoSQL géré par ArcGIS. DO_NOT_ENABLE_SEARCH—La recherche en texte intégral ne sera pas activée pour les éléments de graphe à l’aide de leurs propriétés.	Boolean
document_entity_name (Facultatif)	Nom du type d’entité dans le modèle de données qui représente les documents référencés par le graphe de connaissances. Par défaut, il s’agit de Document.	String
has_document_relationship_name (Facultatif)	Nom du type de relation dans le modèle de données qui représente une relation entre une entité du graphe de connaissances et un document associé à cette entité. Par défaut, il s’agit de HasDocument.	String
document_properties [document_properties,...] (Facultatif)	Spécifie l’ensemble de propriétés qui sera créé pour chaque entité de document. Texte : texte extrait depuis un document. Le nom de propriété par défaut est text. URL : localisation du document. Le nom de propriété par défaut est url. Mots-clés : mots-clés à utiliser pour rechercher le document. Le nom de propriété par défaut est keywords. Nom : nom de fichier du document. Le nom de propriété par défaut est name. Type de contenu : type de données que le document référencé contient. Cette propriété est stockée en tant que type MIME (Multipurpose Internet Mail Extensions). Le nom de propriété par défaut est contentType. Titre : titre du document. Le nom de propriété par défaut est title. Métadonnées : métadonnées décrivant le document. Le nom de propriété par défaut est metadata. Extension de fichier : extension de fichier lorsque le document référencé est un fichier. Le nom de propriété par défaut est fileExtension.	Value Table
max_records (Facultatif)	Nombre d’éléments de graphe qui seront renvoyés et affichés par une requête openCypher. Un chiffre élevé peut réduire les performances. La valeur par défaut est 10 000.	Long
max_records_search (Facultatif)	Nombre d’éléments de graphe qui peuvent être renvoyés par une recherche en utilisant les propriétés indexées des entités et des relations. Un chiffre élevé peut réduire les performances. La valeur par défaut est 2 000.	Long

Sortie obtenue

Nom	Explication	Type de données
out_knowledge_graph_service	Graphe de connaissances en sortie.	Workspace

Exemple de code

Exemple d’utilisation de la fonction CreateKnowledgeGraph (script autonome)

L’exemple de code ci-dessous illustre la création d’un service de graphe de connaissances avec les paramètres par défaut.

# 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)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui