Bagikan melalui


SERVERPROPERTY (Transact-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistem Platform Analitik (PDW)Titik akhir analitik SQL di Microsoft FabricGudang di Microsoft FabricDatabase SQL di Microsoft Fabric

Mengembalikan informasi properti tentang instans server.

Konvensi sintaks transact-SQL

Note

ID Microsoft Entra sebelumnya dikenal sebagai Azure Active Directory (Azure AD).

Syntax

SERVERPROPERTY ( 'propertyname' )

Important

Nomor versi Mesin Database untuk SQL Server dan Azure SQL Database dan Microsoft Fabric 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.

Arguments

propertyname

Ekspresi yang berisi informasi properti yang akan dikembalikan untuk server. propertyname bisa menjadi salah satu nilai berikut. Penggunaan nama properti yang tidak valid atau tidak didukung pada versi Mesin Database tersebut mengembalikan NULL.

Property 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 MachineName properti .

Nota: Jika instans SQL Server berada dalam kluster failover dan Anda ingin mendapatkan nama instans terkluster failover, gunakan MachineName properti .

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 .

Gunakan tabel Edisi berikut untuk mengidentifikasi kemungkinan nilai.

Jenis data dasar: nvarchar(128)
EditionID Mewakili ID 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.

Gunakan tabel Edisi berikut untuk mengidentifikasi kemungkinan nilai.

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 Standar, Pengembang Standar, Web, dan Kecerdasan Bisnis.)
3 = Perusahaan (Untuk edisi Enterprise, Enterprise Developer, Developer, dan Evaluation.)
4 = Ekspres (Untuk Ekspres, Ekspres dengan Alat, dan Ekspres dengan Layanan Tingkat Lanjut)
5 = Database SQL
6 = Azure Synapse Analytics
8 = Instans Terkelola Azure SQL
9 = Azure SQL Edge (Untuk semua edisi Azure SQL Edge)
11 = Kumpulan SQL tanpa server Azure Synapse, atau Microsoft Fabric
12 = Database Microsoft Fabric SQL di Microsoft Fabric.

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 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 Nama jalur default ke file cadangan instans.

Berlaku untuk: SQL Server 2019 (15.x) dan versi yang lebih baru.

Jenis data dasar: nvarchar(128)
InstanceDefaultDataPath Nama jalur default ke file data instans.

Berlaku untuk: SQL Server.

Jenis data dasar: nvarchar(128)
InstanceDefaultLogPath Nama jalur default ke file log instans.

Berlaku untuk: SQL Server.

Jenis data dasar: nvarchar(128)
InstanceName Nama instans tempat pengguna terhubung.

Mengembalikan jika nama instans adalah instans NULL 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 Mengembalikan apakah autentikasi Microsoft Entra-only diaktifkan.

1 = Autentikasi khusus Microsoft Entra diaktifkan.
0 = Autentikasi khusus Microsoft Entra dinonaktifkan.

Berlaku untuk: Azure SQL Database dan Azure SQL Managed Instance.

Jenis data dasar: int
IsExternalGovernanceEnabled Mengembalikan apakah kebijakan akses Microsoft Purview diaktifkan.

1 = Tata kelola eksternal diaktifkan.
0 = Tata kelola eksternal dinonaktifkan.

Berlaku untuk: SQL Server 2022 (16.x) dan versi yang lebih baru.

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

Agar replika ketersediaan dibuat dan dijalankan pada instans SQL Server, grup ketersediaan AlwaysOn harus diaktifkan pada instans server. Untuk informasi selengkapnya, lihat Mengaktifkan atau menonaktifkan fitur grup ketersediaan AlwaysOn.

Nota:IsHadrEnabled Properti 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.

Berlaku untuk: SQL Server.

Jenis data dasar: int
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 Server adalah instans SQL Server Express LocalDB.

NULL = Input tidak valid, kesalahan, atau tidak berlaku.

Berlaku untuk: SQL Server.

Jenis data dasar: int
IsPolyBaseInstalled Mengembalikan apakah instans server telah menginstal fitur PolyBase.

0 = PolyBase tidak diinstal.
1 = PolyBase diinstal.

Berlaku untuk: SQL Server 2016 (13.x) dan versi yang lebih baru.

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

Berlaku untuk: SQL Server 2019 (15.x) dan versi yang lebih baru.

Jenis data dasar: int
IsXTPSupported 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.

Berlaku untuk: SQL Server 2014 (12.x) dan versi yang lebih baru, dan Azure SQL Database.

Jenis data dasar: int
LCID Pengidentifikasi lokal Windows (LCID) dari kolaborasi.

Jenis data dasar: int
LicenseType Unused. 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 Unused. Informasi lisensi tidak dipertahankan atau dikelola oleh produk SQL Server. Selalu mengembalikan NULL.

Jenis data dasar: int
PathSeparator Mengembalikan \ pada Windows dan / di Linux

Berlaku untuk: SQL Server 2017 (14.x) dan versi yang lebih baru.

Jenis 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 Nomor build.

Berlaku untuk: SQL Server 2014 (12.x) dan versi yang lebih baru.

Jenis data dasar: nvarchar(128)
ProductBuildType 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.

Berlaku untuk: SQL Server.

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 Versi utama.

Berlaku untuk: SQL Server.

Jenis data dasar: nvarchar(128)
ProductMinorVersion Versi minor.

Berlaku untuk: SQL Server.

Jenis data dasar: nvarchar(128)
ProductUpdateLevel Perbarui tingkat build saat ini. CU menunjukkan pembaruan kumulatif.

Mengembalikan salah satu nilai berikut:

CUn = Pembaruan Kumulatif
NULL = Tidak berlaku.

Berlaku untuk: SQL Server dan Azure SQL Managed Instance.

Jenis data dasar: nvarchar(128)
ProductUpdateReference Artikel KB untuk rilis tersebut.

Berlaku untuk: SQL Server.

Jenis data dasar: nvarchar(128)
ProductUpdateType Perbarui irama yang diikuti instans. Sesuai dengan kebijakan pembaruan Azure SQL Managed Instance.

Mengembalikan salah satu nilai berikut:

CU = Pembaruan disebarkan melalui pembaruan kumulatif (CUs) untuk rilis SQL Server utama yang sesuai (kebijakan pembaruan SQL Server 2022 ).

Berkelanjutan = Fitur baru dibawa ke Azure SQL Managed Instance segera setelah tersedia, terlepas dari irama rilis SQL Server (Kebijakan pembaruan always-up-to-date ).

Berlaku untuk: Azure SQL Managed Instance.

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

Tabel berikut ini mencantumkan nilai yang mungkin untuk EditionID dan Edition.

EditionID Edisi
1804890536 Enterprise
1872460670 Edisi Perusahaan: Lisensi berbasis inti
610778273 Evaluasi Perusahaan
284895786 Inteligensi Bisnis
-2117995310 Pengembang 1, atau Pengembang Enterprise 2
-2509700633 Standar Pengembang 2
-1592396055 Ekspres
-133711905 Ekspres dengan Layanan Lanjutan
-1534726760 Standar
1293598313 Situs web 1
1674378470 SQL Database atau Azure Synapse Analytics
-1461570097 Pengembang Azure SQL Edge 3
1994083197 Azure SQL Edge 4

1Berlaku untuk: SQL Server 2022 (16.x) dan versi yang lebih lama.
2Berlaku untuk: SQL Server 2025 (17.x) dan versi yang lebih baru.
3 Menunjukkan hanya edisi pengembangan untuk Azure SQL Edge.
4 Menunjukkan edisi berbayar untuk Azure SQL Edge.

Tipe pengembalian

sql_variant

Remarks

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:

EXECUTE sp_dropserver 'current_server_name';
GO

EXECUTE 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. Pada versi utama sebelumnya, versi tersebut 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 .

Permissions

Semua pengguna dapat mengkueri properti server.

Examples

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