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.

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 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.

İ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
• Başlangıç
• Durdu

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.

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 .

Ş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.

   

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 altındaki düğmeye tıklayın.

Sorguları kaydet

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

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.

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.

   

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şıöğ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 öğ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 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 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. 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.

   

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 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 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.

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

Diğer seçenekleri görüntülemek için sonuçlar sekmesindeki öğesine tıklayın.

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.

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, 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.