Skip to content

Commit 94adb1f

Browse files
authored
Merge pull request #197496 from guywi-ms/querying-restored-data
Update restore.md
2 parents 874f616 + 769e59e commit 94adb1f

File tree

1 file changed

+22
-4
lines changed

1 file changed

+22
-4
lines changed

articles/azure-monitor/logs/restore.md

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.date: 01/19/2022
1010
The restore operation makes a specific time range of data in a table available in the hot cache for high-performance queries. This article describes how to restore data, query that data, and then dismiss the data when you're done.
1111

1212
## When to restore logs
13-
Use the restore operation to query data in [Archived Logs](data-retention-archive.md). You can also use the restore operation to run powerful queries within a specific time range on any Analytics table when the log queries you run on the source table cannot complete within the log query timeout of 10 minutes.
13+
Use the restore operation to query data in [Archived Logs](data-retention-archive.md). You can also use the restore operation to run powerful queries within a specific time range on any Analytics table when the log queries you run on the source table can't complete within the log query timeout of 10 minutes.
1414

1515
> [!NOTE]
1616
> Restore is one method for accessing archived data. Use restore to run queries against a set of data within a particular time range. Use [Search jobs](search-jobs.md) to access data based on specific criteria.
@@ -20,7 +20,7 @@ When you restore data, you specify the source table that contains the data you w
2020

2121
The restore operation creates the restore table and allocates additional compute resources for querying the restored data using high-performance queries that support full KQL.
2222

23-
The destination table provides a view of the underlying source data, but does not affect it in any way. The table has no retention setting, and you must explicitly [dismiss the restored data](#dismiss-restored-data) when you no longer need it.
23+
The destination table provides a view of the underlying source data, but doesn't affect it in any way. The table has no retention setting, and you must explicitly [dismiss the restored data](#dismiss-restored-data) when you no longer need it.
2424

2525
## Restore data
2626

@@ -84,11 +84,29 @@ az monitor log-analytics workspace table restore create --subscription ContosoSI
8484
```
8585

8686
---
87+
88+
## Query restored data
89+
90+
Restored logs retain their original timestamps. When you run a query on restored logs, set the query time range based on when the data was originally generated.
91+
92+
Set the query time range by either:
93+
94+
- Selecting **Custom** in the **Time range** dropdown at the top of the query editor and setting **From** and **To** values.<br>
95+
or
96+
- Specifying the time range in the query. For example:
97+
98+
```kusto
99+
let startTime =datetime(01/01/2022 8:00:00 PM);
100+
let endTime =datetime(01/05/2022 8:00:00 PM);
101+
TabelName_RST
102+
| where TimeGenerated between(startTime .. endTime)
103+
```
104+
87105
## Dismiss restored data
88106
89107
To save costs, dismiss restored data when you no longer need it by deleting the restored table.
90108
91-
Deleting the restored table does not delete the data in the source table.
109+
Deleting the restored table doesn't delete the data in the source table.
92110
93111
> [!NOTE]
94112
> Restored data is available as long as the underlying source data is available. When you delete the source table from the workspace or when the source table's retention period ends, the data is dismissed from the restored table. However, the empty table will remain if you do not delete it explicitly.
@@ -116,7 +134,7 @@ Restore is subject to the following limitations.
116134
You can:
117135

118136
- Restore data for a minimum of two days.
119-
- Restore up to 60TB.
137+
- Restore up to 60 TB.
120138
- Perform up to four restores per workspace per week.
121139
- Run up to two restore processes in a workspace concurrently.
122140
- Run only one active restore on a specific table at a given time. Executing a second restore on a table that already has an active restore will fail.

0 commit comments

Comments
 (0)