Graph model policies (preview)

Switch services using the Version drop-down list. Learn more about navigation.
Applies to: ✅ Azure Data Explorer

Note

This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Graph model policies control how a graph model is stored, prepared, and used by default graph queries.

Graph models support existing retention and caching policies. Graph models also support policies that are specific to graph snapshots and graph queries.

Supported policies

Policy Description
retention Controls data retention for graph model artifacts.
caching Controls hot-cache behavior for graph model artifacts.
snapshot_indexing Controls how graph snapshots are indexed.
graph_query Controls graph query behavior for the graph model.

Syntax

.show graph_model GraphModelName policy PolicyName

.alter graph_model GraphModelName policy PolicyName PolicyObject

.delete graph_model GraphModelName policy PolicyName

Parameters

Name Type Required Description
GraphModelName String ✅ The graph model name.
PolicyName String ✅ The policy name. Supported values include retention, caching, snapshot_indexing, and graph_query.
PolicyObject String ✅ for .alter A JSON policy object. The shape depends on the policy.

Examples

Set the snapshot indexing policy

.alter graph_model MyGraph policy snapshot_indexing ```
{
  "IndexingLevel": "Default"
}
```

Set the default graph query policy

.alter graph_model MyGraph policy graph_query ```
{
  "DefaultSnapshotQueryBehavior": "LatestIndexedSnapshot"
}
```