Tutorial: Membuat widget wawasan kustom

Penting

Azure Data Studio akan dihentikan pada 28 Februari 2026. Kami menyarankan agar Anda menggunakan Visual Studio Code. Untuk informasi selengkapnya tentang migrasi ke Visual Studio Code, kunjungi Apa yang terjadi pada Azure Data Studio?

Tutorial ini menunjukkan cara menggunakan kueri wawasan Anda sendiri untuk membangun widget wawasan kustom.

Selama tutorial ini, Anda mempelajari cara:

• Menjalankan kueri Anda sendiri dan menampilkannya dalam bagan
• Membuat widget wawasan kustom dari bagan
• Menambahkan bagan ke server atau dasbor database
• Tambahkan detail ke widget insight kustom Anda

Prasyarat

Tutorial ini memerlukan SQL Server atau TutorialDB Azure SQL Database. Untuk membuat database TutorialDB, selesaikan salah satu panduan cepat berikut:

• Menyambungkan dan mengkueri SQL Server menggunakan Azure Data Studio
• Menyambungkan dan mengkueri Azure SQL Database menggunakan Azure Data Studio

Menjalankan kueri Anda sendiri dan menampilkan hasilnya dalam tampilan bagan

Dalam langkah ini, jalankan skrip sql untuk mengkueri sesi aktif saat ini.

1. Untuk membuka editor baru, tekan Ctrl+N.

2. Ubah konteks koneksi menjadi TutorialDB.

3. Tempelkan kueri berikut ini ke editor kueri:

   SELECT count(session_id) as [Active Sessions]
   FROM sys.dm_exec_sessions
   WHERE status = 'running'
   

4. Simpan kueri di editor ke file *.sql. Untuk tutorial ini, simpan skrip sebagai activeSession.sql.

5. Untuk menjalankan kueri, tekan F5.

6. Setelah hasil kueri ditampilkan, klik Tampilkan sebagai Bagan, lalu klik tab Penampil Bagan.

7. Ubah Tipe Bagan untuk dihitung. Pengaturan ini menghasilkan bagan hitungan.

Tambahkan wawasan khusus ke dasbor basis data

1. Untuk membuka konfigurasi widget wawasan, klik Buat Insight pada Penampil Bagan:

   

2. Salin konfigurasi wawasan (data JSON).

3. Tekan Ctrl+Koma untuk membuka Pengaturan Pengguna.

4. Ketik dasbor di Pencarian Pengaturan.

5. Klik Edit untuk dashboard.database.widgets.

   

6. Tempelkan konfigurasi wawasan JSON ke dasbor.database.widgets. Pengaturan dasbor database terlihat seperti berikut ini:

    "dashboard.database.widgets": [
        {
            "name": "My-Widget",
            "gridItemConfig": {
                "sizex": 2,
                "sizey": 1
            },
            "widget": {
                "insights-widget": {
                    "type": {
                        "count": {
                            "dataDirection": "vertical",
                            "dataType": "number",
                            "legendPosition": "none",
                            "labelFirstColumn": false,
                            "columnsAsLabels": false
                        }
                    },
                    "queryFile": "{your file folder}/activeSession.sql"
                }
            }
        }
    ]
   

7. Simpan file Pengaturan Pengguna dan buka dasbor database TutorialDB untuk melihat widget sesi aktif:

   

Tambahkan detail ke wawasan kustom

1. Untuk membuka editor baru, tekan Ctrl+N.

2. Ubah konteks koneksi menjadi TutorialDB.

3. Tempelkan kueri berikut ini ke editor kueri:

    SELECT session_id AS [SID], login_time AS [Login Time], host_name AS [Host Name], program_name AS [Program Name], login_name AS [Login Name]
    FROM sys.dm_exec_sessions
    WHERE status = 'running'
   

4. Simpan kueri di editor ke file *.sql. Untuk tutorial ini, simpan skrip sebagai activeSessionDetail.sql.

5. Tekan Ctrl+Koma untuk membuka Pengaturan Pengguna.

6. Edit node dashboard.database.widgets yang ada di file pengaturan Anda:

    "dashboard.database.widgets": [
        {
            "name": "My-Widget",
            "gridItemConfig": {
                "sizex": 2,
                "sizey": 1
            },
            "widget": {
                "insights-widget": {
                    "type": {
                        "count": {
                            "dataDirection": "vertical",
                            "dataType": "number",
                            "legendPosition": "none",
                            "labelFirstColumn": false,
                            "columnsAsLabels": false
                        }
                    },
                    "queryFile": "{your file folder}/activeSession.sql",
                    "details": {
                        "queryFile": "{your file folder}/activeSessionDetail.sql",
                        "label": "SID",
                        "value": "Login Name"
                    }
                }
            }
        }
    ]
   

7. Simpan file Pengaturan Pengguna dan buka dasbor database TutorialDB. Klik tombol elipsis (...) di samping My-Widget untuk menampilkan detailnya:

   

Langkah berikutnya

Dalam tutorial ini, Anda mempelajari cara:

• Menjalankan kueri Anda sendiri dan menampilkannya dalam bagan
• Membuat widget wawasan kustom dari bagan
• Menambahkan bagan ke server atau dasbor database
• Tambahkan detail ke widget wawasan kustom Anda

Untuk mempelajari cara mencadangkan dan memulihkan database, selesaikan tutorial berikutnya:

Mencadangkan dan memulihkan basis data.