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 portalArcGIS Enterprise 11.3ArcGIS Enterprise 11.2ArcGIS Enterprise 11.1ArcGIS Enterprise 11.0ArcGIS Enterprise 10.9.1

ArcGIS Pro 3.3

Supported

Supported

Supported

ArcGIS Pro 3.2

Supported

Supported

Supported

ArcGIS Pro 3.1

Supported

Supported

Supported

ArcGIS Pro 3.0

Supported

Supported

ArcGIS Pro 2.9

Supported

Supported

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 or later portal and you open that project with ArcGIS Pro 3.0 or earlier, 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 earlier portal and you open that project in ArcGIS Pro 3.1 or later, 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 Repair Broken Data Source. Work with the project in your previous version of ArcGIS Pro until the ArcGIS Enterprise deployment has been upgraded to version 11.1 or later. With ArcGIS Pro 3.2, if you create a new knowledge graph on a new or upgraded ArcGIS Enterprise deployment that is version 11.1 or later, you can repair the data source of a knowledge graph layer in a map or link chart.

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 or later 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. Open the Create Investigation wizard pane.
    • On the Catalog tab on the ribbon, in the Create group, click the New drop-down arrow and click New Investigation New Investigation.
    • On the Insert tab on the ribbon, in the Knowledge Graph group, click New Investigation New Investigation.

    The Create Investigation pane appears. If the message Server incompatible appears, 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 Browse.

    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 Investigation is created, and appears in the Catalog pane and the catalog view in the Investigations Closed Investigation folder category. The investigation is opened and allows you to 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 Knowledge Graph by right-clicking it and clicking Add To New Investigation Add Investigation.

Create an investigation and a knowledge graph using the default configuration

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

Note:

ArcGIS Pro 3.1 and later can only create knowledge graphs on an ArcGIS Enterprise 11.1 or later 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. Open the Create Investigation wizard.
    • On the Catalog tab on the ribbon, in the Create group, click the New drop-down arrow and click New Investigation New Investigation.
    • On the Insert tab on the ribbon, in the Knowledge Graph group, click New Investigation 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 information describing the investigation in the Summary and Tags text boxes.
  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 information describing the knowledge graph in the Summary text box.
  9. Under Location, click 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 Browse to browse to a folder in your portal content. You can also type a folder name in the text box.

  10. Under Data Stores, click 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 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.

    An Enterprise portal has two data stores that can be used to create a knowledge graph.

  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, verify the WGS 1984 coordinate system displays that 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 Knowledge Graph is created in the active portal. A new investigation Investigation is created in the project referencing the new knowledge graph and appears in the Catalog pane and the catalog view in the Investigations Closed Investigation folder 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 Closed Investigation folder in the Catalog pane or the catalog view and clicking New Investigation New Investigation.

Repair a broken data source for an investigation

When you open an investigation, ArcGIS Pro accesses the knowledge graph that it references and lists its content. If the knowledge graph has been moved, renamed, deleted, or is otherwise inaccessible, an error appears at the bottom of the investigation's contents list. No entity or relationship types are listed in the investigation's Contents pane, and no entities and relationships appear in the contents list.

If the knowledge graph is available in a new location or with a new name, you can repair the data source link. For example, the original data could be loaded into a new knowledge graph on a new ArcGIS Enterprise deployment. Configure the investigation to access the new knowledge graph on the new Enterprise portal.

If you are not able to repair the investigation immediately, you can leave the data source broken and do other work in the project, or you can remove the investigation if it is no longer needed.

  1. Ensure the current knowledge graph is available on the active portal and you are signed in with sufficient privileges to access it.
  2. In the Contents pane, right-click the investigation and click Properties.
  3. On the Source tab, click Set Data Source.
  4. On the dialog box that appears, browse to the new knowledge graph, select it, and click OK.
  5. Click OK in the Investigation Properties dialog box.

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 Closed Investigation folder in the Contents pane.
  2. Click an investigation Investigation in the contents list to select it.
  3. Delete the investigation from the project using one of the following methods:
    • Click Delete Delete on the Catalog tab on the ribbon, in the Organize group.
    • Right-click the investigation and click Delete 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 Closed Investigation folder 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. Once a knowledge graph has been deleted in the ArcGIS Enterprise portal, any associated investigations and knowledge graph layers in a map and a link chart can be updated to reference a different knowledge graph, for example, if the data is now available from a new ArcGIS Knowledge site.

If the knowledge graph uses the hosted graph store, you only need to delete the knowledge graph in the portal. 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. You can delete the NoSQL data store from the Enterprise portal as well. Deleting the NoSQL data store will not delete the associated NoSQL database.

Learn about deleting a Neo4j database or an ArangoDB database

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

Related topics