Merge pull request #213524 from spelluru/twitter1003

A few updates, but couldn't get the twitter client app working

Author: v-dirichards

articles/stream-analytics/stream-analytics-twitter-sentiment-analysis-trends.md

@@ -7,26 +7,26 @@ ms.author: ebnkruma
 ms.reviewer: jasonh
 ms.service: stream-analytics
 ms.topic: how-to
-ms.date: 03/16/2021
+ms.date: 10/03/2022
 ---
 
 # Social media analysis with Azure Stream Analytics
 
-This article teaches you how to build a social media sentiment analysis solution by bringing real-time Twitter events into Azure Event Hubs. You write an Azure Stream Analytics query to analyze the data and store the results for later use or create a [Power BI](https://powerbi.com/) dashboard to provide insights in real-time.
+This article teaches you how to build a social media sentiment analysis solution by bringing real-time Twitter events into Azure Event Hubs and then analyzing them using Stream Analytics. You write an Azure Stream Analytics query to analyze the data and store results for later use or create a [Power BI](https://powerbi.com/) dashboard to provide insights in real-time.
 
 Social media analytics tools help organizations understand trending topics. Trending topics are subjects and attitudes that have a high volume of posts on social media. Sentiment analysis, which is also called *opinion mining*, uses social media analytics tools to determine attitudes toward a product or idea. 
 
 Real-time Twitter trend analysis is a great example of an analytics tool because the hashtag subscription model enables you to listen to specific keywords (hashtags) and develop sentiment analysis of the feed.
 
 ## Scenario: Social media sentiment analysis in real time
 
-A company that has a news media website is interested in gaining an advantage over its competitors by featuring site content that is immediately relevant to its readers. The company uses social media analysis on topics that are relevant to readers by doing real-time sentiment analysis of Twitter data.
+A company that has a news media website is interested in gaining an advantage over its competitors by featuring site content that's immediately relevant to its readers. The company uses social media analysis on topics that are relevant to readers by doing real-time sentiment analysis of Twitter data.
 
 To identify trending topics in real time on Twitter, the company needs real-time analytics about the tweet volume and sentiment for key topics.
 
 ## Prerequisites
 
-In this how-to guide, you use a client application that connects to Twitter and looks for tweets that have certain hashtags (which you can set). To run the application and analyze the tweets using Azure Streaming Analytics, you must have the following:
+In this how-to guide, you use a client application that connects to Twitter and looks for tweets that have certain hashtags (which you can set). The following list gives you prerequisites for running the application and analyzing the tweets using Azure Streaming Analytics.
 
 * If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/).
 
@@ -36,43 +36,32 @@ In this how-to guide, you use a client application that connects to Twitter and
 
 * Install the [.NET Core CLI](/dotnet/core/tools/?tabs=netcore2x) version 2.1.0.
 
-Below is the solution architecture you are going to implement.
+Here's the solution architecture you're going to implement.
 
    ![A diagram showing different pieces of services and applications used to build the solution.](./media/stream-analytics-twitter-sentiment-analysis-trends/solution-diagram.png "Solution Diagram")
 
 ## Create an event hub for streaming input
 
-The sample application generates events and pushes them to an Azure event hub. Azure Event Hubs are the preferred method of event ingestion for Stream Analytics. For more information, see the [Azure Event Hubs documentation](../event-hubs/event-hubs-about.md).
+The sample application generates events and pushes them to an event hub. Azure Event Hubs is the preferred method of event ingestion for Stream Analytics. For more information, see the [Azure Event Hubs documentation](../event-hubs/event-hubs-about.md).
 
-### Create an event hub namespace and event hub
-In this section, you create an event hub namespace and add an event hub to that namespace. Event hub namespaces are used to logically group related event bus instances. 
 
-1. Log  in to the Azure portal and select **Create a resource**. Then. search for **Event Hubs** and select **Create**.
+### Create an Event Hubs namespace and event hub
 
-2. On the **Create Namespace** page, enter a namespace name. You can use any name for the namespace, but the name must be valid for a URL, and it must be unique across Azure. 
-    
-3. Select a pricing tier and subscription, and create or choose a resource group. Then, choose a location and select **Create**. 
- 
-4. When the namespace has finished deploying, navigate to your resource group and find the event hub namespace in your list of Azure resources. 
-
-5. From the new namespace, select **+ Event Hub**. 
+Follow instructions from [Quickstart: Create an event hub using Azure portal](../event-hubs/event-hubs-create.md) to create an Event Hubs namespace and an event hub named **socialtwitter-eh**. You can use a different name. If you do, make a note of it, because you need the name later. You don't need to set any other options for the event hub.
 
-6. Name the new event hub *socialtwitter-eh*. You can use a different name. If you do, make a note of it, because you need the name later. You don't need to set any other options for the event hub.
- 
-7. Select **Create**.
 
 ### Grant access to the event hub
 
 Before a process can send data to an event hub, the event hub needs a policy that allows access. The access policy produces a connection string that includes authorization information.
 
-1.	In the navigation bar on the left side of your event hubs namespace, select **Event Hubs**, which is located in the **Entities** section. Then, select the event hub you just created.
+1.	In the navigation bar on the left side of your Event Hubs namespace, select **Event Hubs**, which is located in the **Entities** section. Then, select the event hub you just created.
 
 2.	In the navigation bar on the left side, select **Shared access policies** located under **Settings**.
 
     >[!NOTE]
-    >There is a Shared access policies option under for the event hub namespace and for the event hub. Make sure you're working in the context of your event hub, not the overall event hub namespace.
+    >There is a **Shared access policies** option under for the namespace and for the event hub. Make sure you're working in the context of your event hub, not the namespace.
 
-3.	From the access policy page, select **+ Add**. Then enter *socialtwitter-access* for the **Policy name** and check the **Manage** checkbox.
+3.	On the **Shared access policies** page, select **+ Add** on the commandbar. Then enter *socialtwitter-access* for the **Policy name** and check the **Manage** checkbox.
 
 4.	Select **Create**.
 
@@ -85,7 +74,7 @@ Before a process can send data to an event hub, the event hub needs a policy tha
    The connection string looks like this:
 
    ```
-   Endpoint=sb://EVENTHUBS-NAMESPACE.servicebus.windows.net/;SharedAccessKeyName=socialtwitter-access;SharedAccessKey=Gw2NFZw6r...FxKbXaC2op6a0ZsPkI=;EntityPath=socialtwitter-eh
+   Endpoint=sb://EVENTHUBS-NAMESPACE.servicebus.windows.net/;SharedAccessKeyName=socialtwitter-access;SharedAccessKey=XXXXXXXXXXXXXXX;EntityPath=socialtwitter-eh
    ```
 
    Notice that the connection string contains multiple key-value pairs, separated with semicolons: `Endpoint`, `SharedAccessKeyName`, `SharedAccessKey`, and `EntityPath`.  
@@ -98,7 +87,7 @@ Before a process can send data to an event hub, the event hub needs a policy tha
 The client application gets tweet events directly from Twitter. In order to do so, it needs permission to call the Twitter Streaming APIs. To configure that permission, you create an application in Twitter, which generates unique credentials (such as an OAuth token). You can then configure the client application to use these credentials when it makes API calls. 
 
 ### Create a Twitter application
-If you do not already have a Twitter application that you can use for this how-to guide, you can create one. You must already have a Twitter account.
+If you don't already have a Twitter application that you can use for this how-to guide, you can create one. You must already have a Twitter account.
 
 > [!NOTE]
 > The exact process in Twitter for creating an application and getting the keys, secrets, and token might change. If these instructions don't match what you see on the Twitter site, refer to the Twitter developer documentation.
@@ -135,7 +124,7 @@ Before the application runs, it requires certain information from you, like the
    * Set `EventHubNameConnectionString` to the connection string.
    * Set `EventHubName` to the event hub name (that is  the value of the entity path).
 
-3. Open the command line and navigate to the directory where your TwitterClientCore app is located. Use the command `dotnet build` to build the project. Then use the command `dotnet run` to run the app. The app sends Tweets to your Event Hub.
+3. Open the command line and navigate to the directory where your TwitterClientCore app is located. Use the command `dotnet build` to build the project. Then use the command `dotnet run` to run the app. The app sends Tweets to your Event Hubs.
 
 ## Create a Stream Analytics job
 
@@ -159,9 +148,9 @@ Now that tweet events are streaming in real time from Twitter, you can set up a
    |---------|---------|---------|
    |Input alias| *TwitterStream* | Enter an alias for the input. |
    |Subscription  | \<Your subscription\> |  Select the Azure subscription that you want to use. |
-   |Event Hub namespace | *asa-twitter-eventhub* |
-   |Event Hub name | *socialtwitter-eh* | Choose *Use existing*. Then select the Event Hub you created.|
-   |Event compression type| GZip | The data compression type.|
+   |Event Hubs namespace | *asa-twitter-eventhub* |
+   |Event hub name | *socialtwitter-eh* | Choose *Use existing*. Then select the event hub you created.|
+   |Event compression type| Gzip | The data compression type.|
 
    Leave the remaining default values and select **Save**.
 
@@ -180,7 +169,7 @@ To compare the number of mentions among topics, you can use a [Tumbling window](
    FROM TwitterStream
    ```
 
-3. Event data from the messages should appear in the **Input preview** window below your query. Ensure the **View** is set to **JSON**. If you do not see any data, ensure that your data generator is sending events to your event hub, and that you've selected **GZip** as the compression type for the input.
+3. Event data from the messages should appear in the **Input preview** window below your query. Ensure the **View** is set to **JSON**. If you don't see any data, ensure that your data generator is sending events to your event hub, and that you've selected **Gzip** as the compression type for the input.
 
 4. Select **Test query** and notice the results in the **Test results** window below your query.
 
@@ -196,15 +185,15 @@ To compare the number of mentions among topics, you can use a [Tumbling window](
 
 ## Create an output sink
 
-You have now defined an event stream, an event hub input to ingest events, and a query to perform a transformation over the stream. The last step is to define an output sink for the job.  
+You've now defined an event stream, an event hub input to ingest events, and a query to perform a transformation over the stream. The last step is to define an output sink for the job.  
 
 In this how-to guide, you write the aggregated tweet events from the job query to Azure Blob storage.  You can also push your results to Azure SQL Database, Azure Table storage, Event Hubs, or Power BI, depending on your application needs.
 
 ## Specify the job output
 
 1. Under the **Job Topology** section on the left navigation menu, select **Outputs**. 
 
-2. In the **Outputs** page, click **+&nbsp;Add** and **Blob storage/Data Lake Storage Gen2**:
+2. In the **Outputs** page, select **+&nbsp;Add** and **Blob storage/Data Lake Storage Gen2**:
 
    * **Output alias**: Use the name `TwitterStream-Output`. 
    * **Import options**: Select **Select storage from your subscriptions**.
@@ -215,7 +204,7 @@ In this how-to guide, you write the aggregated tweet events from the job query t
 
 ## Start the job
 
-A job input, query, and output are specified. You are ready to start the Stream Analytics job.
+A job input, query, and output are specified. You're ready to start the Stream Analytics job.
 
 1. Make sure the TwitterClientCore application is running.