Create an investigation in a project

You can create an investigation from an existing knowledge graph, or create a knowledge graph to support your investigation in ArcGIS Pro.

The following table illustrates the specific combinations of ArcGIS Pro and ArcGIS Enterprise that can be used to create knowledge graphs and to display, query, and search knowledge graph data in an investigation, a map, a link chart, and the Search and Filter pane.

Active portal	ArcGIS Enterprise 11.1	ArcGIS Enterprise 11.0	ArcGIS Enterprise 10.9.1
ArcGIS Pro 3.1
ArcGIS Pro 3.0
ArcGIS Pro 2.9

If you have a project created with a previous version of ArcGIS Pro using knowledge graph data from a previous version of ArcGIS Enterprise, care must be taken to ensure that you can continue working with your project.

• Only use existing projects with a supported combination of versions of ArcGIS Pro and ArcGIS Enterprise.
• Do not update ArcGIS Pro or ArcGIS Enterprise until both can be updated at the same time and any existing knowledge graphs on an ArcGIS Knowledge Server site can be upgraded. Do not use existing projects until all updates are complete.

If ArcGIS Pro and ArcGIS Enterprise are not upgraded at the same time, you can expect the following behavior.

• If a project includes an investigation that accesses a knowledge graph on an ArcGIS Enterprise 11.1 portal and you open that project with ArcGIS Pro 3.0, you cannot use data from the knowledge graph in that project. If any investigations, maps, or link charts displaying knowledge graph data are open in the saved project, you may not be able to open the project at all.
• If your project includes an investigation that accesses a knowledge graph on an ArcGIS Enterprise 11.0 or 10.9.1 portal and you open that project in ArcGIS Pro 3.1, you cannot use data from the knowledge graph in that project. Any investigations, link charts, and the Search and Filter pane show the message: Server incompatible. Any knowledge graph layers in maps will show the broken data source button ; however, you cannot repair the data source of a knowledge graph layer at this time. Work with the project in your previous version of ArcGIS Pro until the ArcGIS Enterprise deployment has been upgraded to version 11.1.

Learn about upgrading existing knowledge graphs

Create an investigation from an existing knowledge graph

When the active portal in ArcGIS Pro is an ArcGIS Enterprise 11.1 portal, you can browse, search, filter, and sort portal content to find the knowledge graph you want to work with and add it to a project. A new investigation will be created in the project, allowing you to analyze the knowledge graph's content.

1. Open the catalog view and click Project in the Contents pane.
2. On the Catalog tab on the ribbon, in the Create group, click the New drop-down arrow and click New Investigation .

   The Create Investigation wizard appears. If the message Server incompatible appears on the wizard, the active Enterprise portal is not compatible with your version of ArcGIS Pro.

3. On the Define Investigation page of the wizard, type a name for the new investigation in the Title text box.

   Only alphanumeric characters can be used in the investigation name at this time.

4. Type descriptive information in the Summary and Tags text boxes.
5. Under the Knowledge Graph heading, click Use an existing knowledge graph.
6. Click the Browse button .

   The Add Knowledge Graph dialog box appears.

7. Browse to or search for the knowledge graph you want to investigate, select the knowledge graph, and click OK.
8. Click Finish.

   If you decide not to create an investigation, click Cancel or click the close button at the top of the pane to close the Create Investigation wizard.

A new investigation is created, and appears in the Catalog pane and the catalog view in the Investigations category. The investigation is opened and lets you explore the entities and relationships in the knowledge graph.

Once the investigation has been created, you can rename it in ArcGIS Pro in the same way you rename other items in your project.

Tip:

When you browse the contents of the active portal in the catalog view or the Catalog pane, you can create an investigation from an existing knowledge graph by right-clicking it and clicking Add To New Investigation .

Create an investigation and a knowledge graph using the default configuration

To create a knowledge graph, you must have the following:

• The active portal in ArcGIS Pro must be an ArcGIS Enterprise 11.1 portal that has been configured to support ArcGIS Knowledge.
• You must be signed in to the active portal using an account that has been assigned sufficient privileges to create a knowledge graph.

Note:

ArcGIS Pro 3.1 can only create knowledge graphs on an ArcGIS Enterprise 11.1 portal.

This workflow explains how to create a knowledge graph with the default settings. To change the default configuration, see Configure a knowledge graph.

1. Open the catalog view and click Project in the Contents pane.
2. On the Catalog tab on the ribbon, in the Create group, click the New drop-down arrow and click New Investigation .

   The Create Investigation wizard appears. If the message Server incompatible appears on the wizard, the active Enterprise portal is not compatible with your version of ArcGIS Pro.

3. On the Define Investigation page of the wizard, type a name for the new investigation in the Title text box that is unique in the active portal.
4. Type descriptive information in the Summary text box.
5. Under the Knowledge Graph heading, click Create a new knowledge graph.
6. Click Next.

   Information you provided to describe the investigation is copied to the second page of the wizard. You can modify this description or use the same information to describe the knowledge graph.

7. On the Define Knowledge Graph page of the wizard, type a name for the new knowledge graph in the Title text box.

   Note:

   Unicode characters can be used in the name with some restrictions.

8. Type descriptive information in the Summary and Tags text boxes.
9. Under Location, use the Folder drop-down list to choose a folder in My Content in which to store the knowledge graph. Optionally, create a folder.

   By default, the knowledge graph is stored at the root level of your portal content.

   Tip:

   Click the Browse button to browse to a folder in your portal content. You can also type a folder name in the text box.
10. Under Data Stores, use the Data Stores drop-down list to choose where the knowledge graph's entities and relationships will be stored.
    • Hosted graph store—The default data store. The knowledge graph's entities and relationships are created and stored in the ArcGIS Data Store graph store associated with the Enterprise portal.
    • NoSQL data store—Other data stores can be listed in addition to the Hosted graph store. These are NoSQL data store items that have been registered with the ArcGIS Knowledge Server site. Each NoSQL data store provides access to a supported database that can store content for one knowledge graph. If all listed NoSQL data stores are in use by other knowledge graphs, you must add a new NoSQL data store for the new investigation you are creating and click Refresh to show the new data store in the list.

    In the example below, the Enterprise portal has a Hosted graph store and a NoSQL data store named neo4j_db1.

    

11. Under Share with, specify how the knowledge graph will be shared.
    • ArcGIS Enterprise—This option allows your content to be shared with all authenticated users in the organization.
    • Groups—This option allows you to share your content with groups to which you belong and their members.

    Leave all options unchecked to set the sharing level to the owner of the item.

12. Click Next.
13. On the Spatial Reference page of the wizard, you see the WGS 1984 coordinate system will be used for any geospatial features defined as part of the knowledge graph.

    Note:

    Geospatial features can only be defined in the WGS 1984 coordinate system at this time. Additional spatial references will be supported in a future release.

14. Click Finish.

    If at any point you want to discard your changes and not create a knowledge graph, click Cancel or the close button at the top of the pane to close the Create Investigation wizard.

    Tip:

    If the Finish button does not become enabled, check if another knowledge graph with the same name exists in the active portal.

The knowledge graph is created in the active portal. A new investigation is created in the project referencing the new knowledge graph and appears in the Catalog pane and the catalog view in the Investigations category. The investigation is opened and lists the entities and relationships in the knowledge graph. You can explore the knowledge graph further in the investigation view.

Tip:

When your project already includes an investigation, you can add another investigation to the project by right-clicking Investigations in the Catalog pane or the catalog view and clicking New Investigation .

Delete an investigation

You can delete an investigation from your project. This will not delete the knowledge graph associated with the investigation from the Enterprise portal. A knowledge graph can support several investigations.

1. Open the catalog view and click Investigations in the Contents pane.
2. Click an investigation in the contents list to select it.
3. Delete the investigation from the project using one of the following methods:
   • Click Delete on the Catalog tab on the ribbon, in the Organize group.
   • Right-click the investigation and click Delete .
4. In the message box that appears, click Yes to indicate you want to permanently delete the investigation from your project.

The selected investigation is deleted from the project and the contents list is updated. Item categories only appear in a project if the project includes those items. For example, after successfully deleting the last investigation in the project, the Investigations category will no longer appear in the Catalog pane and the catalog view. The category will reappear if you add another investigation to the project.

The knowledge graph that was associated with the investigation remains on the ArcGIS Enterprise portal. You can keep the knowledge graph on the portal and use it again in a new investigation.

However, if you no longer need the knowledge graph and want to delete it, you must do this by accessing the Enterprise portal using a web browser and deleting knowledge graph items that you own. If the knowledge graph uses the hosted graph store, you only need to delete the knowledge graph in the portal. Once a knowledge graph has been deleted in the ArcGIS Enterprise portal, any associated investigations, link charts, and map layers must be deleted; they can't be used with a different knowledge graph.

If the knowledge graph's data was stored in a NoSQL data store, the NoSQL data store will remain in the portal even after the knowledge graph is deleted. If the knowledge graph contained ArcGIS-managed data, you will not be able to reuse the existing data store item to create another knowledge graph with ArcGIS-managed data unless all content is deleted from the associated database. If the knowledge graph contained user-managed data, you can reuse the existing data store item to create another knowledge graph with user-managed data.

If you no longer intend to use the database with ArcGIS Knowledge, you can delete the NoSQL data store from the Enterprise portal as well. Deleting the NoSQL data store will not delete the associated Neo4j database.

ArcGIS Enterprise portal administrators can also delete knowledge graphs and data store items owned by other users.