Используйте инструкции по работе с базой данных с GitHub Copilot в SQL Server Management Studio (предварительная версия)

Инструкции по базе данных предоставляют GitHub Copilot в SQL Server Management Studio (SSMS) контекст и рекомендации, относящиеся к конкретной базе данных, которые содержатся непосредственно в базе данных. Владельцы баз данных и команды могут использовать их для описания бизнес-правил, соглашений о данных и шаблонов использования. С помощью инструкций по базе данных Copilot может создавать более точные, значимые и согласованные ответы, когда пользователи задают вопросы или записывают запросы. Инструкции по базам данных действуют в качестве живой документации, которая перемещается с базой данных и автоматически применяется во время взаимодействия Copilot.

В этой статье вы узнаете, как использовать инструкции по базе данных, которые позволяют пользователям и Copilot быстрее находить правильные объекты и информацию. Эта функция помогает сократить время, затрачиваемое на предоставление базы данных, бизнеса и внутренних знаний в Copilot.

Дополнительные сведения о чате GitHub Copilot см. в статье "Использование интерфейса чата GitHub Copilot в SQL Server Management Studio (предварительная версия)".

Как работают инструкции по базе данных

Инструкции по базе данных хранятся в виде метаданных в базе данных, что позволяет Copilot автоматически обнаруживать и применять их во время выполнения. Когда пользователь взаимодействует с GitHub Copilot для базы данных, например задавать вопрос на естественном языке или создавать T-SQL, Copilot включает эти инструкции в качестве дополнительного контекста. Этот контекст гарантирует, что ответы отражают бизнес-определения, канонические таблицы и правила конкретного домена, а не полагаться только на имена схем или угадывание. Инструкции сохраняются в сеансах и доступны любому пользователю, который обращается к той же базе данных.

Предпосылки

Инструкции для базы данных для GitHub Copilot в среде SSMS используют информацию из расширенных свойств.

1. Установите SSMS 22.3 или более позднюю версию с рабочей нагрузкой AI Assistance.

2. Войдите в учетную запись GitHub с помощью доступа Copilot.

Бесплатно используйте GitHub Copilot. Зарегистрируйте и используйте ИИ для более быстрого и эффективного написания кода.

Добавление или просмотр инструкций по базе данных с помощью GitHub Copilot

В этих шагах показано, как создать и использовать инструкции по базе данных с помощью GitHub Copilot.

Задайте Copilot вопрос, чтобы раскрыть отсутствующий контекст

Начните с того, чтобы задать Copilot вопрос о ваших данных в естественном языке. Например, What was revenue for the last quarter of the year? если бизнес имеет разные даты начала финансового года и календарного года, или если доход требует вычисления, включающего несколько таблиц, соответствующие таблицы или столбцы являются хорошими кандидатами для инструкции базы данных.

Определение бизнес-правила в качестве инструкции базы данных

В чате Copilot опишите правило или уточнение, которое нужно помнить Copilot. Например: Add an instruction for the Finance.CompanyRevenue table to state that revenue is defined as SUM(NetAmount) excluding refunds recorded in Finance.Refunds.

Сохранение инструкции в базе данных

После создания синтаксиса T-SQL Copilot для добавления инструкции в качестве расширенного свойства необходимо сохранить эти сведения в качестве инструкции базы данных. В режиме ask GitHub Copilot не может выполнять запросы на изменение базы данных.

-- 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';

После добавления инструкции в базу данных Copilot автоматически применяет сведения к будущим взаимодействиям.

Использование Copilot с применением инструкции

Спросите Copilot тот же или связанный вопрос снова, What was revenue for the last quarter of the year? Copilot теперь использует сохраненную инструкцию, чтобы создать результаты, которые соответствуют вашему бизнес-определению доходов, не требуя повторения правила. Вы также можете попросить Copilot Show me the query used to get this information., чтобы Copilot подтвердил свое понимание инструкции.

Дополнительные примеры

Существуют бесконечные сценарии, в которых бизнес-правила должны применяться для объекта базы данных, включая таблицы, столбцы и хранимые процедуры.

• 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

При использовании инструкций базы данных с Copilot вы также можете узнать об инструкциях, которые уже существуют.

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

Создание конституции базы данных с помощью GitHub Copilot

GitHub Copilot в SSMS также поддерживает единую конституцию для базы данных, которая задает наивысший приоритет для базы данных. Конституция может включать рекомендации, рекомендации по программированию, политики хранения и многое другое.

Замечание

Реализация структуры базы данных применяется к взаимодействиям GitHub Copilot для каждого пользователя, использующего GitHub Copilot в SSMS. Рекомендации и руководящие принципы применяются только к беседам 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.';

Требования

Инструкции по базе данных в настоящее время поддерживаются только в качестве расширенных свойств. Они соответствуют формату AGENTS.md , чтобы предоставить контекст, используемый GitHub Copilot. Имя расширенного свойства объекта должно быть AGENTS.md. Для объекта может существовать только одно свойство с именем AGENTS.md . Если инструкция неправильная, ее можно обновить с помощью sp_updateextendedpropertyили удалить с помощью sp_dropextendedproperty. Для работы инструкций по базе данных не требуется другая конфигурация.

Связанный контент

• Начните работать с GitHub Copilot в SQL Server Management Studio (предварительный просмотр)
• Устранение неполадок с GitHub Copilot в SQL Server Management Studio (предварительная версия)