Hızlı Başlangıç: Belirtim temelli veritabanı tasarımı için plan modunu kullanma

Plan modu, GitHub Copilot’un herhangi bir değişiklik yapmadan bir isteği değerlendirmesini sağlayan bir Visual Studio Code özelliğidir. Veritabanı tasarlarken plan modu, tek CREATE TABLE bir deyim yazmadan önce doğal dil ürün gereksinimleri belgesini (PRD) gerekçeli bir veri modeline (tablolar, ilişkiler, birleşim tabloları, yabancı anahtar yönü ve kısıtlamalar) çevirir. Ardından asıl şemayı oluşturmak için planı aracı moduna veya Şema Tasarımcısı'na teslim edebilirsiniz.

Tip

Özellikle yeşil alan şemaları veya büyük yeniden düzenlemelerde SQL veri tanımı dili (DDL) yazmadan önce düşünmeniz gerektiğinde plan modunu kullanın. Tek tablolu değişiklikler için bunun yerine sor modunu kullanın.

Önemli çıkarımlar

  • Plan modu, yürütmeden önce gözden geçirebileceğiniz yazılı bir plan oluşturur (genellikle plan.md olarak kaydedilir).
  • Plan modu, sohbet katılımcısıyla @mssql birlikte kullandığınızda veya ile #file:dosya eklediğinizde şemaya duyarlıdır.
  • Planın Transact-SQL (T-SQL) kurallarınızı otomatik olarak devralması için plan modunu özel yönergelerle eşleştirin.
  • Plan modu, MSSQL'e özgü bir özellik değil Visual Studio Code bir özelliktir, ancak veritabanı tasarımına iyi uyum sağlar.

Prerequisites

  • MSSQL uzantısının yüklü olduğu Visual Studio Code.
  • Sohbet modu açılır listesinde plan modunun kullanılabildiği etkin bir GitHub Copilot aboneliği.
  • Dosya yazabileceğiniz bir requirements.md çalışma alanı klasörü.
  • İsteğe bağlı: aracı modu devri için hedef veritabanı bağlantısı.
  • İsteğe bağlı: T-SQL kurallarınız için özel yönergeler dosyası.

Plan modu nedir?

Plan modu, Visual Studio Code sohbet modlarından biridir ve soru modu, düzenleme modu ve aracı modu ile birlikte kullanılır. Planlama modunda GitHub Copilot:

  • İsteği ve ekli bağlamı okur.
  • Çalışmayı makul adımlara bölen yazılı bir plan oluşturur.
  • Dosyaları değiştirmez veya araçları çalıştırmaz. Plan bir düşünce yapıtı, yürütme değil.

Ardından planı yürütmek için aracı moduna (veya Şema Tasarımcısı'na) geçebilirsiniz. Genel belgeler için bkz. Visual Studio Code sohbet modları.

Plan modu neden veritabanı tasarımına uyar?

Veri modeli kararları bileşimi. Birleşim tabloları, yabancı anahtar yönü, denetim sütunları ve normalleştirme seçenekleri, yayımlanan DDL'ye kıyasla Markdown planında daha kolay düzeltilir. Plan modu şunları yapmanızı sağlar:

  • Oluşturmadan önce tasarımı doğrulayın. Önerilen şemayı gözden geçirin, tartışmalı tercihlere itiraz edin ve plan üzerinde yineleme yapın.
  • Gizli ilişkileri ortaya çıkarın. Plan modu, açıkça sormadığınız birleşim tablolarını ve çoka çok ilişkileri ortaya çıkar.
  • Belirtimi yürütmeden ayırın. PRD ürüne yönelik kalır; plan teknik yapıt haline gelir; DDL teslim edilebilir hale gelir.

Uçtan uca senaryo: TaskManager şeması

Bu hızlı başlangıç, uçtan uca bir akışı anlatır: doğal dilde PRD → Markdown'da plan → Şema Tasarımcısı'nda oluşturulan tablolar.

1. Adım: Ürün gereksinimleri belgesi yazma

Çalışma alanınızın kök dizininde requirements.md oluşturun. Uygulamayı, etki alanı varlıkları, ilişkiler ve iş kuralları dahil olmak üzere doğal dilde açıklayın. Belgeyi ürün odaklı tutun. Sütun türlerini veya kısıtlamaları belirtmeyin ( özel yönergeler dosyanız bunun içindir).

# 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.

2. Adım: GitHub Copilot Chat plan moduna geçme

  1. GitHub Copilot Chat görünümünü açın.
  2. Sohbet modu açılan listesinde Plan'ı seçin.

3. Adım: PRD'yi plan moduna gönderme

requirements.md öğesini bağlam olarak ekleyin; bunu dosyayı sohbet giriş alanına sürükleyerek, #file:requirements.md kullanarak veya ekle düğmesini seçerek yapabilirsiniz.

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, gerekçelendirilmiş bir plan oluşturur ve bunu çalışma alanınıza plan.md olarak kaydeder. Plan genellikle şunları içerir:

  • Amaçlarına sahip tabloların listesi
  • İlişkiler (bire-çok, çoka-çok) ve bunları mümkün kılan ara tablolar
  • PRD'den iş kurallarını zorunlu kılan kısıtlamalar (benzersiz, denetim, yabancı anahtar)
  • Planın bağlı olduğu açık sorular veya varsayımlar

Devam etmeden önce planı gözden geçirin. Bir ilişki eksikse veya bir kısıtlama yanlışsa, plan modunda takip istemleri göndererek yineleyin. Plan modu durumsuzdur ve düşük maliyetlidir; bu nedenle birden fazla iyileştirme turu normaldir.

4. Adım: Planı aracı moduna veya Şema Tasarımcısı'na teslim etme

Plan doğru okunduktan sonra aracı moduna geçin ve şemayı oluşturun.

  1. Sohbet modu açılır listesinde Agent seçeneğini belirleyin.
  2. Plan dosyasına ve hedef yüzeye başvuran bir istem gönderin:
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.

Aracı modu Şema Tasarımcısı'nı açar ve her adımda onayınızı isteyen her tabloyu oluşturur. Özel yönergeleriniz otomatik olarak uygulanır: sütun adlandırma, denetim sütunları, şema niteliği ve kısıtlama adlandırma kurallarınıza uyar.

Tips

  • Özel yönergelerle eşleştirin. **/*.sql için bir özel yönergeler dosyanız olduğunda plan, kurallarınızı otomatik olarak devralır.
  • PRD'yi ürün odaklı tutun. içinde requirements.mdsütun türlerini veya kısıtlamaları belirtmekten kaçının. Planın, bunları standartlarınıza göre doldurmasına izin verin.
  • DDL üzerinde değil, plan üzerinde yineleme yapın. Markdown planını düzenlemek, tabloları bırakıp yeniden oluşturmaktan daha ucuz.
  • Planı kaynak denetimine kaydedin. Bu plan, gelecekte katkıda bulunacak kişiler için ve tasarım kararlarını yeniden değerlendirmek açısından değerli bir belgedir.
  • PRD'de Denizkızı diyagramlarını kullanın. Mermaid yardım planı modunda varlık ilişkisi diyagramları ilişkileri doğru bir şekilde ayıklar.

Deneyiminizi paylaşma

MSSQL uzantısı için GitHub Copilot'ı geliştirmemize ve geliştirmemize yardımcı olmak için aşağıdaki GitHub sorun şablonunu kullanarak geri bildiriminizi gönderin: GitHub Copilot Geri Bildirimi

Geri bildirim gönderirken şunları dahil etmeyi göz önünde bulundurun:

  • Test edilen senaryolar: Şema oluşturma, sorgu oluşturma, güvenlik, yerelleştirme gibi odaklandığınız alanları bize bildirin.

  • İyi çalışan şeyler: Sorunsuz, yararlı veya beklentilerinizi aşan deneyimleri açıklayın.

  • Sorunlar veya hatalar: Tüm sorunları, tutarsızlıkları veya kafa karıştırıcı davranışları dahil edin. Ekran görüntüleri veya ekran kayıtları özellikle yararlıdır.

  • İyileştirme önerileri: Kullanılabilirliği geliştirmeye, kapsamı genişletmeye veya GitHub Copilot'un yanıtlarını geliştirmeye yönelik fikirleri paylaşın.

İlgili içerik

  • Last updated on