Bagikan melalui

Ekstensi Proyek SQL Database

Penting

Azure Data Studio akan dihentikan pada 28 Februari 2026. Kami menyarankan agar Anda menggunakan Visual Studio Code. Untuk informasi selengkapnya tentang migrasi ke Visual Studio Code, kunjungi Apa yang terjadi pada Azure Data Studio?

Ekstensi Proyek SQL Database adalah ekstensi Visual Studio Code untuk mengembangkan database SQL di lingkungan pengembangan berbasis proyek. Database yang kompatibel termasuk SQL Server, Azure SQL Database, Azure SQL Managed Instance, Warehouse in Fabric, dan database SQL di Fabric. Proyek SQL adalah representasi lokal objek SQL yang terdiri dari skema untuk database tunggal, seperti tabel, prosedur tersimpan, atau fungsi. Saat proyek SQL Database dibangun, artefak output adalah .dacpac file. Database baru dan yang sudah ada dapat diperbarui agar sesuai dengan konten .dacpac dengan menerbitkan proyek SQL Database dengan ekstensi Proyek SQL Database atau dengan menerbitkan .dacpac dengan antarmuka baris perintah SqlPackage .

Cuplikan layar Ringkasan Proyek SQL Database yang berisi skrip pra-penyebaran dan pasca-penyebaran serta objek database.

Untuk informasi selengkapnya tentang konsep proyek SQL, lihat Apa itu proyek database SQL?

Fitur tambahan

Ekstensi Proyek SQL Database menyediakan fitur berikut:

  • Buat proyek Microsoft.Build.Sql kosong baru.
  • Buat proyek baru dari database yang tersambung.
  • Buka proyek yang sebelumnya dibuat di Visual Studio Code, atau di SQL Server Data Tools.
  • Edit proyek dengan menambahkan atau menghapus objek (tabel, tampilan, prosedur tersimpan) atau skrip kustom dalam proyek.
  • Atur file/skrip dalam folder.
  • Tambahkan referensi ke database sistem atau dacpac pengguna.
  • Bangun satu proyek.
  • Sebarkan satu proyek.
  • Muat detail koneksi (autentikasi SQL Windows) dan variabel SQLCMD dari profil penyebaran.

Install

Anda dapat menginstal ekstensi Proyek SQL Database di Visual Studio Code.

Ekstensi Proyek SQL Database diinstal dengan ekstensi mssql untuk Visual Studio Code.

Dependensi

Ekstensi Proyek SQL Database memiliki dependensi pada .NET SDK (diperlukan) dan AutoRest.Sql (opsional).

.NET SDK

.NET SDK diperlukan untuk fungsionalitas build proyek dan Anda diminta untuk menginstal .NET SDK jika versi yang didukung tidak dapat dideteksi oleh ekstensi. .NET SDK dapat diunduh dan diinstal untuk Windows, macOS, dan Linux.

Jika Anda ingin memeriksa versi dotnet SDK yang terinstal saat ini , buka terminal dan jalankan perintah berikut:

dotnet --list-sdks

Setelah menginstal .NET SDK, lingkungan Anda siap untuk menggunakan ekstensi Proyek SQL Database.

Masalah umum

Nuget.org hilang dari daftar sumber dapat mengakibatkan pesan kesalahan seperti:

  • 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

Untuk memeriksa apakah nuget.org terdaftar sebagai sumber, jalankan dotnet nuget list source dari baris perintah dan tinjau hasil untuk item yang [Enabled] merujuk nuget.org. Jika nuget.org tidak terdaftar sebagai sumber, jalankan dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org.

Versi .NET SDK yang tidak didukung dapat mengakibatkan pesan kesalahan seperti:

  • 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]_ (di mana file yang ditautkan tidak ada dan tanda kurung siku penutupnya tidak cocok).

Untuk memaksa ekstensi Proyek SQL Database menggunakan versi v6.x dari .NET SDK saat beberapa versi diinstal, tambahkan file global.json ke folder yang berisi proyek SQL.

Informasi selengkapnya tentang pemecahan masalah build proyek SQL dapat ditemukan di Memecahkan Masalah build proyek SQL.

SQLCLR

Objek SQLCLR dalam proyek database tidak didukung di Visual Studio Code karena mengandalkan .NET Framework dan ekstensi Proyek Database SQL menggunakan .NET untuk membangun proyek.

Workspace

Proyek database SQL terkandung dalam ruang kerja logis (folder) di Visual Studio Code. Semua proyek SQL dalam folder yang terbuka di ruang kerja saat ini tersedia dalam tampilan Proyek SQL Database secara default.

Anda dapat menambahkan dan menghapus proyek secara manual dari ruang kerja melalui antarmuka di panel Proyek . Pengaturan untuk ruang kerja dapat diedit secara manual dalam .code-workspace file, jika perlu.

Dalam contoh file .code-workspace berikut, array folders mencantumkan semua folder yang disertakan dalam panel Explorer, dan array dataworkspace.excludedProjects dalam settings mencantumkan semua proyek SQL yang dikecualikan dari panel Proyek.

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

Konten terkait

  • Last updated on