Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las instrucciones de base de datos proporcionan a GitHub Copilot en SQL Server Management Studio (SSMS) contexto específico de la base de datos y orientación que reside directamente en la base de datos. Los propietarios y equipos de bases de datos pueden usarlos para describir reglas de negocios, convenciones de datos y patrones de uso. Con las instrucciones de la base de datos, Copilot puede generar respuestas más precisas, significativas y coherentes cuando los usuarios hacen preguntas o escriben consultas. Las instrucciones de base de datos actúan como documentación activa que viaja con la base de datos y se aplican automáticamente durante las interacciones de Copilot.
En este artículo, aprenderá a usar instrucciones de base de datos, que permiten a los usuarios y Copilot encontrar los objetos y la información correctos más rápido. Esta característica ayuda a reducir el tiempo dedicado a proporcionar la base de datos, el negocio y el conocimiento interno a Copilot.
Para obtener información relacionada sobre el chat de Copilot de GitHub, consulte Uso de la experiencia de chat de Copilot de GitHub en SQL Server Management Studio (versión preliminar).
Funcionamiento de las instrucciones de base de datos
Las instrucciones de base de datos se almacenan como metadatos en la base de datos, lo que permite a Copilot detectarlos y aplicarlos automáticamente en tiempo de ejecución. Cuando un usuario interactúa con GitHub Copilot para una base de datos, como hacer una pregunta en lenguaje natural o generar T-SQL, Copilot incorpora estas instrucciones como contexto adicional. Este contexto garantiza que las respuestas reflejen las definiciones de negocio, las tablas canónicas y las reglas específicas del dominio, en lugar de confiar solo en nombres de esquema o suposiciones. Las instrucciones se conservan entre sesiones y están disponibles para cualquier usuario que acceda a la misma base de datos.
Prerrequisitos
Las instrucciones de base de datos de GitHub Copilot en SSMS dependen de la información de las propiedades extendidas.
Instale SSMS 22.3 o una versión posterior con la carga de trabajo AI Assistance.
Inicie sesión en su cuenta de GitHub con acceso a Copilot.
Use GitHub Copilot de forma gratuita. Regístrese y use la inteligencia artificial para codificar de forma más rápida y eficaz.
Uso de GitHub Copilot para agregar o ver instrucciones de base de datos
Estos pasos muestran cómo crear y usar instrucciones de base de datos mediante GitHub Copilot.
Pregunte a Copilot una pregunta para revelar el contexto que falta
Empiece por hacer a Copilot una pregunta sobre sus datos en lenguaje natural. Por ejemplo, What was revenue for the last quarter of the year? si la empresa tiene fechas de inicio diferentes para el año fiscal y el año natural, o si los ingresos requieren un cálculo que implique varias tablas, las tablas o columnas pertinentes son buenos candidatos para una instrucción de base de datos.
Definición de la regla de negocios como una instrucción de base de datos
En el chat de Copilot, describa la regla o aclaración que desea que Copilot recuerde. Por ejemplo: Add an instruction for the Finance.CompanyRevenue table to state that revenue is defined as SUM(NetAmount) excluding refunds recorded in Finance.Refunds.
Guardar la instrucción en la base de datos
Una vez que Copilot genera la sintaxis de T-SQL para agregar la instrucción como una propiedad extendida, debe conservar esta información como una instrucción de base de datos. En el modo Ask, GitHub Copilot no puede ejecutar consultas de modificación en la base de datos.
-- 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';
Después de agregar la instrucción a la base de datos, Copilot aplica automáticamente la información a futuras interacciones.
Utiliza Copilot con la instrucción aplicada
Pregunte a Copilot de nuevo la misma pregunta o una pregunta relacionada, What was revenue for the last quarter of the year? Copilot ahora usa la instrucción guardada para generar resultados que se alinean con la definición empresarial de los ingresos, sin necesidad de volver a establecer la regla. También puede pedir a Copilot Show me the query used to get this information. que confirme la comprensión de la instrucción por parte de Copilot.
Más ejemplos
Hay escenarios infinitos en los que es necesario aplicar reglas de negocio para un objeto de base de datos, incluidas tablas, columnas y procedimientos almacenados.
The dbo.Apts table stores information about patient appointmentsThe Status column in dbo.Apts encodes status as: 1 = Scheduled, 2 = Completed, 5 = Confirmed, 99 = CancelledThe DtCrtd column in dbo.Apts lists the date and time the appointment was created
Al usar instrucciones de base de datos con Copilot, también puede consultar las instrucciones que existen actualmente.
Show me the database instructions for this databaseDoes this database have a constitution set?
Uso de GitHub Copilot para crear una constitución de base de datos
GitHub Copilot en SSMS también admite una configuración única para la base de datos, que establece la instrucción con la mayor precedencia para la base de datos. La constitución puede incluir recomendaciones, directrices de codificación, directivas de retención y mucho más.
Nota:
La implementación de una constitución de base de datos se aplica a las conversaciones de GitHub Copilot para cada usuario que use GitHub Copilot en SSMS. Las recomendaciones y directrices solo se aplican a las conversaciones de 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.';
Requisitos
Actualmente, las instrucciones de base de datos solo se admiten como propiedades extendidas. Siguen el formato AGENTS.md para proporcionar el contexto usado por GitHub Copilot. El nombre de la propiedad extendida del objeto debe ser AGENTS.md. Solo puede existir una propiedad denominada AGENTS.md para un objeto . Si una instrucción es incorrecta, puede actualizarla mediante sp_updateextendedpropertyo eliminarla mediante sp_dropextendedproperty. No hay ninguna otra configuración necesaria para que funcionen las instrucciones de base de datos.