SERVERPROPERTY (Transact-SQL)
Berlaku untuk:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)
Mengembalikan informasi properti tentang instans server.
Catatan
ID Microsoft Entra sebelumnya dikenal sebagai Azure Active Directory (Azure AD).
Sintaks
SERVERPROPERTY ( 'propertyname' )
Penting
Nomor versi Mesin Database untuk SQL Server dan Azure SQL Database tidak sebanding satu sama lain, dan mewakili nomor build internal untuk produk terpisah ini. Mesin Database untuk Azure SQL Database didasarkan pada basis kode yang sama dengan Mesin Database SQL Server. Yang terpenting, Mesin Database di Azure SQL Database selalu memiliki bit Mesin SQL Database terbaru. Misalnya, azure SQL Database versi 12 lebih baru dari SQL Server versi 16.
Catatan
Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.
Argumen
nama properti
Ekspresi yang berisi informasi properti yang akan dikembalikan untuk server. propertyname bisa menjadi salah satu nilai di bawah ini. Penggunaan nama properti yang tidak valid atau tidak didukung pada versi Mesin Database tersebut akan mengembalikan NULL.
| Properti | Nilai yang dikembalikan |
|---|---|
BuildClrVersion |
Versi microsoft .NET Framework common language runtime (CLR) yang digunakan saat membangun instans SQL Server. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: nvarchar(128) |
Collation |
Nama kolas default untuk server. NULL = Input tidak valid, atau kesalahan. Jenis data dasar: nvarchar(128) |
CollationID |
ID kolase SQL Server. Jenis data dasar: int |
ComparisonStyle |
Gaya perbandingan Windows dari kolate. Jenis data dasar: int |
ComputerNamePhysicalNetBIOS |
Nama NetBIOS komputer lokal tempat instans SQL Server saat ini berjalan. Untuk instans terkluster SQL Server pada kluster failover, nilai ini berubah saat instans SQL Server gagal ke node lain di kluster failover. Pada instans SQL Server yang berdiri sendiri, nilai ini tetap konstan dan mengembalikan nilai yang sama dengan properti MachineName. Catatan: Jika instans SQL Server berada dalam kluster failover dan Anda ingin mendapatkan nama instans berkluster failover, gunakan properti MachineName. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: nvarchar(128) |
Edition |
Edisi produk yang diinstal dari instans SQL Server. Gunakan nilai properti ini untuk menentukan fitur dan batasan, seperti Batas kapasitas komputasi berdasarkan edisi SQL Server. Versi 64-bit dari tambahkan Mesin Database (64-bit) ke versi . Menampilkan: 'Edisi Perusahaan' 'Edisi Perusahaan: Lisensi berbasis inti' 'Edisi Evaluasi Perusahaan' 'Edisi Kecerdasan Bisnis' 'Edisi Pengembang' 'Edisi Ekspres' 'Edisi Ekspres dengan Layanan Lanjutan' 'Edisi Standar' 'Edisi Web' 'SQL Azure' menunjukkan SQL Database atau Azure Synapse Analytics 'Pengembang Azure SQL Edge' menunjukkan edisi pengembangan saja untuk Azure SQL Edge 'Azure SQL Edge' menunjukkan edisi berbayar untuk Azure SQL Edge Jenis data dasar: nvarchar(128) |
EditionID |
EditionID mewakili edisi produk yang diinstal dari instans SQL Server. Gunakan nilai properti ini untuk menentukan fitur dan batasan, seperti Batas kapasitas komputasi berdasarkan edisi SQL Server. 1804890536 = Enterprise 1872460670 = Edisi Perusahaan: Lisensi berbasis inti 610778273 = Evaluasi Perusahaan 284895786 = Kecerdasan Bisnis -2117995310 = Pengembang -1592396055 = Express -133711905 = Ekspres dengan Layanan Tingkat Lanjut -1534726760 = Standar 1293598313 = Web 1674378470 = SQL Database atau Azure Synapse Analytics -1461570097 = Pengembang Azure SQL Edge 1994083197 = Azure SQL Edge Jenis data dasar: bigint |
EngineEdition |
Database Engine edisi instans SQL Server yang diinstal di server. 1 = Mesin Pribadi atau Desktop (Tidak tersedia di SQL Server 2005 (9.x) dan versi yang lebih baru.) 2 = Standar (Untuk Kecerdasan Standar, Web, dan Bisnis.) 3 = Perusahaan (Untuk edisi Evaluasi, Pengembang, dan Perusahaan.) 4 = Ekspres (Untuk Ekspres, Ekspres dengan Alat, dan Ekspres dengan Layanan Tingkat Lanjut) 5 = SQL Database 6 = Azure Synapse Analytics 8 = Azure SQL Managed Instance 9 = Azure SQL Edge (Untuk semua edisi Azure SQL Edge) 11 = Kumpulan SQL tanpa server Azure Synapse Jenis data dasar: int |
FilestreamConfiguredLevel |
Tingkat akses FILESTREAM yang dikonfigurasi. Untuk informasi selengkapnya, lihat tingkat akses aliran file. 0 = FILESTREAM dinonaktifkan 1 = FILESTREAM diaktifkan untuk akses Transact-SQL 2 = FILESTREAM diaktifkan untuk akses streaming Transact-SQL dan Win32 lokal 3 = FILESTREAM diaktifkan untuk Transact-SQL dan akses streaming Win32 lokal dan jarak jauh Jenis data dasar: int |
FilestreamEffectiveLevel |
Tingkat akses FILESTREAM yang efektif. Nilai ini dapat berbeda dari FilestreamConfiguredLevel jika tingkat telah berubah dan mulai ulang instans atau mulai ulang komputer tertunda. Untuk informasi selengkapnya, lihat tingkat akses aliran file. 0 = FILESTREAM dinonaktifkan 1 = FILESTREAM diaktifkan untuk akses Transact-SQL 2 = FILESTREAM diaktifkan untuk akses streaming Transact-SQL dan Win32 lokal 3 = FILESTREAM diaktifkan untuk Transact-SQL dan akses streaming Win32 lokal dan jarak jauh Jenis data dasar: int |
FilestreamShareName |
Nama berbagi yang digunakan oleh FILESTREAM. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: nvarchar(128) |
HadrManagerStatus |
Berlaku untuk: SQL Server 2012 (11.x) dan yang lebih baru. Menunjukkan apakah manajer grup ketersediaan AlwaysOn telah dimulai. 0 = Tidak dimulai, komunikasi tertunda. 1 = Memulai dan menjalankan. 2 = Tidak dimulai dan gagal. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: int |
InstanceDefaultBackupPath |
Berlaku untuk: SQL Server 2019 (15.x) dan yang lebih baru. Nama jalur default ke file cadangan instans. |
InstanceDefaultDataPath |
Berlaku untuk: SQL Server 2012 (11.x) melalui versi saat ini dalam pembaruan yang dimulai pada akhir 2015. Nama jalur default ke file data instans. Jenis data dasar: nvarchar(128) |
InstanceDefaultLogPath |
Berlaku untuk: SQL Server 2012 (11.x) melalui versi saat ini dalam pembaruan yang dimulai pada akhir 2015. Nama jalur default ke file log instans. Jenis data dasar: nvarchar(128) |
InstanceName |
Nama instans tempat pengguna terhubung. Mengembalikan NULL jika nama instans adalah instans default, jika input tidak valid, atau kesalahan. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: nvarchar(128) |
IsAdvancedAnalyticsInstalled |
Mengembalikan 1 jika fitur Analitik Tingkat Lanjut diinstal selama penyiapan; 0 jika Analitik Tingkat Lanjut tidak diinstal. Jenis data dasar: int |
IsBigDataCluster |
Diperkenalkan di SQL Server 2019 (15.x) dimulai dengan CU 4. Mengembalikan 1 jika instansnya adalah Kluster Big Data SQL Server; 0 jika tidak. Jenis data dasar: int |
IsClustered |
Instans server dikonfigurasi dalam kluster failover. 1 = Berkluster. 0 = Tidak Berkluster. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: int |
IsExternalAuthenticationOnly |
Berlaku untuk: Azure SQL Database dan Azure SQL Managed Instance. Mengembalikan apakah autentikasi Microsoft Entra-only diaktifkan. 1 = Autentikasi khusus Microsoft Entra diaktifkan. 0 = Autentikasi khusus Microsoft Entra dinonaktifkan. Jenis data dasar: int |
IsExternalGovernanceEnabled |
Berlaku untuk: SQL Server 2022 (16.x) dan yang lebih baru. Mengembalikan apakah kebijakan akses Microsoft Purview diaktifkan. 1 = Tata kelola eksternal diaktifkan. 0 = Tata kelola eksternal dinonaktifkan. Jenis data dasar: int |
IsFullTextInstalled |
Komponen pengindeksan teks lengkap dan semantik diinstal pada instans SQL Server saat ini. 1 = Komponen pengindeksan teks lengkap dan semantik diinstal. 0 = Komponen pengindeksan teks lengkap dan semantik tidak diinstal. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: int |
IsHadrEnabled |
Berlaku untuk: SQL Server 2012 (11.x) dan yang lebih baru. Grup ketersediaan AlwaysOn diaktifkan pada instans server ini. 0 = Fitur grup ketersediaan AlwaysOn dinonaktifkan. 1 = Fitur grup ketersediaan AlwaysOn diaktifkan. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: int Agar replika ketersediaan dibuat dan dijalankan pada instans SQL Server, grup ketersediaan AlwaysOn harus diaktifkan pada instans server. Untuk informasi selengkapnya, lihat Mengaktifkan dan Menonaktifkan Grup Ketersediaan AlwaysOn (SQL Server). Catatan: Properti IsHadrEnabled hanya berkaitan dengan grup ketersediaan AlwaysOn. Fitur ketersediaan tinggi atau pemulihan bencana lainnya, seperti pencerminan database atau pengiriman log, tidak terpengaruh oleh properti server ini. |
IsIntegratedSecurityOnly |
Server berada dalam mode keamanan terintegrasi. 1 = Keamanan terintegrasi (Autentikasi Windows) 0 = Tidak terintegrasi keamanan. (Autentikasi Windows dan Autentikasi SQL Server.) NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: int |
IsLocalDB |
Berlaku untuk: SQL Server 2012 (11.x) dan yang lebih baru. Server adalah instans SQL Server Express LocalDB. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: int |
IsPolyBaseInstalled |
Berlaku untuk: SQL Server 2016 (13.x). Mengembalikan apakah instans server telah menginstal fitur PolyBase. 0 = PolyBase tidak diinstal. 1 = PolyBase diinstal. Jenis data dasar: int |
IsServerSuspendedForSnapshotBackup |
Server dalam mode ditangguhkan dan memerlukan pencukur tingkat server. 1 = Ditangguhkan. 0 = Tidak ditangguhkan Jenis data dasar: int |
IsSingleUser |
Server dalam mode pengguna tunggal. 1 = Pengguna tunggal. 0 = Tidak satu pengguna NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: int |
IsTempDbMetadataMemoryOptimized |
Berlaku untuk: SQL Server 2019 (15.x) dan yang lebih baru. Mengembalikan 1 jika tempdb telah diaktifkan untuk menggunakan tabel yang dioptimalkan memori untuk metadata; 0 jika tempdb menggunakan tabel berbasis disk reguler untuk metadata. Untuk informasi selengkapnya, lihat Database tempdb.Jenis data dasar: int |
IsXTPSupported |
Berlaku untuk: SQL Server (SQL Server 2014 (12.x) dan yang lebih baru), SQL Database. Server mendukung OLTP Dalam Memori. 1 = Server mendukung OLTP Dalam Memori. 0 = Server tidak mendukung OLTP Dalam Memori. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: int |
LCID |
Pengidentifikasi lokal Windows (LCID) dari kolaborasi. Jenis data dasar: int |
LicenseType |
Tidak digunakan. Informasi lisensi tidak dipertahankan atau dikelola oleh produk SQL Server. Selalu mengembalikan DISABLED. Jenis data dasar: nvarchar(128) |
MachineName |
Nama komputer Windows tempat instans server berjalan. Untuk instans terkluster, instans SQL Server yang berjalan di server virtual di Microsoft Cluster Service, instans mengembalikan nama server virtual. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: nvarchar(128) |
NumLicenses |
Tidak digunakan. Informasi lisensi tidak dipertahankan atau dikelola oleh produk SQL Server. Selalu mengembalikan NULL. Jenis data dasar: int |
PathSeparator |
Berlaku untuk: SQL Server 2017 (14.x) dan yang lebih baru. Mengembalikan \ pada Windows dan / di LinuxJenis data dasar: nvarchar |
ProcessID |
ID proses layanan SQL Server. ProcessID berguna dalam mengidentifikasi Sqlservr.exe mana yang termasuk dalam instans ini. NULL = Input tidak valid, kesalahan, atau tidak berlaku. Jenis data dasar: int |
ProductBuild |
Berlaku untuk: SQL Server 2014 (12.x) mulai Oktober 2015. Nomor build. Jenis data dasar: nvarchar(128) |
ProductBuildType |
Berlaku untuk: SQL Server 2012 (11.x) melalui versi saat ini dalam pembaruan yang dimulai pada akhir 2015. Jenis build build saat ini. Mengembalikan salah satu nilai berikut: OD = Sesuai Permintaan merilis pelanggan tertentu. GDR = Rilis Distribusi Umum dirilis melalui Windows Update. NULL = Tidak berlaku. Jenis data dasar: nvarchar(128) |
ProductLevel |
Tingkat versi instans SQL Server. Mengembalikan salah satu nilai berikut: 'RTM' = Versi rilis asli 'SPn' = Versi paket layanan 'CTPn', = Versi Pratinjau Teknologi Komunitas Jenis data dasar: nvarchar(128) |
ProductMajorVersion |
Berlaku untuk: SQL Server 2012 (11.x) melalui versi saat ini dalam pembaruan yang dimulai pada akhir 2015. Versi utama. Jenis data dasar: nvarchar(128) |
ProductMinorVersion |
Berlaku untuk: SQL Server 2012 (11.x) melalui versi saat ini dalam pembaruan yang dimulai pada akhir 2015. Versi minor. Jenis data dasar: nvarchar(128) |
ProductUpdateLevel |
Berlaku untuk: SQL Server 2012 (11.x) melalui versi saat ini dalam pembaruan yang dimulai pada akhir 2015. Perbarui tingkat build saat ini. CU menunjukkan pembaruan kumulatif. Mengembalikan salah satu nilai berikut: CUn = Pembaruan Kumulatif NULL = Tidak berlaku. Jenis data dasar: nvarchar(128) |
ProductUpdateReference |
Berlaku untuk: SQL Server 2012 (11.x) melalui versi saat ini dalam pembaruan yang dimulai pada akhir 2015. Artikel KB untuk rilis tersebut. Jenis data dasar: nvarchar(128) |
ProductVersion |
Versi instans SQL Server, dalam bentuk major.minor.build.revision. Jenis data dasar: nvarchar(128) |
ResourceLastUpdateDateTime |
Mengembalikan tanggal dan waktu database Sumber Daya terakhir diperbarui. Jenis data dasar: tanggalwaktu |
ResourceVersion |
Mengembalikan versi database Sumber Daya. Jenis data dasar: nvarchar(128) |
ServerName |
Baik server Windows maupun informasi instans yang terkait dengan instans SQL Server tertentu. NULL = Input tidak valid, atau kesalahan. Jenis data dasar: nvarchar(128) |
SqlCharSet |
ID set karakter SQL dari ID kolase. Jenis data dasar: tinyint |
SqlCharSetName |
Nama kumpulan karakter SQL dari kolase. Jenis data dasar: nvarchar(128) |
SqlSortOrder |
ID urutan pengurutan SQL dari kolase Jenis data dasar: tinyint |
SqlSortOrderName |
Nama urutan pengurutan SQL dari kolase. Jenis data dasar: nvarchar(128) |
SuspendedDatabaseCount |
Jumlah database yang ditangguhkan di server. Jenis data dasar: int |
Jenis yang dikembalikan
aql_variant
Keterangan
Properti ServerName
Properti ServerNameSERVERPROPERTY fungsi dan @@SERVERNAME mengembalikan informasi serupa. Properti ServerName ini menyediakan server Windows dan nama instans yang bersama-sama membentuk instans server unik. @@SERVERNAME menyediakan nama server lokal yang saat ini dikonfigurasi.
Properti ServerName dan @@SERVERNAME mengembalikan informasi yang sama jika nama server default, pada saat penginstalan, belum diubah. Nama server lokal dapat dikonfigurasi dengan menjalankan hal berikut:
EXEC sp_dropserver 'current_server_name';
GO
EXEC sp_addserver 'new_server_name', 'local';
GO
Jika nama server lokal telah diubah dari nama server default pada waktu penginstalan, @@SERVERNAME mengembalikan nama baru.
Properti ServerNameSERVERPROPERTY fungsi mengembalikan nama server Windows saat disimpan. Dalam versi utama sebelumnya, ia mengembalikan huruf besar. Perilaku ini berubah kembali ke huruf besar antara SQL Server 2019 (15.x) CU 9 dan CU 12, tetapi mulai dari SQL Server 2019 (15.x) CU 13, nama server kembali saat disimpan.
Jika nama server Windows berisi karakter huruf kecil, perubahan perilaku ini dapat menyebabkan perbedaan antara ServerName properti SERVERPROPERTY fungsi, dan @@SERVERNAME (huruf besar versus huruf kecil), bahkan jika tidak ada perubahan nama untuk server.
Pertimbangkan Anda memiliki server bernama server01, dengan instans SQL Server bernama INST1. Tabel berikut ini meringkas perubahan perilaku antara build SQL Server 2019 yang berbeda (15.x):
| Rilis SQL Server 2019 (15.x) | SERVERPROPERTY('ServerName') | Informasi Tambahan |
|---|---|---|
| RTM | SERVER01\INST1 |
Mengembalikan ServerName properti dalam huruf besar |
| CU 1 – CU 8 | server01\INST1 |
Mengembalikan ServerName properti apa adanya, tanpa mengubah menjadi huruf besar |
| CU 9 – CU 12 | SERVER01\INST1 |
Mengembalikan ServerName properti dalam huruf besar |
| CU 13 dan versi yang lebih baru | server01\INST1 |
Mengembalikan ServerName properti apa adanya, tanpa mengubah menjadi huruf besar |
Properti versi
Fungsi mengembalikan SERVERPROPERTY properti individual yang terkait dengan informasi versi sedangkan fungsi @@VERSION menggabungkan output menjadi satu string. Jika aplikasi Anda memerlukan string properti individual, Anda dapat menggunakan SERVERPROPERTY fungsi untuk mengembalikannya alih-alih mengurai hasil @@VERSION .
Izin
Semua pengguna dapat mengkueri properti server.
Contoh
Contoh berikut menggunakan SERVERPROPERTY fungsi dalam SELECT pernyataan untuk mengembalikan informasi tentang instans SQL Server saat ini.
SELECT
SERVERPROPERTY('MachineName') AS ComputerName,
SERVERPROPERTY('ServerName') AS InstanceName,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel;
GO
Konten terkait
Untuk daftar fitur yang didukung oleh edisi SQL Server di Windows, lihat:
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk