portal Azure editor kueri untuk Azure SQL Database

  • Artikel

Berlaku untuk:Azure SQL Database

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

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. Anda dapat menjalankan kueri T-SQL terhadap database Anda, serta mengedit data di editor data tabular build-in.

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

Tip

Baru ke Azure SQL Database? Percepat konten pelatihan gratis mendalam: Dasar-Dasar Azure SQL.

Koneksi melalui editor kueri

Ada dua opsi autentikasi untuk editor kueri: Autentikasi atau autentikasi SQL dengan ID Microsoft Entra (sebelumnya Azure Active Directory).

Autentikasi ke Azure SQL Database

Misalnya, lihat Mulai Cepat: Menggunakan editor kueri portal Azure (pratinjau) untuk mengkueri Azure SQL Database.

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

Izin yang diperlukan untuk mengakses editor kueri

Pengguna memerlukan setidaknya izin kontrol akses berbasis peran Azure (RBAC) Akses baca ke server dan database untuk menggunakan editor kueri.

Ada empat bagian utama editor kueri:

  • Bilah navigasi

  • Penjelajah objek

  • Jendela kueri

  • Salinan untuk Azure SQL Database

    Cuplikan layar dari portal Azure memperlihatkan persegi panjang merah yang menyoroti editor Kueri di menu utama dan jendela Bilah navigasi, Object Explorer, dan Kueri.

Ada empat tugas yang bisa Anda lakukan di bilah navigasi.

  • Anda dapat menggunakan Login untuk mengubah konteks autentikasi Anda.
  • Anda bisa menggunakan Kueri Baru untuk membuka jendela kueri kosong.
  • Anda bisa menggunakan Buka Kueri untuk memilih hingga 10 .sql file .txt dari komputer lokal Anda dan membukanya di jendela kueri.
  • Anda dapat memberikan Umpan Balik pada editor kueri Azure SQL Database.

Penjelajah objek

Penjelajah objek memungkinkan Anda melihat dan melakukan tugas terhadap tabel, tampilan, dan prosedur tersimpan database Anda.

  • Perluas Tabel untuk menampilkan daftar tabel di database Anda. Perluas tabel untuk melihat kolom dalam tabel. Gunakan elipsis untuk memilih 1.000 baris teratas, mengakses editor Data, atau mengganti nama tabel. Jika Anda mengganti nama tabel, gunakan panah refresh untuk melihat perubahan.
  • Perluas Tampilan untuk menampilkan daftar tampilan di database Anda. Perluas tampilan untuk melihat kolom dalam tampilan. Gunakan elipsis untuk memilih 1.000 baris teratas atau ganti nama tampilan. Jika Anda mengganti nama tampilan, gunakan panah refresh untuk melihat perubahan.
  • Perluas Prosedur Tersimpan untuk menampilkan daftar semua prosedur tersimpan dalam database Anda. Perluas prosedur tersimpan untuk melihat output prosedur tersimpan. Gunakan elipsis untuk menampilkan definisi prosedur tersimpan di jendela kueri.

Jendela kueri

Jendela ini memungkinkan Anda mengetik atau menempelkan kueri, lalu menjalankannya. Hasil kueri diperlihatkan di panel Hasil .

Anda dapat membatalkan kueri Anda. Seperti disebutkan dalam Pertimbangan dan batasan, ada periode batas waktu lima menit.

Tombol Simpan kueri memungkinkan Anda menyimpan teks kueri ke komputer Anda sebagai file .sql .

Tombol Ekspor data sebagai memungkinkan Anda mengekspor hasil kueri ke komputer Anda sebagai file .json, .csv, atau .xml .

Waktu eksekusi kueri, atau kesalahan, diperlihatkan di bilah status.

Salinan untuk Azure SQL Database (pratinjau)

Copilot di Azure SQL Database adalah asisten AI yang dirancang untuk menyederhanakan desain, operasi, pengoptimalan, dan kesehatan aplikasi berbasis Azure SQL Database. Ini meningkatkan produktivitas dalam portal Azure dengan menawarkan bahasa alami untuk konversi SQL dan bantuan mandiri untuk administrasi database.

Pengalaman Bahasa alami ke SQL dalam editor kueri portal Azure untuk Azure SQL Database menerjemahkan kueri bahasa alami ke dalam SQL, membuat interaksi database lebih intuitif.

Untuk tutorial dan contoh bahasa alami untuk kemampuan SQL Copilot di Azure SQL Database, lihat Bahasa alami untuk SQL di editor kueri portal Azure (pratinjau). Untuk informasi selengkapnya, lihat Tanya jawab umum tentang Copilot di Microsoft Azure SQL (pratinjau).

Penyunting data

Editor data memungkinkan Anda mengubah data di baris yang sudah ada, menambahkan baris data baru ke tabel, atau menghapus baris data. Ini mirip dengan pengalaman di SQL Server Management Studio (SSMS).

Untuk mengakses editor data, di penjelajah objek perluas Tabel, lalu pilih elipsis di sebelah kanan nama tabel dan pilih Edit Data (Pratinjau).

Untuk mengubah data di baris yang sudah ada, pilih nilai yang ingin Anda ubah, buat perubahan Anda, lalu pilih Simpan di bagian atas.

  • Jika kolom adalah kolom identitas, Anda tidak dapat mengedit nilai tersebut. Anda akan melihat pesan kesalahan: Save failed: Failed to execute query. Error: Cannot update identity column *column_name*.

Untuk menambahkan baris baru, pilih Buat Baris Baru dan masukkan nilai yang ingin Anda tambahkan. Ada jenis data tertentu yang tidak dapat Anda tambahkan atau kerjakan dalam konteks ini.

  • Jika kolom adalah kolom identitas, Anda tidak dapat menambahkan nilai di bidang tersebut. Anda akan melihat pesan kesalahan: Save failed: Cannot set value in identity columns *column_name*.
  • Kolom dengan batasan default tidak dihormati. Editor data tidak akan menghasilkan nilai default, itu mengharapkan Anda untuk memasukkan nilai. Tidak disarankan untuk menggunakan editor data untuk tabel yang memiliki batasan kolom default.
  • Kolom komputasi tidak dihitung. Anda akan melihat pesan 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. kesalahan Tidak disarankan untuk menggunakan editor data untuk tabel yang memiliki kolom komputasi.

Untuk menghapus baris data, pilih baris dan pilih Hapus Baris.

  • Jika baris memiliki kunci primer, dan kunci utama tersebut memiliki hubungan kunci asing dengan tabel lain, saat baris dihapus, baris terkait di tabel lain juga akan dihapus.

Pertimbangan dan batasan

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

Batasan editor kueri

  • Jika kueri Anda memiliki beberapa pernyataan, hanya hasil pernyataan terakhir yang diperlihatkan di tab Hasil .
  • Editor kueri tidak mendukung menyambungkan ke database server master logis. Untuk menyambungkan ke master database, gunakan alat lain untuk mengkueri Azure SQL Database Anda.
  • Editor kueri tidak dapat tersambung ke database replika dengan ApplicationIntent=ReadOnly. Untuk menyambungkan dengan cara ini, gunakan SSMS dan tentukan ApplicationIntent=ReadOnly pada tab Parameter Koneksi ion tambahan dalam opsi koneksi. Untuk informasi selengkapnya, lihat Koneksi ke replika baca-saja.
  • Editor kueri memiliki batas waktu 5 menit untuk eksekusi kueri. Untuk menjalankan kueri yang lebih panjang, gunakan alat lain untuk mengkueri Azure SQL Database Anda.
  • Editor kueri hanya mendukung proyeksi silinder untuk tipe data geografi.
  • Editor kueri tidak mendukung IntelliSense untuk tabel dan tampilan database, tetapi mendukung pelengkapan otomatis untuk nama yang telah di ketik. Untuk dukungan IntelliSense, gunakan alat lain untuk mengkueri Azure SQL Database Anda.
  • Menekan F5 me-refresh halaman editor kueri, dan kueri apa pun yang saat ini ada di editor tidak disimpan.

Cara lain untuk mengkueri Azure SQL Database Anda

Selain editor kueri portal Azure untuk Azure SQL Database, pertimbangkan mulai cepat berikut untuk alat lain:

Pertimbangan koneksi

  • Untuk koneksi publik ke editor kueri, Anda perlu menambahkan alamat IP keluar ke aturan firewall server yang diizinkan 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.

pemecahan masalah kesalahan Koneksi ion

  • 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* Ini menunjukkan database tanpa server Anda saat ini dijeda. Jika ini terjadi, memilih Continue as <user@domain> mengirim permintaan ke database untuk dilanjutkan. 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.

Konektivitas Port 443 dan 1443

Anda mungkin mendapatkan salah satu 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 tidak dapat berkomunikasi melalui port 443 dan 1443. 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 dan 1443 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 Tingkat Lanjut, pilih Aturan keluar di menu sebelah kiri.
  4. Pilih Aturan Baru di menu kanan.
  5. Di wizard Aturan keluar baru, 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, 1443, 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 dan 1443 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. Klik Opsi Firewall.
  5. Di jendela Keamanan & Privasi , pilih Izinkan perangkat lunak yang ditandatangani secara otomatis untuk menerima koneksi masuk.

Izinkan 443 dan 1443 di Linux

Jalankan perintah ini untuk memperbarui iptables:

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

Izinkan 443 dan 1443 di Azure VM

Saat menggunakan Azure VM, Anda memiliki konektivitas pemblokiran grup keamanan jaringan Azure. 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 Azure untuk mengkueri Azure SQL Database

Konten terkait