Skip to content

Commit 680377e

Browse files
Merge pull request #2652 from MicrosoftDocs/main639055839326740493sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 0e78ad6 + 9b9516c commit 680377e

26 files changed

+54
-20
lines changed

docs/real-time-hub/get-started-real-time-hub.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,7 @@ There are two ways you can get to the **Data sources** page:
130130

131131
- By selecting **Add data** button on the **Streaming Data** page.
132132

133-
:::image type="content" source="media/get-started-real-time-hub/streaming-data-add-data.png" alt-text="Screenshot that shows the Add data button." lightbox="./media/get-started-real-time-hub/streaming-data-add-data.png":::
133+
:::image type="content" source="media/get-started-real-time-hub/connect-to-data-source-button.png" alt-text="Screenshot that shows the Add data button." lightbox="./media/get-started-real-time-hub/connect-to-data-source-button.png":::
134134
- By selecting **Add data** on the left navigation menu.
135135

136136
:::image type="content" source="media/get-started-real-time-hub/add-data.png" alt-text="Screenshot that shows the Data sources page." lightbox="./media/get-started-real-time-hub/add-data.png":::
-14.4 KB
Loading
-4.04 KB
Loading
-8.53 KB
Loading
21.6 KB
Loading
-7.95 KB
Loading
88 KB
Loading
-18 KB
Loading
Binary file not shown.

docs/real-time-intelligence/manage-monitor-database.md

Lines changed: 21 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@ ms.author: spelluru
66
author: spelluru
77
ms.topic: how-to
88
ms.custom:
9-
ms.date: 05/06/2025
9+
ms.date: 01/29/2026
1010
ms.subservice: rti-eventhouse
1111
ms.search.form: Database
1212
#customer intent: As a user, I want to learn how to manage and monitor a KQL database so that I can effectively utilize Real-Time Intelligence.
1313
---
1414
# Manage and monitor a database
1515

16-
The main page of your KQL database shows an overview of the contents and activity of your database. You track database activity, preview tables, gain insights into the database table schemas.
16+
The main page of your KQL database shows an overview of the contents and activity of your database. You can track data activity, preview tables, and gain insights into the database table schemas.
1717

1818
## Prerequisites
1919

@@ -35,15 +35,15 @@ This page is divided into the following sections:
3535

3636
A. **Database ribbon**: The ribbon provides quick access to essential actions within the database.
3737

38-
B. **Explorer pane**: The explorer pane provides an intuitive interface for navigating between with databases.
38+
B. **Explorer pane**: The explorer pane provides an intuitive interface for navigating between databases.
3939

4040
C. **Main view area**: The main view area displays the main database activities, such as querying data, ingesting data, and the database tables.
4141

4242
D. **Details area**: The details area provides additional information about the database.
4343

4444
## Manage KQL Databases
4545

46-
You can manage the databases in the eventhouse using the options in the [Database ribbon](#database-ribbon) or in the [Explorer pane](#explorer-pane) under **KQL Databases**.
46+
You can manage the databases in the eventhouse by using the options in the [Database ribbon](#database-ribbon) or in the [Explorer pane](#explorer-pane) under **KQL Databases**.
4747

4848
### Database ribbon
4949

@@ -53,11 +53,11 @@ The database ribbon is your quick-access action bar, offering a convenient way t
5353

5454
From here, you can:
5555

56-
* **Refresh**: use this button to manually refresh the database, when live view is disabled.
56+
* **Refresh**: use this button to manually refresh the database when live view is disabled.
5757

5858
* Enable **Live view**: to continually refresh the database automatically, enable Live View. Disable to manually refresh the database.
5959

60-
* Create a **New** item in the database. This includes a table, a materialized view, a table update policy, and a OneLake shortcut.
60+
* Create a **New** item in the database. This option includes a table, a materialized view, a table update policy, and a OneLake shortcut.
6161

6262
* **Get data**: select the desired ingest method. To learn more, see [data formats](ingestion-supported-formats.md) and the corresponding ingestion methods.
6363

@@ -71,7 +71,7 @@ From here, you can:
7171

7272
### Explorer pane
7373

74-
In the Explorer pane you can:
74+
In the Explorer pane, you can:
7575

7676
:::image type="content" source="media/eventhouse/manage-databases.png" alt-text="Screenshot showing the eventhouse KQL Databases section.":::
7777

@@ -93,34 +93,35 @@ In the Explorer pane you can:
9393

9494
## Main view area
9595

96-
The main database information pane tracks data activity, allows you to preview table details and data, and to view query insights.
96+
The main database information pane tracks data activity, and it allows you to preview table details and data, and to view query insights.
9797

98-
At the top of the main view area, you can select these options:
98+
At the top of the main view area, select from these options:
9999

100100
* **Query with code**: select to open the queryset for the database.
101101

102-
* **Overview** or **Entity diagram (preview)**: View an overview of the [Database activity tracker](#database-activity-tracker) and the [Tabs - Tables / Data preview / Query Insights](#data-insights) in the main view area, or view the database as an [entity diagram](database-entity-diagram.md).
102+
* **Overview** or **Entity diagram (preview)**: View an overview of the [Data activity tracker](#data-activity-tracker) and the [Tabs - Tables / Data preview / Query Insights](#data-insights) in the main view area, or view the database as an [entity diagram](database-entity-diagram.md).
103103

104104
* **Share**: to share access to a database, select the database from the list and [share the database link](access-database-copy-uri.md#share-a-kql-database-link).
105105

106106
> [!NOTE]
107107
> Sharing multiple databases at once isn't supported.
108108
109-
### Database activity tracker
109+
### Data activity tracker
110110

111-
The database activity tracker displays the number of rows loaded into the database and the number or queries, in the selected time range.
111+
The data activity tracker displays the number of rows loaded into the database and the number of queries, in the selected time range.
112112

113-
:::image type="content" source="media/create-database/database-activity-tracker-tooltip.png" alt-text="Screenshot of KQL database activity tracker." lightbox="media/create-database/database-activity-tracker-tooltip.png":::
113+
:::image type="content" source="media/create-database/database-activity-tracker-tooltip.png" alt-text="Screenshot of KQL data activity tracker." lightbox="media/create-database/database-activity-tracker-tooltip.png":::
114114

115115
| Item| Description|
116116
|---|---|
117117
| **Ingestion** | The number of rows loaded into the database in the selected time range. Select **Ingestion** to view only ingestion data. Select again to view both query and ingestion data. |
118-
| **Queries** | The number of queries that ran in the database in the selected time range. Select **Queries** to view only query data. Select again to view both query and ingestion data . <br></br> If there are failed, throttled, or canceled queries, you can open the dropdown menu to view them as a percentage compared to the total queries. <br></br> :::image type="content" source="media/create-database/queries-cancelled-menu.png" alt-text="Screenshot of percentage of queries completed.":::|
118+
| **Queries** | The number of queries that ran in the database in the selected time range. Select **Queries** to view only query data. Select again to view both query and ingestion data. <br></br> If there are failed, throttled, or canceled queries, you can open the dropdown menu to view them as a percentage compared to the total queries. <br></br> :::image type="content" source="media/create-database/queries-cancelled-menu.png" alt-text="Screenshot of percentage of queries completed.":::|
119119
| **Last run** | The time when the histogram was last generated.|
120-
| Time range | The time range of the histogram display. Set ranges for one hour, six hours, three days, seven days, or 30 days. |
121-
| Interval | Set the data aggregation interval for the histogram display. Set intervals by one minute, five minutes, one hour, 12 hours, one day, three days, and 30 days. |
120+
| Time range | The time range of the histogram display. Set ranges for one hour, six hours, three days, 7 days, or 30 days. |
121+
| Interval | Set the data aggregation interval for the histogram display. Set intervals by one minute, five minutes, 1 hour, 12 hours, one day, 3 days, and 30 days. |
122122
| Refresh | Refresh your histogram manually.|
123123
| Histogram | The query and ingestion data display side by side, each with their own vertical scale. The ingestion scale is on the left, and the query scale is on the right of the histogram.<br><br/>The ingestion histogram displays data by the interval chosen, and displays in UTC time. Hover over the histogram to display total rows ingested and total queries per status. |
124+
| **Open query** | Open the KQL editor with the underlying query preloaded. This step allows you to modify and execute the query directly to analyze the data further. |
124125

125126
### Data insights
126127

@@ -134,7 +135,9 @@ The tabs and graphs show the following information:
134135
|---|---|
135136
| **Tables** | View table information as **Cards** or as a **List**. Cards and lists view table name, *Compressed size*, *Last ingestion*, and *OneLake availability* or latency. </br></br>* Cards uniquely display a histogram of the database ingestion over the past seven days, the number of rows ingested in the last ingestion, and the table creator profile. </br></br>* The list view display also shows total *Row count*, *Original size*, *Compressed size*, *Last ingestion*, *Caching*, *Retention*, *OneLake* status, and *Created on*. To explore a specific table, select the name of this table from the list. For more information, see [Manage and monitor a table](manage-monitor-table.md). |
136137
| **Data preview** | Shows a preview of the top records ingested for each table. Displays *IngestionTime*, *TableName*, and *Record*. Select **Columns** to select columns and values for a Pivot view. You can also search for keywords and use the filter tables option.|
137-
| **Query insights** | Shows query duration, cache hit misses over time, and top queries.<br></br>* **Queries duration (sec) percentiles over time**: The query duration percentiles represent the duration values in seconds or milliseconds, below which 50%, 75%, and 90% of the query durations fall, respectively. To see the query duration details at a specific point in time, hover over the graph and the details pop up.<br></br>* **Cache hit misses over time (%)**: High cache miss percentage indicates requested data wasn't in cache, leading to longer query durations.<br></br>* **Top queries**: A list of queries that can be sorted according to most recent, longest duration, highest CPU usage, highest cold storage usage, or highest memory peak usage. You can also filter the queries by complete, failed, throttled, or canceled. To sort, use the **Top by:** menu.</br> :::image type="content" source="media/create-database/queries-top-by-menu.png" alt-text="Screenshot of queries menu to see percentage of queries completed."::: |
138+
| **Query insights** | Shows query duration, cache hit misses over time, and top queries.<br></br>* **Queries duration (sec) percentiles over time**: The query duration percentiles represent the duration values in seconds or milliseconds, below which 50%, 75%, and 90% of the query durations fall, respectively. To see the query duration details at a specific point in time, hover over the graph and the details pop up.<br></br>* **Cache hit misses over time (%)**: High cache miss percentage indicates requested data wasn't in cache, leading to longer query durations.<br></br>* **Top queries**: A list of queries that you can sort according to most recent, longest duration, highest CPU usage, highest cold storage usage, or highest memory peak usage. You can also filter the queries by complete, failed, throttled, or canceled. To sort, use the **Top by:** menu.</br> :::image type="content" source="media/create-database/queries-top-by-menu.png" alt-text="Screenshot of queries menu to see percentage of queries completed."::: |
139+
140+
In most graphs, you can select the **Open query** in the ellipsis menu to open the KQL editor with the underlying query preloaded. This step allows you to modify and execute the query directly to analyze the data further.
138141

139142
## Database details
140143

@@ -151,7 +154,7 @@ The right pane displays details of the selected database showing the following i
151154

152155
| Item| Description|
153156
|---|---|
154-
| Availability| Set OneLake availability to **Enabled** or **Disabled**. When OneLake availability is enabled, tables can't be renamed.|
157+
| Availability| Set OneLake availability to **Enabled** or **Disabled**. When you enable OneLake availability, you can't rename tables.|
155158
| Latency| The maximum time until data is available across tables in OneLake.|
156159
| Table number |The number of tables available in OneLake. |
157160
| OneLake path | Copy the OneLake folder path for creating shortcuts.|

0 commit comments

Comments
 (0)