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 public preview. Functionality and syntax are subject to change before General Availability.
Creates a new graph snapshot from a specified graph model. A graph snapshot is a materialized instance of a graph model that can be efficiently queried.
Permissions
To run this command, the user needs Database admin permissions or Graph admin permissions.
Syntax
.make [async] graph_snapshot SnapshotName from GraphModelName
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
async |
Keyword | ❌ | If specified, the command runs asynchronously and returns immediately. |
| SnapshotName | String | ✅ | The name of the snapshot to create. The name must be unique within the scope of the graph model. |
| GraphModelName | String | ✅ | The name of the graph model from which to create the snapshot. |
Returns
If run synchronously, this command returns a table with the following columns:
| Column | Type | Description |
|---|---|---|
| Name | String | The name of the created snapshot. |
| SnapshotTime | DateTime | The timestamp when the snapshot was created. |
| ModelName | String | The name of the graph model. |
| ModelId | String | The unique identifier of the graph model. |
| ModelCreationTime | DateTime | The timestamp when the graph model was created. |
| NodesCount | Long | The number of nodes in the snapshot. |
| EdgesCount | Long | The number of edges in the snapshot. |
| RetentionPolicy | String | The retention policy applied to the snapshot in JSON format. |
If run asynchronously, the command returns an operation ID that can be used to check the status of the operation.
Examples
Create a graph snapshot synchronously
.make graph_snapshot WeeklySnapshot from SocialNetwork
Output
| Name | SnapshotTime | ModelName | ModelId | ModelCreationTime | NodesCount | EdgesCount | RetentionPolicy |
|---|---|---|---|---|---|---|---|
| WeeklySnapshot | 2025-05-24 05:26:35.1495944 | SocialNetwork | aaaaaaaa-0b0b-1c1c-2d2d-333333333333 | 2025-05-21 10:47:05.8611670 | 2 | 1 | { "SoftDeletePeriod": "365000.00:00:00"<//br>} |
Create a graph snapshot asynchronously
.make async graph_snapshot DailySnapshot from ProductRecommendations
Output
| OperationId |
|---|
| bbbbbbbb-1c1c-2d2d-3e3e-444444444444 |
Notes
- Creating a graph snapshot materializes the graph model definition into a queryable format. This process can be time-consuming for large graphs.
- For large graphs, it's recommended to use the
asyncoption to run the operation in the background. - A graph model can have multiple snapshots, each representing the state of the graph at different points in time.
- Snapshots are immutable. To update a snapshot with fresh data, you need to create a new snapshot.