Gunakan instruksi database dengan GitHub Copilot di SQL Server Management Studio (Pratinjau)

Petunjuk database menyediakan GitHub Copilot di SQL Server Management Studio (SSMS) dengan konteks dan panduan khusus yang langsung berada di dalam database. Pemilik dan tim database dapat menggunakannya untuk menjelaskan aturan bisnis, konvensi data, dan pola penggunaan. Dengan instruksi database, Copilot dapat menghasilkan respons yang lebih akurat, bermakna, dan konsisten saat pengguna mengajukan pertanyaan atau menulis kueri. Instruksi database bertindak sebagai dokumentasi dinamis yang menyertai database dan diterapkan secara otomatis selama interaksi dengan Copilot.

Dalam artikel ini, Anda mempelajari cara menggunakan instruksi database, yang selanjutnya memberdayakan pengguna dan Copilot untuk menemukan objek dan informasi yang benar lebih cepat. Fitur ini membantu mengurangi waktu yang dihabiskan untuk menyediakan database, bisnis, dan pengetahuan internal untuk Copilot.

Untuk informasi terkait tentang GitHub Copilot Chat, lihat Menggunakan pengalaman GitHub Copilot Chat di SQL Server Management Studio (Pratinjau).

Cara kerja instruksi database

Instruksi database disimpan sebagai metadata dalam database, yang memungkinkan Copilot untuk secara otomatis menemukan dan menerapkannya saat runtime. Saat pengguna berinteraksi dengan GitHub Copilot untuk database, seperti mengajukan pertanyaan dalam bahasa alami atau menghasilkan T-SQL, Copilot menggabungkan instruksi ini sebagai konteks tambahan. Konteks ini memastikan respons mencerminkan definisi bisnis, tabel kanonis, dan aturan khusus domain, daripada hanya mengandalkan nama skema atau tebakan. Instruksi berlanjut di seluruh sesi dan tersedia untuk setiap pengguna yang mengakses database yang sama.

Prasyarat

Instruksi database untuk GitHub Copilot di SSMS mengandalkan informasi di properti yang diperluas.

1. Instal SSMS 22.3 atau versi yang lebih baru dengan beban kerja Bantuan AI.

2. Masuk ke akun GitHub Anda dengan akses Copilot.

Gunakan GitHub Copilot secara gratis. Daftar dan gunakan AI untuk mengodekan lebih cepat dan lebih efisien.

Menggunakan GitHub Copilot untuk menambahkan atau melihat instruksi database

Langkah-langkah ini menunjukkan cara membuat dan menggunakan instruksi database menggunakan GitHub Copilot.

Ajukan pertanyaan Kepada Copilot untuk mengungkapkan konteks yang hilang

Mulailah dengan mengajukan pertanyaan kepada Copilot tentang data Anda dalam bahasa alami. Misalnya, What was revenue for the last quarter of the year? Jika bisnis memiliki tanggal mulai yang berbeda untuk tahun fiskal dan tahun kalender, atau jika pendapatan memerlukan perhitungan yang melibatkan beberapa tabel, tabel atau kolom yang relevan adalah kandidat yang baik untuk instruksi database.

Menentukan aturan bisnis sebagai instruksi database

Di obrolan Copilot, jelaskan aturan atau klarifikasi yang ingin diingat oleh Copilot. Misalnya: Add an instruction for the Finance.CompanyRevenue table to state that revenue is defined as SUM(NetAmount) excluding refunds recorded in Finance.Refunds.

Menyimpan instruksi ke database

Setelah Copilot menghasilkan sintaks T-SQL untuk menambahkan instruksi sebagai properti yang diperluas, Anda harus mempertahankan informasi ini sebagai instruksi database. Dalam mode Tanyakan, GitHub Copilot tidak dapat menjalankan kueri modifikasi terhadap database.

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

Setelah Anda menambahkan instruksi ke database, Copilot secara otomatis menerapkan informasi ke interaksi di masa mendatang.

Gunakan Copilot dengan instruksi yang telah diterapkan

Ajukan Copilot pertanyaan yang sama atau terkait lagi, What was revenue for the last quarter of the year? Copilot sekarang menggunakan instruksi yang disimpan untuk menghasilkan hasil yang selaras dengan definisi pendapatan bisnis Anda, tanpa mengharuskan Anda untuk memulihkan aturan. Anda juga dapat meminta Copilot Show me the query used to get this information. untuk mengonfirmasi pemahaman Copilot tentang instruksi.

Contoh lainnya

Ada skenario tak terbatas di mana aturan bisnis perlu diterapkan untuk objek database termasuk tabel, kolom, dan prosedur tersimpan.

• 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

Saat menggunakan instruksi database dengan Copilot, Anda juga dapat bertanya tentang instruksi yang saat ini ada.

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

Menggunakan GitHub Copilot untuk membuat struktur basis data

GitHub Copilot di SQL Server Management Studio juga mendukung konfigurasi unik untuk database Anda, yang menetapkan perintah dengan prioritas tertinggi untuk database. Konstitusi dapat mencakup rekomendasi, pedoman pengkodian, kebijakan penyimpanan, dan banyak lagi.

Nota

Menerapkan konstitusi database berlaku untuk percakapan GitHub Copilot untuk setiap pengguna yang menggunakan GitHub Copilot di SSMS. Rekomendasi dan panduan hanya berlaku untuk percakapan 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.';

Persyaratan

Instruksi database saat ini hanya didukung sebagai properti yang diperluas. Mereka mengikuti format AGENTS.md untuk menyediakan konteks yang digunakan oleh GitHub Copilot. Nama properti objek yang diperluas harus AGENTS.md. Hanya satu properti bernama AGENTS.md yang dapat ada untuk objek. Jika instruksi salah, Anda dapat memperbaruinya menggunakan sp_updateextendedproperty, atau menghapusnya menggunakan sp_dropextendedproperty. Tidak ada konfigurasi lain yang diperlukan agar instruksi database berfungsi.

Konten terkait

• Mulai menggunakan GitHub Copilot di SQL Server Management Studio (Pratinjau)
• Pemecahan Masalah GitHub Copilot di SQL Server Management Studio (Pratinjau)