.make graph_snapshot (preview)

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 async option 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.

Related content