Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
The snapshot_indexing policy controls how graph snapshots for a graph model are indexed.
The policy affects snapshots created after the policy is set. It doesn't change existing snapshots.
The default IndexingLevel value is Default.
Indexing can improve query performance, but more complete indexing can increase the work needed to prepare a snapshot. Indexing runs in the background, so graph queries can continue to use available snapshots while indexing work is in progress. To control whether default graph queries wait for indexed snapshots, use the graph_query policy.
Permissions
To show the policy, you need Database Monitor or Database Viewer permissions.
To alter or delete the policy, you need Graph Admin permissions on the graph model.
Syntax
.show graph_model GraphModelName policy snapshot_indexing
.show graph_model * policy snapshot_indexing
.alter graph_model GraphModelName policy snapshot_indexing PolicyObject
.delete graph_model GraphModelName policy snapshot_indexing
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| GraphModelName | String | ✅ | The graph model name. |
| PolicyObject | String | ✅ for .alter |
A JSON policy object. |
IndexingLevel |
String | ✅ | The requested indexing level. Supported values are Disabled, Default, and Best. |
Indexing levels
| Indexing level | Description |
|---|---|
Disabled |
Don't index graph snapshots for the model. |
Default |
Let the system decide whether indexing is beneficial for each snapshot. This is the default value. |
Best |
Use the most complete indexing behavior for snapshots of the model. This can improve query performance, but might require more work while preparing snapshots. |
Deleting the policy restores the default behavior.
Returns
This command returns a table with the following columns:
| Column | Type | Description |
|---|---|---|
| PolicyName | String | The policy name. |
| EntityName | String | The graph model name. |
| Policy | String | The JSON representation of the policy. |
| ChildEntities | String | Reserved. |
| EntityType | String | The entity type. |
Examples
Show the policy for a graph model
.show graph_model MyGraph policy snapshot_indexing
Show policies for all graph models
.show graph_model * policy snapshot_indexing
Use the default indexing behavior
.alter graph_model MyGraph policy snapshot_indexing ```
{
"IndexingLevel": "Default"
}
```
Use the most complete indexing behavior
.alter graph_model MyGraph policy snapshot_indexing ```
{
"IndexingLevel": "Best"
}
```
Disable snapshot indexing
.alter graph_model MyGraph policy snapshot_indexing ```
{
"IndexingLevel": "Disabled"
}
```
Delete the policy
.delete graph_model MyGraph policy snapshot_indexing