SQL Database Projects 확장

아티클
10/01/2024

SQL 데이터베이스 프로젝트 확장은 프로젝트 기반 개발 환경에서 SQL 데이터베이스를 개발하기 위한 Azure Data Studio 및 Visual Studio Code 확장 프로그램입니다. 호환되는 데이터베이스에는 SQL Server, Azure SQL 데이터베이스, Azure SQL Managed Instance 및 Azure Synapse SQL이 포함됩니다. SQL 프로젝트는 테이블, 저장 프로시저 또는 함수와 같은 단일 데이터베이스의 스키마를 구성하는 SQL 개체의 로컬 표현입니다. SQL 데이터베이스 프로젝트가 빌드되면 출력 아티팩트는 .dacpac 파일입니다. 새 데이터베이스 및 기존 데이터베이스는 SQL 데이터베이스 프로젝트 확장자를 사용하여 SQL 데이터베이스 프로젝트를 게시하거나 명령줄 인터페이스 SqlPackage를 사용하여 .dacpac을 게시하여 .dacpac의 콘텐츠와 일치하도록 업데이트할 수 있습니다.

배포 전 및 배포 후 스크립트와 데이터베이스 개체가 포함된 SQL 데이터베이스 프로젝트 요약입니다.

확장 기능

SQL Database Projects 확장은 다음 기능을 제공합니다.

비어 있는 새 프로젝트 만들기
연결된 데이터베이스에서 새 프로젝트를 만듭니다.
Azure Data Studio, Visual Studio Code 또는 SQL Server Data Tools에서 이전에 만든 프로젝트를 엽니다.
프로젝트에서 개체(테이블, 뷰, 저장 프로시저) 또는 사용자 지정 스크립트를 추가하거나 제거하여 프로젝트를 편집합니다.
폴더의 파일/스크립트 구성
시스템 데이터베이스 또는 사용자 dacpac에 대한 참조를 추가합니다.
단일 프로젝트를 빌드합니다.
단일 프로젝트를 배포합니다.
배포 프로필에서 연결 세부 정보(SQL Windows 인증) 및 SQLCMD 변수 로드

SQL Database 프로젝트 확장의 다음 기능은 현재 미리 보기로 제공됩니다.

OpenAPI 사양 파일에서 새 프로젝트를 만듭니다.
SDK 스타일 SQL 프로젝트(Microsoft.Build.Sql).

Azure Data Studio의 SQL Database Projects 확장을 소개하는 10분 분량의 다음 동영상을 시청하세요.

설치

Azure Data Studio 및 Visual Studio Code에서 SQL Database 프로젝트 확장을 설치할 수 있습니다.

Azure Data Studio

Azure Data Studio에서 SQL Database 프로젝트 확장을 설치하려면 다음 단계를 수행합니다.

확장 관리자를 열어 사용 가능한 확장에 액세스합니다. 이렇게 하려면 확장 아이콘을 선택하거나 보기 메뉴에서 확장을 선택합니다.
확장 검색 상자에 이름 전부 또는 일부를 입력하여 SQL Database Projects 확장을 식별합니다. 세부 정보를 보려면 사용 가능한 확장을 선택합니다.
원하는 확장을 선택하고 설치하도록 선택합니다.
다시 로드를 선택하여 확장을 사용하도록 설정합니다(확장을 처음 설치할 때만 필요).
작업 표시줄에서 프로젝트 아이콘을 선택합니다.

참고

모든 기능을 사용할 수 있도록 스키마 비교 확장을 SQL Database Projects 확장과 함께 설치하는 것이 좋습니다.

Visual Studio Code

SQL Database 프로젝트 확장은 Visual Studio Code용 mssql 확장과 함께 설치됩니다.

종속성

SQL 데이터베이스 프로젝트 확장자는 .NET SDK(필수) 및 AutoRest.Sql(선택 사항)에 대한 종속성이 있습니다.

.NET SDK

.NET SDK는 프로젝트 빌드 기능에 필요하며 확장자에서 지원되는 버전을 감지할 수 없는 경우 .NET SDK를 설치하라는 메시지가 표시됩니다. Windows, macOS 및 Linux용 .NET SDK를 다운로드하여 설치할 수 있습니다.

dotnet SDK의 현재 설치된 버전을 확인하려면 터미널을 열고 다음 명령을 실행합니다.

dotnet --list-sdks

.NET SDK를 설치한 후에는 환경에서 SQL Database Projects 확장을 사용할 준비가 된 것입니다.

일반적인 문제

원본 목록에서 누락된 Nuget.org 다음과 같은 오류 메시지가 발생할 수 있습니다.

error MSB4236: The SDK 'Microsoft.Build.Sql/0.1.9-preview' specified could not be found.
Unable to find package Microsoft.Build.Sql. No packages exist with this id in source(s): Microsoft Visual Studio Offline Packages

nuget.org가 소스로 등록되어 있는지 확인하려면 명령줄에서 dotnet nuget list source를 실행하고 nuget.org를 참조하는 [Enabled] 항목에 대한 결과를 검토합니다. nuget.org가 소스로 등록되지 않은 경우 dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org를 실행합니다.

지원되지 않는 .NET SDK 버전에서는 다음과 같은 오류 메시지가 표시될 수 있습니다.

error MSB4018: The "SqlBuildTask" task failed unexpectedly.
error MSB4018: System.TypeInitializationException: The type initializer for 'SqlSchemaModelStaticState' threw an exception. ---> System.IO.FileNotFoundException: Could not load file or assembly 'System.Runtime, Version=4.2.2.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'. The system cannot find the file specified. [c:\Users\ .sqlproj]_(연결된 존재하지 않는 파일의 닫는 대괄호가 일치하지 않는 경우).

여러 버전이 설치되어 있는 경우 SQL 데이터베이스 프로젝트 확장자가 .NET SDK의 v6.x 버전을 사용하도록 하려면 SQL 프로젝트가 포함된 폴더에 global.json 파일을 추가합니다.

AutoRest.Sql

AutoRest용 SQL 확장은 SQL 프로젝트가 OpenAPI 사양 파일에서 생성될 때 SQL Database 프로젝트 확장에 의해 자동으로 다운로드되고 사용됩니다.

제한 사항

현재 SQL Database Projects 확장에는 다음과 같은 제한 사항이 있습니다.

작업(빌드/게시)은 사용자가 정의할 수 없습니다.
프로젝트의 SQLCLR 개체는 지원되지 않습니다.
현재 프로젝트에 대한 코드 분석 규칙은 지원되지 않습니다.

작업 영역

SQL 데이터베이스 프로젝트는 Azure Data Studio 및 Visual Studio Code의 논리적 작업 영역에 포함됩니다. 작업 영역은 탐색기 창에 표시되는 폴더를 관리합니다. 현재 작업 영역에서 열려 있는 폴더 내의 모든 SQL 프로젝트는 기본적으로 SQL Database 프로젝트 보기에서 사용할 수 있습니다.

프로젝트 창의 인터페이스를 통해 작업 영역에서 프로젝트를 수동으로 추가하고 제거할 수 있습니다. 작업 영역의 설정은 필요한 경우 .code-workspace 파일에서 수동으로 편집할 수 있습니다.

다음 예제 .code-workspace 파일에서 folders 배열은 탐색기 창에 포함된 모든 폴더를 나열하고 settings 내의 dataworkspace.excludedProjects 배열은 프로젝트 창에 제외된 모든 SQL 프로젝트를 나열합니다.

{
  "folders": [
    {
      "path": "."
    },
    {
      "name": "WideWorldImportersDW",
      "path": "..\\WideWorldImportersDW"
    }
  ],
  "settings": {
    "dataworkspace.excludedProjects": [
      "AdventureWorksLT.sqlproj"
    ]
  }
}

다음을 통해 공유

SQL Database Projects 확장

확장 기능

설치

Azure Data Studio

Visual Studio Code

종속성

.NET SDK

일반적인 문제

AutoRest.Sql

제한 사항

작업 영역

피드백

추가 리소스

다음을 통해 공유

SQL Database Projects 확장

확장 기능

설치

Azure Data Studio

Visual Studio Code

종속성

.NET SDK

일반적인 문제

AutoRest.Sql

제한 사항

작업 영역

관련 콘텐츠

피드백

추가 리소스