Documentation and script comment request for CreateDatabase.usql

[Paul Oldham]

This issue is for a: (mark with an x)

- [ ] bug report -> please search issues before submitting
- [ ] feature request
- [x] documentation issue or request
- [ ] regression (a behavior that used to work and stopped in a new release)

Minimal steps to reproduce

In File CreateDatabase.usql
DECLARE @DATAVERSION string = "mag-##DatasetVersion##";
DECLARE @blobAccount string = "##YourBlobAccount##";
DECLARE @uriPrefix string = "wasb://" + @DATAVERSION + "@" + @blobAccount + "/";

Any log messages given by the failure

Failure message in Visual Studio on does not exist.

Expected/desired behavior

Suggestion to please update the walkthrough and a comment in the script that the user should replace the text so that the uri prefix will build e.g.

DECLARE @DATAVERSION string = "mag-2019-01-25";
DECLARE @blobAccount string = "mymagblob";
DECLARE @uriPrefix string = "wasb://" + @DATAVERSION + "@" + @blobAccount + "/";

OS and Version?

Windows 7, 8 or 10. Linux (which distribution). macOS (Yosemite? El Capitan? Sierra?)

Windows Standard E2s v3 (2 vcpus, 16 GB memory)

Versions

Mention any other details that might be useful

For those users who have never used Azure or Visual Studio before but want to start using MAG, the samples are really important. However, it would be helpful if they could be a little bit clearer for newbies. For example, build and then submit a script. The documentation request above relates to a gotcha for a visual studio novice. A comment flag in the build dbase script might be enough... but for complete newcomers a few more very basic sentences in the samples docs would be a real help.

Many thanks!

Paul