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

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

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

SQL kimlik doğrulamasını veya Microsoft Entra kimlik doğrulamasını kullanarak sorgu düzenleyicisinde kimlik doğrulaması yapabilirsiniz.

Azure SQL Veritabanı kimlik doğrulaması

Örnekler için bkz . Hızlı Başlangıç: Azure portalı sorgu düzenleyicisini 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üzenleyicisi deneyimine bağlandıktan sonra, veritabanı nesnelerini görüntülemek için Gezgin'i veya T-SQL sorgularını yürütmek için Sorgu penceresini kullanabilirsiniz.

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

Yararlı ipuçları:

Sorgu penceresi

Bu Sorgu penceresi, bir sorgu yazmanızı veya yapıştırmanızı ve çalıştırmanızı sağlar. Sonuçlar bölmesinde sorgu sonuçları gösterilir.

  • Beş dakikalık sorgu zaman aşımı vardır.
  • Sorgu sonuçlarını bilgisayarınıza.csv, .json veya .xlsxdosyası olarak aktarmak için Farklı İndir düğmelerini kullanın.
  • Durum çubuğunda sorgu yürütme süresi veya hatalar gösterilir.
  • Sonuçlar araç çubuğunda sonuç kümelerini kopyalayabilir veya filtreleyebilirsiniz.

Dikkat edilecekler ve sınırlamalar

Azure portal sorgu düzenleyicisini kullanarak Azure SQL Veritabanı'na bağlanırken ve bu veritabanını sorgularken aşağıdaki önemli noktalar ve sınırlamalar geçerlidir.

Sorgu düzenleyicisi sınırlamaları

Bağlantıyla ilgili dikkat edilmesi gerekenler

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 hata iletisi sunucusuz veritabanınızın şu anda duraklatıldığını gösterir. Bu hata iletisi görüntülenirse, Continue as <user@domain> seçildiğinde veritabanına devam etme isteği gönderilir. 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 edecek şekilde yapılandırılmamış. AD kimlik doğrulamasını kullanmaya çalıştığınızda, kullanıcınızın veritabanına erişimi yok.

Port 443 bağlantısı

Mart 2026'dan itibaren Azure SQL sorgu düzenleyicisi yalnızca 443 numaralı TCP bağlantı noktasını kullanır.

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 numaralı bağlantı noktası üzerinden iletişim kurması gerektiğinden ancak iletişim kuramadığından oluşur. Bu bağlantı noktası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'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. Port türünde bir kural oluşturmak istiyorsanız, ardından İleri'yi seçin.
    2. TCP’yi seçin.
    3. Belirli uzak bağlantı noktaları'nı seçin, 443 ve ardından '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'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 kilide tıklayın ve güvenlik duvarını açın.
  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'e izin ver

iptables'yi güncellemek için şu komutları çalıştırın:

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

Azure VM'de 443'e izin ver

Azure VM'lerini kullandığınızda, bir Azure ağ güvenlik grubu bağlantıyı engeller. 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