SQL Düzenleyicisi'nde 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.

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 .

İşlem için Bağlan

Sorguları çalıştırmak için çalışan bir SQL Ambarı üzerinde 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.

İ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:

• Çalışan
• Başlangıç
• Durdu

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. Veri nesnelerine Katalog Gezgini'nden de göz atabilirsiniz.

Etkin işlem olmadan Katalog Gezgini'nde Unity Kataloğu'nda yönetilen veritabanı nesnelerinde gezinebilirsiniz. Unity Kataloğu tarafından yönetilmeyen ve diğer kataloglardaki hive_metastore verileri keşfetmek için, hesaplamaya uygun ayrıcalıklarla eklemeniz gerekir. Bkz. Unity Kataloğu ile 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ına 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.

• 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. yazarsanızselect * from table_name as t where t., otomatik tamamlama bunun için table_name bir diğer ad olduğunu t tanır ve içindeki table_namesütunları önerir.

  

• (İsteğe bağlı) Düzenlemeyi bitirdiğinizde 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ı (ve gibi SELECTJOIN) ve sorgu kod 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üzenleyicisi'nin 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 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 veya Var olan sorguyu aç'ı seçin. Kaydedilen sorgular listenizi görmek için Var olan sorguyu aç'a tıklayın. Sorgu listesini filtrelemek için Sorgularım veya Sık Kullanılanlar'a tıklayın. Görüntülemek istediğiniz sorguyu içeren satırda Aç'a tıklayın.

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. Sonuçları sonuçlar bölmesinde tablo olarak görüntülemek için Ctrl/Cmd + Enter tuşlarına basın veya Çalıştır 'a (1000) tıklayın.

   

Not

Sorgu dönüşünü 1000 satırla sınırlamak için tüm sorgular için varsayılan olarak Sınır 1000 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 Çalıştır (1000) açılan menüsüne tıklayarak LIMIT 1000 seçimini kaldırabilirsiniz. Satır sayısı üzerinde farklı bir sınır belirtmek istiyorsanız, sorgunuza istediğiniz değeri içeren bir yan tümce ekleyebilirsiniz LIMIT .

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 .

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 tıklayın ve Çöp Kutusuna Taşı'yı 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 öğesine tıklayın .
2. Bir sorguya tıklayın.
3. SQL düzenleyicisinin sağ üst köşesindeki kebap bağlam menüsüne ve ardından 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 yanındaki kebap bağlam menüsüne tıklayın ve sorgu bilgilerini düzenle'ye tıklayın.

   

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 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. Sorguda etiket uygulanmamışsa, etiketlerin görüntüleneceği metin kutusunda Bazı etiketler ekle 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.

   

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

Etiketleri kaldırma

1. Sorgunun 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 X'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 sorgular için Yeni sonuç tablosu ON'dır. 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 tıklayın. Aşağıdaki seçenekler görüntülenir:

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.

Filtre: 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 parametreleri.

Sonuçları indirme veya özelleştirme

İndirme ve özelleştirme seçeneklerinizi görüntülemek için öğesine tıklayın.

Özel tablo oluştur: Bu seçenek, özgün sorgunun sonuçlarını değiştirmek için kullanıcı arabirimini kullanabileceğiniz yeni bir Sonuçlar paneli açar. Tablo düzeyindeki ekrandan satır numaralarını kaldırabilir veya belirli sütunları gizleyebilirsiniz.

Sütun adına tıklayarak tek bir sütunu da değiştirebilirsiniz. Sütun adını ve biçimlendirmesini değiştirebilirsiniz. Ayrıca, görüntüde kullanılan veri türünü değiştirebilir ve satırları koşullu olarak biçimlendirebilirsiniz.

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.

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.

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

Sorgular penceresinde kaydedilen sorguların listesini filtreleme

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

Otomatik güncelleştirmeler

Sorgu çalıştırmaları için otomatik bir tempo ayarlamak için Zamanla 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ünüm 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.