Skip to content

Commit f387da1

Browse files
author
stevestein
committed
updating with firewall dialog, and usability study improvements
1 parent 1fbe8db commit f387da1

File tree

8 files changed

+41
-30
lines changed

8 files changed

+41
-30
lines changed

‎docs/sql-operations-studio/media/quickstart-sql-database/firewall.png‎

33.2 KB
Loading

‎docs/sql-operations-studio/media/quickstart-sql-database/new-connection-icon.png‎

-9.04 KB
Loading

‎docs/sql-operations-studio/media/quickstart-sql-dw/firewall.png‎

33.2 KB
Loading

‎docs/sql-operations-studio/media/quickstart-sql-dw/new-connection-icon.png‎

-6.29 KB
Loading

‎docs/sql-operations-studio/media/quickstart-sql-server/new-connection-icon.png‎

-6.29 KB
Loading

‎docs/sql-operations-studio/quickstart-sql-database.md‎

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Quickstart: Connect and query an Azure SQL database using SQL Operations Studio (preview) | Microsoft Docs"
33
description: This quickstart shows how to use SQL Operations Studio (preview) to connect to a SQL database and run a query
44
ms.custom: "tools|sos"
5-
ms.date: "11/15/2017"
5+
ms.date: "03/08/2018"
66
ms.prod: "sql-non-specified"
77
ms.reviewer: "alayu; erickang; sstein"
88
ms.suite: "sql"
@@ -36,11 +36,11 @@ If you don't already have an Azure SQL server, complete one of the following Azu
3636

3737
Use [!INCLUDE[name-sos](../includes/name-sos-short.md)] to establish a connection to your Azure SQL Database server.
3838

39-
1. The first time you run [!INCLUDE[name-sos](../includes/name-sos-short.md)] the **Connection** page should open. If the **Connection** page doesn't open, click the **New Connection** icon in the **SERVERS** sidebar:
39+
1. The first time you run [!INCLUDE[name-sos](../includes/name-sos-short.md)] the **Connection** page should open. If you don't see the **Connection** page, click **Add Connection**, or the **New Connection** icon in the **SERVERS** sidebar:
4040

4141
![New Connection Icon](media/quickstart-sql-database/new-connection-icon.png)
4242

43-
2. This article uses *SQL Login*, but *Windows Authentication* is also supported. Fill in the fields as follows:
43+
2. This article uses *SQL Login*, but *Windows Authentication* is also supported. Fill in the fields as follows using the server name, user name, and password for *your* Azure SQL server:
4444

4545
| Setting | Suggested value | Description |
4646
| ------------ | ------------------ | ------------------------------------------------- |
@@ -54,17 +54,19 @@ Use [!INCLUDE[name-sos](../includes/name-sos-short.md)] to establish a connectio
5454

5555
![New Connection Icon](media/quickstart-sql-database/new-connection-screen.png)
5656

57-
3. If you get an error about the firewall, you need to create a firewall rule. To create a firewall rule, see [Firewall rules](https://docs.microsoft.com/azure/sql-database/sql-database-firewall-configure).
57+
3. If your server doesn't have a firewall rule allowing SQL Operations Studio to connect, the**Create new firewall rule** dialog opens. Complete the form to create a new firewall rule. For details, see [Firewall rules](https://docs.microsoft.com/azure/sql-database/sql-database-firewall-configure).
5858

59-
4. After successfully connecting your server will appear in the *Servers* sidebar.
59+
![New firewall rule](media/quickstart-sql-database/firewall.png)
60+
61+
4. After successfully connecting your server opens in the *Servers* sidebar.
6062

6163
## Create the tutorial database
6264

63-
The *TutorialDB* database is used in several [!INCLUDE[name-sos](../includes/name-sos-short.md)] tutorials.
65+
The following sections create the *TutorialDB* database that is used in several [!INCLUDE[name-sos](../includes/name-sos-short.md)] tutorials.
6466

6567
1. Right click on your Azure SQL server in the SERVERS sidebar and select **New Query.**
6668

67-
1. Paste the following snippet into the query editor.
69+
1. Paste the following snippet into the query editor and click **Run**:
6870

6971
```sql
7072
IF NOT EXISTS (
@@ -79,7 +81,6 @@ The *TutorialDB* database is used in several [!INCLUDE[name-sos](../includes/nam
7981
GO
8082
```
8183

82-
1. To execute the query, click **Run**.
8384

8485

8586
## Create a table
@@ -92,7 +93,10 @@ The query editor is still connected to the *master* database, but we want to cre
9293

9394

9495

95-
1. Paste the following snippet into the query editor.
96+
1. Paste the following snippet into the query editor and click **Run**:
97+
98+
> [!NOTE]
99+
> You can append this to, or overwrite the previous query in the editor. Note that clicking **Run** executes only the query that is selected. If nothing is selected, clicking **Run** executes all queries in the editor.
96100
97101
```sql
98102
-- Create a new table called 'Customers' in schema 'dbo'
@@ -110,11 +114,12 @@ The query editor is still connected to the *master* database, but we want to cre
110114
);
111115
GO
112116
```
113-
1. To execute the query, click **Run**.
117+
114118

115119
## Insert rows
116120

117-
1. Paste the following snippet into the query editor:
121+
- Paste the following snippet into the query editor and click **Run**:
122+
118123
```sql
119124
-- Insert rows into table 'Customers'
120125
INSERT INTO dbo.Customers
@@ -127,17 +132,16 @@ The query editor is still connected to the *master* database, but we want to cre
127132
GO
128133
```
129134

130-
1. To execute the query, click **Run**.
131135

132136
## View the result
133-
1. Paste the following snippet into the query editor.
137+
1. Paste the following snippet into the query editor and click **Run**.
134138

135139
```sql
136140
-- Select rows from table 'Customers'
137141
SELECT * FROM dbo.Customers;
138142
```
139143

140-
1. To execute the query, click **Run**.
144+
1. The results of the query are displayed:
141145

142146
![Select results](media/quickstart-sql-database/select-results.png)
143147

‎docs/sql-operations-studio/quickstart-sql-dw.md‎

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Quickstart: Connect and query an Azure SQL Data Warehouse using SQL Operations Studio (preview) | Microsoft Docs"
33
description: This quickstart shows how to use SQL Operations Studio (preview) to connect to a SQL database and run a query
44
ms.custom: "tools|sos"
5-
ms.date: "11/15/2017"
5+
ms.date: "03/08/2018"
66
ms.prod: "sql-non-specified"
77
ms.reviewer: "alayu; erickang; sstein"
88
ms.suite: "sql"
@@ -51,14 +51,18 @@ Use [!INCLUDE[name-sos](../includes/name-sos-short.md)] to establish a connectio
5151

5252
![New Connection Icon](media/quickstart-sql-dw/new-connection-screen.png)
5353

54-
3. If you get an error about the firewall, you need to create a firewall rule. To create a firewall rule, see [Firewall rules](https://docs.microsoft.com/azure/sql-database/sql-database-firewall-configure).
54+
3. If your server doesn't have a firewall rule allowing SQL Operations Studio to connect, the**Create new firewall rule** dialog opens. Complete the form to create a new firewall rule. For details, see [Firewall rules](https://docs.microsoft.com/azure/sql-database/sql-database-firewall-configure).
55+
56+
![New firewall rule](media/quickstart-sql-dw/firewall.png)
57+
58+
4. After successfully connecting your server opens in the *Servers* sidebar.
5559

5660
4. After successfully connecting your server will appear in the object explorer.
5761

5862
## Create the tutorial data warehouse
5963
1. Right click on your server, in the object explorer and select **New Query.**
6064

61-
1. Paste the following snippet into the query editor:
65+
1. Paste the following snippet into the query editor and click **Run**:
6266

6367
```sql
6468
IF NOT EXISTS (
@@ -73,7 +77,6 @@ Use [!INCLUDE[name-sos](../includes/name-sos-short.md)] to establish a connectio
7377
GO
7478
```
7579

76-
1. To execute the query, click **Run**.
7780

7881
## Create a table
7982

@@ -84,7 +87,10 @@ The query editor is still connected to the *master* database, but we want to cre
8487
![Change context](media/quickstart-sql-database/change-context.png)
8588

8689

87-
1. Paste the following snippet into the query editor:
90+
1. Paste the following snippet into the query editor and click **Run**:
91+
92+
> [!NOTE]
93+
> You can append this to, or overwrite the previous query in the editor. Note that clicking **Run** executes only the query that is selected. If nothing is selected, clicking **Run** executes all queries in the editor.
8894
8995
```sql
9096
-- Create a new table called 'Customers' in schema 'dbo'
@@ -103,11 +109,10 @@ The query editor is still connected to the *master* database, but we want to cre
103109
GO
104110
```
105111

106-
1. To execute the query, click **Run**.
107112

108113
## Insert rows
109114

110-
1. Paste the following snippet into the query editor:
115+
1. Paste the following snippet into the query editor and click **Run**:
111116

112117
```sql
113118
-- Insert rows into table 'Customers'
@@ -119,17 +124,16 @@ The query editor is still connected to the *master* database, but we want to cre
119124
SELECT 4, N'Janet', N'United States', N'[email protected]'
120125
```
121126

122-
1. To execute the query, click **Run**.
123127

124128
## View the result
125-
1. Paste the following snippet into the query editor:
129+
1. Paste the following snippet into the query editor and click **Run**:
126130

127131
```sql
128132
-- Select rows from table 'Customers'
129133
SELECT * FROM dbo.Customers;
130134
```
131135

132-
1. To execute the query, click **Run**.
136+
1. The results of the query are displayed:
133137

134138
![Select results](media/quickstart-sql-dw/select-results.png)
135139

‎docs/sql-operations-studio/quickstart-sql-server.md‎

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Quickstart: Connect and query SQL Server using SQL Operations Studio (preview) | Microsoft Docs"
33
description: This quickstart shows how to use SQL Operations Studio (preview) to connect to SQL Server and run a query
44
ms.custom: "tools|sos"
5-
ms.date: "11/15/2017"
5+
ms.date: "03/08/2018"
66
ms.prod: "sql-non-specified"
77
ms.reviewer: "alayu; erickang; sstein"
88
ms.suite: "sql"
@@ -88,7 +88,10 @@ The query editor is still connected to the *master* database, but we want to cre
8888

8989

9090

91-
1. Paste the following snippet into the query window:
91+
1. Paste the following snippet into the query window and click **Run**:
92+
93+
> [!NOTE]
94+
> You can append this to, or overwrite the previous query in the editor. Note that clicking **Run** executes only the query that is selected. If nothing is selected, clicking **Run** executes all queries in the editor.
9295
9396
```sql
9497
-- Create a new table called 'Customers' in schema 'dbo'
@@ -111,7 +114,8 @@ After the query completes, the new **Customers** table appears in the list of ta
111114

112115
## Insert rows
113116

114-
1. Paste the following snippet into the query window:
117+
- Paste the following snippet into the query window and click **Run**:
118+
115119
```sql
116120
-- Insert rows into table 'Customers'
117121
INSERT INTO dbo.Customers
@@ -124,18 +128,17 @@ After the query completes, the new **Customers** table appears in the list of ta
124128
GO
125129
```
126130

127-
1. To execute the query, click **Run**.
128131

129132

130133
## View the data returned by a query
131-
1. Paste the following snippet into the query window:
134+
1. Paste the following snippet into the query window and click **Run**:
132135

133136
```sql
134137
-- Select rows from table 'Customers'
135138
SELECT * FROM dbo.Customers;
136139
```
137140

138-
1. To execute the query, click **Run**.
141+
1. The results of the query are displayed:
139142

140143
![Select results](media/quickstart-sql-server/select-results.png)
141144

0 commit comments

Comments
 (0)