diff --git a/samples/applications/README.md b/samples/applications/README.md index f79229fc..cf9ef9fa 100644 --- a/samples/applications/README.md +++ b/samples/applications/README.md @@ -1,7 +1,3 @@ # Application samples Applications that are built on Microsoft SQL databases, including SQL Server, Azure SQL Database, and Azure SQL Data Warehouse. - -Samples are coming soon! - - diff --git a/samples/features/in-memory/iot-smart-grid/App.config b/samples/applications/iot-smart-grid/App.config similarity index 100% rename from samples/features/in-memory/iot-smart-grid/App.config rename to samples/applications/iot-smart-grid/App.config diff --git a/samples/features/in-memory/iot-smart-grid/ConsoleClient/ConsoleClient.csproj b/samples/applications/iot-smart-grid/ConsoleClient/ConsoleClient.csproj similarity index 100% rename from samples/features/in-memory/iot-smart-grid/ConsoleClient/ConsoleClient.csproj rename to samples/applications/iot-smart-grid/ConsoleClient/ConsoleClient.csproj diff --git a/samples/features/in-memory/iot-smart-grid/ConsoleClient/Program.cs b/samples/applications/iot-smart-grid/ConsoleClient/Program.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/ConsoleClient/Program.cs rename to samples/applications/iot-smart-grid/ConsoleClient/Program.cs diff --git a/samples/features/in-memory/iot-smart-grid/ConsoleClient/Properties/AssemblyInfo.cs b/samples/applications/iot-smart-grid/ConsoleClient/Properties/AssemblyInfo.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/ConsoleClient/Properties/AssemblyInfo.cs rename to samples/applications/iot-smart-grid/ConsoleClient/Properties/AssemblyInfo.cs diff --git a/samples/features/in-memory/iot-smart-grid/DataGenerator/CancellableTask.cs b/samples/applications/iot-smart-grid/DataGenerator/CancellableTask.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/DataGenerator/CancellableTask.cs rename to samples/applications/iot-smart-grid/DataGenerator/CancellableTask.cs diff --git a/samples/features/in-memory/iot-smart-grid/DataGenerator/DataGenerator.csproj b/samples/applications/iot-smart-grid/DataGenerator/DataGenerator.csproj similarity index 100% rename from samples/features/in-memory/iot-smart-grid/DataGenerator/DataGenerator.csproj rename to samples/applications/iot-smart-grid/DataGenerator/DataGenerator.csproj diff --git a/samples/features/in-memory/iot-smart-grid/DataGenerator/Properties/AssemblyInfo.cs b/samples/applications/iot-smart-grid/DataGenerator/Properties/AssemblyInfo.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/DataGenerator/Properties/AssemblyInfo.cs rename to samples/applications/iot-smart-grid/DataGenerator/Properties/AssemblyInfo.cs diff --git a/samples/features/in-memory/iot-smart-grid/DataGenerator/SqlDataGenerator.cs b/samples/applications/iot-smart-grid/DataGenerator/SqlDataGenerator.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/DataGenerator/SqlDataGenerator.cs rename to samples/applications/iot-smart-grid/DataGenerator/SqlDataGenerator.cs diff --git a/samples/features/in-memory/iot-smart-grid/DataGenerator/SqlDataGeneratorException.cs b/samples/applications/iot-smart-grid/DataGenerator/SqlDataGeneratorException.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/DataGenerator/SqlDataGeneratorException.cs rename to samples/applications/iot-smart-grid/DataGenerator/SqlDataGeneratorException.cs diff --git a/samples/features/in-memory/iot-smart-grid/Db/Db.dbmdl b/samples/applications/iot-smart-grid/Db/Db.dbmdl similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Db/Db.dbmdl rename to samples/applications/iot-smart-grid/Db/Db.dbmdl diff --git a/samples/features/in-memory/iot-smart-grid/Db/Db.sqlproj b/samples/applications/iot-smart-grid/Db/Db.sqlproj similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Db/Db.sqlproj rename to samples/applications/iot-smart-grid/Db/Db.sqlproj diff --git a/samples/features/in-memory/iot-smart-grid/Db/Storage/mod.sql b/samples/applications/iot-smart-grid/Db/Storage/mod.sql similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Db/Storage/mod.sql rename to samples/applications/iot-smart-grid/Db/Storage/mod.sql diff --git a/samples/features/in-memory/iot-smart-grid/Db/dbo/Stored Procedures/InsertMeterMeasurement.sql b/samples/applications/iot-smart-grid/Db/dbo/Stored Procedures/InsertMeterMeasurement.sql similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Db/dbo/Stored Procedures/InsertMeterMeasurement.sql rename to samples/applications/iot-smart-grid/Db/dbo/Stored Procedures/InsertMeterMeasurement.sql diff --git a/samples/features/in-memory/iot-smart-grid/Db/dbo/Tables/MeterMeasurement.sql b/samples/applications/iot-smart-grid/Db/dbo/Tables/MeterMeasurement.sql similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Db/dbo/Tables/MeterMeasurement.sql rename to samples/applications/iot-smart-grid/Db/dbo/Tables/MeterMeasurement.sql diff --git a/samples/features/in-memory/iot-smart-grid/Db/dbo/Tables/MeterMeasurementHistory.sql b/samples/applications/iot-smart-grid/Db/dbo/Tables/MeterMeasurementHistory.sql similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Db/dbo/Tables/MeterMeasurementHistory.sql rename to samples/applications/iot-smart-grid/Db/dbo/Tables/MeterMeasurementHistory.sql diff --git a/samples/features/in-memory/iot-smart-grid/Db/dbo/User Defined Types/udtMeterMeasurement.sql b/samples/applications/iot-smart-grid/Db/dbo/User Defined Types/udtMeterMeasurement.sql similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Db/dbo/User Defined Types/udtMeterMeasurement.sql rename to samples/applications/iot-smart-grid/Db/dbo/User Defined Types/udtMeterMeasurement.sql diff --git a/samples/features/in-memory/iot-smart-grid/Db/dbo/Views/vwMeterMeasurement.sql b/samples/applications/iot-smart-grid/Db/dbo/Views/vwMeterMeasurement.sql similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Db/dbo/Views/vwMeterMeasurement.sql rename to samples/applications/iot-smart-grid/Db/dbo/Views/vwMeterMeasurement.sql diff --git a/samples/features/in-memory/iot-smart-grid/IoT-Smart-Grid.sln b/samples/applications/iot-smart-grid/IoT-Smart-Grid.sln similarity index 100% rename from samples/features/in-memory/iot-smart-grid/IoT-Smart-Grid.sln rename to samples/applications/iot-smart-grid/IoT-Smart-Grid.sln diff --git a/samples/features/in-memory/iot-smart-grid/PowerDashboard.pbix b/samples/applications/iot-smart-grid/PowerDashboard.pbix similarity index 100% rename from samples/features/in-memory/iot-smart-grid/PowerDashboard.pbix rename to samples/applications/iot-smart-grid/PowerDashboard.pbix diff --git a/samples/applications/iot-smart-grid/README.md b/samples/applications/iot-smart-grid/README.md new file mode 100644 index 00000000..9e253166 --- /dev/null +++ b/samples/applications/iot-smart-grid/README.md @@ -0,0 +1,128 @@ +# IoT Smart Grid +This code sample demonstrates how a SQL Server 2016 (or higher) memory optimized database could be used to ingest a very high input data rate and ultimately help improve the performance of applications with this scenario. The code simulates an IoT Smart Grid scenario where multiple IoT power meters are constantly sending electricity usage measurements to the database. + +### Contents + +[About this sample](#about-this-sample)
+[Before you begin](#before-you-begin)
+[Run this sample](#run-this-sample)
+[Sample details](#sample-details)
+[Disclaimers](#disclaimers)
+[Related links](#related-links)
+ + + +## About this sample + +1. **Applies to:** SQL Server 2016 (or higher) Enterprise / Developer / Evaluation Edition, Azure SQL Database +2. **Key features:** + - Memory Optimized Tables and Table valued Parameters (TVPs) + - Natively Compiled Stored Procedures + - System-Versioned Temporal Tables + - Clustered Columnstore Index (CCI) + - Power BI +3. **Workload:** Data Ingestion for IoT +4. **Programming Language:** .NET C#, T-SQL +5. **Authors:** Perry Skountrianos [perrysk-msft] + + + +## Before you begin + +To run this sample, you need the following prerequisites. + +**Software prerequisites:** + +1. SQL Server 2016 (or higher) or an Azure SQL Database +2. Visual Studio 2015 (or higher) with the latest SSDT installed +3. [Power BI Desktop Installed] (https://powerbi.microsoft.com/en-us/desktop/) + +**Azure prerequisites:** + +1. Permission to create an Azure SQL Database + + + +## Run this sample +1. Clone this repository using Git for Windows (http://www.git-scm.com/), or download the zip file. + +2. From Visual Studio, open the **IoT-Smart-Grid.sln** file from the root directory. + +3. The sample includes two clients for generating the workload: **ConsoleClient** and **WinFormsClient**. Right click on either of these projects and select "Set as StartUp Project". + +4. In Visual Studio Build menu, select **Build Solution** (or Press F6). + +5. Modify the **App.config Settings** (located in the **Solution Items** solution folder) + + By accepting the default values for the following settings you should be able to see a data generated spike every 35 seconds with a 4 second duration. If you want to produce a continuous high data volume workload you should set the **commandDelay to 0** and adjust the **numberOfTasks** and **batchSize** according to the hardware specifications of your environment. + + - **Db**: SQL Server connectionString. Currently it is configured to connect to the local default SQL Server Instance using Integrated Security. + - **insertSPName**: The name of the Natively Compiled Stored Procedure that inserted the sample data. (Default Value: InsertMeterMeasurement) + - **numberOfTasks**: The number of Asynchronous Tasks the Data Generator uses. (Default Value: 50) + - **numberOfMeters**: The number of IoT Power Meters to be used. (Default Value: 1000000) + - **batchSize**: The sample data batch size.(Default Value: 1000) + - **commandDelay**: The delay between sql calls. Note that during a data generated spike the app changes this to 0. (Default Value: 1500ms) + - **enableShock**: Flag that turns on/off the data shock. This should be set to 0 for max high volume workload + - **commandTimeout**: SQL Command Timeout(Default Value: 600) + - **shockFrequency**: How often to generate a data spike. (Default Value: 35000ms) + - **shockDuration**: The duration of the data spike. (Default Value: 4000ms) + - **rpsFrequency**: The polling frequency for Rows per Second. (Default Value: 2000ms) + - **logFileName**: Log File Name. (Default Value: log.txt) + - **powerBIDesktopPath**: The local path to the PBIDesktop.exe. (Default Value: C:\Program Files\Microsoft Power BI Desktop\bin\PBIDesktop.exe) + +6. Publish the Database + - Right click on the **Db** SQL Server Database Project and Select **Publish**. + - Click Edit... to choose your connection string. + - We recommend choosing **PowerConsumption** as the Database name as this is the default db name the sample is configured to run under. + - Click Publish. + - Note: For publishing to Azure SQL you need to + - Change the DB project target platform to **Microsoft Azure SQL Database V12** and + - Comment the T-SQL in the **mod.sql** file in the Db/Storage folder before publishing. + +7. Build the app and run it. Do not use the debugger, as that will slow down the app. + +8. Start the workload + - From the **ConsoleClient**: Type 'START' + - From the **WinFormsClient**: Press the **Start** button. + +9. Launch the Power BI Report + - From the **ConsoleClient**: Type 'REPORT' on the command prompt window. + - From the **WinFormsClient**: Click the **Power BI Report** link. + +10. In the Power BI Desktop menu click on **Edit Queries** and then **Source** to make sure that both the Server and the Database Name match the values from **Step 6**. Click OK to apply changes. + + + +## Sample details + +**High Level Description** + +This code sample simulates an IoT Smart Grid scenario where multiple IoT power meters are sending electricity usage measurements to a SQL Server memory optimized database. The Data Generator, that can be started either from the Console or the Windows Form client, produces a data generated spike to simulate a [shock absorber scenario] (https://blogs.technet.microsoft.com/dataplatforminsider/2013/09/19/in-memory-oltp-common-design-pattern-high-data-input-rateshock-absorber/). Every async task in the Data Generator produces a batch of records with random values in order to simulate the data of an IoT power meter. It then calls a natively compiled stored procedure, that accepts an memory optimized table valued parameter (TVP), to insert the data into an memory optimized SQL Server table. In addition to the in-memory features, the sample is leveraging [System-Versioned Temporal Tables](https://msdn.microsoft.com/en-us/library/dn935015.aspx) for building version history, [Clustered Columnstore Index](https://msdn.microsoft.com/en-us/library/dn817827.aspx) for enabling real time operational analytics, and [Power BI](https://powerbi.microsoft.com/en-us/desktop/) for data visualization. + +![Alt text](Screenshots/WinFormsClient.png "Windows Forms Data Generator") +![Alt text](Screenshots/ConsoleClient.png "Console Data Generator") +![Alt text](Screenshots/PowerBIDashboard.png "Power BI Dashboard") + +**Visual Studio Solution Projects** + +1. **ConsoleAppClient**: Console Data Generator client. Uses START | STOP | HELP | REPORT | EXIT commands. +2. **Data Generator**: Data Generator client library. Uses multiple async tasks to produce a test data workload. +3. **Db**: SQL Server Database project +4. **WFClient**: Windows Forms Data Generator client. + + + +## Disclaimers +The code included in this sample is not intended to be a set of best practices on how to build scalable enterprise grade applications. This is beyond the scope of this quick start sample. + + + +## Related Links + + +For more information, see these articles: +- [In-Memory OLTP (In-Memory Optimization)] (https://msdn.microsoft.com/en-us/library/dn133186.aspx) +- [OLTP and database management] (https://www.microsoft.com/en-us/server-cloud/solutions/oltp-database-management.aspx) +- [SQL Server 2016 Temporal Tables] (https://msdn.microsoft.com/en-us/library/dn935015.aspx) +- [In-Memory OLTP Common Design Pattern – High Data Input Rate/Shock Absorber] (https://blogs.technet.microsoft.com/dataplatforminsider/2013/09/19/in-memory-oltp-common-design-pattern-high-data-input-rateshock-absorber/) +- [Power BI Download] (https://powerbi.microsoft.com/en-us/desktop/) diff --git a/samples/features/in-memory/iot-smart-grid/Screenshots/ConsoleClient.png b/samples/applications/iot-smart-grid/Screenshots/ConsoleClient.png similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Screenshots/ConsoleClient.png rename to samples/applications/iot-smart-grid/Screenshots/ConsoleClient.png diff --git a/samples/features/in-memory/iot-smart-grid/Screenshots/PowerBIDashboard.png b/samples/applications/iot-smart-grid/Screenshots/PowerBIDashboard.png similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Screenshots/PowerBIDashboard.png rename to samples/applications/iot-smart-grid/Screenshots/PowerBIDashboard.png diff --git a/samples/features/in-memory/iot-smart-grid/Screenshots/PowerBISettings.png b/samples/applications/iot-smart-grid/Screenshots/PowerBISettings.png similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Screenshots/PowerBISettings.png rename to samples/applications/iot-smart-grid/Screenshots/PowerBISettings.png diff --git a/samples/features/in-memory/iot-smart-grid/Screenshots/WinFormsClient.png b/samples/applications/iot-smart-grid/Screenshots/WinFormsClient.png similarity index 100% rename from samples/features/in-memory/iot-smart-grid/Screenshots/WinFormsClient.png rename to samples/applications/iot-smart-grid/Screenshots/WinFormsClient.png diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/FrmMain.Designer.cs b/samples/applications/iot-smart-grid/WinFormsClient/FrmMain.Designer.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/FrmMain.Designer.cs rename to samples/applications/iot-smart-grid/WinFormsClient/FrmMain.Designer.cs diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/FrmMain.cs b/samples/applications/iot-smart-grid/WinFormsClient/FrmMain.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/FrmMain.cs rename to samples/applications/iot-smart-grid/WinFormsClient/FrmMain.cs diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/FrmMain.resx b/samples/applications/iot-smart-grid/WinFormsClient/FrmMain.resx similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/FrmMain.resx rename to samples/applications/iot-smart-grid/WinFormsClient/FrmMain.resx diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/Program.cs b/samples/applications/iot-smart-grid/WinFormsClient/Program.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/Program.cs rename to samples/applications/iot-smart-grid/WinFormsClient/Program.cs diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/AssemblyInfo.cs b/samples/applications/iot-smart-grid/WinFormsClient/Properties/AssemblyInfo.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/AssemblyInfo.cs rename to samples/applications/iot-smart-grid/WinFormsClient/Properties/AssemblyInfo.cs diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/Resources.Designer.cs b/samples/applications/iot-smart-grid/WinFormsClient/Properties/Resources.Designer.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/Resources.Designer.cs rename to samples/applications/iot-smart-grid/WinFormsClient/Properties/Resources.Designer.cs diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/Resources.resx b/samples/applications/iot-smart-grid/WinFormsClient/Properties/Resources.resx similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/Resources.resx rename to samples/applications/iot-smart-grid/WinFormsClient/Properties/Resources.resx diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/Settings.Designer.cs b/samples/applications/iot-smart-grid/WinFormsClient/Properties/Settings.Designer.cs similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/Settings.Designer.cs rename to samples/applications/iot-smart-grid/WinFormsClient/Properties/Settings.Designer.cs diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/Settings.settings b/samples/applications/iot-smart-grid/WinFormsClient/Properties/Settings.settings similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/Properties/Settings.settings rename to samples/applications/iot-smart-grid/WinFormsClient/Properties/Settings.settings diff --git a/samples/features/in-memory/iot-smart-grid/WinFormsClient/WinFormsClient.csproj b/samples/applications/iot-smart-grid/WinFormsClient/WinFormsClient.csproj similarity index 100% rename from samples/features/in-memory/iot-smart-grid/WinFormsClient/WinFormsClient.csproj rename to samples/applications/iot-smart-grid/WinFormsClient/WinFormsClient.csproj diff --git a/samples/features/in-memory/iot-smart-grid/README.md b/samples/features/in-memory/iot-smart-grid/README.md index 9e253166..1f89eb6b 100644 --- a/samples/features/in-memory/iot-smart-grid/README.md +++ b/samples/features/in-memory/iot-smart-grid/README.md @@ -1,128 +1,3 @@ -# IoT Smart Grid -This code sample demonstrates how a SQL Server 2016 (or higher) memory optimized database could be used to ingest a very high input data rate and ultimately help improve the performance of applications with this scenario. The code simulates an IoT Smart Grid scenario where multiple IoT power meters are constantly sending electricity usage measurements to the database. +This content was moved: -### Contents - -[About this sample](#about-this-sample)
-[Before you begin](#before-you-begin)
-[Run this sample](#run-this-sample)
-[Sample details](#sample-details)
-[Disclaimers](#disclaimers)
-[Related links](#related-links)
- - - -## About this sample - -1. **Applies to:** SQL Server 2016 (or higher) Enterprise / Developer / Evaluation Edition, Azure SQL Database -2. **Key features:** - - Memory Optimized Tables and Table valued Parameters (TVPs) - - Natively Compiled Stored Procedures - - System-Versioned Temporal Tables - - Clustered Columnstore Index (CCI) - - Power BI -3. **Workload:** Data Ingestion for IoT -4. **Programming Language:** .NET C#, T-SQL -5. **Authors:** Perry Skountrianos [perrysk-msft] - - - -## Before you begin - -To run this sample, you need the following prerequisites. - -**Software prerequisites:** - -1. SQL Server 2016 (or higher) or an Azure SQL Database -2. Visual Studio 2015 (or higher) with the latest SSDT installed -3. [Power BI Desktop Installed] (https://powerbi.microsoft.com/en-us/desktop/) - -**Azure prerequisites:** - -1. Permission to create an Azure SQL Database - - - -## Run this sample -1. Clone this repository using Git for Windows (http://www.git-scm.com/), or download the zip file. - -2. From Visual Studio, open the **IoT-Smart-Grid.sln** file from the root directory. - -3. The sample includes two clients for generating the workload: **ConsoleClient** and **WinFormsClient**. Right click on either of these projects and select "Set as StartUp Project". - -4. In Visual Studio Build menu, select **Build Solution** (or Press F6). - -5. Modify the **App.config Settings** (located in the **Solution Items** solution folder) - - By accepting the default values for the following settings you should be able to see a data generated spike every 35 seconds with a 4 second duration. If you want to produce a continuous high data volume workload you should set the **commandDelay to 0** and adjust the **numberOfTasks** and **batchSize** according to the hardware specifications of your environment. - - - **Db**: SQL Server connectionString. Currently it is configured to connect to the local default SQL Server Instance using Integrated Security. - - **insertSPName**: The name of the Natively Compiled Stored Procedure that inserted the sample data. (Default Value: InsertMeterMeasurement) - - **numberOfTasks**: The number of Asynchronous Tasks the Data Generator uses. (Default Value: 50) - - **numberOfMeters**: The number of IoT Power Meters to be used. (Default Value: 1000000) - - **batchSize**: The sample data batch size.(Default Value: 1000) - - **commandDelay**: The delay between sql calls. Note that during a data generated spike the app changes this to 0. (Default Value: 1500ms) - - **enableShock**: Flag that turns on/off the data shock. This should be set to 0 for max high volume workload - - **commandTimeout**: SQL Command Timeout(Default Value: 600) - - **shockFrequency**: How often to generate a data spike. (Default Value: 35000ms) - - **shockDuration**: The duration of the data spike. (Default Value: 4000ms) - - **rpsFrequency**: The polling frequency for Rows per Second. (Default Value: 2000ms) - - **logFileName**: Log File Name. (Default Value: log.txt) - - **powerBIDesktopPath**: The local path to the PBIDesktop.exe. (Default Value: C:\Program Files\Microsoft Power BI Desktop\bin\PBIDesktop.exe) - -6. Publish the Database - - Right click on the **Db** SQL Server Database Project and Select **Publish**. - - Click Edit... to choose your connection string. - - We recommend choosing **PowerConsumption** as the Database name as this is the default db name the sample is configured to run under. - - Click Publish. - - Note: For publishing to Azure SQL you need to - - Change the DB project target platform to **Microsoft Azure SQL Database V12** and - - Comment the T-SQL in the **mod.sql** file in the Db/Storage folder before publishing. - -7. Build the app and run it. Do not use the debugger, as that will slow down the app. - -8. Start the workload - - From the **ConsoleClient**: Type 'START' - - From the **WinFormsClient**: Press the **Start** button. - -9. Launch the Power BI Report - - From the **ConsoleClient**: Type 'REPORT' on the command prompt window. - - From the **WinFormsClient**: Click the **Power BI Report** link. - -10. In the Power BI Desktop menu click on **Edit Queries** and then **Source** to make sure that both the Server and the Database Name match the values from **Step 6**. Click OK to apply changes. - - - -## Sample details - -**High Level Description** - -This code sample simulates an IoT Smart Grid scenario where multiple IoT power meters are sending electricity usage measurements to a SQL Server memory optimized database. The Data Generator, that can be started either from the Console or the Windows Form client, produces a data generated spike to simulate a [shock absorber scenario] (https://blogs.technet.microsoft.com/dataplatforminsider/2013/09/19/in-memory-oltp-common-design-pattern-high-data-input-rateshock-absorber/). Every async task in the Data Generator produces a batch of records with random values in order to simulate the data of an IoT power meter. It then calls a natively compiled stored procedure, that accepts an memory optimized table valued parameter (TVP), to insert the data into an memory optimized SQL Server table. In addition to the in-memory features, the sample is leveraging [System-Versioned Temporal Tables](https://msdn.microsoft.com/en-us/library/dn935015.aspx) for building version history, [Clustered Columnstore Index](https://msdn.microsoft.com/en-us/library/dn817827.aspx) for enabling real time operational analytics, and [Power BI](https://powerbi.microsoft.com/en-us/desktop/) for data visualization. - -![Alt text](Screenshots/WinFormsClient.png "Windows Forms Data Generator") -![Alt text](Screenshots/ConsoleClient.png "Console Data Generator") -![Alt text](Screenshots/PowerBIDashboard.png "Power BI Dashboard") - -**Visual Studio Solution Projects** - -1. **ConsoleAppClient**: Console Data Generator client. Uses START | STOP | HELP | REPORT | EXIT commands. -2. **Data Generator**: Data Generator client library. Uses multiple async tasks to produce a test data workload. -3. **Db**: SQL Server Database project -4. **WFClient**: Windows Forms Data Generator client. - - - -## Disclaimers -The code included in this sample is not intended to be a set of best practices on how to build scalable enterprise grade applications. This is beyond the scope of this quick start sample. - - - -## Related Links - - -For more information, see these articles: -- [In-Memory OLTP (In-Memory Optimization)] (https://msdn.microsoft.com/en-us/library/dn133186.aspx) -- [OLTP and database management] (https://www.microsoft.com/en-us/server-cloud/solutions/oltp-database-management.aspx) -- [SQL Server 2016 Temporal Tables] (https://msdn.microsoft.com/en-us/library/dn935015.aspx) -- [In-Memory OLTP Common Design Pattern – High Data Input Rate/Shock Absorber] (https://blogs.technet.microsoft.com/dataplatforminsider/2013/09/19/in-memory-oltp-common-design-pattern-high-data-input-rateshock-absorber/) -- [Power BI Download] (https://powerbi.microsoft.com/en-us/desktop/) +[applications/iot-smart-grid] (/samples/applications/iot-smart-grid/)