Skip to content

Commit 8965469

Browse files
authored
Merge pull request #23784 from rwestMSFT/rw-0818-linux-ssdt
Refresh Linux SSDT article
2 parents db8ec60 + beba554 commit 8965469

1 file changed

Lines changed: 41 additions & 44 deletions

File tree

Lines changed: 41 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: Develop and Deploy SQL Server databases for Linux  | Microsoft Docs
33
description: SQL Server Data Tools with Visual Studio is a powerful development and database lifecycle management environment for SQL Server on Linux.
4-
author: VanMSFT
4+
author: VanMSFT
55
ms.author: vanto
6-
ms.date: 03/17/2017
7-
ms.topic: conceptual
6+
ms.reviewer: randolphwest
7+
ms.date: 08/18/2022
88
ms.prod: sql
99
ms.technology: linux
10-
ms.assetid: 1e924704-e07c-4a8b-b243-8c1dd8cff0d3
10+
ms.topic: conceptual
1111
---
1212

1313
# Use Visual Studio to create databases for SQL Server on Linux
@@ -20,92 +20,89 @@ SQL Server Data Tools (SSDT) turns Visual Studio into a powerful development and
2020

2121
1. If you haven't already installed Visual Studio on your Windows machine, [Download and Install Visual Studio](https://visualstudio.microsoft.com/downloads/). If you don't have a Visual Studio license, Visual Studio Community edition is a free, fully featured IDE for students, open-source, and individual developers.
2222

23-
2. During the Visual Studio installation, select **Custom** for the **Choose the type of installation** option. Select **Next**
23+
1. During the Visual Studio installation, select **Custom** for the **Choose the type of installation** option. Select **Next**
2424

25-
3. Select **Microsoft SQL Server Data Tools**, **Git for Windows**, and **GitHub Extension for Visual Studio** from the feature selection list.
25+
1. Select **Microsoft SQL Server Data Tools**, **Git for Windows**, and **GitHub Extension for Visual Studio** from the feature selection list.
2626

27-
<img src="./media/sql-server-linux-develop-use-ssdt/ssdt-setup.png" alt="ssdt setup"/>
27+
:::image type="content" source="media/sql-server-linux-develop-use-ssdt/ssdt-setup.png" alt-text="Screenshot of SSDT setup.":::
2828

29-
4. Continue and finish the installation of Visual Studio. It can take a few minutes.
29+
1. Continue and finish the installation of Visual Studio. It can take a few minutes.
3030

31-
## Upgrade SQL Server Data Tools to SSDT 17.0 RC release
31+
## Get the latest version of SQL Server Data Tools
3232

33-
SQL Server on Linux is supported by SSDT version 17.0 RC or later.
33+
SQL Server on Linux is supported by SSDT version 17.0 or later.
3434

35-
* [Download and Install SSDT 17.0 RC2](https://go.microsoft.com/fwlink/?linkid=837939).
35+
- [Download SQL Server Data Tools (SSDT) for Visual Studio](../ssdt/download-sql-server-data-tools-ssdt.md)
3636

3737
## Create a new database project in source control
3838

3939
1. Launch Visual Studio.
4040

41-
2. Select **Team Explorer** on the **View** menu.
41+
1. Select **Team Explorer** on the **View** menu.
4242

43-
3. Select **New** in **Local Git Repository** section on the **Connect** page.
43+
1. Select **New** in **Local Git Repository** section on the **Connect** page.
4444

45-
<img src="./media/sql-server-linux-develop-use-ssdt/git-repository.png" alt="Screenshot of the Local Git Repository section with the New option called out."/>
45+
:::image type="content" source="media/sql-server-linux-develop-use-ssdt/git-repository.png" alt-text="Screenshot of the Local Git Repository section with the New option called out.":::
4646

47-
4. Click **Create**. After the local Git repository is created, double-click **SSDTRepo**.
47+
1. Select **Create**. After the local Git repository is created, double-click **SSDTRepo**.
4848

49-
5. Select **New** in the **Solutions** section. Select **SQL Server** under **Other Languages** node in the **New Project** dialog.
49+
1. Select **New** in the **Solutions** section. Select **SQL Server** under **Other Languages** node in the **New Project** dialog.
5050

51-
<img src="./media/sql-server-linux-develop-use-ssdt/new-project.png" alt="Screenshot of the Solutions section with the New option and SQL Server option called out."/>
51+
:::image type="content" source="media/sql-server-linux-develop-use-ssdt/new-project.png" alt-text="Screenshot of the Solutions section with the New option and SQL Server option called out.":::
5252

53-
6. Type in **TutorialDB** for the name and select **OK** to create a new database project.
53+
1. Type in **TutorialDB** for the name and select **OK** to create a new database project.
5454

5555
## Create a new table in the database project
5656

5757
1. Select **Solution Explorer** on the **View** menu.
5858

59-
2. Open the database project menu by right-clicking on **TutorialDB** in Solution Explorer.
59+
1. Open the database project menu by right-clicking on **TutorialDB** in Solution Explorer.
6060

61-
3. Select **Table** under **Add**.
61+
1. Select **Table** under **Add**.
6262

63-
<img src="./media/sql-server-linux-develop-use-ssdt/create-table.png" alt="create table"/>
63+
:::image type="content" source="media/sql-server-linux-develop-use-ssdt/create-table.png" alt-text="Screenshot showing how to create a new table using Add > Table.":::
6464

65-
4. Using table designer, add two columns, Name `nvarchar(50)` and Location `nvarchar(50)`, as shown in the picture. SSDT generates the `CREATE TABLE` script as you add the columns in the designer.
65+
1. Using table designer, add two columns, Name `nvarchar(50)` and Location `nvarchar(50)`, as shown in the picture. SSDT generates the `CREATE TABLE` script as you add the columns in the designer.
6666

67-
<img src="./media/sql-server-linux-develop-use-ssdt/add-columns.png" alt="Screenshot of the table designer with the Name and Location values called out."/>
67+
:::image type="content" source="media/sql-server-linux-develop-use-ssdt/add-columns.png" alt-text="Screenshot of the table designer with the Name and Location values called out.":::
6868

69-
5. Save the **Table1.sql** file.
69+
1. Save the **Table1.sql** file.
7070

7171
## Build and validate the database
7272

73-
1. Open the database project menu on **TutorialDB** and select **Build**. SSDT compiles .sql source code files in your project and builds a Data-tier Application package (dacpac) file. This can be used to publish a database to your SQL Server instance on Linux.
73+
1. Open the database project menu on **TutorialDB** and select **Build**. SSDT compiles .sql source code files in your project and builds a Data-tier Application package (dacpac) file. This can be used to publish a database to your SQL Server instance on Linux.
7474

75-
<img src="./media/sql-server-linux-develop-use-ssdt/build.png" alt="Screenshot showing the TutorialDB with the Build option called out."/>
75+
:::image type="content" source="media/sql-server-linux-develop-use-ssdt/build.png" alt-text="Screenshot showing the TutorialDB with the Build option called out.":::
7676

77-
2. Check the build success message in **Output** window in Visual Studio.
77+
1. Check the build success message in **Output** window in Visual Studio.
7878

7979
## Publish the database to SQL Server instance on Linux
8080

8181
1. Open the database project menu on **TutorialDB** and select **Publish**.
8282

83-
2. Select **Edit** to select your SQL Server instance on Linux.
83+
1. Select **Edit** to select your SQL Server instance on Linux.
8484

85-
<img src="./media/sql-server-linux-develop-use-ssdt/publish-dialog.png" alt="publish dialog"/>
85+
:::image type="content" source="media/sql-server-linux-develop-use-ssdt/publish-dialog.png" alt-text="Screenshot showing the Publish option with the Edit option called out":::
8686

87-
3. On the connection dialog, type in the IP address or host name of your SQL Server instance on Linux, user name and password.
87+
1. On the connection dialog, type in the IP address or host name of your SQL Server instance on Linux, user name and password.
8888

89-
<img src="./media/sql-server-linux-develop-use-ssdt/connection-dialog.png" alt="connection dialog"/>
89+
:::image type="content" source="media/sql-server-linux-develop-use-ssdt/connection-dialog.png" alt-text="Screenshot showing the connection dialog.":::
9090

91-
4. Select the **Publish** button on the publish dialog.
91+
1. Select the **Publish** button on the publish dialog.
9292

93-
5. Check the publish status in the **Data Tools Operations** window.
93+
1. Check the publish status in the **Data Tools Operations** window.
9494

95-
6. Select **View Results** or **View Script** to see details of the database publish result on your SQL Server on Linux.
95+
1. Select **View Results** or **View Script** to see details of the database publish result on your SQL Server on Linux.
9696

97-
<img src="./media/sql-server-linux-develop-use-ssdt/publish-result.png" alt="publish result"/>
97+
:::image type="content" source="media/sql-server-linux-develop-use-ssdt/publish-result.png" alt-text="Screenshot showing the publish result with View Script and View Result called out.":::
9898

9999
You've successfully created a new database on SQL Server instance on Linux and learned the basics of developing a database with a source-controlled database project.
100100

101101
## Next steps
102102

103-
If you're new to T-SQL, see [Tutorial: Writing Transact-SQL Statements](../t-sql/tutorial-writing-transact-sql-statements.md).
104-
105-
For more information about developing a database with SQL Data Tools, see the below articles.
106-
107-
* [Download and Install Visual Studio](https://www.visualstudio.com/downloads/)
108-
* [Download and Install SSDT](../ssdt/download-sql-server-data-tools-ssdt.md)
109-
* [SSDT MSDN documents](/previous-versions/sql/sql-server-data-tools/hh272686(v=vs.103))
110-
* [Tutorial: Writing Transact-SQL Statements](../t-sql/tutorial-writing-transact-sql-statements.md)
111-
* [Transact-SQL Reference (Database Engine)](../t-sql/language-reference.md)
103+
- [Tutorial: Writing Transact-SQL Statements](../t-sql/tutorial-writing-transact-sql-statements.md)
104+
- [Download and Install Visual Studio](https://www.visualstudio.com/downloads/)
105+
- [Download and Install SSDT](../ssdt/download-sql-server-data-tools-ssdt.md)
106+
- [SSDT MSDN articles](/previous-versions/sql/sql-server-data-tools/hh272686(v=vs.103))
107+
- [Tutorial: Writing Transact-SQL Statements](../t-sql/tutorial-writing-transact-sql-statements.md)
108+
- [Transact-SQL Reference (Database Engine)](../t-sql/language-reference.md)

0 commit comments

Comments
 (0)