Utiliser des instructions de base de données avec GitHub Copilot dans SQL Server Management Studio (préversion)

Les instructions de base de données fournissent GitHub Copilot dans SQL Server Management Studio (SSMS) avec un contexte et des conseils spécifiques à la base de données qui se trouvent directement dans la base de données. Les propriétaires et les équipes de base de données peuvent les utiliser pour décrire les règles d’entreprise, les conventions de données et les modèles d’utilisation. Avec des instructions de base de données, Copilot peut générer des réponses plus précises, significatives et cohérentes lorsque les utilisateurs posent des questions ou écrivent des requêtes. Les instructions de base de données agissent en tant que documentation vivante qui se déplace avec la base de données et sont appliquées automatiquement pendant les interactions Copilot.

Dans cet article, vous allez apprendre à utiliser des instructions de base de données, ce qui permet aux utilisateurs et à Copilot de trouver les objets et les informations appropriés plus rapidement. Cette fonctionnalité permet de réduire le temps passé à fournir une base de données, une entreprise et des connaissances internes à Copilot.

Pour plus d’informations sur GitHub Copilot Chat, consultez Utiliser l’expérience GitHub Copilot Chat dans SQL Server Management Studio (préversion).

Fonctionnement des instructions de base de données

Les instructions de base de données sont stockées sous forme de métadonnées dans la base de données, ce qui permet à Copilot de les détecter et de les appliquer automatiquement lors de l’exécution. Lorsqu’un utilisateur interagit avec GitHub Copilot pour une base de données, par exemple en posant une question en langage naturel ou en générant T-SQL, Copilot incorpore ces instructions en tant que contexte supplémentaire. Ce contexte garantit que les réponses reflètent les définitions métier, les tables canoniques et les règles spécifiques au domaine, plutôt que de s’appuyer uniquement sur des noms de schéma ou des estimations. Les instructions persistent dans les sessions et sont disponibles pour tous les utilisateurs qui accèdent à la même base de données.

Prerequisites

Les instructions de base de données pour GitHub Copilot dans SSMS s’appuient sur des informations dans les propriétés étendues.

1. Installez SSMS 22.3 ou une version ultérieure avec la charge de travail d’assistance IA.

2. Connectez-vous à votre compte GitHub avec l’accès Copilot.

Utilisez GitHub Copilot gratuitement. Inscrivez-vous et utilisez l’IA pour coder plus rapidement et plus efficacement.

Utiliser GitHub Copilot pour ajouter ou afficher des instructions de base de données

Ces étapes montrent comment créer et utiliser des instructions de base de données à l’aide de GitHub Copilot.

Poser une question à Copilot pour révéler le contexte manquant

Commencez par poser une question à Copilot sur vos données en langage naturel. Par exemple, What was revenue for the last quarter of the year? si l’entreprise a des dates de début différentes pour l’année fiscale et l’année civile, ou si le chiffre d’affaires nécessite un calcul impliquant plusieurs tables, les tables ou colonnes pertinentes sont de bons candidats pour une instruction de base de données.

Définir la règle métier en tant qu’instruction de base de données

Dans la conversation Copilot, décrivez la règle ou la clarification que vous souhaitez que Copilot mémorise. Par exemple, Add an instruction for the Finance.CompanyRevenue table to state that revenue is defined as SUM(NetAmount) excluding refunds recorded in Finance.Refunds.

Enregistrer l’instruction dans la base de données

Une fois Que Copilot génère la syntaxe T-SQL pour ajouter l’instruction en tant que propriété étendue, vous devez conserver ces informations en tant qu’instruction de base de données. En mode Demander, GitHub Copilot ne peut pas exécuter de requêtes de modification sur la base de données.

-- Created by GitHub Copilot in SSMS - review carefully before executing
EXECUTE sp_addextendedproperty
    @name = N'AGENTS.md',
    @value = N'Revenue is defined as SUM(NetAmount) excluding refunds recorded in Finance.Refunds. When calculating actual revenue, refunds must be subtracted from the Revenue column values.',
    @level0type = N'SCHEMA',
    @level0name = N'Finance',
    @level1type = N'TABLE',
    @level1name = N'CompanyRevenue';

Après avoir ajouté l’instruction à la base de données, Copilot applique automatiquement les informations aux futures interactions.

Utiliser Copilot avec l’instruction appliquée

Demandez à Copilot la même question ou une question connexe, What was revenue for the last quarter of the year? Copilot utilise maintenant l’instruction enregistrée pour générer des résultats qui s’alignent sur la définition de votre entreprise de revenus, sans vous obliger à refaire la règle. Vous pouvez également demander à Copilot de confirmer comment Copilot Show me the query used to get this information. comprend l’instruction.

Autres exemples

Il existe des scénarios infinis où les règles métier doivent être appliquées pour un objet de base de données, notamment des tables, des colonnes et des procédures stockées.

• The dbo.Apts table stores information about patient appointments
• The Status column in dbo.Apts encodes status as: 1 = Scheduled, 2 = Completed, 5 = Confirmed, 99 = Cancelled
• The DtCrtd column in dbo.Apts lists the date and time the appointment was created

Lorsque vous utilisez des instructions de base de données avec Copilot, vous pouvez également demander des informations sur les instructions actuellement existantes.

• Show me the database instructions for this database
• Does this database have a constitution set?

Utiliser GitHub Copilot pour créer une constitution de base de données

GitHub Copilot dans SSMS prend également en charge une constitution singulière pour votre base de données, qui définit l’instruction de priorité la plus élevée pour la base de données. La constitution peut inclure des recommandations, des directives de codage, des politiques de rétention, etc.

Note

L’implémentation d’une constitution de base de données s’applique aux conversations GitHub Copilot pour chaque utilisateur qui utilise GitHub Copilot dans SSMS. Les recommandations et lignes directrices s’appliquent uniquement aux conversations GitHub Copilot.

EXECUTE sp_addextendedproperty
    @name = N'CONSTITUTION.md',
    @value = N'Any T-SQL in this database must comply with the organizational standards and guidelines outlined in this constitution document.
 Queries that use SELECT * should not be used.';

Spécifications

Les instructions de base de données sont actuellement uniquement prises en charge en tant que propriétés étendues. Ils suivent le format AGENTS.md pour fournir le contexte utilisé par GitHub Copilot. Le nom de la propriété étendue de l’objet doit être AGENTS.md. Une seule propriété nommée AGENTS.md peut exister pour un objet. Si une instruction est incorrecte, vous pouvez la mettre à jour à l’aide sp_updateextendedproperty, ou la supprimer à l’aide sp_dropextendedpropertyde . Aucune autre configuration n’est requise pour que les instructions de base de données fonctionnent.

Contenu connexe

• Prise en main de GitHub Copilot dans SQL Server Management Studio (préversion)
• Résoudre les problèmes liés à GitHub Copilot dans SQL Server Management Studio (préversion)