From d2e2f0eff0df471988a6b3cd6bfad5b931e85a28 Mon Sep 17 00:00:00 2001 From: Jos de Bruijn Date: Wed, 21 Jun 2017 11:21:48 -0700 Subject: [PATCH] initial documentation for WideWorldsImportersDW --- .../wwi-dw-ssdt/README.md | 72 +++++++++++++++++++ .../wide-world-importers/wwi-ssdt/README.md | 12 +--- 2 files changed, 74 insertions(+), 10 deletions(-) create mode 100644 samples/databases/wide-world-importers/wwi-dw-ssdt/README.md diff --git a/samples/databases/wide-world-importers/wwi-dw-ssdt/README.md b/samples/databases/wide-world-importers/wwi-dw-ssdt/README.md new file mode 100644 index 00000000..afa8c94c --- /dev/null +++ b/samples/databases/wide-world-importers/wwi-dw-ssdt/README.md @@ -0,0 +1,72 @@ +# WideWorldImportersDW OLAP Database + +The Visual Studio SQL Server Data Tools project in this folder is used to construct the WideWorldImportersDW database from scratch on SQL Server or Azure SQL Database. It is possible to vary the data size. + +A pre-created version of the database is available for download as part of the latest release of the sample: [wide-world-importers-release](http://go.microsoft.com/fwlink/?LinkID=800630). + +### Contents + +[About this sample](#about-this-sample)
+[Before you begin](#before-you-begin)
+[Run this sample](#run-this-sample)
+[Disclaimers](#disclaimers)
+ + + + +## About this sample + + +1. **Applies to:** SQL Server 2016 (or higher), Azure SQL Database [testing and modified instructions are TBD] +1. **Key features:** Core database features +1. **Workload:** OLTP +1. **Programming Language:** Transact-SQL +1. **Authors:** Greg Low, Denzil Ribeiro, Jos de Bruijn, Robert Cain + +The instructions below are for creating the sample database from scratch. + +A pre-created version of the database is available for download as part of the latest release of the sample: [wide-world-importers-release](http://go.microsoft.com/fwlink/?LinkID=800630). + + + +## Before you begin + +To run this sample, you need the following prerequisites. + +**Software prerequisites:** + +1. SQL Server 2016 SP1 (or higher) or an Azure SQL Database. Also works with SQL Server 2016 RTM, for Evaluation, Developer, and Enterprise edition. +2. Visual Studio 2015 Update (or higher) with SQL Server Data Tools (SSDT). We recommend you update to the latest available of SSDT from the Visual Studio Extensions and Updates feed. + + + + +## Run this sample + +The below steps reconstruct the WideWorldImportersDW database. To populate the database, you need to have the WideWorldImporters database as well. + + + +### Publishing to SQL Server + +1. Open the solution **wwi-dw-ssdt.sln** in Visual Studio. Skip this step if you have already opened the solution **wwi-sample.sln** in the root of this sample. + +2. Build the solution. + +3. Publish the WideWorldImportersDW database: + a. In the Solution Explorer, right-click the **WideWorldImportersDW** project, and select **Publish** to bring up the **Publish Database** dialog. + b. Click **Edit** to modify the **Target Database Connection** to point to your SQL Server 2016 (or later) instance. + c. Edit the **Database Name** to say "WideWorldImportersDW". + d. Click **Publish**. + e. Wait for publication to finish. You can monitor progress in the **Data Tools Operations** page in Visual Studio. In testing this took around 3 minutes. + +4. Execute the SQL Server Integration Services package **Daily ETL** once, to seed the WideWorldImportersDW database based on the contents of the WideWorldImporters database. For instructions on how to install and run this package see [wwi-ssis] (../wwi-ssis/). + +### Publishing to Azure SQL Database + +TBD + + + +## Disclaimers +The code included in this sample is not intended to be used for production purposes. diff --git a/samples/databases/wide-world-importers/wwi-ssdt/README.md b/samples/databases/wide-world-importers/wwi-ssdt/README.md index 6485f626..7c5bd402 100644 --- a/samples/databases/wide-world-importers/wwi-ssdt/README.md +++ b/samples/databases/wide-world-importers/wwi-ssdt/README.md @@ -1,4 +1,4 @@ -# Construct WideWorldImporters OLTP Database +# WideWorldImporters OLTP Database The Visual Studio SQL Server Data Tools project in this folder is used to construct the WideWorldImporters database from scratch on SQL Server or Azure SQL Database. It is possible to vary the data size. @@ -10,7 +10,6 @@ A pre-created version of the database is available for download as part of the l [Before you begin](#before-you-begin)
[Run this sample](#run-this-sample)
[Disclaimers](#disclaimers)
-[Related links](#related-links)
@@ -37,7 +36,7 @@ To run this sample, you need the following prerequisites. **Software prerequisites:** 1. SQL Server 2016 SP1 (or higher) or an Azure SQL Database. Also works with SQL Server 2016 RTM, for Evaluation, Developer, and Enterprise edition. -2. Visual Studio 2015 (or higher) with SQL Server Data Tools. +2. Visual Studio 2015 Update (or higher) with SQL Server Data Tools (SSDT). We recommend you update to the latest available of SSDT from the Visual Studio Extensions and Updates feed. @@ -90,10 +89,3 @@ TBD ## Disclaimers The code included in this sample is not intended to be used for production purposes. - - - -## Related Links - -TBD -For more information, see these articles: