Rychlý start: Použití režimu plánu pro návrh databáze řízené specifikacemi

Režim plánování je funkce aplikace Visual Studio Code, která umožňuje GitHub Copilotu promyslet požadavek, aniž by provedl jakékoli změny. Při návrhu databáze přeloží režim plánu dokument s požadavky na produkt v přirozeném jazyce (PRD) do odůvodněného datového modelu (tabulky, relace, spojovací tabulky, směr cizího klíče a omezení) před zápisem jednoho CREATE TABLE příkazu. Plán pak předáte režimu agenta nebo návrháři schématu k sestavení skutečného schématu.

Tip

Režim plánování použijte, když si potřebujete věci promyslet před psaním jazyka SQL DDL (Data Definition Language), zejména u nově navrhovaných schémat nebo rozsáhlých refaktorizací. U změn v jedné tabulce použijte místo toho režim dotazování .

Klíčové poznatky

  • Režim plánu vytvoří napsaný plán (často uložený jako plan.md), který můžete před provedením zkontrolovat.
  • Režim plánu rozpoznává schéma, když ho používáte spolu s účastníkem chatu @mssql nebo když přiložíte soubory pomocí #file:.
  • Spárujte režim plánu s vlastními pokyny , aby plán zdědil vaše konvence Transact-SQL (T-SQL) automaticky.
  • Režim plánu je funkce Visual Studio Code, ne specifická pro MSSQL, ale dobře odpovídá návrhu databáze.

Předpoklady

  • Visual Studio Code s nainstalovaným rozšířením MSSQL.
  • Aktivní předplatné GitHub Copilot s dostupným režimem plánování v rozevíracím seznamu režimu chatu.
  • Složka pracovního prostoru, ve které můžete vytvořit requirements.md soubor.
  • Volitelné: připojení k cílové databázi pro předání do režimu agenta.
  • Volitelné: Vlastní soubor instrukcí pro konvence T-SQL.

Co je režim plánu?

Režim plánování je jedním z režimů chatu v Visual Studio Code spolu s režimem dotazování, režimem úprav a režimem agenta. V režimu plánování GitHub Copilot:

  • Přečte požadavek a veškerý připojený kontext.
  • Vytvoří napsaný plán, který rozdělí práci na odůvodněné kroky.
  • Neupravuje soubory ani nespouští nástroje. Plán je myšlenková pomůcka, nikoli realizace.

Pak můžete přepnout do režimu agenta (nebo Návrhář schématu) a plán spustit. Obecná dokumentace najdete v tématu Režimy chatu v Visual Studio Code.

Proč režim plánu odpovídá návrhu databáze

Rozhodnutí o datovém modelu se kumulují. Propojovací tabulky, směr cizího klíče, auditní sloupce a volby normalizace se snáze upravují v markdownovém plánu než ve zveřejněném DDL. Režim plánování umožňuje:

  • Před sestavením ověřte návrh. Zkontrolujte navrhované schéma, zpochybněte problematická rozhodnutí a plán průběžně upravujte.
  • Odhalte skryté vztahy. Režim plánu zobrazuje spojovací tabulky a relace mnoho ku mnoha, které jste si výslovně nevyžádali.
  • Oddělte specifikaci od provádění. PRD zůstává zaměřené na produkt; plán je technickým artefaktem; DDL je výstupem.

Kompletní scénář: Schéma TaskManageru

Tento rychlý start vás provede úplným tokem: PRD v přirozeném jazyce → plán v Markdownu → tabulky integrované v Návrháři schématu.

Krok 1: Vytvoření dokumentu s požadavky na produkt

Vytvořte requirements.md v kořenovém adresáři vašeho pracovního prostoru. Popište aplikaci v přirozeném jazyce, včetně entit domény, vztahů a obchodních pravidel. Udržujte dokument zaměřený na produkt. Nezadávejte typy sloupců ani omezení (to je soubor s vlastními pokyny ).

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

Krok 2: Přepnutí Copilot Chat GitHubu do režimu plánování

  1. Otevřete zobrazení Copilot Chat GitHubu.
  2. V rozevíracím seznamu chatovacího režimu vyberte Plán.

Krok 3: Odešlete PRD do režimu plánování

Připojte requirements.md jako kontext buď přetažením souboru do vstupu chatu, pomocí #file:requirements.mdnebo výběrem tlačítka Připojit.

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 vytvoří zdůvodněný plán a uloží ho jako plan.md v pracovním prostoru. Plán obvykle zahrnuje:

  • Seznam tabulek s jejich účelem
  • Relace (jeden k mnoha, mnoho k mnoha) a propojovací tabulky, které je umožňují
  • Omezení (jedinečná, kontrola, cizí klíč), která vynucují obchodní pravidla z PRD
  • Otevřené otázky nebo předpoklady, na které plán spoléhá

Než budete pokračovat, zkontrolujte plán. Pokud relace chybí nebo je nějaké omezení nesprávné, iterujte odesláním následných výzev v režimu plánu. Režim plánování je bezstavový a nenákladný, takže několik kol upřesňování je běžné.

Krok 4: Předání plánu do režimu agenta nebo návrháře schémat

Jakmile se plán přečte správně, přepněte do režimu agenta a sestavte schéma.

  1. V rozevíracím seznamu chatovacího režimu vyberte Agent.
  2. Odešlete výzvu, která odkazuje na soubor plánu a cílovou plochu:
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.

Režim agenta otevře Návrhář schématu a vytvoří každou tabulku s žádostí o schválení v každém kroku. Vlastní pokyny platí automaticky: pojmenování sloupců, auditování sloupců, kvalifikace schématu a pojmenování omezení se řídí vašimi konvencemi.

Tips

  • Spárujte s vlastními instrukcemi. Plán dědí vaše konvence automaticky, pokud máte soubor s vlastními pokyny pro **/*.sql.
  • Udržujte PRD zaměřené na produkt. Vyhněte se zadávání typů sloupců nebo omezení v requirements.md. Nechte plán, aby je doplnil podle vašich konvencí.
  • Upravujte iterativně plán, ne DDL. Úprava plánu Markdownu je levnější než vyřazení a opětovné vytvoření tabulek.
  • Uložte plán ve správě zdrojového kódu. Plán je cenná dokumentace pro budoucí přispěvatele a pro revizi rozhodnutí o návrhu.
  • V PRD používejte diagramy Mermaid. Diagramy entit a vztahů v nástroji Mermaid pomáhají režimu plánování přesně extrahovat vztahy.

Podělte se o své zkušenosti

Pokud nám chcete pomoct upřesnit a vylepšit GitHub Copilot pro rozšíření MSSQL, odešlete zpětnou vazbu pomocí následující šablony problému Na GitHubu: Váš názor na GitHub Copilot

Při odesílání zpětné vazby zvažte následující:

  • Testované scénáře: Dejte nám vědět, na které oblasti jste se zaměřili, například na vytváření schématu, generování dotazů, zabezpečení, lokalizaci.

  • Co dobře fungovalo: Popište všechny zkušenosti, které probíhaly hladce, byly užitečné nebo překročily vaše očekávání.

  • Problémy nebo chyby: Zahrňte všechny problémy, nekonzistence nebo matoucí chování. Snímky obrazovky nebo nahrávky obrazovky jsou užitečné hlavně.

  • Návrhy pro zlepšení: Sdílejte nápady na zlepšení použitelnosti, rozšíření pokrytí nebo vylepšení odpovědí GitHub Copilotu.

Související obsah

  • Last updated on