Aracılığıyla paylaş

SQL Not Defterleri (önizleme)

Visual Studio Code için MSSQL uzantısındaki SQL Not Defterleri, yerel Visual Studio Code Jupyter not defterlerini kullanarak not defteri tabanlı SQL geliştirmesi sağlar. Çalıştırılabilir sorgu koleksiyonları, belge veritabanı işlemleri oluşturmak ve yeniden üretilebilir analizi paylaşmak için etkileşimli SQL sorgu yürütmesini Markdown belge hücreleriyle birleştirebilirsiniz.

Tavsiye

SQL Not Defterleri şu anda önizleme aşamasındadır ve geri bildirimlere göre değişebilir. Fikirlerinizi paylaşmak veya sorunları bildirmek için GitHub Tartışmaları'nda topluluğa katılın.

Features

SQL Not Defterleri şu özellikleri sunar:

  • T-SQL sorgularını not defteri kod hücrelerinde etkileşimli olarak yürütür ve her hücrenin altında satır içi sonuçlar görüntülenir.

  • Mevcut not defteri araçlarıyla tam uyumluluk için yerel Visual Studio Code Jupyter not defteri biçimini (.ipynb dosyalar) kullanın.

  • Sıralama, filtreleme, hücre seçimi, null değer vurgulama ve kopyalama seçenekleri (üst bilgilerle kopyalama dahil) ile zengin bir veri kılavuzunda sorgu sonuçlarını görüntüleyin.

  • Etkin veritabanı bağlantınıza göre tablo ve sütun adı önerileri de dahil olmak üzere IntelliSense ile SQL yazın.

  • Sorguları belgeleme, sonuçlara açıklama ekleme ve anlatı iş akışları oluşturma amacıyla SQL kod hücrelerinin yanına Markdown metin hücreleri ekleyin.

  • Her not defterini bir SQL Server örneğine bağlayın ve aynı sunucudaki veritabanları arasında geçiş yapın.

  • Hücreleri tek tek çalıştırın veya tüm hücreleri sırasıyla çalıştırın.

  • Kod hücrelerinde satır içi sorgu önerileri için GitHub Copilot'ı ve doğal dil açıklamalarından eksiksiz not defterleri oluşturmak için sohbet temelli not defteri yazma özelliğini kullanın.

  • Jupyter uzantısını yükleyerek SQL hücrelerini aynı not defterinde diğer dil çekirdekleriyle (Python gibi) birleştirin.

  • Not defterlerini başkalarının Visual Studio Code'da veya Jupyter uyumlu herhangi bir ortamda açabileceği dosyalar olarak .ipynb dışarı aktarın ve paylaşın.

Önkoşullar

SQL Not Defterlerini kullanmadan önce aşağıdaki gereksinimlerin karşılandığından emin olun:

SQL not defteri oluşturma

Çeşitli yollarla yeni bir SQL not defteri oluşturabilirsiniz:

  • Komut Paleti'ni açın (Windows ve Linux'ta Ctrl+Shift+P veya macOS'ta Cmd+Shift+P), yazın New Notebookve komutunu seçin.

  • Dosya menüsüne gidin ve Yeni Dosya'yı ve ardından Jupyter Not Defteri türünü seçin.

  • MSSQL uzantısının Nesne Gezgini'nde bir veritabanına sağ tıklayın ve bağlam menüsünden Yeni Not Defteri'ni seçin.

Yeni bir not defteri oluşturduğunuzda, kod hücrelerinde T-SQL yürütmesini etkinleştirmek için MSSQL çekirdeğini seçin.

Veritabanına bağlan

Sorguları çalıştırmak için her SQL not defterinin etkin bir veritabanı bağlantısına ihtiyacı vardır. MSSQL çekirdeğiyle bir not defteri açtığınızda, uzantı bir bağlantı profili seçmenizi veya yeni bir tane oluşturmanızı ister.

Önemli

Her not defteri çekirdek başına tek bir sunucu bağlantısını destekler. Bir SQL Server örneğine bağlanabilir ve bu sunucudaki veritabanları arasında geçiş yapabilirsiniz, ancak aynı not defterindeki birden çok sunucuya bağlanamazsınız. Farklı bir sunucuyla çalışmak için ayrı bir not defteri oluşturun veya not defterinin bağlantısını değiştirin.

SQL hücrelerini yazma ve çalıştırma

SQL kod hücreleri, T-SQL sorgularını not defteri içinde etkileşimli olarak yazmanızı ve yürütmenizi sağlar.

  1. Yeni bir kod hücresi eklemek için not defteri araç çubuğunda + Kod'u seçin.

  2. Hücreye T-SQL sorgunuzu girin. Hücre, bağlı veritabanından tablo ve sütun adı önerileri içeren IntelliSense de dahil olmak üzere standart sorgu düzenleyicisiyle aynı SQL düzenleme deneyimini sağlar.

  3. Sorguyu yürütmek için Hücreyi Çalıştır'ı (hücrenin solundaki yürütme düğmesi) seçin.

  4. Sonuçlar, zengin veri tablosundaki hücrenin hemen altında görünür.

Not defterindeki tüm hücreleri sırayla çalıştırmak için not defteri araç çubuğunda Tümünü Çalıştır'ı seçin.

Tavsiye

Geçerli hücreyi çalıştırmak ve hücrede kalmak için Ctrl+Enter (Windows ve Linux) veya Cmd+Enter (macOS) kullanın. Geçerli hücreyi çalıştırmak ve sonrakine ilerlemek için Shift+Enter tuşunu kullanın.

Sorgu sonuçları

SQL Not Defterlerindeki sorgu sonuçları, standart sorgu düzenleyicisinde sağlanan zengin veri kılavuzu deneyiminin aynısını sağlar:

  • Sıralama: Sonuçları artan veya azalan düzende sıralamak için bir sütun başlığı seçin.
  • Filtreleme: Sonuç verilerini filtrelemek için sütun üst bilgilerindeki filtre simgesini kullanın.
  • Hücre seçimi: Sonuç kılavuzunda tek tek hücreleri veya hücre aralıklarını seçin.
  • Null vurgulama: NULL Değerler, kolay tanımlama için sonuç kılavuzunda görsel olarak vurgulanır.
  • Kopyalama seçenekleri: Kopyala, Üst Bilgilerle Kopyala ve Tüm seçenekleri seç seçeneklerine erişmek için seçili hücrelere sağ tıklayın.

Markdown hücreleri ekleme

SQL kod hücrelerinize biçimlendirilmiş metin, başlık, liste ve bağlantı eklemek için Markdown hücrelerini kullanabilirsiniz. Bunları kullanarak sorgularınızı belgeleyin, iş mantığını açıklayın veya beklenen sonuçlar hakkında notlar ekleyin.

  1. Yeni bir metin hücresi eklemek için not defteri araç çubuğunda + Markdown'ı seçin.

  2. Markdown içeriğinizi yazın. Yazarken bir önizleme gösterilir.

  3. Markdown metnini işlemek için hücre dışını seçin.

Düzenleme moduna dönmek için hücreyi yeniden seçin.

Birden çok çekirdek kullanma

MSSQL uzantısı, SQL çekirdeğini kutudan çıkarır. Python ve diğer çekirdekler için destek sunan Jupyter uzantısını yükleyerek not defterlerinizi daha fazla dil çekirdeğiyle genişletebilirsiniz. SQL veri sorgularını aynı not defterindeki Python veri işleme ve görselleştirme hücreleriyle birleştirebilirsiniz.

GitHub Copilot tümleştirmesi

GitHub Copilot, sorgu yazmanıza ve not defterleri oluşturmanıza yardımcı olmak için SQL Notebooks ile birlikte çalışır. GitHub Copilot uzantısını yüklediğinizde şunları elde edersiniz:

  • Satır içi öneriler: SQL kod hücrelerine yazarken GitHub Copilot, veritabanı bağlamınıza ve çevresindeki Markdown hücrelerine göre sorgu tamamlamaları önerir.

  • Sohbet temelli not defteri yazma: Alternatif Markdown ve SQL hücreleriyle eksiksiz not defterleri oluşturmak için GitHub Copilot Sohbeti'ni kullanın. Gerçekleştirmek istediğiniz analizi açıklayın ve GitHub Copilot tam not defteri yapısını oluşturur.

Örneğin GitHub Copilot Sohbeti'ni açabilir ve aşağıdaki gibi bir istem kullanabilirsiniz:

I have a SQL Notebook open connected to AdventureWorks. Create cells for a sales
analysis: list all tables, find top 10 customers by revenue, show revenue by product
category, and demonstrate a safe data modification using BEGIN TRAN / ROLLBACK.

GitHub Copilot, Markdown belge hücrelerini ve T-SQL kod hücrelerini oluşturur. Bu hücreleri tek tek veya tümünü Tümünü Çalıştır'ı kullanarak tek tek çalıştırabilirsiniz.

Veritabanlarını değiştirme

Aynı sunucu bağlantısı içinde farklı bir veritabanına geçmek için:

  1. Not defterinin bağlantı durumu alanında görüntülenen veritabanı adını seçin.

  2. Açılan listeden farklı bir veritabanı seçin.

Sonraki tüm hücre yürütmeleri yeni seçilen veritabanını kullanır.

Uyarı

Farklı bir sunucuya geçmek için not defterinin bağlantı profilini değiştirmeniz gerekir. Birlikte çalışmanız gereken her sunucu için ayrı bir not defteri oluşturmayı göz önünde bulundurun.

Sınırlamalar

Not defteri başına tek sunucu bağlantısı: Şu anda her not defteri bir SQL Server örneğine bağlanır. Bu sunucudaki veritabanlarını değiştirebilirsiniz ancak aynı not defterindeki ikinci bir sunucuya bağlanamazsınız.

Geri bildirim ve destek

Fikirleriniz, geri bildirimleriniz varsa veya toplulukla etkileşim kurmak istiyorsanız adresinden https://aka.ms/vscode-mssql-discussionstartışmaya katılın. Bir hatayı bildirmek için https://aka.ms/vscode-mssql-bug adresini ziyaret edin. Yeni bir özellik istemek için adresine https://aka.ms/vscode-mssql-feature-requestgidin.

İlgili içerik

  • Last updated on