Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Mode agen memungkinkan GitHub Copilot mengatur alat yang dikontribusikan oleh ekstensi MSSQL untuk Visual Studio Code. Ketika ekstensi diinstal dan aktif, GitHub Copilot dapat mencantumkan koneksi Microsoft SQL Server, terhubung ke server dan database, mengambil metadata skema, menjalankan kueri, dan menyelidiki kinerja Query Store, semuanya dari prompt bahasa alami. Persyaratan persetujuan tergantung pada alatnya.
Semua tindakan menggunakan konteks koneksi dan kredensial yang sama dengan ekstensi MSSQL. Mode agen tidak memperkenalkan autentikasi atau perubahan izin lain.
Tip
Gunakan mode agen untuk alur kerja multi-langkah, eksplorasi dalam skala besar, dan perubahan yang didelegasikan. Gunakan mode pertanyaan saat Anda memerlukan satu jawaban atau kueri sekali jalan. Gunakan mode rencana saat Anda perlu mempertimbangkan desain sebelum menulis bahasa definisi data (DDL) Transact-SQL (T-SQL).
Kesimpulan utama
- Mode agen mengambil alat ekstensi MSSQL secara otomatis. Tidak perlu
@mssqlmenyebutkan. - Tinjau dan setujui panggilan alat saat diminta. Pembacaan diagnostik Query Store tidak meminta konfirmasi; memaksa atau melepas rencana memerlukan tinjauan dan konfirmasi.
- Mode agen memahami skema melalui alat-alatnya: setiap pemanggilan alat mengembalikan data aktual dari basis data Anda yang terhubung.
- Untuk konteks arsitektur di semua permukaan, lihat Cara GitHub Copilot bekerja dengan ekstensi MSSQL.
Kapan menggunakan mode agen
Mode agen adalah yang terbaik untuk:
- Alur kerja multi-langkah. "Sambungkan ke LocalDev, beralihlah ke AdventureWorks, lalu tunjukkan kepada saya setiap tabel dengan kunci asing kepada Pelanggan."
- Eksplorasi dalam skala besar. "Temukan prosedur tersimpan yang mereferensikan SalesOrderHeader dan ringkas apa yang dilakukan masing-masing."
- Investigasi kinerja. "Gunakan Query Store untuk menemukan kueri CPU tertinggi dalam 24 jam terakhir, lalu analisis riwayat, tungguan, dan rencana kueri teratas."
- Perubahan yang didelegasikan. "Tambahkan kolom audit ke setiap tabel dalam skema Penjualan dan regenerasi prosedur tersimpan terkait."
Gunakan mode tanya jika satu pertanyaan atau kueri sekali kirim sudah memenuhi kebutuhan Anda. Gunakan perintah garis miring saat Anda sudah mengetahui tindakan mana yang Anda inginkan. Gunakan mode rencana saat Anda menginginkan rencana tertulis sebelum melakukan perubahan apa pun.
Untuk detail tentang cara mode agen memilih dan menjalankan alat, lihat dokumentasi Visual Studio Code tentang mode agen.
Apa itu mode agen?
Mode agen memungkinkan GitHub Copilot melakukan aksi terkait SQL dengan menggunakan ekstensi MSSQL. Alat yang memerlukan konfirmasi akan menampilkan tindakan yang diminta untuk tinjauan Anda sebelum dieksekusi.
Anda dapat memanggil tindakan ini dengan menggunakan variabel obrolan seperti #mssql_connect, atau dengan mengeluarkan permintaan bahasa alami yang setara, misalnya:
Connect to my Library database using my LocalDev profile
Referensi alat Mode Agen MSSQL
Bagian ini menyediakan referensi terperinci untuk alat khusus SQL yang tersedia dalam GitHub Copilot Agent Mode. Ekstensi MSSQL berkontribusi pada alat-alat ini, memungkinkan GitHub Copilot untuk menjalankan tindakan melalui variabel obrolan atau perintah bahasa alami. Alat diagnostik Query Store membaca data kinerja yang ditangkap tanpa meminta konfirmasi. Tinjau dan setujui tindakan lain saat diminta.
Tip
Anda juga dapat menggunakan variabel obrolan seperti #mssql_connect memanggil alat-alat ini secara langsung, atau menulis perintah dalam bahasa alami seperti:
Connect to my development database
GitHub Copilot menangani pemilihan alat secara otomatis.
Manajemen koneksi
| Nama alat | Description |
|---|---|
connect |
Menyambungkan ke database dengan menggunakan profil koneksi tersimpan atau server dan database tertentu. |
disconnect |
Mengakhiri sesi koneksi aktif saat ini. |
change_database |
Mengubah database untuk sesi koneksi yang sudah ada. |
get_connection_details |
Mendapatkan detail koneksi untuk koneksi MSSQL tertentu. |
list_servers |
Mencantumkan semua profil koneksi SQL Server yang disimpan di lingkungan Anda. |
list_databases |
Mencantumkan semua database yang tersedia untuk server MSSQL yang tersambung. |
Examples
Gunakan frasa berikut untuk berinteraksi dengan GitHub Copilot.
- Connect to my LocalDev environment
- Disconnect from my current database
- List my available connection profiles
- List all databases in the localhost server
- Set the active connection to localhost
- Set AdventureWorks as the active database
- Get the connection string for AdventureWorks on localhost
Cara kerja logika koneksi
Mode Agen Copilot GitHub mendukung cara fleksibel untuk menyambungkan ke database SQL Anda, baik dengan mereferensikan profil yang disimpan atau dengan menentukan server dan database secara langsung. Berikut cara kerja logika koneksi.
Saat Anda tersambung dengan profil tersimpan:
- Anda tersambung dengan merujuk nama profil koneksi yang disimpan.
- GitHub Copilot menggunakan
mssql_list_serversalat untuk memverifikasi bahwa profil ada. -
mssql_connectkemudian menggunakanprofileIdyang telah disimpan dan parameternya untuk membuat koneksi.
Saat Anda menyambungkan dengan menentukan server dan database:
Jika profil tersimpan cocok dengan server dan database yang ditentukan:
- GitHub Copilot menggunakan
mssql_list_serversuntuk menemukan kecocokan. - Kemudian memanggil
mssql_connectmenggunakan profil lengkap.
- GitHub Copilot menggunakan
Apabila profil yang tersimpan hanya cocok dengan server:
- GitHub Copilot menemukan profil server yang cocok.
- Ini mencoba menyambungkan dengan mengganti database yang diminta pengguna ke dalam profil tersebut.
- Jika koneksi gagal, kesalahan akan ditampilkan.
Jika tidak ada profil yang cocok dengan server yang ditentukan:
- GitHub Copilot melaporkan kesalahan.
Sistem pencocokan fleksibel ini memungkinkan GitHub Copilot menangani berbagai skenario koneksi. Ini meminimalkan upaya pengguna sambil memastikan tindakan yang aman dan dapat dikonfirmasi.
Eksplorasi skema
| Nama alat | Description |
|---|---|
show_schema |
Menampilkan diagram tingkat tinggi dari skema database tersambung Anda, termasuk tabel dan hubungan. |
list_schemas |
Mencantumkan semua skema dalam database untuk server MSSQL yang tersambung. |
list_tables |
Mencantumkan semua tabel dalam database untuk server MSSQL yang tersambung. |
list_views |
Mencantumkan semua tampilan dalam database untuk server MSSQL yang tersambung. |
list_functions |
Mencantumkan semua fungsi dalam database untuk server MSSQL yang tersambung. |
Examples
Gunakan frasa berikut untuk berinteraksi dengan GitHub Copilot.
- Show me the schema for this database
- Show me all tables in the current database
- List all views from this MSSQL database
- Give me a list of all the functions available in this schema
- What schemas are available in this database?
Eksekusi kueri
| Nama alat | Description |
|---|---|
run_query |
Menjalankan kueri SQL terhadap database yang tersambung. |
Examples
Gunakan frasa berikut untuk berinteraksi dengan GitHub Copilot.
- Give me the top five posts published this week
- Execute the current file to find how many comments each post has
- Get all categories along with the number of posts in each
Alat performa Query Store (pratinjau)
Gunakan alat-alat ini untuk menyelidiki kinerja query yang ditangkap daripada membangun SQL diagnostik secara manual. Mereka memerlukan database yang mendukung Query Store, data yang ditangkap untuk periode yang Anda minta, dan izin untuk membaca data tersebut. Anda dapat mengidentifikasi target melalui koneksi yang sudah ada atau profil koneksi yang disimpan dan nama database.
| Nama alat | Description |
|---|---|
mssql_query_store_status |
Membaca status Query Store, alasan hanya-baca, dan riwayat yang tersedia. |
mssql_query_store_top_queries |
Menemukan kueri yang diurutkan berdasarkan metrik sumber daya atau jumlah eksekusi dalam jendela waktu. |
mssql_query_store_query_details |
Membaca teks satu kueri, statistik runtime, dan plan eksekusi beserta statistiknya. |
mssql_query_store_query_history |
Membaca kinerja kueri dari waktu ke waktu, termasuk statistik untuk rencana yang berjalan di setiap interval. |
mssql_query_store_wait_stats |
Membaca waktu tunggu berdasarkan kategori untuk database, query, atau rencana. Memerlukan dukungan dan perekaman statistik tunggu Query Store. |
mssql_query_store_plan_summary |
Merangkum informasi pernyataan rencana tersimpan, peringatan, rekomendasi indeks hilang, dan operator yang mahal. |
mssql_query_store_analyze_query |
Menggabungkan detail query, rencana, riwayat eksekusi, waktu tunggu, dan ringkasan rencana utama dalam satu panggilan diagnostik. |
mssql_open_performance_dashboard |
Membuka Dasbor Kinerja Kueri untuk sebuah basis data, atau pada kueri dan tab tertentu yang spesifik. |
mssql_query_store_plan_forcing |
Memaksa atau membatalkan paksa pada rencana kueri setelah Anda meninjau dan mengonfirmasi SQL yang dihasilkan. |
mssql_query_store_verify_forced_plan |
Memeriksa apakah eksekusi setelah rencana dipaksakan menggunakan rencana tersebut. |
Untuk memulai investigasi, identifikasi database dan periode dalam prompt Anda:
Use Query Store to find the queries with the highest total CPU time in AdventureWorksLT in the past 24 hours. Analyze the top query, explain its execution history and waits, and open it in the performance dashboard. Don't make changes.
Ganti contoh nama database dengan database Anda. Anda juga dapat merujuk alat secara eksplisit, seperti #mssql_query_store_analyze_query, ketika Anda sudah mengetahui ID kueri dan basis data target.
Aksi Chat di dashboard membuka mode agen dan mengirimkan prompt yang secara eksplisit mereferensikan #mssql_query_store_analyze_query dan menyediakan server, database, ID profil yang tersimpan, ID kueri, dan rentang waktu dari query yang dipilih. Untuk panduan dan petunjuk tindak lanjut, lihat Investigate Query Store performance.
Important
Pembacaan diagnostik tidak memodifikasi database atau memerlukan konfirmasi. Memaksa atau melepas rencana adalah perubahan terpisah: alat ini menampilkan SQL yang tepat dan peringatan untuk ditinjau dan dikonfirmasi. Memverifikasi rencana yang dipaksakan bersifat hanya-baca. Diagnosa masalahnya dan tinjau bukti sebelum meminta perubahan rencana.
Pengaturan retensi dan penangkapan Query Store menentukan data yang tersedia. Jika Query Store dimatikan atau periode yang diminta tidak memiliki data yang tertangkap, alat tidak dapat memberikan diagnosis kinerja untuk periode tersebut. Untuk detail pengaturan, lihat prasyarat Dasbor Kinerja Query.
Cara alat dikelola dalam Mode Agen
GitHub Copilot dapat menggunakan alat khusus MSSQL dan alat berkontribusi ekstensi lainnya saat memproses permintaan Anda. Anda dapat melihat alat-alat ini di antarmuka Mode Agen di bawah menu Alat , di mana Anda juga dapat mengaktifkan atau menonaktifkan alat tertentu.
Ketika sebuah alat memerlukan konfirmasi, GitHub Copilot meminta Anda untuk meninjau tindakan yang diminta sebelum dijalankan. Anda dapat mengizinkan alat hanya untuk sesi saat ini, ruang kerja, atau secara permanen. Pembacaan diagnostik Query Store tidak meminta konfirmasi; pemaksaan dan pembatalan pemaksaan rencana memintanya.
Untuk informasi selengkapnya tentang visibilitas dan persetujuan alat, lihat Mengelola persetujuan alat.
Alur kerja konfirmasi Mode Agen
Untuk alat yang memerlukan konfirmasi, GitHub Copilot menampilkan detail tentang tindakan yang diminta. Tinjau permintaan sebelum memilih opsi persetujuan:
- Izinkan dalam sesi ini
- Izinkan di ruang kerja ini
- Selalu izinkan
Langkah konfirmasi ini membantu memastikan interaksi yang aman dan disengaja dengan lingkungan pengembangan Anda.
Note
Untuk informasi selengkapnya tentang cara kerja konfirmasi di semua alat dalam Mode Agen, lihat dokumentasi Visual Studio Code tentang persetujuan alat.
Katalog prompt mode agen
Gunakan perintah bahasa alami ini untuk memanggil alat ekstensi MSSQL melalui mode agen. Untuk setiap kategori, perintah garis miring yang setara atau permintaan mode tanya dirujuk silang.
Manajemen koneksi
Connect to my LocalDev profile and set AdventureWorks as the active database.
List all my saved connection profiles and tell me which one I'm currently connected to.
Disconnect from my current database.
Perintah garis miring yang setara: /connect, /listServers, /changeDatabase, /disconnect.
Eksplorasi skema
Show me every table in the SalesLT schema, grouped by whether they're
referenced by a foreign key from another table.
Find all stored procedures that reference SalesLT.SalesOrderHeader and
summarize what each one does in one sentence.
Which tables in the current database have no primary key?
Permintaan yang setara: lihat Mengobrol dengan @mssql peserta.
Eksekusi kueri
Run a query to count the number of active customers in SalesLT.Customer,
then show me the top 10 by order total.
Show me the execution plan for this query: SELECT ... FROM ...
Execute the last query I ran against my Dev database instead.
Alur kerja multi-langkah
Connect to LocalDev, switch to AdventureWorks, list all tables with a
foreign key to SalesLT.Customer, and save the list to a file called
customer-dependents.md.
Find every stored procedure that uses dynamic SQL and open each one
in a new editor tab so I can review them.
Perubahan skema yang didelegasikan
Note
Perubahan skema cocok untuk dijalankan dalam mode perencanaan terlebih dahulu. Rencanakan perubahan, tinjau perubahan tersebut, lalu serahkan rencana itu ke mode agen untuk dieksekusi.
Add createdAt and updatedAt audit columns to every table in the Sales
schema that doesn't already have them. Use DATETIME2(7) with a default
of GETUTCDATE().
Regenerate every stored procedure that inserts into SalesLT.Customer
to include the new email column.
Konten terkait
- Cara kerja GitHub Copilot dengan ekstensi MSSQL
- Dasbor Kinerja Query (pratinjau)
-
Quickstart: Ngobrol dengan
@mssqlpeserta (mode tanya) - Quickstart: Gunakan mode rencana untuk desain basis data berbasis spesifikasi
- Quickstart: Gunakan perintah garis miring GitHub Copilot
- Quickstart: Gunakan instruksi khusus untuk menyelaraskan GitHub Copilot dengan konvensi T-SQL Anda
- Mulai cepat: Buat kode
- Quickstart: Rancang skema secara visual dengan skenario GitHub Copilot tertanam
- Quickstart: Gunakan smart query builder
- Quickstart: Asisten pengoptimal kueri
- Integrasi pemetaan objek-relasional dengan GitHub Copilot
- Keterbatasan dan masalah yang diketahui