Skip to content

Commit de47c70

Browse files
learn-build-service-prod[bot]learn-build-service-prod[bot]
authored
Merge pull request #2667 from MicrosoftDocs/main638870905955954396sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 8919d26 + 3f69167 commit de47c70

8 files changed

+195
-9
lines changed

‎data-explorer/kusto/.openpublishing.redirection.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@
6262
},
6363
{
6464
"source_path": "management/show-table-mirroring-operations-command.md",
65-
"redirect_url": "/kusto/management/show-table-operations-mirroring-status-command",
65+
"redirect_url": "/kusto/management/show-database-operations-mirroring-statistics",
6666
"redirect_document_id": true
6767
},
6868
{

‎data-explorer/kusto/management/alter-merge-mirroring-policy-command.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter-merge table policy mirroring command
33
description: Learn how to use the `.alter-merge table policy mirroring` command to create a logical copy of tables of your database.
44
ms.reviewer: sharmaanshul
55
ms.topic: reference
6-
ms.date: 01/12/2025
6+
ms.date: 03/06/2025
77
monikerRange: "microsoft-fabric"
88
---
99

@@ -40,7 +40,7 @@ Changes the tables's [mirroring policy](mirroring-policy.md). The mirroring poli
4040
|Name|Type|Description|
4141
|--|--|--|
4242
|`IsEnabled`| `bool`| A Boolean value that determines whether the mirroring policy is enabled. Default value is `true`. When the mirroring policy is disabled and set to `false`, the underlying mirroring data is soft-deleted and retained in the database. |
43-
|`TargetLatencyInMinutes`| `int`| The write operation delay in minites. By default, the write operation can take up to 3 hours or until there's 256 MB of data available. You can adjust the delay to a value between 5 minutes and 3 hours. |
43+
|`TargetLatencyInMinutes`| `int`| The write operation delay in minutes. By default, the write operation can take up to 3 hours or until there's 256 MB of data available. You can adjust the delay to a value between 5 minutes and 3 hours. |
4444
|`Backfill`| `bool`| When set to `true`, mirroring starts from the `EffectiveDateTime`. If `EffectiveDateTime` isn't specified, all of the table data is mirrored. Default value is `false`.|
4545
|`EffectiveDateTime`| `datetime`| Relevant when Backfill is set to `true`. If provided, mirroring starts from the specified value.|
4646

@@ -62,5 +62,5 @@ In the following example, a table called *myTable* is mirrored. The data is part
6262

6363
## Related content
6464

65-
* To check mirroring operations, see [.show table mirroring operations command](show-table-mirroring-operations-command.md).
65+
* To check mirroring operations, see [.show table operations mirroring-statistics](show-database-operations-mirroring-statistics.md).
6666
* To delete mirroring operations, see [.delete table policy mirroring command](delete-table-mirroring-policy-command.md).

‎data-explorer/kusto/management/mirroring-policy.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,8 @@ The mirroring policy commands allow you to view, change, partition, and delete y
1717
* Use [.show table policy mirroring command](show-table-mirroring-policy-command.md) to show the current mirroring policy of the table.
1818
* Use [.alter-merge table policy mirroring command](alter-merge-mirroring-policy-command.md) to change the current mirroring policy.
1919
* Use [.delete table policy mirroring command](delete-table-mirroring-policy-command.md) to soft-delete the current mirroring policy.
20-
* Use [.show table mirroring operations command](show-table-mirroring-operations-command.md) to check operations mirroring status.
20+
* Use [.show database operations mirroring-statistics](show-database-operations-mirroring-statistics.md) to check database operations mirroring statistics.
21+
* Use [.show table operations mirroring-statistics](show-table-operations-mirroring-statistics.md) to check table operations mirroring statistics.
2122
* Use [.show table mirroring operations exported artifacts command](show-table-mirroring-operations-exported-artifacts.md) to check operations exported artifacts status.
2223
* Use [.show table mirroring operations failures](show-table-mirroring-operations-failures.md) to check operations mirroring failure status.
2324

‎data-explorer/kusto/management/show-database-operations-mirroring-statistics.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: .show database operations mirroring-statistics
3+
description: Learn how to use the `.show database operations mirroring statistics` command to check the mirroring policy operations.
4+
ms.reviewer: sharmaanshul
5+
ms.topic: reference
6+
ms.date: 04/22/2025
7+
---
8+
9+
# .show database operations mirroring-statistics
10+
11+
> [!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)]
12+
13+
Displays [mirroring policy](mirroring-policy.md) operations statistics for all tables in the database. Mirroring statistics allows you to verify the latency and status of your data export.
14+
15+
## Syntax
16+
17+
`.show` `database` *DatabaseName* `operations` `mirroring-statistics`
18+
19+
[!INCLUDE [syntax-conventions-note](../includes/syntax-conventions-note.md)]
20+
21+
## Parameters
22+
23+
|Name|Type|Required|Description|
24+
|--|--|--|--|
25+
|*DatabaseName*| `string` | :heavy_check_mark:|The name of the database for which to show the operations mirroring statistics.|
26+
27+
## Returns
28+
29+
| Property | Type | Description |
30+
|-----|-----|-----|
31+
|DatabaseName| `string` | The name of the database. |
32+
|CompletionPercentage|`int` | The status of the mirroring operation as a percentage. |
33+
|PendingDataSize| `int` | The size of data in bytes that is pending ingestion or processing. |
34+
|MaxLatency| `timespan`| The maximum amount of time in minutes between the last and next time new data was added to your logical copy. |
35+
|NumOfTables| `int`| The number of tables in the database. |
36+
37+
[!INCLUDE [mirroring-note](../includes/mirroring-note.md)]
38+
39+
## Example
40+
41+
The following example requests operations mirroring statistics of the *Telemetry* database.
42+
43+
```kusto
44+
.show database Telemetry operations mirroring-statistics
45+
```
46+
47+
**Output**
48+
49+
| DatabaseName | CompletionPercentage | PendingDataSize | MaxLatency | NumOfTables |
50+
| ------------------------------------ | -------------------- | --------------- | ---------- | ----------- |
51+
| 4145dac4-ee39-4ec2-aafb-11315b5b7c9b | 100 | 0 | 00:00:00 | 1 |

‎data-explorer/kusto/management/show-external-tables-details.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
title: .show external table details
3+
description: Learn how to use the `.show external table details` command to show details of the specified external tables in the database.
4+
ms.reviewer: yifats
5+
ms.topic: reference
6+
ms.date: 04/23/2025
7+
---
8+
# .show external table details
9+
10+
> [!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)]
11+
12+
Returns query acceleration details of a specified external table or all external tables in the database.
13+
14+
This command is relevant to any external table of any type. For an overview of external tables, see [external tables](../query/schema-entities/external-tables.md).
15+
16+
## Permissions
17+
18+
You must have at least Database User, Database Viewer, Database Monitor to run these commands. For more information, see [role-based access control](../access-control/role-based-access-control.md).
19+
20+
## Syntax
21+
22+
`.show` `external` `tables` `details`
23+
24+
`.show` `external` `table` *TableName* `details`
25+
26+
[!INCLUDE [syntax-conventions-note](../includes/syntax-conventions-note.md)]
27+
28+
## Parameters
29+
30+
|Name|Type|Required|Description|
31+
|--|--|--|--|
32+
|*TableName*| `string` | :heavy_check_mark:|The name of the external table to show.|
33+
34+
## Returns
35+
36+
| Output parameter | Type | Description |
37+
|--|--|--|
38+
| TableName | `string` | Name of external table |
39+
| QueryAccelerationPolicy | `string` | A JSON-serialization of the [query acceleration policy](#query-acceleration-policy) that is set on the table. |
40+
| QueryAccelerationState | `string` | A JSON-serialization of the [query acceleration status](#query-acceleration-state) parameters. |
41+
42+
### Query acceleration policy
43+
44+
| Column | Type | Description |
45+
|--|--|--|
46+
| TableName | `string` | The name of the external table. |
47+
| IsEnabled | `bool` | Indicates whether the external table has a query acceleration policy enabled. |
48+
| Hot | `timespan` | The hot period defined in the query acceleration policy. |
49+
50+
### Query acceleration state
51+
52+
| Column | Type | Description |
53+
|--|--|--|
54+
| HotSize | `long` | The total size on disk (in bytes) of artifacts accelerated due to the query acceleration policy. |
55+
| CompletePercentage | `double` | The percentage of artifacts that are accelerated, out of the total artifacts that are able to be accelerated. |
56+
| PendingDataFilesSize | `long` | The total size of artifacts that are pending acceleration. |
57+
| PendingDataFilesCount | `int` | The number of artifacts that are pending acceleration. |
58+
| IsHealthy | `string` | Indicated whether healthy or not health. |
59+
| NotHealthyReason | `string` | Describes the reason for query acceleration not being healthy. Empty if healthy. |
60+
| LastUpdatedDateTime | `datetime` | The last datetime when the internal representation of the table was successfully refreshed. |
61+
| Latency | `timespan` | The time in minutes since the last new data was added to your logical copy. |
62+
63+
## Example
64+
65+
```kusto
66+
.show external tables details
67+
.show external table deltatable details
68+
```
69+
70+
**Output**
71+
72+
| TableName | QueryAccelerationPolicy | QueryAccelerationState |
73+
|-----------|-----------|----------------|
74+
| deltatable | {
75+
"IsEnabled": true, "Hot": "365000.00:00:00"} | { "HotSize": 29454192, "CompletionPercentage": 75.0, "PendingArtifactSize": 21162035, "PendingArtifactCount": 3, "IsHealthy": false, "NotHealthyReason": "InaccessibleDeltaTable : Delta table does not exist", "LastUpdatedDateTime": "2025-04-03 13:38:00.1541537", "Latency": "26.00:58:12.8941033"} |

‎data-explorer/kusto/management/show-table-operations-mirroring-statistics.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
title: .show table operations mirroring-statistics
3+
description: Learn how to use the `.show table operations mirroring-statistics` command to check the mirroring policy operations.
4+
ms.reviewer: sharmaanshul
5+
ms.topic: reference
6+
ms.date: 04/22/2025
7+
---
8+
# .show table operations mirroring-statistics
9+
10+
> [!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)]
11+
12+
Displays [mirroring policy](mirroring-policy.md) operations statistics for a table. Mirroring statistics allows you to verify the latency and status of your data export.
13+
14+
## Syntax
15+
16+
`.show` `table` *TableName* `operations` `mirroring-statistics`
17+
18+
[!INCLUDE [syntax-conventions-note](../includes/syntax-conventions-note.md)]
19+
20+
## Parameters
21+
22+
|Name|Type|Required|Description|
23+
|--|--|--|--|
24+
|*TableName*| `string` | :heavy_check_mark:|The name of the table for which to show the operations mirroring statistics.|
25+
26+
## Returns
27+
28+
| Property | Type | Description |
29+
|-----|-----|-----|
30+
|TableName | `string` | The name of the table. |
31+
|IsEnabled | `bool` |Indicates whether or not the mirroring policy is enabled. |
32+
|ManagedIdentityIdentifier |`string` | The identifier of the managed identity |
33+
|IsExportRunning | `bool` | Indicates whether or not the mirroring policy is running. |
34+
|LastExportStartTime | `datetime`| The start time of the last export. |
35+
|LastExportResult | `string` | The status of the last export result. |
36+
|LastExportedDataTime|`datetime` | The time of the last data export. |
37+
|Latency | `timespan` |The maximum amount of time in minutes between the last and next time new data was added to your logical copy. |
38+
|CompletionPercentage|`int` | The percentage of a task or operation completed. |
39+
|PendingDataSize|`int` | The size of data in bytes that is pending ingestion or processing.|
40+
41+
[!INCLUDE [mirroring-note](../includes/mirroring-note.md)]
42+
43+
## Example
44+
45+
The following example requests operations mirroring-statistics of the *MTelemetry* table.
46+
47+
```kusto
48+
.show table MTelemetry operations mirroring-statistics
49+
```
50+
51+
**Output**
52+
53+
| TableName | IsEnabled | ManagedIdentityIdentifier | IsExportRunning | LastExportStartTime | LastExportResult | LastExportedDataTime | Latency | CompletionPercentage | PendingDataSize |
54+
|--|--|--|--|--|--|--|--|--|--|
55+
| MTelemetry | true | | false | 2025-04-09 18:42:37.3760 | Completed | 2025-04-09 16:47:07.8420 | 00:00:00 | 100 | 0 |

‎data-explorer/kusto/management/toc.yml‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,8 @@ items:
131131
href: external-tables-azure-storage.md
132132
- name: Create or alter delta external table
133133
href: external-tables-delta-lake.md
134+
- name: .show external table details
135+
href: show-external-tables-details.md
134136
- name: Manage external table mappings
135137
items:
136138
- name: .alter external table mapping command
@@ -540,9 +542,11 @@ items:
540542
- name: .show table policy mirroring command
541543
href: show-table-mirroring-policy-command.md
542544
displayName: .show table mirroring policy
543-
- name: .show table operations mirroring-status command
544-
href: show-table-operations-mirroring-status-command.md
545-
displayName: .show table mirroring status operations
545+
- name: .show database operations mirroring-statistics
546+
href: show-database-operations-mirroring-statistics.md
547+
- name: .show table operations mirroring-statistics
548+
href: show-table-operations-mirroring-statistics.md
549+
546550
- name: .show table operations mirroring-exported-artifacts command
547551
href: show-table-operations-mirroring-exported-artifacts-command.md
548552
displayName: .show table mirroring operations exported artifacts

‎data-explorer/kusto/query/toc.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1272,7 +1272,7 @@ items:
12721272
href: variancepif-aggregation-function.md
12731273
- name: Graph
12741274
items:
1275-
- name: Graph overview
1275+
- name: Graph semantics overview
12761276
href: graph-semantics-overview.md
12771277
- name: Graph best practices
12781278
href: graph-best-practices.md

0 commit comments

Comments
 (0)