Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ ms.date: 05/24/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Creates a new graph model or alters an existing one using the provided model definition payload.

Expand Down
2 changes: 1 addition & 1 deletion data-explorer/kusto/management/graph/graph-model-drop.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/28/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Deletes an existing graph model and all its versions from the database, including any associated snapshots.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/24/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Graph models in Azure Data Explorer enable you to define, manage, and efficiently query persistent graph structures within your database. Unlike transient graphs created using the [make-graph](../../query/make-graph-operator.md) operator, graph models are stored representations that can be queried repeatedly without rebuilding the graph for each query, significantly improving performance for complex relationship-based analysis.

Expand Down
2 changes: 1 addition & 1 deletion data-explorer/kusto/management/graph/graph-model-show.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/24/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Shows the details of a specific graph model, including its versions.

Expand Down
2 changes: 1 addition & 1 deletion data-explorer/kusto/management/graph/graph-models-show.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/24/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Lists all graph models in the database, showing the latest version for each model by default.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/24/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Persistent graphs enable you to store, manage, and query graph data structures at scale. Unlike transient graphs created with the [make-graph](../../query/make-graph-operator.md) operator, persistent graphs are durable database objects that persist beyond individual query executions, providing enterprise-grade graph analytics capabilities.

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
title: .show graph_snapshot data statistics command
description: Learn how to display storage profile statistics for a graph snapshot by using the .show graph_snapshot data statistics command.
ms.reviewer: royo
ms.topic: reference
ms.date: 06/16/2026
---

# .show graph_snapshot data statistics (preview)

> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Displays a storage profile for a specific graph snapshot, including persisted size, compression, index footprint, and element count for nodes, edges, and graph structure data.

## Permissions

You must have at least [Database User, Database Viewer, or Database Monitor](../../access-control/role-based-access-control.md) permissions to run this command.

## Syntax

`.show` `graph_snapshot` *GraphModelName*`.`*SnapshotName* `data` `statistics`

## Parameters

|Name|Type|Required|Description|
|--|--|--|--|
|*GraphModelName*|`string`|✅|The name of the graph model.|
|*SnapshotName*|`string`|✅|The name of the snapshot to display data statistics for.|

## Returns

This command returns a table with the following columns:

|Column|Type|Description|
|--|--|--|
|*DatabaseName*|`string`|The name of the database containing the graph model and snapshot.|
|*GraphModelName*|`string`|The name of the graph model.|
|*SnapshotName*|`string`|The name of the snapshot.|
|*EntityKind*|`string`|The data category for the row: `Nodes`, `Edges`, or `GraphStructure`.|
|*TotalExtentSize*|`long`|Total persisted size in bytes (`DataCompressedSize + IndexSize`)`*`.|
|*OriginalSize*|`long`|Uncompressed data size in bytes`*`.|
|*DataCompressedSize*|`long`|Compressed data size in bytes, excluding index`*`.|
|*IndexSize*|`long`|Index size in bytes, including the shared text index`*`.|
|*CompressionRatio*|`real`|`OriginalSize / DataCompressedSize`; 0 when `DataCompressedSize` is 0`*`.|
|*TotalElementCount*|`long`|Number of elements in the entity`*`.|

The command returns two or three rows per snapshot: one row each for `Nodes` and `Edges`, and an additional `GraphStructure` row when graph structure data exists.

`*` *Values may be up to 15 minutes old, as they're taken from a cached summary of the graph's extents.*

## Examples

### Show data statistics for a specific snapshot

```kusto
.show graph_snapshot MyGraphModel.snapshot1 data statistics
```

#### Output

|DatabaseName|GraphModelName|SnapshotName|EntityKind|TotalExtentSize|OriginalSize|DataCompressedSize|IndexSize|CompressionRatio|TotalElementCount|
|--|--|--|--|--:|--:|--:|--:|--:|--:|
|MyDatabase|MyGraphModel|snapshot1|Nodes|17860000|56000000|16970000|890000|3.30|1000000|
|MyDatabase|MyGraphModel|snapshot1|Edges|23280000|60000000|22440000|840000|2.67|2000000|
|MyDatabase|MyGraphModel|snapshot1|GraphStructure|4120000|9800000|4120000|0|2.38|3000000|

## Notes

- This command reports storage profile metrics. For build-time metrics such as CPU, memory, and duration, use [.show graph_snapshot statistics](graph-snapshot-statistics-show.md).

## Related commands

- [.show graph_snapshots data statistics](graph-snapshots-data-statistics-show.md)
- [.show graph_snapshot statistics](graph-snapshot-statistics-show.md)
- [.show graph_snapshot](graph-snapshot-show.md)
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/24/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Deletes a specific graph snapshot from a graph model.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/24/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in 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.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 02/02/2026
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

A graph snapshot is a database entity that represents a materialized instance of a graph model at a specific point in time. While a [graph model](graph-model-overview.md) defines the structure and data sources, a snapshot is the queryable graph implementation.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/24/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Shows detailed information about a specific graph snapshot.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 02/02/2026
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Displays detailed statistics for a specific graph snapshot, including performance metrics, resource utilization, and processing details.

Expand All @@ -23,8 +23,6 @@ You must have at least [Database User, Database Viewer, or Database Monitor](../

`.show` `graph_snapshot` *GraphModelName*`.`*SnapshotName* `statistics`

[Learn more about syntax conventions](../../query/syntax-conventions.md).

## Parameters

|Name|Type|Required|Description|
Expand Down Expand Up @@ -124,7 +122,7 @@ The `Details` column contains a JSON object with information about the processin
- Statistics include both processing metrics and final graph structure information
- The `Details` column provides a step-by-step breakdown of the snapshot creation process
- The command fails if the specified graph model doesn't exist
- Only completed steps are shown. If a retry occurs, failed steps are not displayed
- Only completed steps are shown. If a retry occurs, failed steps aren't displayed

## Related commands

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
---
title: .show graph_snapshots data statistics command
description: Learn how to display storage profile statistics for graph snapshots by using the .show graph_snapshots data statistics command.
ms.reviewer: royo
ms.topic: reference
ms.date: 06/16/2026
---

# .show graph_snapshots data statistics (preview)

> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Displays a storage profile for graph snapshots, including persisted size, compression, index footprint, and element count for nodes, edges, and graph structure data.

## Permissions

You must have at least [Database User, Database Viewer, or Database Monitor](../../access-control/role-based-access-control.md) permissions to run this command.

## Syntax

`.show` `graph_snapshots` *GraphModelName* `data` `statistics`

`.show` `graph_snapshots` `*` `data` `statistics`

## Parameters

|Name|Type|Required|Description|
|--|--|--|--|
|*GraphModelName*|`string`|✅|The name of the graph model to display data statistics for. Use `*` to show data statistics for all graph models in scope.|

## Returns

This command returns a table with the following columns:

|Column|Type|Description|
|--|--|--|
|*DatabaseName*|`string`|The name of the database containing the graph model and snapshot.|
|*GraphModelName*|`string`|The name of the graph model.|
|*SnapshotName*|`string`|The name of the snapshot.|
|*EntityKind*|`string`|The data category for the row: `Nodes`, `Edges`, or `GraphStructure`.|
|*TotalExtentSize*|`long`|Total persisted size in bytes (`DataCompressedSize + IndexSize`)`*`.|
|*OriginalSize*|`long`|Uncompressed data size in bytes`*`.|
|*DataCompressedSize*|`long`|Compressed data size in bytes, excluding index`*`.|
|*IndexSize*|`long`|Index size in bytes, including the shared text index`*`.|
|*CompressionRatio*|`real`|`OriginalSize / DataCompressedSize`; 0 when `DataCompressedSize` is 0`*`.|
|*TotalElementCount*|`long`|Number of elements in the entity`*`.|

The command returns two or three rows per snapshot: one row each for `Nodes` and `Edges`, and an additional `GraphStructure` row when graph structure data exists.

`*` *Values may be up to 15 minutes old, as they're taken from a cached summary of the graph's extents.*

## Examples

### Show data statistics for all snapshots of a graph model

```kusto
.show graph_snapshots MyGraphModel data statistics
```

#### Output

|DatabaseName|GraphModelName|SnapshotName|EntityKind|TotalExtentSize|OriginalSize|DataCompressedSize|IndexSize|CompressionRatio|TotalElementCount|
|--|--|--|--|--:|--:|--:|--:|--:|--:|
|MyDatabase|MyGraphModel|snapshot1|Nodes|17860000|56000000|16970000|890000|3.30|1000000|
|MyDatabase|MyGraphModel|snapshot1|Edges|23280000|60000000|22440000|840000|2.67|2000000|
|MyDatabase|MyGraphModel|snapshot1|GraphStructure|4120000|9800000|4120000|0|2.38|3000000|
|MyDatabase|MyGraphModel|snapshot2|Nodes|18620000|58400000|17610000|1010000|3.32|1050000|
|MyDatabase|MyGraphModel|snapshot2|Edges|24150000|62800000|23230000|920000|2.70|2100000|

### Show data statistics for all snapshots across all graph models on the current scope

```kusto
.show graph_snapshots * data statistics
```

This command returns data statistics for snapshots across all graph models in scope. The output shape is the same: two or three rows per snapshot.

## Notes

- This command reports storage profile metrics. For build-time metrics such as CPU, memory, and duration, use [.show graph_snapshots statistics](graph-snapshots-statistics-show.md).

## Related commands

- [.show graph_snapshot data statistics](graph-snapshot-data-statistics-show.md)
- [.show graph_snapshots statistics](graph-snapshots-statistics-show.md)
- [.show graph_snapshots](graph-snapshots-show.md)
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/24/2025
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Deletes all graph snapshots associated with a specific graph model.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 02/02/2026
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Displays information about failed graph snapshot creation attempts, including failure reasons, error details, and resource consumption statistics.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 05/27/2026
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Lists all graph snapshots for a specific graph model or for all graph models in the database.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ms.date: 02/02/2026
> [!INCLUDE [applies](../../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../../includes/applies-to-version/azure-data-explorer.md)]

> [!NOTE]
> This feature is currently in public preview. Functionality and syntax are subject to change before General Availability.
> This feature is currently in preview. Functionality and syntax are subject to change before General Availability.

Displays detailed statistics for all snapshots of a specific graph model, including performance metrics, resource utilization, and processing details.

Expand All @@ -25,8 +25,6 @@ You must have at least [Database User, Database Viewer, or Database Monitor](../

`.show` `graph_snapshots` `*` `statistics`

[Learn more about syntax conventions](../../query/syntax-conventions.md).

## Parameters

|Name|Type|Required|Description|
Expand Down