From f1bbaea2415a7d0bef4227c0a7598f5e7846e71b Mon Sep 17 00:00:00 2001 From: barbkess Date: Fri, 29 Apr 2016 21:49:26 -0700 Subject: [PATCH 1/3] samples template --- README_samples_template.md | 103 ++++++++++++++++++++----------------- 1 file changed, 56 insertions(+), 47 deletions(-) diff --git a/README_samples_template.md b/README_samples_template.md index 9e4e695499..433b0a8535 100644 --- a/README_samples_template.md +++ b/README_samples_template.md @@ -1,72 +1,81 @@ -# Ticket Reservations Sample +# -Ticket Reservations is a Windows Forms sample application built on .NET Framework 4.6 that demonstrates the performance benefits of using SQL Server memory optimized tables and native compiled stored procedures. You can compare the performance before and after enabling In-Memory OLTP by observing the transactions/sec as well as the current CPU Usage and latches/sec. +Briefly describe what the sample does. Describe the benefit of running this sample. -![Alt text](samples/features/in-memory/ticket-reservations/Screenshots/1.png "Ticket Reservations") + +![Alt text](/media/image-name.png "") -## Applies -**Platforms:** -- SQL Server (starting with 2016) -- Azure SQL Database +### Contents -**Features:** -- In-memory OLTP +[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) -**Languages:** -- TSQL -- C# + +## About this sample -## Running this sample -1. Before you can run this sample, you must have the following perquisites: - - SQL Server 2016 CTP3 (or higher) - - Visual Studio 2015 (or higher) with the latest SSDT installed. +**Applies to:** SQL Server 2016 (or higher), or Azure SQL Database -2. Clone this repository using Git for Windows (http://www.git-scm.com/), or download the zip file. +**Key features:** -3. From Visual Studio, open the **InMemoryOLTPDemo.sln** file from the root directory. +**Workload:** -4. In Visual Studio Build menu, select **Build Solution** (or Press F6). +**Languages: ** -5. In the **App.config** file, located in the project root, find the **TicketReservations** app setting and edit the connectionString if needed. Currently it is configured to connect to the local default SQL Server Instance using Integrated Security. +**Authors:** -6. Publish the TicketReservations Database - - Right click on the TicketReservations SQL Server Database Project and Select **Publish** - - Click Edit... to choose your connection string - - Click Publish - - Note: For publishing to Azure SQL you need to change the DB project target platform to **Microsoft Azure SQL Database V12** +**Last update:** -7. You can now run and debug the application locally by pressing **F5** in Visual Studio. + -8. Start the workload with the **Start** button, and run for a while to show perf profile. Then press stop to stop the workload. +## Before you begin -9. In the database project, - - Change TicketReservations.sql to a memory-optimized table (instructions commented in the file itself) - - Change InsertTicketReservations.sql to natively compiled (instructions in the same file) +To run this sample, you need the following prerequisites. -10. Publish the database project to the same database – the tool will take care of making the necessary changes. - Note that, as part of publication, the data is copied from the old disk-based table to the new memory-optimized table, so the longer you run the initial workload, the longer this publication takes. +**Software** prerequisites: -11. Go back to the app and run the workload again. No need to recompile or restart the application. + +1. SQL Server 2016 (or higher) or an Azure SQL Database +2. Visual Studio 2015 (or higher) with the latest SSDT installed -The perf gains from In-Memory OLTP as shown by the load generation app depend on two factors: -- Hardware - - more cores => higher perf gain - - slower log IO => lower perf gain -- Configuration settings in the load generator - - more rows per transaction => higher perf gain - - more reads per write => lower perf gain - - default setting is 10 rows per transaction and 1 read per write +**Azure** prerequisites: -With default settings on one machine with 24 logical cores and relatively slow SSD for the log the app shows around performance 40X gain, and in this case the bottleneck was log IO. + +1. Permission to create an Azure SQL Database + -## About the code -The code included in this sample is not intended to be a set of best practices on how to build scalable enterprise grade web applications. This is beyond the scope of this quick start sample. +## Run this sample -## More information -- [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) + + +1. From Visual Studio, open the **sample.sln** file from the root directory. + +2. In Visual Studio Build menu, select **Build Solution** (or Press F6). + +3. Step 3 ... + + + +## Sample details + +Describe sample details + + + +## Disclaimers +The code included in this sample is not intended to be ... + + + +## Related Links + + +For more information, see these articles: From f2eac39f2fd82f872a1ad043833eb7b303713768 Mon Sep 17 00:00:00 2001 From: barbkess Date: Fri, 29 Apr 2016 21:55:29 -0700 Subject: [PATCH 2/3] updates --- README_samples_template.md | 39 ++++++++++++++++++++++++-------------- 1 file changed, 25 insertions(+), 14 deletions(-) diff --git a/README_samples_template.md b/README_samples_template.md index 433b0a8535..2b98c8cb1b 100644 --- a/README_samples_template.md +++ b/README_samples_template.md @@ -9,29 +9,40 @@ Briefly describe what the sample does. Describe the benefit of running this samp ### 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](#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 -**Applies to:** SQL Server 2016 (or higher), or Azure SQL Database +Applies to: -**Key features:** +- SQL Server 2016 (or higher), or Azure SQL Data Warehouse -**Workload:** +Key features: -**Languages: ** +- columnstore indexes -**Authors:** +Workload: +- data warehouse -**Last update:** +Languages: + +- T-SQL + +Authors: + +- github-user1;github-user2 + +Last update: + +- 04/29/2016 @@ -39,13 +50,13 @@ Briefly describe what the sample does. Describe the benefit of running this samp To run this sample, you need the following prerequisites. -**Software** 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 -**Azure** prerequisites: +Azure prerequisites: 1. Permission to create an Azure SQL Database From e4edca6b8a87ea6cdbc49751ad0dc0b832cf49b6 Mon Sep 17 00:00:00 2001 From: barbkess Date: Fri, 29 Apr 2016 21:57:48 -0700 Subject: [PATCH 3/3] updates --- README_samples_template.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_samples_template.md b/README_samples_template.md index 2b98c8cb1b..36eb0724fd 100644 --- a/README_samples_template.md +++ b/README_samples_template.md @@ -1,4 +1,4 @@ -# +# Sample name Briefly describe what the sample does. Describe the benefit of running this sample.