Hızlı Başlangıç: SQL dosyalarında satır içi GitHub Copilot tamamlamaları kullanma

Satır içi tamamlamalar, bir .sql dosyada yazarken görünen hayalet metin önerileridir. Bunlar GitHub Copilot modelinden gelir ve siz yazarken yaygın SQL desenlerini tamamlamak için kullanışlıdır. Bu makalede satır içi tamamlamaların neler sunduğu, temel sınırlamaları (veritabanı şemanızı görmezler) ve bunun yerine şemayı kullanan öneriler için sohbet katılımcısının@mssql ne zaman kullanılacağı açıklanır.

Satır içi tamamlamalar bağlı veritabanı şemanızı görmez. Bunlar, MSSQL uzantısının şema bağlamı erişimi olmadan doğrudan GitHub Copilot modeli tarafından oluşturulur. SQL yazarken şemaya duyarlı öneriler için sohbet katılımcısını@mssql kullanın. Mimari neden için GitHub Copilot'un MSSQL uzantısıyla nasıl çalıştığına bakın.

Önemli çıkarımlar

  • Satır içi tamamlamalar, düzenleyicide yazdıkça gölge metin oluşturur.
  • Genel Transact-SQL (T-SQL) desenleri (birleşimler, yan tümceler, SELECT ortak işlevler) için kullanışlıdır.
  • Bağlı veritabanı şemanıza başvurmuyorlar .
  • Şema kullanan tamamlamalar için satır içi tamamlamalar yerine sohbet katılımcısını kullanın@mssql.
  • Akıllı eylem simgesi ve Ctrl+I klavye kısayolu seçili kodda GitHub Copilot çağırır. Satır içi tamamlamaları tamamlar.

Prerequisites

Bir veritabanına bağlı olduğunuzdan ve MSSQL uzantısıyla etkin bir düzenleyici penceresinin açık olduğundan emin olun. Bağlandığınızda, sohbet katılımcısı @mssql veritabanı ortamınızın bağlamını anlar ve doğru, bağlama duyarlı öneriler verebilir. Bir veritabanına bağlanmıyorsanız, sohbet katılımcısının anlamlı yanıtlar sağlamak için şeması veya veri bağlamı yoktur.

Aşağıdaki örneklerde, AdventureWorksLT2022 giriş sayfasından indirebileceğiniz örnek veritabanı kullanılır.

En iyi sonuçları elde etmek için tablo ve şema adlarını kendi ortamınızla eşleşecek şekilde ayarlayın.

Sohbetin ön ekini içerdiğinden @mssql emin olun. Örneğin, @mssql yazdıktan sonra sorunuzu ya da isteminizi yazın. Bu ön ek, sohbet katılımcısının SQL ile ilgili yardım istediğinizi anlamasını sağlar.

Satır içi tamamlamalar ne sunar?

GitHub Copilot etkinken bir .sql dosyasında yazı yazdığınızda, hayalet metin satır içinde görünür. Tab veya Enter ile kabul edin; yazmaya devam ederek yok sayın.

Satır içi tamamlamalar şunlarda başarılıdır:

  • Yaygın desenleri (SELECT * FROM, INNER JOIN ... ON, WHERE x = ?) bitirme.
  • Dosyada zaten yazdığınız kısmi tanımlayıcıların tamamlanması.
  • Yaygın SQL yapıları için kalıp kod oluşturma.

Satır içi tamamlamalar şu durumlarda iyi değildir :

  • Veritabanınızdaki gerçek tablo veya sütun adlarını kullanma (bağlama göre tahmin ederler).
  • Veritabanınızın gerçek şemasına veya ilişkilerine saygı duyma.
  • Sohbet katılımcısının @mssql şema bağlamını kullanma.

Satır içi tamamlamalar neden şemaya duyarlı değildir?

Visual Studio Code'un satır içi tamamlama uygulama programlama arabirimi (API), herhangi bir belge için fiilen tek sağlayıcılıdır. GitHub Copilot etkinleştirildiğinde, üçüncü taraf uzantıları (MSSQL uzantısı dahil) SQL dosyaları için şema kullanan hayalet metinlere katkıda bulunamaz. Hayalet metin doğrudan GitHub Copilot modelinden gelir.

Bu bir MSSQL uzantısı sınırlaması değil platform davranışıdır. Tam açıklama için bkz. GitHub Copilot MSSQL uzantısıyla nasıl çalışır?

SQL yazarken şemaya duyarlı öneriler alma

Gerçek tablolarınıza, sütunlarınıza ve ilişkilerinize başvuran öneriler için sohbet katılımcısını@mssql kullanın. Sohbetteki adres @mssql :

@mssql Write a T-SQL query that lists customers from SalesLT.Customer
who placed an order in the last 30 days.

Sohbet katılımcısı istekte şema meta verilerini içerdiğinden öneriler veritabanınızdaki gerçek nesnelere başvurur.

Akıllı eylem simgesini kullanma

Düzenleyicide SQL'i seçtiğinizde, seçimin ✨ yanında akıllı eylem simgesi görünür. Kısa bir menü açmak için seçin:

  • Copilot kullanarak değiştirme: Satır içi öneriyle seçimi yeniden yazma.
  • Açıklama: Seçili SQL'in doğal dil açıklamasını alın.
  • /doc: Seçim için belge açıklamaları oluşturun.
  • /fix: Seçimdeki sorunlar için düzeltmeler önerin.

GitHub Copilot kullanarak gözden geçir'i seçtiğinizde satır içi bir öneri görüntülenir:

Visual Studio Code'da SQL sorgusunu iyileştirmeye yönelik GitHub Copilot'tan gelen satır içi öneriyi gösteren ekran görüntüsü.

Klavye kısayollarını kullanma

GitHub Copilot'ı satır içi olarak şununla çağırın:

  • Ctrl+I Windows ve Linux'ta
  • macOS'ta Cmd+I

Sorgunuzda soru sorabileceğiniz veya değişiklik isteyebileceğiniz bir satır içi istem kutusu görüntülenir.

Visual Studio Code'da Ctrl artı I klavye kısayolunu kullanarak GitHub Copilot çağırma işleminin ekran görüntüsü.

Satır içi tamamlamalar mı, sohbet mi: karar kılavuzu

Eğer istersen... Use
Yazarken yaygın bir SQL kalıbını tamamlama Satır içi tamamlamalar
Şema kullanan bir sorgu alma @mssql sohbet
Vurgulanan sorguyu değiştirme Akıllı eylem simgesi
Şemanız hakkında çok aşamalı bir konuşma yapın @mssql Sohbet
Yeni bir istemde satır içinde GitHub Copilot’u çağırma Ctrl+I / Cmd+I

Deneyiminizi paylaşma

MSSQL uzantısı için GitHub Copilot'ı geliştirmemize ve geliştirmemize yardımcı olmak için aşağıdaki GitHub sorun şablonunu kullanarak geri bildiriminizi gönderin: GitHub Copilot Geri Bildirimi

Geri bildirim gönderirken şunları dahil etmeyi göz önünde bulundurun:

  • Test edilen senaryolar: Şema oluşturma, sorgu oluşturma, güvenlik, yerelleştirme gibi odaklandığınız alanları bize bildirin.

  • İyi çalışan şeyler: Sorunsuz, yararlı veya beklentilerinizi aşan deneyimleri açıklayın.

  • Sorunlar veya hatalar: Tüm sorunları, tutarsızlıkları veya kafa karıştırıcı davranışları dahil edin. Ekran görüntüleri veya ekran kayıtları özellikle yararlıdır.

  • İyileştirme önerileri: Kullanılabilirliği geliştirmeye, kapsamı genişletmeye veya GitHub Copilot'un yanıtlarını geliştirmeye yönelik fikirleri paylaşın.