Aracılığıyla paylaş


SQL düzenleyicisinde sorgu yazma ve verileri keşfetme

Azure Databricks kullanıcı arabirimi, sorgu yazmak, kullanılabilir verilere göz atmak ve görselleştirmeler oluşturmak için kullanabileceğiniz bir SQL düzenleyicisi içerir. Kaydedilmiş sorgularınızı çalışma alanında diğer ekip üyeleriyle de paylaşabilirsiniz. Bu makalede sorguları yazmak, çalıştırmak ve yönetmek için SQL düzenleyicisinin nasıl kullanılacağı açıklanmaktadır. SQL düzenleyicisinin yeni bir sürümü Genel Önizleme sürümündedir. Yeni SQL düzenleyicisini etkinleştirmeyi ve bu düzenleyiciyle çalışmayı öğrenmek için bkz . Yeni SQL düzenleyicisini kullanarak iş arkadaşlarınızla işbirliği yapma.

SQL düzenleyicisi kullanıcı arabirimi

Düzenleyiciyi açtıktan sonra bir SQL sorgusu yazabilir veya kullanılabilir verilere göz atabilirsiniz. Metin düzenleyicisi otomatik tamamlama, otomatik biçimlendirme ve diğer çeşitli klavye kısayollarını destekler.

Metin düzenleyicisinin üst kısmındaki sorgu sekmelerini kullanarak birden çok sorgu açabilirsiniz. Her sorgu sekmesinde sorguyu çalıştırma, sorguyu sık kullanılan olarak işaretleme ve SQL ambarı'na bağlanma denetimleri vardır. Ayrıca sorguları kaydedebilir, zamanlayabilir veya paylaşabilirsiniz .

SQL düzenleyicisini açma

SQL düzenleyicisini Azure Databricks kullanıcı arabiriminde açmak için kenar çubuğunda SQL Düzenleyicisi'ne tıklayın SQL Düzenleyicisi Simgesi.

SQL düzenleyicisi son açık sorgunuza açılır. Sorgu yoksa veya tüm sorgularınız açıkça kapatılmışsa yeni bir sorgu açılır. Otomatik olarak Yeni Sorgu olarak adlandırılır ve oluşturma zaman damgası başlığa eklenir.

İşlem'e bağlanma

Sorguları çalıştırmak için çalışan bir SQL ambarında en azından CAN USE izinlerine sahip olmanız gerekir. Kullanılabilir seçenekleri görmek için düzenleyicinin üst kısmındaki açılan listeyi kullanabilirsiniz. Listeyi filtrelemek için metin kutusuna metin girin.

SQL ambarı seçicisi

İlk kez sorgu oluşturduğunuzda, kullanılabilir SQL ambarlarının listesi alfabetik olarak görünür. Son kullanılan SQL ambarı, bir sonraki sorgu oluşturduğunuzda seçilir.

SQL ambarı'nın yanındaki simge durumu gösterir:

  • Koşarak Çalışıyor
  • Başlangıç Başlatılıyor
  • Durdu Durduruldu

Not

Listede SQL ambarı yoksa çalışma alanı yöneticinize başvurun.

Sorgunuzu çalıştırdığınızda seçili SQL ambarı otomatik olarak yeniden başlatılır. SQL ambarı başlatmanın diğer yollarını öğrenmek için bkz. SQL ambarı başlatma.

SQL düzenleyicisinde veri nesnelerine göz atma

Meta veri okuma izniniz varsa, SQL düzenleyicisindeki şema tarayıcısı kullanılabilir veritabanlarını ve tabloları gösterir. Katalog Gezginiveri nesnelerine de göz atabilirsiniz.

Örnek kataloğunu, nyctaxi veritabanını, trips tablosunu ve bu tablodaki sütunları gösteren şema tarayıcısı.

Etkin işlem olmadan Katalog Gezgini'nde Unity Kataloğu'nda yönetilen veritabanı nesnelerinde gezinebilirsiniz. Unity Kataloğu tarafından yönetilmeyen hive_metastore ve diğer kataloglardaki verileri keşfetmek için, uygun ayrıcalıklara sahip bir hesaplama ortamına bağlanmanız gerekir. Bkz. Unity Kataloğuile veri idaresi .

Not

Şema tarayıcısında veya Katalog Gezgini'nde veri nesnesi yoksa çalışma alanı yöneticinize başvurun.

Şemayı yenilemek için şema tarayıcısının üst kısmındaki Şemayı Yenile simgesine tıklayın. Arama kutusuna filtre dizeleri yazarak şemayı filtreleyebilirsiniz.

Bu tablonun sütunlarını göstermek için bir tablo adına tıklayın.

Sorgu oluşturma

SQL düzenleyicisinde sorgu oluşturmak için metin girebilirsiniz. Kataloglara ve tablolara başvurmak için şema tarayıcısından öğe ekleyebilirsiniz.

  1. Sorgunuzu SQL düzenleyicisine yazın.

    SQL düzenleyicisi otomatik tamamlamayı destekler. Siz yazarken otomatik tamamlama işlemi tamamlamaları önerir. Örneğin, imleç konumunda geçerli bir tamamlama bir sütunsa, otomatik tamamlama bir sütun adı önerir. select * from table_name as t where t.yazdığınızda, otomatik tamamlama t'in table_name için bir diğer ad olduğunu algılar ve table_nameiçindeki sütunları önerir.

    Otomatik tamamlama diğer adı

  2. (İsteğe bağlı) Düzenlemeyi bitirdiğinizde Kaydet'e tıklayın. Varsayılan olarak, sorgu kullanıcı giriş klasörünüzde kaydedilir veya farklı bir konum seçebilirsiniz. Daha sonra Kaydet'e tıklayın.

Otomatik tamamlama özelliğini açma ve kapatma

Dinamik otomatik tamamlama şema belirteçlerini, sorgu söz dizimi tanımlayıcılarını (SELECT ve JOINgibi) ve sorgu parçacıklarının başlıklarınıtamamlayabilir. Veritabanı şemanız beş bin belirteci (tablolar veya sütunlar) aşmadığı sürece varsayılan olarak etkinleştirilir.

Canlı otomatik tamamlama özelliğini kapatmak veya açmak için SQL düzenleyicisinin altındaki iki durumlu düğmeyi kullanın.

  • Canlı otomatik tamamlama özelliğini kapatmak için Ctrl + Ara Çubuğu tuşlarına basın veya SQL düzenleyicisinin Otomatik Tamamlama Etkin altındaki düğmeye tıklayın.

Sorguları kaydet

SQL düzenleyicisinin sağ üst köşesindeki Kaydet düğmesi sorgunuzu kaydeder.

Önemli

Bir sorguyu değiştirdiğinizde ancak Açıkça Kaydet'e tıklamadığınızda, bu durum sorgu taslağı olarak korunur. Sorgu taslakları 30 gün boyunca saklanır. 30 gün sonra sorgu taslakları otomatik olarak silinir. Değişikliklerinizi korumak için bunları açıkça kaydetmeniz gerekir.

Birden çok sorgu düzenleme

Varsayılan olarak, SQL düzenleyicisi aynı anda birden çok sorguyu düzenleyebilmeniz için sekmeleri kullanır. Yeni bir sekme açmak için +öğesine tıklayın, ardından Yeni sorgu oluştur'u veya Var olan sorguyu aç'ıseçin. Kaydedilen sorgular listenizi görmek için Var olan sorgu aç'a tıklayın. Sorgu listesini filtrelemek için Sorgularım veya Sık Kullanılanlar tıklayın. Görüntülemek istediğiniz sorguyu içeren satırda Aç'a tıklayın.

Sorgular İletişim Kutusu

Tek bir sorgu veya birden çok sorgu çalıştırma

Sorguyu veya tüm sorguları çalıştırmak için:

  1. Bir SQL ambarı seçin.

  2. SQL düzenleyicisinde bir sorguyu vurgulayın (sorgu bölmesinde birden çok sorgu varsa).

  3. Ctrl/Cmd + Enter tuşlarına basın veya sonuçları sonuçlar bölmesinde tablo olarak görüntülemek için Çalıştır (1000) tıklayın.

    Sorgu sonucu

Not

Sınır 1000, sorgu dönüşünü 1000 satırla sınırlamak üzere tüm sorgular için varsayılan olarak seçilir. Bir sorgu Sınırı 1000 ayarıyla kaydedilirse, bu ayar tüm sorgu çalıştırmaları (panolar dahil) için geçerlidir. Bu sorgunun tüm satırlarını döndürmek için, LIMIT açılan menüsüne tıklayarak 1000 seçimini kaldırabilirsiniz. Satır sayısı için farklı bir sınır belirtmek istiyorsanız, sorgunuza istediğiniz değere sahip bir LIMIT yan tümcesi ekleyebilirsiniz.

Sorguyu sonlandırma

Sorgu yürütülürken sonlandırmak için İptal'e tıklayın. Yönetici, başka bir kullanıcının başlattığı yürütme sorgusunu Sonlandırma sorgusunu görüntüleyerek durdurabilir.

Sorgu seçenekleri

Sorgu bilgilerini kopyalama, geri döndürme, biçimlendirme ve düzenleme menü seçeneklerine erişmek için sorgu düzenleyicisinin üst kısmındaki kebap bağlam menüsünü kullanabilirsiniz Kebap menüsü .

Kaydedilen sorguya geri dönme

Sorguyu düzenlediğinizde, sorgunun bağlam menüsünde Değişiklikleri geri döndür seçeneği görüntülenir. Kaydedilmiş sürümünüze geri dönmek için Geri Döndür'e tıklayabilirsiniz.

Sorguları atma ve geri yükleme

Sorguyu çöp kutusuna taşımak için:

  • SQL düzenleyicisinde sorgunun yanındaki kebap bağlam menüsüne Kebab menüsüne tıklayın ve Çöp Kutusuna Taşıöğesini seçin.
  • Onaylamak için Çöp kutusuna taşı'ya tıklayın.

Bir sorguyu çöp sepetinden geri yüklemek için:

  1. Tüm Sorgular listesinde Çöp Sepetiöğesine tıklayın.
  2. Bir sorguya tıklayın.
  3. SQL düzenleyicisinin sağ üst kısmındaki kebap bağlam menüsüne Kebab menüsüne tıklayın ve Geri Yükle'ye tıklayın.

Sorgu açıklamasını ayarlama ve sorgu bilgilerini görüntüleme

Sorgu açıklaması ayarlamak için:

  1. Sorgunun Kebap menüsü yanındaki kebap bağlam menüsüne tıklayın ve sorgu bilgilerini düzenle'ye tıklayın.

    Bağlam menüsü

  2. Açıklama metin kutusuna açıklamanızı girin. Daha sonra Kaydet'e tıklayın. Bu iletişim kutusunda sorgunun ne zaman oluşturulduğu ve güncelleştirilmiş olduğu da dahil olmak üzere geçmişini de görüntüleyebilirsiniz.

Sık kullanılanlar ve etiket sorguları

Sık kullanılanları ve etiketleri kullanarak çalışma alanı giriş sayfanızda ve panolar ve sorgular için liste sayfalarının her birinde görüntülenen sorgu ve pano listelerini filtreleyebilirsiniz.

Sık Kullanılanlar: Sorguyu sık kullanılanlara eklemek için Sorgular listesinde başlığının solundaki yıldıza tıklayın. Yıldız sarıya dönecek.

Etiketler: Sorguları ve panoları kuruluşunuz için anlamlı bir dizeyle etiketleyebilirsiniz.

Etiket ekleme

Sorgu düzenleyicisine etiketler ekleyin.

  1. Sorgunun Kebap menüsü yanındaki kebap bağlam menüsüne tıklayın ve sorgu bilgilerini düzenle'ye tıklayın. Sorgu bilgileri iletişim kutusu görüntülenir.

  2. Sorguya hiçbir etiket uygulanmadıysa, etiketlerin görüneceği metin kutusunda "Birkaç etiket ekle" yazısı gösterilir. Yeni bir etiket oluşturmak için kutuya yazın. Birden çok etiket girmek için girdiler arasında Sekme tuşuna basın.

    Etiket ekleme

  3. Etiketleri uygulamak ve iletişim kutusunu kapatmak için Kaydet'e tıklayın.

Etiketleri kaldırma

  1. Sorgunun Kebap menüsü yanındaki kebap bağlam menüsüne tıklayın ve sorgu bilgilerini düzenle'ye tıklayın.
  2. Kaldırmak istediğiniz herhangi bir etikette ve'e tıklayın.
  3. İletişim kutusunu kapatmak için Kaydet'e tıklayın.

Sorgu sonuçlarını görüntüleme

Sorgu çalıştırıldıktan sonra sonuçlar altındaki bölmede görünür. Yeni sonuç tablosu, yeni sorgular için AÇIK. Gerekirse, kapatmak için açılan menüye tıklayın. Bu bölümdeki görüntülerde yeni sonuç tablosu kullanılır.

Sonuç bölmesini kullanarak sorgu sonuçlarınızla etkileşimde bulunabilir ve sonuçları keşfedebilirsiniz. Sonuç bölmesi, sonuçları keşfetmek için aşağıdaki özellikleri içerir:

Görselleştirmeler, filtreler ve parametreler

Görselleştirme, filtre veya parametre eklemek için öğesine Artı İşareti Simgesi tıklayın. Aşağıdaki seçenekler görüntülenir:

Kullanılabilir seçenekler gösterilir.

Görselleştirme: Görselleştirmeler sonuç kümesini keşfetmeye yardımcı olabilir. Kullanılabilir görselleştirme türlerinin tam listesi için bkz. Görselleştirme türleri.

Filter: Filtreler, sorgu çalıştırıldıktan sonra sonuç kümesini sınırlamanıza olanak sağlar. Verilerin farklı alt kümelerini seçmeli olarak göstermek için filtreler uygulayabilirsiniz. Filtrelerin nasıl kullanılacağını öğrenmek için bkz. Sorgu filtreleri.

Parametre: Parametreler, çalışma zamanında değerleri bir sorguya değiştirerek sonuç kümesini sınırlamanıza olanak tanır. Parametrelerin nasıl uygulanacağını öğrenmek için bkz. Sorgu parametreleriyle çalışma.

Panoyu düzenleme, indirme veya panoya ekleme

Önemli

  • Databricks, AI/BI panolarının (eski adıYla Lakeview panoları) kullanılmasını önerir. Daha önce Databricks SQL panoları olarak adlandırılan panoların önceki sürümleri artık eski panolar olarak adlandırılıyor. Databricks, yeni eski panolar oluşturulmasını önermez.

Desteğin sonu zaman çizelgesi:

  • 7 Nisan 2025: Panoların eski sürümü için resmi destek sona erecektir. Yalnızca kritik güvenlik sorunları ve hizmet kesintileri giderilecektir.

  • 3 Kasım 2025: Databricks, son altı ay içinde erişilmeyen eski panoları arşivlemeye başlayacaktır. Arşivlenen panolara artık erişilemez ve arşivleme işlemi kademeli olarak gerçekleşir. Etkin olarak kullanılan panolara erişim değişmeden kalır.

    Databricks, 3 Kasım 2025'den sonra etkin eski panolar için geçiş planları geliştirmek üzere müşterilerle birlikte çalışacaktır.

  • Geçiş aracını veya REST API'yi kullanarak eski panoları dönüştürün. Yerleşik geçiş aracını kullanma yönergeleri için bkz . Eski bir panoyu AI/BI panosuna kopyalama. REST API kullanarak pano oluşturma ve yönetme öğreticileri için bkz . Pano öğreticileri .

Aşağı Şapka İşareti Diğer seçenekleri görüntülemek için sonuçlar sekmesindeki öğesine tıklayın.

Sonuçları özelleştirme, indirme ve panolara ekleme seçenekleri.

  1. Görselleştirmede gösterilen sonuçları özelleştirmek için Düzenle'ye tıklayın.
  2. Sonuçlar sekmesini silmek için Sil'e tıklayın.
  3. Sonuçlar sekmesini kopyalamak için Çoğalt'a tıklayın.
  4. Sorguyu ve görselleştirmeyi yeni bir panoya kopyalamak için Panoya ekle'ye tıklayın.
    • Bu eylem, sorguyla ilişkili tüm görselleştirmeleri içeren yeni bir pano oluşturur. Panonuzu düzenlemeyi öğrenmek için bkz . Panolar .
    • Yeni pano için bir ad seçmeniz istenir. Yeni pano giriş klasörünüzde kaydedilir.
    • Mevcut bir panoya sonuç ekleyemezsiniz.
  5. Sonuçlar sekmesini yeni veya mevcut bir eski panoya eklemek için Eski panoya ekle'ye tıklayın.
  6. Sonuçları indirmek için indirme seçeneklerinden herhangi birine tıklayın. Ayrıntılar ve sınırlar için aşağıdaki açıklamaya bakın.

Sonuçları indirme: Sonuçları CSV, TSV veya Excel dosyası olarak indirebilirsiniz.

Databricks SQL'den CSV ve TSV biçiminde yaklaşık 1 GB'a kadar sonuç verisi ve Excel dosyasına en fazla 100.000 satır indirebilirsiniz.

1 GB sınırı son dosya indirme adımından önceki bir adıma uygulandığından, son dosya indirme boyutu 1 GB'tan biraz daha fazla veya daha az olabilir.

Not

Sorgu indiremiyorsanız, çalışma alanı yöneticiniz çalışma alanınız için indirmeyi devre dışı bırakmış olur.

Geçmiş yürütmeler

Sorgu söz diziminin tamamı dahil olmak üzere sorgu için önceki çalıştırmaları görüntüleyebilirsiniz. Geçmiş yürütmeler salt okunur modda açılır ve Yeni sorguya kopyala veya Düzenlemeyi sürdür düğmeleri içerir. Bu sekme zamanlanmış çalıştırmaları göstermez.

Kayıt, belirli bir sorgu söz dizimi dahil olmak üzere sorgunun her çalıştırıldığında gösterilir.

Sonuçları keşfetme

Döndürülen sorgu sonuçları sorgunun altında görünür. Ham sonuçlar sekmesi döndürülen satırlarla doldurulur. Sonuçları artan veya azalan değerlere göre yeniden sıralamak için yerleşik filtreleri kullanabilirsiniz. Belirli bir değeri içeren sonuç satırlarını aramak için filtreyi de kullanabilirsiniz.

Sonuçları aramayla filtreleme

Görselleştirmeler, filtreler ve parametreler eklemek için sonuç bölmesindeki sekmeleri kullanabilirsiniz.

Veri dağılım grafiği, yeni görselleştirme, filtre veya parametreler oluşturma seçenekleriyle birlikte .

Sorgular penceresinde kaydedilen sorguların listesini filtreleme

Sorgular penceresinde, oluşturduğunuz sorguların listesine (Sorgularım), sık kullanılanlara ve etiketlere göre tüm sorguların listesini filtreleyebilirsiniz.

Otomatik güncelleştirmeler

Sorgu çalıştırmaları için otomatik bir tempo ayarlamak için Zamanlama düğmesini kullanabilirsiniz. Otomatik güncelleştirmeler, panolarınızın ve raporlarınızın en güncel verilerle güncel kalmasına yardımcı olabilir. Schedueled sorguları, bir değer belirtilen eşiğe ulaştığında bildirim gönderen özel bir zamanlanmış görev türü olan Databricks SQL uyarılarını da etkinleştirebilir.

Bkz. Sorgu zamanlama.

Bkz . Databricks SQL uyarıları nelerdir?.

Sorguları paylaşma

Paylaş düğmesi, sorgunuzu çalışma alanınızdaki diğer kullanıcılarla paylaşmanızı sağlar. Paylaşım sırasında aşağıdaki seçenekler arasından seçim yapın:

  • Sahip olarak çalıştır (sahibin kimlik bilgileri): Bu ayar, görüntüleyicilerin sorgu sahibiyle aynı sorgu sonuçlarını görebileceği anlamına gelir. Bu, zamanlanmış veya el ile yapılan sorgu çalıştırmaları için geçerlidir.
  • Görüntüleyici olarak çalıştır (görüntüleyici kimlik bilgileri): Bu ayar sonuçları görüntüleyicinin atanan izinleriyle sınırlar.

Bkz . Sorgu izinlerini yapılandırma.

Sonraki adım

Azure Databricks kullanıcı arabirimiyle sorgularla çalışmayı öğrenmek için bkz. Kaydedilmiş sorgulara erişme ve bu sorguları yönetme.