Quickstart: Planmodus gebruiken voor het ontwerpen van specifieke databases

Planmodus is een Visual Studio Code-functie waarmee GitHub Copilot over een verzoek kan nadenken zonder wijzigingen aan te brengen. Wanneer u een database ontwerpt, vertaalt de planmodus een document met productvereisten in natuurlijke taal (PRD) in een gereden gegevensmodel (tabellen, relaties, verbindingstabellen, richting van refererende sleutels en beperkingen) voordat u één CREATE TABLE instructie schrijft. Vervolgens kunt u het plan aan de agentmodus of SchemaOntwerper geven om het werkelijke schema te bouwen.

Tip

Gebruik de planmodus wanneer u moet nadenken voordat u DDL (SQL Data Definition Language) schrijft, met name voor greenfield-schema's of grote herstructureringen. Gebruik in plaats daarvan de vraagmodus voor wijzigingen in één tabel.

Belangrijke punten

  • De planmodus produceert een geschreven plan (vaak opgeslagen als plan.md) dat u kunt controleren voordat u deze uitvoert.
  • De planmodus is zich bewust van het schema wanneer u deze gebruikt in combinatie met de @mssql chatdeelnemer of bestanden bijvoegt met #file:.
  • Koppel de planmodus met aangepaste instructies , zodat uw Transact-SQL (T-SQL)-conventies automatisch worden overgenomen.
  • De planmodus is een Visual Studio Code-functie, niet een MSSQL-specifieke functie, maar past goed bij het ontwerpen van databases.

Prerequisites

  • Visual Studio Code waarop de MSSQL-extensie is geïnstalleerd.
  • Een actief GitHub Copilot-abonnement waarbij de planmodus beschikbaar is in de vervolgkeuzelijst voor de chatmodus.
  • Een werkruimtemap waar u een requirements.md bestand kunt maken.
  • Optioneel: een doeldatabaseverbinding voor de overdracht van de agentmodus.
  • Optioneel: een aangepast instructiesbestand voor uw T-SQL-conventies.

Wat is de planningsmodus?

De planmodus is een van de chatmodi in Visual Studio Code, naast de vraagmodus, de bewerkingsmodus en de agentmodus. In de planmodus, GitHub Copilot:

  • Leest de aanvraag en eventuele gekoppelde context.
  • Stelt een schriftelijk plan op dat het werk opsplitst in logische stappen.
  • Hiermee worden geen bestanden gewijzigd of hulpprogramma's uitgevoerd. Het plan is een denkend artefact, geen uitvoering.

U kunt vervolgens overschakelen naar de agentmodus (of SchemaOntwerper) om het plan uit te voeren. Zie Chatmodi in Visual Studio Code voor algemene documentatie.

Waarom de planmodus past bij databaseontwerp

Beslissingen over het gegevensmodel stapelen zich op. Koppeltabellen, de richting van vreemde sleutels, auditkolommen en keuzes voor normalisatie zijn gemakkelijker te herzien in een Markdown-plan dan in gepubliceerde DDL. In de planningsmodus kunt u het volgende doen:

  • Valideer het ontwerp voordat u gaat bouwen. Bekijk het voorgestelde schema, wees kritisch op twijfelachtige keuzes en scherp het plan verder aan.
  • Verborgen relaties blootleggen. In de planningsmodus worden koppeltabellen en veel-op-veel-relaties getoond waar u niet expliciet om hebt gevraagd.
  • Scheid specificatie van uitvoering. De PRD blijft productgericht; het plan wordt het technische artefact; de DDL wordt het product.

End-to-endscenario: het schema van TaskManager

In deze quickstart wordt een volledige stroom doorlopen: PRD in natuurlijke taal → plan in Markdown → tabellen die zijn gebouwd in Schema Designer.

Stap 1: Een document met productvereisten maken

Maak requirements.md aan in de hoofdmap van uw werkruimte. Beschrijf de toepassing in natuurlijke taal, waaronder domeinentiteiten, relaties en bedrijfsregels. Houd het document productgericht. Geef geen kolomtypen of beperkingen op (dat is het bestand met aangepaste instructies ).

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

Stap 2: GitHub-Copilot Chat overschakelen naar de planmodus

  1. Open de weergave GitHub Copilot Chat.
  2. Selecteer Plan in de vervolgkeuzelijst voor de chatmodus.

Stap 3: de PRD verzenden naar de planmodus

Voeg requirements.md toe als context, door het bestand naar het chatveld te slepen, #file:requirements.md te gebruiken of de knop Bijvoegen te selecteren.

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 produceert een onderbouwd plan en slaat het op als plan.md in uw werkruimte. Het plan omvat doorgaans:

  • Een lijst met tabellen met hun doel
  • Relaties (één-op-veel, veel-op-veel) en de koppeltabellen die deze mogelijk maken
  • Beperkingen (uniek, checkbeperking, vreemde sleutel) die de bedrijfsregels uit de PRD afdwingen
  • Open vragen of aannames waar het plan van uitgaat

Controleer het plan voordat u doorgaat. Als er een relatie ontbreekt of een restrictie niet klopt, herhaal dit dan door vervolgprompts te sturen in de planmodus. De planmodus is staatloos en goedkoop, dus meerdere afrondingen van verfijning zijn normaal.

Stap 4: Het plan aan agentmodus of SchemaOntwerper geven

Zodra het plan correct is gelezen, schakelt u over naar de agentmodus en bouwt u het schema.

  1. Selecteer Agent in de vervolgkeuzelijst chatmodus.
  2. Verzend een prompt die verwijst naar het planbestand en het doeloppervlak:
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.

De agentmodus opent SchemaOntwerper en maakt elke tabel, waarin u bij elke stap om goedkeuring wordt gevraagd. Uw aangepaste instructies zijn automatisch van toepassing: kolomnamen, auditkolommen, schemakwalificatie en naamgeving van beperkingen volgen allemaal uw conventies.

Tips

  • Koppelen aan aangepaste instructies. Het plan neemt uw conventies automatisch over wanneer u een aangepast instructiesbestand voor **/*.sqlhebt.
  • Houd het PRD productgericht. Vermijd het opgeven van kolomtypen of beperkingen in requirements.md. Laat het plan deze invullen op basis van uw afspraken.
  • Werk iteratief aan het plan, niet aan de DDL. Het is goedkoper om een Markdown-plan te herzien dan tabellen te verwijderen en opnieuw te maken.
  • Sla het plan op in broncodebeheer. Het plan is waardevolle documentatie voor toekomstige inzenders en voor het herzien van ontwerpbeslissingen.
  • Gebruik Mermaid-diagrammen in de PRD. Entiteitsrelatiediagrammen in mermaid helpen de planmodus relaties nauwkeurig te extraheren.

Uw ervaring delen

Om ons te helpen GitHub Copilot voor de MSSQL-extensie te verfijnen en te verbeteren, gebruikt u de volgende GitHub-probleemsjabloon om uw feedback te verzenden: GitHub Copilot-feedback

Overweeg het volgende bij het indienen van feedback:

  • Geteste scenario's: Laat ons weten op welke gebieden u zich richt, bijvoorbeeld het maken van schema's, het genereren van query's, beveiliging, lokalisatie.

  • Wat goed werkte: Beschrijf alle ervaringen die soepel verliepen, behulpzaam waren of uw verwachtingen overtroffen.

  • Problemen of bugs: neem eventuele problemen, inconsistenties of verwarrend gedrag op. Schermafbeeldingen of schermopnamen zijn vooral nuttig.

  • Suggesties voor verbetering: Deel ideeën voor het verbeteren van bruikbaarheid, het uitbreiden van de dekking of het verbeteren van de reacties van GitHub Copilot.

Verwante inhoud

  • Last updated on