Merge pull request #293471 from spelluru/asafreshness01232

Stream Analytics - freshness

Author: prmerger-automator[bot]

articles/stream-analytics/cicd-tools.md

@@ -1,11 +1,12 @@
 ---
-title: Automate builds, tests, and deployments of an Azure Stream Analytics job using CI/CD tools
+title: Automate builds, tests, and deployments using CI/CD tools
 description: This article describes how to use Azure Stream Analytics CI/CD tools to auto build, test, and deploy an Azure Stream Analytics project.
 author: alexlzx
 ms.author: zhenxilin
 ms.service: azure-stream-analytics
 ms.topic: how-to
-ms.date: 03/08/2023
+ms.date: 01/23/2025
+# Customer intent: I want to know how to automate builds, tests, and deployments of Azure Stream Analytics projects using CI/CD tools. 
 ---
 
 # Automate builds, tests, and deployments of a Stream Analytics project
@@ -53,7 +54,7 @@ azure-streamanalytics-cicd build --v2 --project ./asaproj.json --outputPath ./De
 If the project is built successfully, you see two JSON files created under the output folder:
 
 * ARM template file: `[ProjectName].JobTemplate.json`
-* ARM parameter file: `[ProjectName].JobTemplate.parameters.json`
+* Azure Resource Manager parameter file: `[ProjectName].JobTemplate.parameters.json`
 
 The default values for **parameters.json** file come from your project settings. If you want to deploy to another environment, replace the values accordingly.
 
@@ -251,7 +252,7 @@ To deploy your Stream Analytics project using ARM templates, follow these steps:
 
 For more information about deploying resources with ARM templates, see [Deploy with a Resource Manager template file and Azure PowerShell](https://aka.ms/armdeploytemplate).
 
-## Next steps
+## Related content
 
 * [Continuous integration and Continuous deployment for Azure Stream Analytics](cicd-overview.md)
 * [Set up CI/CD pipeline for Stream Analytics job using Azure Pipelines](set-up-cicd-pipeline.md)

articles/stream-analytics/power-bi-output.md

@@ -1,11 +1,12 @@
 ---
 title: Power BI output from Azure Stream Analytics
-description: This article describes how to output data from Azure Stream Analytics to Power BI.
+description: This article describes how to output data from Azure Stream Analytics to Power BI for a rich visualization experience of analysis results. 
 author: AliciaLiMicrosoft 
 ms.author: ali 
 ms.service: azure-stream-analytics
-ms.topic: conceptual
-ms.date: 07/20/2023
+ms.topic: concept-article
+ms.date: 01/23/2025
+# Customer intent: I want to learn how to send output from a Stream Analytics job to Power BI. 
 ---
 
 # Power BI output from Azure Stream Analytics
@@ -44,7 +45,7 @@ Azure Stream Analytics creates a Power BI dataset and table schema for the user
 Power BI uses the first-in, first-out (FIFO) retention policy. Data is collected in a table until it hits 200,000 rows.
 
 > [!NOTE]
-> We do not recommend using multiple outputs to write to the same dataset because it can cause several issues. Each output tries to create the Power BI dataset independently which can result in multiple datasets with the same name. Additionally, if the outputs don't have consistent schemas, the dataset changes the schema on each write, which leads to too many schema change requests. Even if these issues are avoided, multiple outputs will be less performant than a single merged output.
+> We don't recommend using multiple outputs to write to the same dataset because it can cause several issues. Each output tries to create the Power BI dataset independently which can result in multiple datasets with the same name. Additionally, if the outputs don't have consistent schemas, the dataset changes the schema on each write, which leads to too many schema change requests. Even if these issues are avoided, multiple outputs are less performant than a single merged output.
 
 ### Convert a data type from Stream Analytics to Power BI
 
@@ -58,7 +59,7 @@ This table covers the data type conversions from [Stream Analytics data types](/
 | nvarchar(max) | String |
 | datetime | Datetime |
 | float | Double |
-| Record array | String type, constant value `IRecord` or `IArray` |
+| Record array | String type, constant value `IRecord`, or `IArray` |
 
 ### Update the schema
 
@@ -83,7 +84,7 @@ You can use the following equation to compute the value to give your window in s
 For example:
 
 * You have 1,000 devices sending data at one-second intervals.
-* You're using the Power BI Pro SKU that supports 1,000,000 rows per hour.
+* You're using the Power BI Pro Stock Keeping Unit (SKU) that supports 1,000,000 rows per hour.
 * You want to publish the amount of average data per device to Power BI.
 
 As a result, the equation becomes:
@@ -113,7 +114,7 @@ Similarly, if a job starts after the token has expired, an error occurs and the
 
 After the authorization has been refreshed with Power BI, a green alert appears in the authorization area to reflect that the issue has been resolved. To overcome this limitation, it's recommended to [use Managed Identity to authenticate your Azure Stream Analytics job to Power BI](powerbi-output-managed-identity.md)
 
-## Next steps
+## Related content
 
 * [Use Managed Identity to authenticate your Azure Stream Analytics job to Power BI](powerbi-output-managed-identity.md)
 * [Quickstart: Create a Stream Analytics job by using the Azure portal](stream-analytics-quick-create-portal.md)

articles/stream-analytics/stream-analytics-parsing-json.md

@@ -1,19 +1,19 @@
 ---
 title: Parsing JSON and AVRO in Azure Stream Analytics
-description: This article describes how to operate on complex data types like arrays, JSON, CSV formatted data.
+description: This article describes how to operate on complex data types like arrays, JSON, CSV formatted data when using Azure Stream Analytics.
 ms.service: azure-stream-analytics
 author: an-emma
 ms.author: raan
-ms.topic: conceptual
-ms.date: 05/25/2023
-ms.custom:
+ms.topic: concept-article
+ms.date: 01/23/2025
+# Customer intent: I want to know about Azure Stream Analytics support for parsing JSON and AVRO data. 
 ---
 # Parse JSON and Avro data in Azure Stream Analytics
 
-Azure Stream Analytics support processing events in CSV, JSON, and Avro data formats. Both JSON and Avro data can be structured and contain some complex types such as nested objects (records) and arrays. 
+The Azure Stream Analytics service supports processing events in CSV, JSON, and Avro data formats. Both JSON and Avro data can be structured and contain some complex types such as nested objects (records) and arrays. 
 
 >[!NOTE]
->AVRO files created by Event Hub Capture use a specific format that requires you to use the *custom deserializer* feature. For more information, see [Read input in any format using .NET custom deserializers](./custom-deserializer-examples.md).
+>AVRO files created by Event Hubs Capture use a specific format that requires you to use the *custom deserializer* feature. For more information, see [Read input in any format using .NET custom deserializers](./custom-deserializer-examples.md).
 
 
 
@@ -44,7 +44,7 @@ Record data types are used to represent JSON and Avro arrays when corresponding
 ```
 
 ### Access nested fields in known schema
-Use dot notation (.) to easily access nested fields directly from your query. For example, this query selects the Latitude and Longitude coordinates under the Location property in the preceding JSON data. The dot notation can be used to navigate multiple levels as shown below.
+Use dot notation (.) to easily access nested fields directly from your query. For example, this query selects the Latitude and Longitude coordinates under the Location property in the preceding JSON data. The dot notation can be used to navigate multiple levels as shown in the following snippet:
 
 ```SQL
 SELECT
@@ -82,9 +82,9 @@ The result is:
 
 ### Access nested fields when property name is a variable
 
-Use the [GetRecordPropertyValue](/stream-analytics-query/getrecordpropertyvalue-azure-stream-analytics) function if the property name is a variable. This allows for building dynamic queries without hardcoding property names.
+Use the [GetRecordPropertyValue](/stream-analytics-query/getrecordpropertyvalue-azure-stream-analytics) function if the property name is a variable. It allows for building dynamic queries without hardcoding property names.
 
-For example, imagine the sample data stream needs **to be joined with reference data** containing thresholds for each device sensor. A snippet of such reference data is shown below.
+For example, imagine the sample data stream needs **to be joined with reference data** containing thresholds for each device sensor. A snippet of such reference data is shown in the following snippet.
 
 ```json
 {
@@ -99,7 +99,7 @@ For example, imagine the sample data stream needs **to be joined with reference
 }
 ```
 
-The goal here is to join our sample dataset from the top of the article to that reference data, and output one event for each sensor measure above its threshold. That means our single event above can generate multiple output events if multiple sensors are above their respective thresholds, thanks to the join. To achieve similar results without a join, see the section below.
+The goal here's to join our sample dataset from the top of the article to that reference data, and output one event for each sensor measure above its threshold. That means our single event above can generate multiple output events if multiple sensors are above their respective thresholds, thanks to the join. To achieve similar results without a join, see the following example:
 
 ```SQL
 SELECT
@@ -119,8 +119,8 @@ WHERE
 The result is:
 
 |DeviceID|SensorName|AlertMessage|
-|-|-|-|
-|12345|Humidity|Alert : Sensor above threshold|
+| - | - | - |
+| 12345 | Humidity | Alert: Sensor above threshold |
 
 ### Convert record fields into separate events
 
@@ -165,7 +165,7 @@ SELECT DeviceID, PropertyValue AS Humidity INTO HumidityOutput FROM Stage0 WHERE
 ```
 
 ### Parse JSON record in SQL reference data
-When using Azure SQL Database as reference data in your job, it's possible to have a column that has data in JSON format. An example is shown below.
+When using Azure SQL Database as reference data in your job, it's possible to have a column that has data in JSON format. An example is shown in the following example: 
 
 |DeviceID|Data|
 |-|-|
@@ -180,7 +180,7 @@ return JSON.parse(string);
 }
 ```
 
-You can then create a step in your Stream Analytics query as shown below to access the fields of your JSON records.
+You can then create a step in your Stream Analytics query as shown here to access the fields of your JSON records.
 
  ```SQL
  WITH parseJson as
@@ -198,9 +198,9 @@ You can then create a step in your Stream Analytics query as shown below to acce
 
 ## Array data types
 
-Array data types are an ordered collection of values. Some typical operations on array values are detailed below. These examples use the functions [GetArrayElement](/stream-analytics-query/getarrayelement-azure-stream-analytics), [GetArrayElements](/stream-analytics-query/getarrayelements-azure-stream-analytics), [GetArrayLength](/stream-analytics-query/getarraylength-azure-stream-analytics), and the [APPLY](/stream-analytics-query/apply-azure-stream-analytics) operator.
+Array data types are an ordered collection of values. Some typical operations on array values are detailed here. These examples use the functions [GetArrayElement](/stream-analytics-query/getarrayelement-azure-stream-analytics), [GetArrayElements](/stream-analytics-query/getarrayelements-azure-stream-analytics), [GetArrayLength](/stream-analytics-query/getarraylength-azure-stream-analytics), and the [APPLY](/stream-analytics-query/apply-azure-stream-analytics) operator.
 
-Here's an example of a event. Both `CustomSensor03` and `SensorMetadata` are of type **array**:
+Here's an example of an event. Both `CustomSensor03` and `SensorMetadata` are of type **array**:
 
 ```json
 {
@@ -294,7 +294,7 @@ The result is:
 |12345|Manufacturer|ABC|
 |12345|Version|1.2.45|
 
-If the extracted fields need to appear in columns, it is possible to pivot the dataset using the [WITH](/stream-analytics-query/with-azure-stream-analytics) syntax in addition to the [JOIN](/stream-analytics-query/join-azure-stream-analytics) operation. That join requires a [time boundary](/stream-analytics-query/join-azure-stream-analytics#BKMK_DateDiff) condition that prevents duplication:
+If the extracted fields need to appear in columns, it's possible to pivot the dataset using the [WITH](/stream-analytics-query/with-azure-stream-analytics) syntax in addition to the [JOIN](/stream-analytics-query/join-azure-stream-analytics) operation. That join requires a [time boundary](/stream-analytics-query/join-azure-stream-analytics#BKMK_DateDiff) condition that prevents duplication:
 
 ```SQL
 WITH DynamicCTE AS (
@@ -322,5 +322,5 @@ The result is:
 |-|-|-|-|-|
 |12345|47|122|1.2.45|ABC|
 
-## See Also
+## Related content
 [Data Types in Azure Stream Analytics](/stream-analytics-query/data-types-azure-stream-analytics)