Azure SQL Veritabanı için Azure portalı sorgu düzenleyicisi

  • Makale

Şunlar için geçerlidir: Azure SQL Veritabanı

Sorgu düzenleyicisi (önizleme), Azure SQL Veritabanı karşı tarayıcıda Azure portalında T-SQL sorguları çalıştırmaya yönelik bir araçtır.

Azure portalından Azure SQL Veritabanı sorgulama

Sorgu düzenleyicisi, Azure portalındaki tarayıcının içinden Azure SQL veritabanınızda basit sorgulama ve nesne keşfi için tasarlanmıştır. Veritabanınızda T-SQL sorguları çalıştırabilir ve yerleşik tablosal veri düzenleyicisinde verileri düzenleyebilirsiniz.

SQL Server Management Studio'daki sorgu deneyimine benzer şekilde, hem basit sorgular hem de daha büyük T-SQL sorguları için sorgu düzenleyicisini kullanın. Veri İşleme Dili (DML) ve Veri Tanımlama Dili (DDL) sorgularını yürütebilirsiniz.

İpucu

Azure SQL Veritabanı yeni misiniz? Ayrıntılı ücretsiz eğitim içeriğiyle çalışmaya başlayın: Azure SQL Ile İlgili Temel Bilgiler.

Sorgu düzenleyicisi aracılığıyla bağlanma

Sorgu düzenleyicisi için iki kimlik doğrulama seçeneği vardır: SQL kimlik doğrulaması veya Microsoft Entra Id (eski adıyla Azure Active Directory) ile kimlik doğrulaması.

Azure SQL Veritabanı kimlik doğrulaması

Örnekler için bkz. Hızlı Başlangıç: Azure SQL Veritabanı sorgulamak için Azure portalı sorgu düzenleyicisini (önizleme) kullanma.

  • Sorgu düzenleyicisi aracılığıyla bir Azure SQL veritabanına bağlanmak için SQL Kimlik Doğrulaması'nı kullanmak için, mantıksal sunucunun master veritabanında oturum açma veya istenen kullanıcı veritabanında bulunan bir SQL kullanıcınız olmalıdır. Daha fazla bilgi için bkz. Kullanıcı Bilgileri.
    • Kullanıcı adınızı ve parolanızı girip Tamam'ı seçin.
  • Sorgu düzenleyicisi aracılığıyla bir Azure SQL veritabanına bağlanmak için Microsoft Entra kimlik doğrulamasını kullanmak için veritabanınızın Microsoft Entra kimlik doğrulamasıyla yapılandırılması ve veritabanında bir Microsoft Entra kullanıcısının oluşturulması gerekir.
    • user@domain> olarak <devam et'i seçin.

Sorgu düzenleyicisine erişmek için gereken izinler

Kullanıcıların sorgu düzenleyicisini kullanabilmesi için en azından Azure rol tabanlı erişim denetimi (RBAC) izni Sunucu ve veritabanına okuma erişimi gerekir.

Sorgu düzenleyicisinin dört ana bölümü vardır:

  • Gezinti çubuğu

  • Nesne gezgini

  • Sorgu penceresi

  • Azure SQL Veritabanı için Copilot

    Ana menüde Sorgu düzenleyicisini ve Gezinti çubuğu, Nesne Gezgini ve Sorgu penceresini vurgulayan kırmızı dikdörtgenleri gösteren Azure portalı ekran görüntüsü.

Gezinti çubuğunda gerçekleştirebileceğiniz dört görev vardır.

  • Kimlik doğrulama bağlamınızı değiştirmek için Oturum Aç'ı kullanabilirsiniz.
  • Boş bir sorgu penceresi açmak için Yeni Sorgu'yu kullanabilirsiniz.
  • Yerel bilgisayarınızdan en fazla 10 .sql dosya .txt seçmek ve bunları sorgu penceresinde açmak için Sorguyu Aç'ı kullanabilirsiniz.
  • Azure SQL Veritabanı sorgu düzenleyicisinde Geri Bildirim sağlayabilirsiniz.

Nesne gezgini

Nesne gezgini, veritabanınızın tablolarını, görünümlerini ve saklı yordamlarını görüntülemenize ve bu yordamlara karşı görevleri gerçekleştirmenize olanak tanır.

  • Veritabanınızdaki tabloların listesini görüntülemek için Tablolar'ı genişletin. Tablodaki sütunları görmek için tabloyu genişletin. İlk 1.000 satırı seçmek, Veri düzenleyicisine erişmek veya tabloyu yeniden adlandırmak için üç noktayı kullanın. Tabloyu yeniden adlandırırsanız, değişiklikleri görmek için yenileme okunu kullanın.
  • Veritabanınızdaki görünümlerin listesini görüntülemek için Görünümler'i genişletin. Görünümdeki sütunları görmek için görünümü genişletin. İlk 1.000 satırı seçmek veya görünümü yeniden adlandırmak için üç noktayı kullanın. Bir görünümü yeniden adlandırırsanız, değişiklikleri görmek için yenileme okunu kullanın.
  • Veritabanınızdaki tüm saklı yordamların listesini görüntülemek için Saklı Yordamlar'ı genişletin. Saklı yordamın çıkışını görmek için saklı yordamı genişletin. Sorgu penceresinde saklı yordamın tanımını görüntülemek için üç noktayı kullanın.

Sorgu penceresi

Bu pencere, bir sorgu yazmanıza veya yapıştırmanıza ve ardından çalıştırmanıza olanak tanır. Sorgunun sonuçları Sonuçlar bölmesinde gösterilir.

Sorgunuzu iptal edebilirsiniz. Önemli noktalar ve sınırlamalar bölümünde belirtildiği gibi beş dakikalık bir zaman aşımı süresi vardır.

Sorguyu kaydet düğmesi, sorgu metnini bilgisayarınıza .sql dosyası olarak kaydetmenizi sağlar.

Verileri farklı dışarı aktar düğmesi, sorgu sonuçlarını bilgisayarınıza .json, .csv veya .xml dosyası olarak dışarı aktarmanızı sağlar.

Sorgu yürütme süresi veya hatalar durum çubuğunda gösterilir.

Azure SQL Veritabanı'de Microsoft Copilot becerileri (önizleme)

Microsoft Copilot, Azure SQL Veritabanı tabanlı uygulamaların tasarımını, çalışmasını, iyileştirmesini ve durumunu kolaylaştırmak için tasarlanmış bir yapay zeka yardımcısıdır. SQL dönüştürmeye doğal dil ve veritabanı yönetimi için kendi kendine yardım sunarak Azure portalında üretkenliği artırır.

Azure SQL Veritabanı için Azure portalı sorgu düzenleyicisindeki Doğal dilden SQL'e deneyimi, doğal dil sorgularını SQL'e çevirerek veritabanı etkileşimlerini daha sezgisel hale getirir.

Copilot'un SQL özelliklerine doğal dil öğreticisi ve örnekleri için bkz . Azure portalı sorgu düzenleyicisinde (önizleme) Doğal dilden SQL'e. Daha fazla bilgi için bkz. Azure SQL Veritabanı(önizleme)'de Microsoft Copilot becerileri hakkında sık sorulan sorular.

Veri düzenleyicisi

Veri düzenleyicisi var olan bir satırdaki verileri değiştirmenize, tabloya yeni bir veri satırı eklemenize veya bir veri satırını silmenize olanak tanır. Bu, SQL Server Management Studio (SSMS) deneyimine benzer.

Veri düzenleyicisine erişmek için nesne gezgininde Tablolar'ı genişletin, ardından tablo adının sağındaki üç noktayı seçin ve Verileri Düzenle (Önizleme) öğesini seçin.

Var olan bir satırdaki verileri değiştirmek için, değiştirmek istediğiniz değeri seçin, değişikliğinizi yapın ve ardından en üstteki Kaydet'i seçin.

  • Sütun bir kimlik sütunuysa, bu değeri düzenleyemezsiniz. Şu hata iletisini görürsünüz: Save failed: Failed to execute query. Error: Cannot update identity column *column_name*.

Yeni satır eklemek için Yeni Satır Oluştur'u seçin ve eklemek istediğiniz değerleri girin. Bu bağlamda ekleyebileceğiniz veya çalışabileceğiniz belirli veri türleri vardır.

  • Sütun bir kimlik sütunuysa, bu alana değer ekleyemezsiniz. Şu hata iletisini görürsünüz: Save failed: Cannot set value in identity columns *column_name*.
  • Varsayılan kısıtlamaları olan sütunlar kabul edilmez. Veri düzenleyicisi varsayılan değeri oluşturmaz, bir değer girmenizi bekler. Varsayılan sütun kısıtlamaları olan tablolar için veri düzenleyicisinin kullanılması önerilmez.
  • Hesaplanan sütunlar hesaplanmamıştır. Hesaplanmış sütunları olan tablolar için veri düzenleyicisinin kullanılması önerilmez hata iletisini Save failed: Failed to execute query. Error: The column *column_name* cannot be modified because it is either a computed column or is the result of a UNION operator. görürsünüz.

Bir veri satırını silmek için satırı seçin ve Satırı Sil'i seçin.

  • Satırın birincil anahtarı varsa ve bu birincil anahtarın başka bir tabloyla yabancı anahtar ilişkisi varsa, satır silindiğinde, diğer tablodaki ilgili satırlar da silinir.

Dikkat edilecekler ve sınırlamalar

Azure portal sorgu düzenleyicisiyle Azure SQL Veritabanı bağlanırken ve sorgularken aşağıdaki önemli noktalar ve sınırlamalar geçerlidir.

Sorgu düzenleyicisi sınırlamaları

  • Sorgunuzda birden çok deyim varsa Sonuçlar sekmesinde yalnızca son deyimin sonuçları gösterilir.
  • Sorgu düzenleyicisi mantıksal sunucunun master veritabanına bağlanmayı desteklemez. Veritabanına bağlanmak için master Azure SQL Veritabanı sorgulamak için diğer araçları kullanın.
  • Sorgu düzenleyicisi ile ApplicationIntent=ReadOnlybir çoğaltma veritabanına bağlanamıyor. Bu şekilde bağlanmak için SSMS'yi kullanın ve bağlantı seçeneklerindeki Ek Bağlantı Parametreleri sekmesinde belirtinApplicationIntent=ReadOnly. Daha fazla bilgi için bkz . Salt okunur çoğaltmaya bağlanma.
  • Sorgu düzenleyicisinde sorgu yürütme için 5 dakikalık bir zaman aşımı vardır. Daha uzun sorgular çalıştırmak için Azure SQL Veritabanı sorgulamak için diğer araçları kullanın.
  • Sorgu düzenleyicisi yalnızca coğrafya veri türleri için silindirik projeksiyonu destekler.
  • Sorgu düzenleyicisi, veritabanı tabloları ve görünümleri için IntelliSense'i desteklemez, ancak önceden yazılmış olan adlar için otomatik tamamlamayı destekler. IntelliSense desteği için, Azure SQL Veritabanı sorgulamak için diğer araçları kullanın.
  • F5 tuşuna basıldığında sorgu düzenleyicisi sayfası yenilenir ve şu anda düzenleyicide bulunan tüm sorgular kaydedilmez.

Azure SQL Veritabanı sorgulamanın diğer yolları

Azure SQL Veritabanı için Azure portalı sorgu düzenleyicisine ek olarak, diğer araçlar için aşağıdaki hızlı başlangıçları göz önünde bulundurun:

Bağlantıyla ilgili dikkat edilmesi gerekenler

  • Sorgu düzenleyicisine genel bağlantılar için, veritabanlarınıza erişmek için sunucunun izin verilen güvenlik duvarı kurallarına giden IP adresinizi eklemeniz gerekir.
    • Sunucuda ayarlanmış bir Özel Bağlantı bağlantınız varsa ve özel sanal ağın içinden sunucuya bağlanıyorsanız, IP adresinizi SQL server güvenlik duvarı kurallarına eklemeniz gerekmez.

Bağlantı hatası sorunlarını giderme

  • hata iletisini The X-CSRF-Signature header could not be validatedgörürseniz, sorunu çözmek için aşağıdaki eylemleri gerçekleştirin:

    • Bilgisayarınızın saatinin doğru saat ve saat dilimine ayarlandığını doğrulayın. Doğu ABD gibi veritabanı konumunuzun saat dilimini arayarak bilgisayarınızın saat dilimini Azure ile eşleştirmeyi deneyebilirsiniz.
    • Ara sunucu ağındaysanız istek üst bilgisinin X-CSRF-Signature değiştirilmediğinden veya bırakılmadığından emin olun.

  • Veritabanınız sunucusuzsa ve hata iletisini görüyorsanız: Database *name* on server *name.database.windows.net* is not currently available. Please retry the connection later. If the problem persists, contact customer support, and provide them the session tracing ID *ID* Bu, sunucusuz veritabanınızın şu anda duraklatıldığını gösterir. Bu durumda, seçildiğinde Continue as <user@domain> veritabanına sürdürülecek bir istek gönderir. Yaklaşık bir dakika bekleyin, sayfayı yenileyin ve yeniden deneyin.

  • "Kullanıcı <token-identified principal>için oturum açma başarısız oldu" hata iletisini görürseniz. Sunucu şu anda bu belirteci kabul etmek üzere yapılandırılmamış."

    • Microsoft Entra sorumlusundan veritabanı kullanıcısı oluşturma hakkında daha fazla bilgi için bkz . Azure SQL ile Microsoft Entra kimlik doğrulamasını yapılandırma ve yönetme ve kullanıcı veritabanında kullanma CREATE USER [group or user] FROM EXTERNAL PROVIDER .

Bağlantı noktası 443 ve 1443 bağlantısı

Sorgu düzenleyicisinde aşağıdaki hatalardan birini alabilirsiniz:

  • Your local network settings might be preventing the Query Editor from issuing queries. Please click here for instructions on how to configure your network settings.
  • A connection to the server could not be established. This might indicate an issue with your local firewall configuration or your network proxy settings.

Bu hatalar, sorgu düzenleyicisinin 443 ve 1443 bağlantı noktaları üzerinden iletişim kuramaması nedeniyle oluşur. Bu bağlantı noktalarında giden HTTPS trafiğini etkinleştirmeniz gerekir. Aşağıdaki yönergeler, işletim sisteminize bağlı olarak bu işlemde size yol gösterir. Kurumsal BT departmanınızın bu bağlantıyı yerel ağınızda açmak için onay vermesi gerekebilir.

Windows Defender Güvenlik Duvarı'nda 443 ve 1443'e izin ver

  1. Windows Defender Güvenlik Duvarı'nı açın.
  2. Soldaki menüde Gelişmiş ayarlar'ı seçin.
  3. Gelişmiş Güvenlik özellikli Windows Defender Güvenlik Duvarı'nda soldaki menüden Giden kuralları'nı seçin.
  4. Sağ menüden Yeni Kural'ı seçin.
  5. Yeni giden kuralı sihirbazında şu adımları izleyin:
    1. Oluşturmak istediğiniz kural türü olarak bağlantı noktasını seçin ve ardından İleri'yi seçin.
    2. TCP’yi seçin.
    3. Belirli uzak bağlantı noktaları'yı seçin, girin 443, 1443ve ardından İleri'yi seçin.
    4. Güvenliyse bağlantıya izin ver'i seçin, İleri'yi ve sonra yeniden İleri'yi seçin.
    5. Etki Alanı, Özel ve Genel'i seçili tutun.
    6. Kurala access Azure SQL sorgu düzenleyicisi gibi bir ad verin ve isteğe bağlı olarak bir açıklama sağlayın. Ardından Son’u seçin.

macOS'ta 443 ve 1443'e izin ver

  1. Apple menüsünde Sistem Tercihleri'ni açın.
  2. Güvenlik ve Gizlilik'i ve ardından Güvenlik Duvarı'nı seçin.
  3. Güvenlik duvarı kapalıysa, değişiklik yapmak için kilidi tıklatın'ı ve güvenlik duvarını aç'ı seçin.
  4. Güvenlik Duvarı Seçenekleri'ni seçin.
  5. Güvenlik ve Gizlilik penceresinde İmzalı yazılımın gelen bağlantıları almasına otomatik olarak izin ver'i seçin.

Linux'ta 443 ve 1443'e izin ver

güncelleştirmek iptablesiçin şu komutları çalıştırın:

sudo iptables -A OUTPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A OUTPUT -p tcp --dport 1443 -j ACCEPT

Azure VM'de 443 ve 1443'e izin ver

Azure VM'lerini kullanırken, bağlantıyı engelleyen bir Azure ağ güvenlik grubunuz vardır. Ağ güvenlik grubu, Azure sanal ağındaki Azure kaynaklarına gelen ve giden ağ trafiğini filtreleyebilir. Ağ güvenlik grubuna bir giden güvenlik kuralı eklemeniz gerekir. Bir örnek için bkz . Güvenlik kuralları oluşturma.

Sonraki adım

Hızlı Başlangıç: Azure SQL Veritabanı sorgulamak için Azure portalı sorgu düzenleyicisini kullanma

İlgili içerik