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 Anda membuat proyek SQL Database, Anda membuat .dacpac file. Anda dapat memperbarui database baru dan yang sudah ada 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 dan 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 tergantung pada .NET SDK (diperlukan) dan AutoRest.Sql (opsional).

.NET SDK

Ekstensi memerlukan .NET SDK untuk fungsionalitas build proyek. Jika ekstensi tidak dapat mendeteksi versi yang didukung, ekstensi akan meminta Anda untuk menginstal .NET SDK. Anda dapat mengunduh dan menginstal .NET SDK untuk Windows, macOS, dan Linux.

Untuk memeriksa versi dotnet SDK yang saat ini diinstal , buka terminal dan jalankan perintah berikut:

dotnet --list-sdks

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

Masalah umum

  • Tidak ada nuget.org 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).

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

Untuk informasi selengkapnya tentang pemecahan masalah build proyek SQL, lihat Memecahkan masalah build proyek SQL.

SQLCLR

Visual Studio Code tidak mendukung objek SQLCLR dalam proyek database, karena objek ini mengandalkan .NET Framework, dan ekstensi Proyek SQL Database menggunakan .NET untuk membangun proyek.

Workspace

Proyek database SQL terkandung dalam ruang kerja logis (folder) di Visual Studio Code. Secara default, Anda dapat mengakses semua proyek SQL dalam folder yang terbuka di ruang kerja saat ini dalam tampilan Proyek SQL Database .

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

Dalam contoh berikut file .code-workspace, array folders mencantumkan semua folder yang disertakan pada panel Explorer. 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