Skip to content

sql-server-linux-develop-use-ssdt.md

Latest commit

 

History

History
117 lines (70 loc) · 5.51 KB

sql-server-linux-develop-use-ssdt.md

File metadata and controls

117 lines (70 loc) · 5.51 KB
title Develop and Deploy SQL Server databases for Linux  | Microsoft Docs
description
author erickangMSFT
ms.author erickang
manager jroth
ms.date 03/17/2017
ms.topic article
ms.prod sql-non-specified
ms.prod_service database-engine
ms.service
ms.component
ms.suite sql
ms.technology database-engine
ms.assetid 1e924704-e07c-4a8b-b243-8c1dd8cff0d3
ms.custom sql-linux
ms.workload On Demand

Use Visual Studio to create databases for SQL Server on Linux

[!INCLUDEappliesto-ss-xxxx-xxxx-xxx-md-linuxonly]

SQL Server Data Tools (SSDT) turns Visual Studio into a powerful development and database lifecycle management (DLM) environment for SQL Server on Linux. You can develop, build, test, and publish your database from a source-controlled project, just like you develop your application code.

Install Visual Studio and SQL Server Data Tools

  1. If you have not already installed Visual Studio on your Windows machine, Download and Install Visual Studio. If you do not have a Visual Studio license, Visual Studio Community edition is a free, fully-featured IDE for students, open-source and individual developers.

  2. During the Visual Studio installation, select Custom for the Choose the type of installation option. Click Next

  3. Select Microsoft SQL Server Data Tools, Git for Windows, and GitHub Extension for Visual Studio from the feature selection list.

    ssdt setup

  4. Continue and finish the installation of Visual Studio. It can take a few minutes.

Upgrade SQL Server Data Tools to SSDT 17.0 RC release

SQL Server 2017 on Linux is supported by SSDT version 17.0 RC or later.

Create a new database project in source control

  1. Launch Visual Studio.

  2. Select Team Explorer on the View menu.

  3. Click New in Local Git Repository section on the Connect page.

    local repository

  4. Click Create. After the local Git repository is created, double click SSDTRepo.

  5. Click New in the Solutions section. Select SQL Server under Other Languages node in the New Project dialog.

    local repository

  6. Type in TutorialDB for the name and click OK to create a new database project.

Create a new table in the database project

  1. Select Solution Explorer on the View menu.

  2. Open the database project menu by right-clicking on TutorialDB in Solution Explorer.

  3. Select Table under Add.

    create table

  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.

    add columns

  5. Save the Table1.sql file.

Build and validate the database

  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 2017 instance on Linux.

    add columns

  2. Check the build success message in Output window in Visual Studio.

Publish the database to SQL Server 2017 instance on Linux

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

  2. Click Edit to select your SQL Server instance on Linux.

    publish dialog

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

    connection dialog

  4. Click the Publish button on the publish dialog.

  5. Check the publish status in the Data Tools Operations window.

  6. Click View Reulst or View Script to see details of the database publish result on your SQL Server on Linux.

    publish result

You have 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.

Next steps

If you're new to T-SQL, see Tutorial: Writing Transact-SQL Statements and the Transact-SQL Reference (Database Engine).

For more information about developing a database with SQL Data Tools, see SSDT MSDN documents