Merge pull request #116450 from jovanpop-msft/patch-174

Update query-data-storage.md

Author: v-shmck

articles/synapse-analytics/sql/query-data-storage.md

@@ -14,7 +14,7 @@ ms.reviewer: jrasnick, carlrab
 # Overview: Query data in storage
 
 This section contains sample queries you can use to try out the SQL on-demand (preview) resource within Azure Synapse Analytics.
-Currently supported files are: 
+Currently supported file formats are:  
 - CSV
 - Parquet
 - JSON
@@ -39,14 +39,7 @@ Additionally, the parameters are as follows:
 
 ## First-time setup
 
-Before using the samples included later in this article, you have two steps:
-
-- Create a database for your views (in case you want to use views)
-- Create credentials to be used by SQL on-demand to access the files in storage
-
-### Create database
-
-You need a database to create views. You'll use this database for some of the sample queries in this documentation.
+Your first step is to **create a database** where you will execute the queries. Then initialize the objects by executing [setup script](https://github.com/Azure-Samples/Synapse/blob/master/SQL/Samples/LdwSample/SampleDB.sql) on that database. This setup script will create the data sources, database scoped credentials, and external file formats that are used to read data in these samples.
 
 > [!NOTE]
 > Databases are only used for viewing metadata, not for actual data.  Write down the database name that you use, you will need it later on.
@@ -55,53 +48,6 @@ You need a database to create views. You'll use this database for some of the sa
 CREATE DATABASE mydbname;
 ```
 
-### Create credentials
-
-You must create credentials before you can run queries. This credential will be used by SQL on-demand service to access the files in storage.
-
-> [!NOTE]
-> In order to successfully run How To's in this section you have to use SAS token.
->
-> To start using SAS tokens you have to drop the UserIdentity which is explained in the following [article](develop-storage-files-storage-access-control.md#disable-forcing-azure-ad-pass-through).
->
-> SQL on-demand by default always uses AAD pass-through.
-
-For more information on how to manage storage access control, check this [link](develop-storage-files-storage-access-control.md).
-
-To create credentials for CSV, JSON, and Parquet containers, run the code below:
-
-```sql
--- create credentials for CSV container in our demo storage account
-IF EXISTS (SELECT * FROM sys.credentials WHERE name = 'https://sqlondemandstorage.blob.core.windows.net/csv')
-DROP CREDENTIAL [https://sqlondemandstorage.blob.core.windows.net/csv];
-GO
-
-CREATE CREDENTIAL [https://sqlondemandstorage.blob.core.windows.net/csv]
-WITH IDENTITY='SHARED ACCESS SIGNATURE',  
-SECRET = 'sv=2018-03-28&ss=bf&srt=sco&sp=rl&st=2019-10-14T12%3A10%3A25Z&se=2061-12-31T12%3A10%3A00Z&sig=KlSU2ullCscyTS0An0nozEpo4tO5JAgGBvw%2FJX2lguw%3D';
-GO
-
--- create credentials for JSON container in our demo storage account
-IF EXISTS (SELECT * FROM sys.credentials WHERE name = 'https://sqlondemandstorage.blob.core.windows.net/json')
-DROP CREDENTIAL [https://sqlondemandstorage.blob.core.windows.net/json];
-GO
-
-CREATE CREDENTIAL [https://sqlondemandstorage.blob.core.windows.net/json]
-WITH IDENTITY='SHARED ACCESS SIGNATURE',  
-SECRET = 'sv=2018-03-28&ss=bf&srt=sco&sp=rl&st=2019-10-14T12%3A10%3A25Z&se=2061-12-31T12%3A10%3A00Z&sig=KlSU2ullCscyTS0An0nozEpo4tO5JAgGBvw%2FJX2lguw%3D';
-GO
-
--- create credentials for PARQUET container in our demo storage account
-IF EXISTS (SELECT * FROM sys.credentials WHERE name = 'https://sqlondemandstorage.blob.core.windows.net/parquet')
-DROP CREDENTIAL [https://sqlondemandstorage.blob.core.windows.net/parquet];
-GO
-
-CREATE CREDENTIAL [https://sqlondemandstorage.blob.core.windows.net/parquet]
-WITH IDENTITY='SHARED ACCESS SIGNATURE',  
-SECRET = 'sv=2018-03-28&ss=bf&srt=sco&sp=rl&st=2019-10-14T12%3A10%3A25Z&se=2061-12-31T12%3A10%3A00Z&sig=KlSU2ullCscyTS0An0nozEpo4tO5JAgGBvw%2FJX2lguw%3D';
-GO
-```
-
 ## Provided demo data
 
 Demo data contains the following data sets:
@@ -127,24 +73,6 @@ Demo data contains the following data sets:
 | /json/                                                       | Parent folder for data in JSON format                        |
 | /json/books/                                                 | JSON files with books data                                   |
 
-## Validation
-
-Execute the following three queries and check if the credentials are created correctly.
-
-> [!NOTE]
-> All URIs in the sample queries use a storage account located in the North Europe Azure region. Make sure that you created the appropriate credential. Run the query below and make sure the storage account is listed.
-
-```sql
-SELECT name
-FROM sys.credentials
-WHERE
-     name IN ( 'https://sqlondemandstorage.blob.core.windows.net/csv',
-     'https://sqlondemandstorage.blob.core.windows.net/parquet',
-     'https://sqlondemandstorage.blob.core.windows.net/json');
-```
-
-If you can't find the appropriate credential, check [First-time setup](#first-time-setup).
-
 ### Sample query
 
 The last step of validation is to execute the following query:
@@ -154,7 +82,8 @@ SELECT
     COUNT_BIG(*)
 FROM  
     OPENROWSET(
-        BULK 'https://sqlondemandstorage.blob.core.windows.net/parquet/taxi/year=2017/month=9/*.parquet',
+        BULK 'parquet/taxi/year=2017/month=9/*.parquet',
+        DATA_SOURCE = 'sqlondemanddemo',
         FORMAT='PARQUET'
     ) AS nyc;
 ```