Masalah umum dan pemecahan masalah ekstensi Agen IaaS SQL Server

Berlaku untuk:SQL Server di Azure VM

Artikel ini membantu Anda mengatasi masalah yang diketahui dan memecahkan masalah kesalahan saat menggunakan ekstensi SQL Server IaaS Agent.

Untuk jawaban atas pertanyaan yang sering diajukan tentang ekstensi, lihat FAQ.

Memeriksa prasyarat

Untuk menghindari kesalahan karena opsi atau batasan yang tidak didukung, verifikasi prasyarat untuk ekstensi.

Jika Anda memperbaiki atau menginstal ulang ekstensi SQL IaaS Agent, pengaturan Anda tidak dipertahankan, selain perubahan lisensi. Jika Anda memperbaiki atau menginstal ulang ekstensi, Anda harus mengonfigurasi ulang pencadangan otomatis, patching otomatis, dan layanan lain yang Anda konfigurasi sebelum perbaikan atau penginstalan ulang.

Periksa kesehatan ekstensi

Anda dapat memeriksa kesehatan ekstensi Anda di halaman Gambaran Umum sumber daya komputer virtual SQL Anda di portal Azure, di bawah Status kesehatan ekstensi.

Catatan

Anda juga dapat menggunakan skrip PowerShell untuk memeriksa status kesehatan ekstensi pada komputer virtual Anda. Anda dapat menemukan skrip lengkap di GitHub.

Status ekstensi Agen IaaS SQL dapat berupa:

Sehat: Semuanya bekerja seperti yang diharapkan.
Gagal: Layanan SQL IaaS Agent utama tidak berjalan pada komputer virtual (VM) SQL Server.
Tidak sehat: Satu atau beberapa sublayanan memiliki masalah.

Jika status ekstensi Agen IaaS SQL Tidak Sehat atau Gagal, periksa Pemberitahuan di halaman Gambaran Umum untuk mengetahui detail selengkapnya.

Perbaiki ekstensi

Dimungkinkan agar ekstensi Agen IaaS SQL Anda berada dalam status gagal. Gunakan portal Azure untuk memperbaiki ekstensi SQL IaaS Agent.

Untuk memperbaiki ekstensi dengan portal Azure:

Masuk ke portal Azure.
Buka sumber daya komputer virtual SQL Anda.
Pilih komputer virtual SQL Server dari daftar. Jika komputer virtual SQL Server Anda tidak tercantum di sini, kemungkinan belum terdaftar dengan ekstensi Agen IaaS SQL.
Pilih Pengaturan Ekstensi Agen IaaS SQL di bawah Bantuan.
Jika status provisi Anda menampilkan Gagal, pilih Perbaiki untuk memperbaiki ekstensi. Jika status Anda Berhasil, Anda dapat mencentang kotak di samping Perbaiki paksa untuk memperbaiki ekstensi terlepas dari statusnya.

Layanan ekstensi utama tidak berjalan

Layanan utama untuk ekstensi SQL IaaS Agent (agen IaaS Microsoft SQL Server) dalam keadaan berhenti. Status ekstensi SQL IaaS Agent gagal karena kesalahan ini.

Untuk mengatasi kondisi kesalahan ini, perbaiki ekstensi.

Layanan kueri ekstensi tidak berjalan

Ekstensi SQL IaaS Agent menggunakan layanan kueri (Layanan Kueri IaaS Microsoft SQL Server) untuk berkomunikasi dengan SQL Server. Jika layanan kueri dalam status berhenti, fitur yang mengandalkan komunikasi dengan SQL Server tidak akan berfungsi. Status ekstensi SQL IaaS Agent tidak sehat karena kesalahan ini.

Untuk mengatasi kondisi kesalahan ini, perbaiki ekstensi.

SQL Server tidak berjalan

Layanan SQL Server dihentikan. Status ekstensi SQL IaaS Agent tidak sehat karena kesalahan ini.

Selidiki lebih lanjut, dan mulai ulang layanan.

Ekstensi tidak memiliki izin yang benar

Layanan kueri ekstensi SQL IaaS Agent (Microsoft SQL Server IaaS Query Service) menggunakan akun untuk mengkueri instans NT Service\SQLIaaSExtensionQuery SQL Server. Jika login ini dihapus dari SQL Server, atau jika kebijakan pengguna atau domain mengubah izin untuk masuk, Anda akan melihat kesalahan bahwa ekstensi tidak memiliki izin yang benar. Status ekstensi SQL IaaS Agent tidak sehat karena kesalahan ini.

Untuk komputer virtual SQL Server yang menggunakan model izin dengan hak istimewa minimum, pastikan NT Service\SQLIaaSExtensionQuery akun memiliki izin yang tepat yang terkait dengan setiap fitur yang diaktifkan. Jika tidak ada fitur yang diaktifkan, maka Anda akan melihat kesalahan jika NT Service\SQLIaaSExtensionQuery login tidak ada dalam SQL Server atau jika Layanan Kueri IaaS Microsoft SQL Server berjalan di bawah nama pengguna yang berbeda dari NT Service\SQLIaaSExtensionQuery.

Beberapa komputer virtual SQL Server yang disebarkan sebelum Oktober 2022 mungkin masih menggunakan model izin sysadmin yang lebih lama. Untuk VM yang lebih lama ini, Anda akan melihat kesalahan izin jika NT Service\SQLIaaSExtensionQuery tidak ada, atau tidak memiliki hak sysadmin dalam SQL Server, atau jika Layanan Kueri IaaS Microsoft SQL Server berjalan di bawah nama pengguna yang berbeda dari NT Service\SQLIaaSExtensionQuery.

Untuk mengatasi kondisi kesalahan ini, konfirmasikan bahwa login ada di SQL Server, dan memiliki izin yang benar berdasarkan fitur yang telah Anda aktifkan. Anda mungkin perlu membuat ulang login, dan/atau menetapkan izin yang benar. Selain itu, validasi Microsoft SQL Server IaaS Query Service berjalan di bawah nama pengguna NT Service\SQLIaaSExtensionQuery.

Kesalahan "gambar tidak didukung"

Pendaftaran ekstensi SQL IaaS Agent diblokir pada gambar Marketplace Azure yang tidak didukung berikut:

Komputer virtual Power BI
SQL Server Analysis Services

Status tidak sah bagi manajemen

Perbaiki ekstensi jika Anda melihat pesan kesalahan berikut:

The SQL virtual machines resource is not in a valid state for management

Komputer virtual yang mendasar tidak valid

Jika Anda melihat pesan kesalahan berikut:

SQL management operations are disabled because the state of underlying virtual machine is invalid

Pertimbangkan hal berikut:

Komputer virtual SQL mungkin dihentikan, dibatalkan alokasinya, dalam keadaan gagal, atau tidak ditemukan. Pastikan mesin virtual yang mendasari sedang berjalan.
Ekstensi Agen IaaS SQL Anda mungkin dalam status gagal. Perbaiki ekstensi.

Hapus ekstensi dari komputer virtual SQL Server Anda lalu daftarkan komputer virtual SQL dengan ekstensi lagi jika Anda melakukan salah satu hal berikut:

Memigrasikan VM Anda dari satu langganan ke langganan lainnya.
Mengubah lokal atau pengurutan pada SQL Server.
Mengubah versi instans SQL Server Anda.
Telah mengubah edisi instans SQL Server Anda.

Penyediaan gagal

Perbaiki ekstensi jika status ekstensi SQL IaaS Agent menunjukkan bahwa Provisi gagal di portal Azure.

Ekstensi SQL IaaS Agent dapat gagal diinstal jika TCP/IP dinonaktifkan di Pengelola Konfigurasi SQL Server, atau di tingkat komputer virtual.

Sumber daya komputer virtual SQL tidak tersedia di portal

Jika ekstensi SQL IaaS Agent diinstal, dan komputer virtual online, tetapi resource SQL VM tidak tersedia di portal Azure, verifikasi bahwa layanan SQL Server dan SQL Browser Anda dijalankan di dalam komputer virtual. Jika ini tidak mengatasi masalah, perbaiki ekstensi.

Fitur dalam keadaan nonaktif karena berwarna abu-abu

Jika Anda menavigasi ke sumber daya SQL VM di portal Azure, dan ada fitur yang berwarna abu-abu, verifikasi bahwa SQL VM sedang berjalan, dan Anda memiliki versi terbaru ekstensi Agen IaaS SQL, .

Akun layanan yang diubah

Mengubah akun layanan untuk salah satu dari dua layanan yang terkait dengan ekstensi dapat menyebabkan ekstensi gagal atau bertingkah tidak terduga.

Dua layanan harus berjalan di bawah akun berikut:

Agen IaaS Microsoft SQL Server adalah layanan utama untuk ekstensi Agen IaaS SQL dan harus berjalan di bawah akun Sistem Lokal.
Layanan Kueri IaaS Microsoft SQL Server adalah layanan pembantu yang membantu ekstensi menjalankan kueri dalam SQL Server dan seharusnya berjalan dengan akun NT Service.

Pendaftaran otomatis gagal

Jika Anda memiliki beberapa komputer virtual SQL Server yang gagal mendaftar secara otomatis, periksa versi SQL Server pada VM yang gagal mendaftar. Secara default, Azure VM dengan SQL Server 2016 atau yang lebih baru secara otomatis terdaftar dengan ekstensi Agen IaaS SQL saat terdeteksi oleh layanan CEIP. Komputer virtual SQL Server yang memiliki versi yang lebih lama dari 2016 harus didaftarkan secara manual secara individual atau massal.

Konsumsi sumber daya tinggi

Jika Anda melihat bahwa ekstensi Agen IaaS SQL mengonsumsi CPU atau memori yang sangat tinggi secara tak terduga, verifikasi ekstensi berada pada versi terbaru. Jika demikian, mulai ulang Microsoft SQL Server IaaS Agent dari services.msc.

Tidak dapat memperluas disk

Memperluas disk dari halaman Konfigurasi Penyimpanan sumber daya VM SQL tidak tersedia dalam kondisi berikut:

Jika Anda menghapus dan menginstal ulang ekstensi SQL IaaS Agent.
Jika Anda menghapus instalasi dan memasang ulang instans SQL Server Anda.
Jika Anda menggunakan konvensi penamaan kustom untuk nama disk atau kumpulan penyimpanan saat menyebarkan citra SQL Server Anda dari Marketplace Azure.
Jika Anda memasang komputer virtual SQL Server Anda dengan Premium SSDv2.
Jika TCP/IP dinonaktifkan di Pengelola Konfigurasi SQL Server, atau di tingkat komputer virtual.

Konfigurasi disk berwarna abu-abu selama penyebaran

Jika Anda membuat komputer virtual SQL Server dengan menggunakan disk yang tidak dikelola, konfigurasi disk sengaja dinonaktifkan.

Pencadangan otomatis dinonaktifkan

Jika sumber daya komputer virtual SQL Anda menampilkan Pencadangan otomatis saat ini dinonaktifkan, periksa untuk melihat apakah instans SQL Server Anda mengaktifkan pencadangan terkelola. Untuk menggunakan Pencadangan otomatis dari portal Azure, nonaktifkan pencadangan terkelola di SQL Server.

Ekstensi terjebak dalam proses transisi

Ekstensi SQL IaaS Agent Anda mungkin terjebak dalam status transisi dalam skenario berikut:

Anda telah menghapus NT service\SQLIaaSExtension layanan dari login SQL Server dan/atau grup administrator lokal.
Salah satu dari kedua layanan ini dihentikan di services.msc
- Agen Microsoft SQL Server IaaS
- Layanan Kueri IaaS Microsoft SQL Server

Gagal menginstal pada pengendali domain

Mendaftarkan instans SQL Server yang diinstal ke pengontrol domain Anda dengan ekstensi Agen IaaS SQL tidak didukung. Mendaftar dengan ekstensi membuat pengguna NT Service\SQLIaaSExtension dan karena pengguna ini tidak dapat dibuat di pengendali domain, mendaftarkan VM ini dengan Agen IaaS SQL tidak didukung.

TCP/IP dinonaktifkan

Ekstensi SQL IaaS Agent mengharuskan TCP/IP diaktifkan baik di Pengelola Konfigurasi SQL Server, maupun di tingkat komputer virtual. Menonaktifkan TCP/IP dapat mengakibatkan perilaku yang tidak dapat diprediksi, seperti gagal menginstal, atau beberapa fitur gagal berfungsi seperti yang diharapkan.

Tidak dapat menemukan instans SQL yang dituju

Kesalahan: Unable to find SQL instance to target. Skipping 'NT Service\\SQLIaaSExtensionQuery' removal from SQL logins adalah pesan peringatan yang dapat diabaikan dengan aman.

Anda mungkin melihat pesan ini di penampil peristiwa Windows jika langganan Anda memiliki Pendaftaran otomatis tetapi komputer virtual Azure Anda tidak menginstal SQL Server, dalam hal ini, pesan ini aman untuk diabaikan.

Layanan MSSQLSERVER tidak ditemukan di komputer

Kesalahan: SQL Server IaaS Agent: PreReq failure: ErrorCode: NotRetryableUnexpectedError, Message: Service MSSQLSERVER was not found on computer '.'.;The specified service does not exist as an installed service

Ekstensi SQL IaaS Agent hanya berfungsi dengan satu instans default atau satu instans bernama. Untuk informasi lebih lanjut, tinjau dukungan untuk beberapa instance.

Layanan dengan nama 'MSSQLSERVER' tidak berjalan

Kesalahan: Service with name 'MSSQLSERVER' is not running. Please make sure service 'MSSQLSERVER' is running and retry this operation

Periksa apakah layanan SQL Server untuk instans default berjalan di dalam VM atau memperbaiki ekstensi IaaS. Jika Anda memiliki beberapa instans SQL Server, ekstensi SQL IaaS Agent tidak akan berfungsi karena beberapa instans saat ini tidak didukung. Untuk informasi lebih lanjut, tinjau dukungan untuk beberapa instance.

Ekstensi macet dalam status transisi atau provisi gagal

Perbaiki ekstensi Agen IaaS SQL. Pastikan Anda hanya memiliki satu default atau satu instans bernama. Untuk informasi lebih lanjut, tinjau dukungan untuk beberapa instance.

Akses ditolak ke ExtensionLog_0.log

Kesalahan: EventID:56067 denied access to 'C:\WindowsAzure\Logs\Plugins\Microsoft.SqlServer.Management.SqlIaaSAgent\2.0.x.x\ExtensionLog_0.log'

Tambahkan izin untuk [NT Service\SQLIaaSExtensionQuery] ke jalur yang tercantum dalam kesalahan.

Sumber daya VM SQL gagal dibuat

Sumber daya komputer virtual SQL tidak akan dibuat dalam skenario berikut:

Mengkloning mesin virtual
Menggunakan Azure Site Recovery
Migrasi dari satu langganan, grup sumber daya, atau wilayah ke wilayah lain

Instal ulang ekstensi SQL IaaS Agent untuk mengatasi kesalahan ini.

Gagal karena status Agen Tamu/Agen VM "Belum Siap"

Instal ekstensi Agen VM untuk mengatasi kesalahan.

Ekstensi tidak berfungsi dengan beberapa instance

Sesuai harapan. Untuk informasi lebih lanjut, tinjau dukungan untuk beberapa instance.

Layanan ekstensi mengonsumsi lebih banyak memori/CPU

Jika Anda melihat ini, hapus dan instal ulang ekstensi untuk memastikan ekstensi Agen IaaS SQL berada pada versi terbaru atau mulai ulang layanan ekstensi Agen IaaS SQL dari services.msc.

Fitur ekstensi tidak berfungsi dengan SQL FCI

Sesuai harapan. Saat ini, instans kluster failover SQL Server pada komputer virtual Azure yang terdaftar di ekstensi Agen IaaS SQL hanya mendukung sejumlah fitur terbatas yang tersedia melalui pendaftaran dasar.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-09-26