Mulai cepat: Gunakan mode rencana untuk desain database berbasis spesifikasi

Mode Rencana adalah fitur Visual Studio Code yang memungkinkan GitHub Copilot menalar permintaan tanpa membuat perubahan apa pun. Saat Anda merancang database, mode perencanaan menerjemahkan dokumen persyaratan produk (PRD) berbahasa alami ke dalam model data yang disusun berdasarkan penalaran (tabel, relasi, tabel penghubung, arah kunci asing, dan kendala) sebelum Anda menulis satu pun pernyataan CREATE TABLE. Anda kemudian menyerahkan rencana ke mode agen atau Schema Designer untuk membangun skema aktual.

Tip

Gunakan mode perencanaan saat Anda perlu berpikir sebelum menulis bahasa definisi data SQL (DDL), terutama untuk skema baru atau refaktor besar. Untuk perubahan tabel tunggal, gunakan mode tanya sebagai gantinya.

Kesimpulan utama

  • Mode rencana menghasilkan rencana tertulis (sering disimpan sebagai plan.md) yang dapat Anda tinjau sebelum eksekusi.
  • Mode Rencana mengenali skema saat Anda menggunakannya bersama peserta chat @mssql atau melampirkan berkas dengan #file:.
  • Padukan mode rencana dengan instruksi kustom agar rencana mewarisi konvensi Transact-SQL (T-SQL) Anda secara otomatis.
  • Mode perencanaan adalah fitur Visual Studio Code, bukan fitur yang khusus untuk MSSQL, tetapi sangat cocok untuk perancangan basis data.

Prasyarat

  • Visual Studio Code dengan ekstensi MSSQL terinstal.
  • Langganan GitHub Copilot yang aktif dengan mode paket langganan yang tersedia dalam daftar tarik-turun mode obrolan.
  • Folder workspace tempat Anda dapat membuat file requirements.md.
  • Opsional: koneksi database target untuk handoff dalam mode agen.
  • Opsional: berkas instruksi khusus untuk konvensi T-SQL Anda.

Apa itu mode rencana?

Mode perencanaan adalah salah satu dari mode chat di Visual Studio Code, bersama mode tanya, mode edit, dan mode agen. Dalam mode perencanaan, GitHub Copilot:

  • Membaca permintaan dan konteks yang dilampirkan.
  • Menghasilkan rencana tertulis yang memecah pekerjaan menjadi langkah-langkah beralasan.
  • Tidak mengubah file atau menjalankan alat. Rencananya adalah artefak berpikir, bukan eksekusi.

Anda kemudian dapat beralih ke mode agen (atau Schema Designer) untuk menjalankan rencana. Untuk dokumentasi umum, lihat Mode obrolan di Visual Studio Code.

Mengapa mode perencanaan cocok untuk desain database

Keputusan terkait model data bersifat akumulatif. Tabel penghubung, arah relasi kunci asing, kolom audit, dan pilihan normalisasi lebih mudah diubah di dalam rencana Markdown daripada di DDL yang sudah diterbitkan. Mode rencana memungkinkan Anda:

  • Validasi desain sebelum membangun. Tinjau skema yang diusulkan, sanggah pilihan yang meragukan, dan lakukan iterasi terhadap rencana.
  • Mengekspos hubungan tersembunyi. Mode perencanaan memunculkan tabel penghubung dan relasi banyak-ke-banyak yang tidak Anda minta secara eksplisit.
  • Pisahkan spesifikasi dari eksekusi. PRD tetap berfokus pada produk; rencana menjadi artefak teknis; DDL menjadi hasil akhir.

Skenario end-to-end: Skema TaskManager

Panduan singkat ini memandu Anda melalui alur lengkap: PRD dalam bahasa alami → rencana dalam Markdown → tabel yang dibuat di Desainer Skema.

Langkah 1: Menulis dokumen persyaratan produk

Buat requirements.md di akar ruang kerja Anda. Jelaskan aplikasi dalam bahasa alami, termasuk entitas domain, hubungan, dan aturan bisnis. Jaga agar dokumen tetap fokus pada produk. Jangan tentukan jenis atau batasan kolom (itulah tujuan file instruksi kustom Anda).

# TaskManager - Product Specification

## Overview
A task management application for small development teams. Supports user
registration, role-based project membership, task tracking with multi-assignee
support, and team collaboration.

## User management
- Users register with email, username, first and last name, hashed password.
- Email and username must be unique across the system.
- Users can be deactivated (soft delete) rather than removed.
- A user can belong to multiple projects, each with a role: owner, admin, or member.

## Project management
- Projects have a name, description, and active/inactive status.
- Each project tracks who created it.
- Project membership is role-based - one entry per user per project.

## Task tracking
- Tasks belong to exactly one project.
- Required: title. Optional: description, due date.
- Status must be one of: todo, in-progress, done.
- Priority must be one of: low, medium, high, critical.
- Tasks can be assigned to multiple team members.

## Collaboration
- Team members can comment on tasks.
- Comments are text-based, tied to both a task and the author.

## Data integrity
- Every record must track when it was created and last updated.
- All relationships must enforce referential integrity.
- Deletes should be restricted (no orphan records).
- Status and priority fields must only accept valid values.

Langkah 2: Alihkan GitHub Copilot Chat ke mode perencanaan

  1. Buka tampilan Copilot Chat GitHub.
  2. Dalam daftar tarik-turun mode chat, pilih Plan.

Langkah 3: Kirim PRD ke mode rencana

Lampirkan requirements.md sebagai konteks, baik dengan menyeret file ke dalam input obrolan, menggunakan #file:requirements.md, atau memilih tombol lampirkan.

Based on the requirements document, think through the full data model:
identify all tables, relationships, junction tables, and constraints.
Save the plan so I can use it in the next step.

GitHub Copilot menghasilkan rencana yang beralasan dan menyimpannya seperti plan.md di ruang kerja Anda. Paket ini biasanya mencakup:

  • Daftar tabel dengan tujuannya
  • Hubungan (satu-ke-banyak, banyak-ke-banyak) dan tabel penghubung yang memungkinkan hubungan tersebut
  • Batasan (unik, periksa, kunci asing) yang memberlakukan aturan bisnis dari PRD
  • Pertanyaan terbuka atau asumsi yang menjadi dasar rencana

Tinjau rencana sebelum melanjutkan. Jika ada relasi yang tidak ada atau batasan yang keliru, lakukan iterasi dengan mengirim prompt lanjutan dalam mode perencanaan. Mode perencanaan tidak menyimpan status dan hemat biaya, sehingga beberapa putaran penyempurnaan merupakan hal yang wajar.

Langkah 4: Serahkan rencana ke mode agen atau Schema Designer

Jika rencana sudah benar, beralihlah ke mode agen dan buat skemanya.

  1. Di daftar dropdown mode obrolan, pilih Agen.
  2. Kirim prompt yang merujuk ke file rencana dan permukaan target:
Based on #file:plan.md, use Schema Designer to create all the tables
and relationships in my database. Focus on the database schema only -
skip any application layer items from the plan.

Mode agen membuka Perancang Skema dan membuat setiap tabel, meminta persetujuan Anda di setiap langkah. Instruksi kustom Anda berlaku secara otomatis: penamaan kolom, kolom audit, kualifikasi skema, dan penamaan batasan semua mengikuti konvensi Anda.

Tips

  • Padukan dengan instruksi kustom. Paket mewarisi konvensi Anda secara otomatis ketika Anda memiliki file instruksi kustom untuk **/*.sql.
  • Pastikan PRD tetap berfokus pada produk. Hindari menentukan jenis kolom atau batasan di requirements.md. Biarkan rencana mengisinya berdasarkan konvensi Anda.
  • Iterasi pada rencana, bukan DDL. Lebih murah merevisi rencana Markdown daripada menghapus dan membuat ulang tabel.
  • Simpan rencana dalam kontrol versi. Rencana ini merupakan dokumentasi yang berharga bagi kontributor di masa mendatang dan untuk meninjau kembali keputusan desain.
  • Gunakan diagram Mermaid di PRD. Diagram hubungan entitas dalam mode rencana bantuan Mermaid mengekstrak hubungan secara akurat.

Membagikan pengalaman Anda

Untuk membantu kami memperbaiki dan meningkatkan GitHub Copilot untuk ekstensi MSSQL, gunakan templat masalah GitHub berikut untuk mengirimkan umpan balik Anda: GitHub Copilot Feedback

Saat mengirimkan umpan balik, pertimbangkan untuk menyertakan:

  • Skenario yang diuji: Beri tahu kami area mana yang Anda fokuskan, misalnya, pembuatan skema, pembuatan kueri, keamanan, pelokalan.

  • Apa yang bekerja dengan baik: Jelaskan pengalaman apa pun yang terasa lancar, membantu, atau melebihi harapan Anda.

  • Masalah atau gangguan: Sertakan setiap masalah, inkonsistensi, atau perilaku yang membingungkan. Cuplikan layar atau rekaman layar sangat membantu.

  • Saran untuk perbaikan: Bagikan ide untuk meningkatkan kegunaan, memperluas cakupan, atau meningkatkan respons GitHub Copilot.

Konten terkait

  • Last updated on