editor kueri portal Azure untuk Azure SQL Database

Berlaku untuk:Azure SQL Database

Editor Kueri (pratinjau) adalah alat untuk menjalankan kueri T-SQL di portal Azure di browser terhadap Azure SQL Database.

• Untuk mulai cepat di editor kueri portal Microsoft Azure, lihat Mulai Cepat: Menggunakan editor kueri portal Microsoft Azure.
• Untuk kemampuan dan fungsi manajemen penjelajah objek yang lebih canggih, gunakan SQL Server Management Studio (SSMS) atau ekstensi mssql untuk Visual Studio Code.
• Jika Anda belum memiliki Azure SQL Database yang sudah dibuat, kunjungi Quickstart: Membuat Database Tunggal. Temukan opsi untuk menggunakan penawaran Anda untuk Menerapkan Azure SQL Database secara gratis.

Mengkueri Azure SQL Database Anda dari portal Azure

Editor kueri dirancang untuk kueri ringan dan eksplorasi objek di database Azure SQL Anda, semuanya dari dalam browser di portal Azure.

Mirip dengan pengalaman kueri di SQL Server Management Studio, gunakan editor kueri untuk kueri sederhana atau kueri T-SQL yang lebih besar. Anda dapat menjalankan kueri Bahasa Manipulasi Data (DML) dan Bahasa Definisi Data (DDL).

Tips

Baru mengenal Azure SQL Database? Dapatkan pemahaman menyeluruh dengan konten pelatihan gratis mendalam: Dasar-Dasar Azure SQL.

Menyambungkan melalui editor kueri

Anda dapat mengautentikasi ke editor kueri dengan menggunakan autentikasi SQL atau autentikasi Microsoft Entra.

Autentikasi ke Azure SQL Database

Misalnya, lihat Mulai Cepat: Menggunakan editor kueri portal Microsoft Azure.

• Untuk menggunakan autentikasi SQL untuk menyambungkan ke database Azure SQL melalui editor kueri, Anda harus memiliki login di database server master logis atau pengguna SQL yang terkandung dalam database pengguna yang diinginkan. Untuk informasi lebih lanjut, lihat Log masuk.
  • Masukkan nama pengguna dan kata sandi Anda, lalu pilih OK.
• Untuk menggunakan autentikasi Microsoft Entra untuk menyambungkan ke database Azure SQL melalui editor kueri, database Anda harus dikonfigurasi dengan autentikasi Microsoft Entra, dan Anda harus membuat pengguna Microsoft Entra dalam database.
  • Pilih Lanjutkan sebagai <user@domain>.

Menavigasi editor kueri

Setelah tersambung ke pengalaman editor kueri, Anda bisa menggunakan Explorer untuk menampilkan objek database atau jendela Kueri untuk menjalankan kueri T-SQL.

Tips Bermanfaat:

• Toolbar berisi Templat untuk objek T-SQL baru.
• Daftar dropdown Buka di memungkinkan Anda meluncurkan koneksi ke database ini di SQL Server Management Studio (SSMS) atau Visual Studio Code dan ekstensi MSSQL. Tindakan ini meluncurkan Dialog Koneksi di Visual Studio Code.
• Untuk menggunakan versi editor kueri SQL portal Microsoft Azure yang lebih lama, pilih Pengalaman klasik.

Jendela kueri

Jendela Kueri ini memungkinkan Anda mengetik atau menempelkan kueri dan menjalankannya. Panel Hasil memperlihatkan hasil kueri.

• Ada batas waktu kueri lima menit.
• Gunakan tombol Unduh sebagai untuk mengekspor hasil kueri ke komputer Anda sebagai file .csv, .json, atau .xlsx .
• Bilah status memperlihatkan waktu eksekusi kueri atau kesalahan apa pun.
• Anda dapat menyalin atau memfilter kumpulan hasil di toolbar Hasil .

Pertimbangan dan batasan

Pertimbangan dan batasan berikut berlaku saat menyambungkan dan mengkueri Azure SQL Database dengan menggunakan editor kueri portal Microsoft Azure.

Pembatasan editor kueri

• Jika kueri Anda memiliki beberapa pernyataan, tab Hasil hanya memperlihatkan hasil pernyataan terakhir.
• Editor kueri tidak mendukung koneksi ke server logis master database. Untuk menyambungkan ke master database, gunakan SQL Server Management Studio (SSMS) atau ekstensi mssql untuk Visual Studio Code.
• Editor kueri tidak dapat tersambung ke database replika dengan menggunakan ApplicationIntent=ReadOnly. Untuk menyambungkan dengan cara ini, gunakan SSMS dan tentukan ApplicationIntent=ReadOnly pada tab Parameter Koneksi Tambahan dalam opsi koneksi. Untuk informasi selengkapnya, lihat Menyambungkan ke replika baca-saja.
• Editor kueri memiliki batas waktu lima menit untuk eksekusi kueri. Untuk menjalankan kueri yang lebih lama, gunakan SQL Server Management Studio (SSMS) atau ekstensi mssql untuk Visual Studio Code.
• Editor kueri hanya mendukung proyeksi silinder untuk tipe data geografi.
• Editor kueri tidak mendukung IntelliSense untuk kolom, tetapi mendukung tabel dan tampilan. Untuk dukungan IntelliSense penuh, gunakan SQL Server Management Studio (SSMS) atau ekstensi mssql untuk Visual Studio Code.
• Meskipun dalam sesi browser yang sama, Anda dapat dengan bebas menavigasi melalui portal Microsoft Azure dan kueri Anda akan dipertahankan. Jika Anda me-refresh halaman (dengan menekan F5) atau menutup browser, Anda akan kehilangan kueri Anda.

Pertimbangan koneksi

• Untuk koneksi publik ke editor kueri, Anda perlu menambahkan alamat IP keluar ke aturan firewall yang diperbolehkan oleh server untuk mengakses database Anda.
  • Anda tidak perlu menambahkan alamat IP Anda ke aturan firewall server SQL jika Anda memiliki koneksi Private Link yang disiapkan di server, dan Anda terhubung ke server dari dalam jaringan virtual privat.
  • Untuk pemecahan masalah, lihat Pemecahan masalah kesalahan koneksi.
  • Untuk informasi selengkapnya tentang akses jaringan publik, pengaturan versi TLS, dan kebijakan koneksi, lihat Pengaturan konektivitas Azure SQL.

Pemecahan masalah kesalahan koneksi

• Jika Anda melihat pesan The X-CSRF-Signature header could not be validatedkesalahan , lakukan tindakan berikut untuk mengatasi masalah:

  • Pastikan jam komputer Anda diatur ke zona waktu dan waktu yang tepat. Anda dapat mencoba mencocokkan zona waktu komputer Anda dengan Azure dengan mencari zona waktu untuk lokasi database Anda, seperti US Timur.
  • Jika Anda berada di jaringan proksi, pastikan header X-CSRF-Signature permintaan tidak dimodifikasi atau dihilangkan.

• Jika database Anda tanpa server dan Anda melihat pesan kesalahan: 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* Pesan kesalahan ini menunjukkan database serverless Anda saat ini dijeda. Jika pesan kesalahan ini muncul, memilih Continue as <user@domain> akan mengirimkan permintaan ke database untuk melanjutkan. Tunggu sekitar satu menit, refresh halaman, dan coba lagi.

• Jika Anda melihat pesan kesalahan "Login gagal untuk pengguna <token-identified principal>. Server saat ini tidak dikonfigurasi untuk menerima token ini." Ketika Anda mencoba menggunakan autentikasi AD, pengguna Anda tidak memiliki akses ke database.

  • Untuk informasi selengkapnya tentang membuat pengguna database dari perwakilan Microsoft Entra, lihat Mengonfigurasi dan mengelola autentikasi Microsoft Entra dengan Azure SQL dan menggunakan CREATE USER [group or user] FROM EXTERNAL PROVIDER dalam database pengguna.

Konektivitas Port 443

Mulai Maret 2026, editor kueri Azure SQL hanya menggunakan port TCP 443.

Anda mungkin mendapatkan salah satu dari kesalahan berikut di editor kueri:

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

Kesalahan ini terjadi karena editor kueri perlu berkomunikasi melalui port 443 tetapi tidak bisa. Anda perlu mengaktifkan lalu lintas HTTPS keluar pada port ini. Instruksi berikut memanding Anda melalui proses ini, tergantung pada OS Anda. Departemen IT perusahaan Anda mungkin perlu memberikan persetujuan untuk membuka koneksi ini di jaringan lokal Anda.

Izinkan 443 di Windows Defender Firewall

1. Buka Firewall Pertahanan Windows.
2. Di menu sebelah kiri, pilih Pengaturan tingkat lanjut.
3. Di Windows Defender Firewall dengan Keamanan Canggih, pilih Aturan Keluar di menu di sebelah kiri.
4. Pilih Aturan Baru di menu kanan.
5. Di wizard aturan baru keluar, ikuti langkah-langkah berikut ini:
   1. Pilih port sebagai jenis aturan yang ingin Anda buat, lalu pilih Berikutnya.
   2. Pilih TCP.
   3. Pilih Port jarak jauh tertentu, masukkan 443, lalu pilih Berikutnya.
   4. Pilih Izinkan koneksi jika aman, pilih Berikutnya, lalu pilih Berikutnya lagi.
   5. Tetap pilih Domain, Privat, dan Publik .
   6. Beri nama aturan, misalnya Editor kueri Access Azure SQL, dan secara opsional berikan deskripsi. Selanjutnya pilih Selesai.

Izinkan 443 di macOS

1. Pada menu Apple, buka Preferensi Sistem.
2. Pilih Keamanan & Privasi, lalu pilih Firewall.
3. Jika Firewall mati, pilih Klik kunci untuk membuat perubahan, dan pilih Aktifkan Firewall.
4. Pilih Opsi Firewall.
5. Di jendela Keamanan & Privasi , pilih Izinkan perangkat lunak yang ditandatangani secara otomatis untuk menerima koneksi masuk.

Izinkan 443 di Linux

Jalankan perintah ini untuk memperbarui iptables:

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

Izinkan 443 di Azure VM

Saat Anda menggunakan Azure VM, grup keamanan jaringan Azure memblokir konektivitas. Grup keamanan jaringan dapat memfilter lalu lintas jaringan masuk dan keluar ke dan dari sumber daya Azure di jaringan virtual Azure. Anda perlu menambahkan aturan keamanan keluar ke grup keamanan jaringan. Misalnya, lihat Membuat aturan keamanan.

Langkah selanjutnya

Mulai cepat: Menggunakan editor kueri portal Microsoft Azure

Konten terkait

• Apa itu Azure SQL?
• Glosarium istilah Azure SQL
• Perbedaan T-SQL antara SQL Server dan Azure SQL Database