Aracılığıyla paylaş


SERVERPROPERTY (Transact-SQL)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsAnaliz Platformu Sistemi (PDW)Microsoft Fabric'teki SQL analiz uç noktasıMicrosoft Fabric'teki ambarMicrosoft Fabric'teki SQL veritabanı

Sunucu örneği hakkındaki özellik bilgilerini döndürür.

Transact-SQL söz dizimi kuralları

Note

Microsoft Entra Id daha önce Azure Active Directory (Azure AD) olarak biliniyordu.

Syntax

SERVERPROPERTY ( 'propertyname' )

Important

SQL Server ve Azure SQL Veritabanı ile Microsoft Fabric için Veritabanı Altyapısı sürüm numaraları birbiriyle karşılaştırılamaz ve bu ayrı ürünlerin iç derleme numaralarını temsil edebilir. Azure SQL Veritabanı için Veritabanı Altyapısı, SQL Server Veritabanı Altyapısı ile aynı kod tabanını temel alır. En önemlisi, Azure SQL Veritabanı'ndaki Veritabanı Motoru her zaman en yeni SQL Veritabanı Motoru bitlerine sahiptir. Örneğin, Azure SQL Veritabanı'nın 12. sürümü SQL Server'ın 16. sürümünden daha yenidir.

Arguments

propertyname

Sunucu için döndürülecek özellik bilgilerini içeren bir ifade. propertyname aşağıdaki değerlerden biri olabilir. Veritabanı Altyapısı'nın bu sürümünde geçersiz veya desteklenmeyen bir özellik adının kullanılması döndürür NULL.

Property Döndürülen değerler
BuildClrVersion SQL Server örneğini oluştururken kullanılan Microsoft .NET Framework ortak dil çalışma zamanının (CLR) sürümü.

NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: nvarchar(128)
Collation Sunucu için varsayılan harmanlamanın adı.

NULL = Giriş geçerli değil veya bir hata.

Temel veri türü: nvarchar(128)
CollationID SQL Server harmanlamasının kimliği.

Temel veri türü: int
ComparisonStyle Harmanlamanın Windows karşılaştırma stili.

Temel veri türü: int
ComputerNamePhysicalNetBIOS SQL Server örneğinin çalışmakta olduğu yerel bilgisayarın NetBIOS adı.

Bir yük devretme kümesinde SQL Server'ın kümelenmiş örneği için, SQL Server örneği yük devretme kümesindeki diğer düğümlere yük devredildikçe bu değer değişir.

SQL Server'ın tek başına bir örneğinde bu değer sabit kalır ve özelliğiyle MachineName aynı değeri döndürür.

Not: SQL Server örneği bir yük devretme kümesindeyse ve yük devretme kümelenmiş örneğinin adını almak istiyorsanız özelliğini kullanın MachineName .

NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: nvarchar(128)
Edition SQL Server örneğinin yüklü ürün sürümü. SQL Server sürümüne göre işlem kapasitesi sınırları gibi özellikleri ve sınırları belirlemek için bu özelliğin değerini kullanın. Veritabanı Altyapısı'nın 64 bit sürümleri sürüme (64 bit) eklenir.

Olası değerleri belirlemek için aşağıdaki Sürüm tablosunu kullanın.

Temel veri türü: nvarchar(128)
EditionID SQL Server örneğinin yüklü ürün sürümünün kimliğini temsil eder. SQL Server sürümüne göre işlem kapasitesi sınırları gibi özellikleri ve sınırları belirlemek için bu özelliğin değerini kullanın.

Olası değerleri belirlemek için aşağıdaki Sürüm tablosunu kullanın.

Temel veri türü: bigint
EngineEdition Sunucuda yüklü SQL Server örneğinin Veritabanı Altyapısı sürümü.

1 = Kişisel veya Masaüstü Altyapısı (SQL Server 2005 (9.x) ve sonraki sürümlerde kullanılamaz.)
2 = Standart (Standart, Standart Geliştirici, Web ve İş Zekası için.)
3 = Kurumsal (Kurumsal, Kurumsal Geliştirici, Geliştirici ve Değerlendirme sürümleri için.)
4 = Express (Express, Araçlarla Express ve Gelişmiş Hizmetler ile Express için)
5 = SQL Veritabanı
6 = Azure Synapse Analytics
8 = Azure SQL Yönetilen Örneği
9 = Azure SQL Edge (Azure SQL Edge'in tüm sürümleri için)
11 = Azure Synapse sunucusuz SQL havuzu veya Microsoft Fabric
12 = Microsoft Fabric SQL veritabanı Microsoft Fabric.

Temel veri türü: int
FilestreamConfiguredLevel Yapılandırılmış FILESTREAM erişimi düzeyi. Daha fazla bilgi için bkz. dosya akışı erişim düzeyi.

0 = FILESTREAM devre dışı
1 = Transact-SQL erişim için FILESTREAM etkinleştirildi
2 = FILESTREAM Transact-SQL ve yerel Win32 akış erişimi için etkinleştirildi
3 = FILESTREAM, Transact-SQL ve hem yerel hem de uzak Win32 akış erişimi için etkinleştirilir.

Temel veri türü: int
FilestreamEffectiveLevel FILESTREAM erişiminin etkili düzeyi. Düzey değiştiyse ve örnek yeniden başlatma veya bilgisayar yeniden başlatma bekleniyorsa bu değer FilestreamConfiguredLevel değerinden farklı olabilir. Daha fazla bilgi için bkz. dosya akışı erişim düzeyi.

0 = FILESTREAM devre dışı
1 = Transact-SQL erişim için FILESTREAM etkinleştirildi
2 = FILESTREAM Transact-SQL ve yerel Win32 akış erişimi için etkinleştirildi
3 = FILESTREAM, Transact-SQL ve hem yerel hem de uzak Win32 akış erişimi için etkinleştirilir.

Temel veri türü: int
FilestreamShareName FILESTREAM tarafından kullanılan paylaşımın adı.

NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: nvarchar(128)
HadrManagerStatus Always On kullanılabilirlik grupları yöneticisinin başlatılıp başlatılmadığını gösterir.

0 = Başlatılmadi, iletişim bekleniyor.
1 = Başlatıldı ve çalışıyor.
2 = Başlatılmadi ve başarısız oldu.
NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: int
InstanceDefaultBackupPath Örnek yedekleme dosyalarının varsayılan yolunun adı.

için geçerlidir: SQL Server 2019 (15.x) ve sonraki sürümler.

Temel veri türü: nvarchar(128)
InstanceDefaultDataPath Örnek veri dosyalarının varsayılan yolunun adı.

Şunlar için geçerlidir: SQL Server.

Temel veri türü: nvarchar(128)
InstanceDefaultLogPath Örnek günlük dosyalarının varsayılan yolunun adı.

Şunlar için geçerlidir: SQL Server.

Temel veri türü: nvarchar(128)
InstanceName Kullanıcının bağlı olduğu örneğin adı.

Örnek adı varsayılan örnekse, giriş geçerli değilse veya hataysa döndürür NULL .

NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: nvarchar(128)
IsAdvancedAnalyticsInstalled Gelişmiş Analiz özelliği kurulum sırasında yüklendiyse 1 döndürür; Advanced Analytics yüklü değilse 0.

Temel veri türü: int
IsBigDataCluster CU 4 ile başlayan SQL Server 2019 (15.x) sürümünde kullanıma sunulmuştur.

Örnek SQL Server Büyük Veri Kümesi ise 1 döndürür; 0 değilse.

Temel veri türü: int
IsClustered Sunucu örneği bir yük devretme kümesinde yapılandırılır.

1 = Kümelenmiş.
0 = Kümelenmedi.
NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: int
IsExternalAuthenticationOnly Microsoft Entra-only kimlik doğrulamasının etkinleştirilip etkinleştirilmediğini döndürür.

1 = Microsoft Entra-only kimlik doğrulaması etkinleştirildi.
0 = Microsoft Entra-only kimlik doğrulaması devre dışı bırakıldı.

Şunlar için geçerlidir: Azure SQL Veritabanı ve Azure SQL Yönetilen Örneği.

Temel veri türü: int
IsExternalGovernanceEnabled Microsoft Purview erişim ilkelerinin etkinleştirilip etkinleştirilmediğini döndürür.

1 = Dış idare etkinleştirildi.
0 = Dış idare devre dışı bırakıldı.

Şunlar için geçerlidir: SQL Server 2022 (16.x) ve sonraki sürümleri.

Temel veri türü: int
IsFullTextInstalled Tam metin ve anlamsal dizin oluşturma bileşenleri geçerli SQL Server örneğine yüklenir.

1 = Tam metin ve anlamsal dizin oluşturma bileşenleri yüklenir.
0 = Tam metin ve anlamsal dizin oluşturma bileşenleri yüklenmez.
NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: int
IsHadrEnabled Always On kullanılabilirlik grupları bu sunucu örneğinde etkindir.

0 = AlwaysOn kullanılabilirlik grupları özelliği devre dışı bırakıldı.
1 = AlwaysOn kullanılabilirlik grupları özelliği etkinleştirilir.
NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Kullanılabilirlik çoğaltmalarının bir SQL Server örneğinde oluşturulup çalıştırılması için, sunucu örneğinde Always On kullanılabilirlik gruplarının etkinleştirilmesi gerekir. Daha fazla bilgi için bkz . Always On kullanılabilirlik grubu özelliğini etkinleştirme veya devre dışı bırakma.

Not:IsHadrEnabled Özelliği yalnızca Always On kullanılabilirlik gruplarıyla ilgili. Veritabanı yansıtma veya günlük gönderimi gibi diğer yüksek kullanılabilirlik veya olağanüstü durum kurtarma özellikleri bu sunucu özelliğinden etkilenmez.

Şunlar için geçerlidir: SQL Server.

Temel veri türü: int
IsIntegratedSecurityOnly Sunucu tümleşik güvenlik modunda.

1 = Tümleşik güvenlik (Windows Kimlik Doğrulaması)
0 = Tümleşik güvenlik değil. (Hem Windows Kimlik Doğrulaması hem de SQL Server Kimlik Doğrulaması.)
NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: int
IsLocalDB Server, SQL Server Express LocalDB'nin bir örneğidir.

NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Şunlar için geçerlidir: SQL Server.

Temel veri türü: int
IsPolyBaseInstalled Sunucu örneğinde PolyBase özelliğinin yüklü olup olmadığını döndürür.

0 = PolyBase yüklü değil.
1 = PolyBase yüklü.

Şunlar için geçerlidir: SQL Server 2016 (13.x) ve sonraki sürümleri.

Temel veri türü: int
IsServerSuspendedForSnapshotBackup Sunucu askıya alma modundadır ve sunucu düzeyinde çözme gerektirir.

1 = Askıya alındı.
0 = Askıya alınmaz.

Temel veri türü: int
IsSingleUser Sunucu tek kullanıcı modunda.

1 = Tek kullanıcı.
0 = Tek kullanıcı değil
NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: int
IsTempDbMetadataMemoryOptimized Meta veriler için bellek için iyileştirilmiş tabloları kullanmak üzere etkinleştirildiyse tempdb 1, meta veriler için normal, disk tabanlı tablolar kullanılıyorsa tempdb 0 döndürür. Daha fazla bilgi için bkz. tempdb Veritabanı.

için geçerlidir: SQL Server 2019 (15.x) ve sonraki sürümler.

Temel veri türü: int
IsXTPSupported Sunucu In-Memory OLTP'leri destekler.

1 = Sunucu In-Memory OLTP'leri destekler.
0 = Sunucu In-Memory OLTP'In-Memory desteklemez.
NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Şunlar için geçerlidir: SQL Server 2014 (12.x) ve sonraki sürümleri ve Azure SQL Veritabanı.

Temel veri türü: int
LCID Harmanlamanın Windows yerel ayar tanımlayıcısı (LCID).

Temel veri türü: int
LicenseType Unused. Lisans bilgileri SQL Server ürünü tarafından korunmaz veya korunmaz. Her zaman DISABLED döndürür.

Temel veri türü: nvarchar(128)
MachineName Sunucu örneğinin çalıştığı Windows bilgisayar adı.

Microsoft Küme Hizmeti'nin sanal sunucusunda çalışan bir SQL Server örneği olan kümelenmiş örnek için, sanal sunucunun adını döndürür.

NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: nvarchar(128)
NumLicenses Unused. Lisans bilgileri SQL Server ürünü tarafından korunmaz veya korunmaz. Her zaman NULL döndürür.

Temel veri türü: int
PathSeparator Windows ve \ Linux üzerinde döndürür /

Şunlar için geçerlidir: SQL Server 2017 (14.x) ve sonraki sürümler.

Temel veri türü: nvarchar
ProcessID SQL Server hizmetinin işlem kimliği. ProcessID, hangi Sqlservr.exe bu örneğe ait olduğunu belirlemede yararlıdır.

NULL = Giriş geçerli değil, bir hata veya geçerli değil.

Temel veri türü: int
ProductBuild Derleme numarası.

Şunlar için geçerlidir: SQL Server 2014 (12.x) ve sonraki sürümler.

Temel veri türü: nvarchar(128)
ProductBuildType Geçerli derlemenin derleme türü.

Aşağıdaki değerlerden birini döndürür:

OD = İsteğe Bağlı belirli bir müşteriyi serbest bırakır.
GDR = Windows Update aracılığıyla yayımlanan Genel Dağıtım Sürümü.
NULL = Geçerli değil.

Şunlar için geçerlidir: SQL Server.

Temel veri türü: nvarchar(128)
ProductLevel SQL Server örneğinin sürümünün düzeyi.

Aşağıdaki değerlerden birini döndürür:

'RTM' = Özgün sürüm
'SPn' = Hizmet paketi sürümü
'CTPn', = Community Technology Preview sürümü.

Temel veri türü: nvarchar(128)
ProductMajorVersion Ana sürüm.

Şunlar için geçerlidir: SQL Server.

Temel veri türü: nvarchar(128)
ProductMinorVersion İkincil sürüm.

Şunlar için geçerlidir: SQL Server.

Temel veri türü: nvarchar(128)
ProductUpdateLevel Geçerli derlemenin düzeyini güncelleştirin. CU toplu güncelleştirmeyi gösterir.

Aşağıdaki değerlerden birini döndürür:

CUn = Toplu Güncelleştirme
NULL = Geçerli değil.

Şunlar için geçerlidir: SQL Server ve Azure SQL Yönetilen Örneği.

Temel veri türü: nvarchar(128)
ProductUpdateReference Bu sürüm için KB makalesi.

Şunlar için geçerlidir: SQL Server.

Temel veri türü: nvarchar(128)
ProductUpdateType Örneğin izlediği tempoyu güncelleştirin. Azure SQL Yönetilen Örneği güncelleştirme ilkesine karşılık gelir.

Aşağıdaki değerlerden birini döndürür:

CU = Güncelleştirmeler, ilgili ana SQL Server sürümü (SQL Server 2022 güncelleştirme ilkesi) için toplu güncelleştirmeler (CU) aracılığıyla dağıtılır.

Sürekli = Yeni özellikler, SQL Server sürüm temposunun (Always-up-to-date güncelleştirme ilkesi) bağımsız olarak kullanıma sunuldukları anda Azure SQL Yönetilen Örneği'ne getirilir.

Şunlar için geçerlidir: Azure SQL Yönetilen Örneği.

Temel veri türü: nvarchar(128)
ProductVersion SQL Server örneğinin major.minor.build.revision biçimindeki sürümü.

Temel veri türü: nvarchar(128)
ResourceLastUpdateDateTime Kaynak veritabanının son güncelleştirilmiş olduğu tarih ve saati döndürür.

Temel veri türü: datetime
ResourceVersion Kaynak veritabanı sürümünü döndürür.

Temel veri türü: nvarchar(128)
ServerName Belirtilen bir örnekle ilişkili hem Windows sunucusu hem de örnek bilgileri.

NULL = Giriş geçerli değil veya bir hata.

Temel veri türü: nvarchar(128)
SqlCharSet Harmanlama kimliğinden SQL karakter kümesi kimliği.

Temel veri türü: tinyint
SqlCharSetName Harmanlamadan SQL karakter kümesi adı.

Temel veri türü: nvarchar(128)
SqlSortOrder Harmanlamadan SQL sıralama düzeni kimliği.

Temel veri türü: tinyint
SqlSortOrderName Harmanlamadan SQL sıralama düzeni adı.

Temel veri türü: nvarchar(128)
SuspendedDatabaseCount Sunucudaki askıya alınan veritabanlarının sayısı.

Temel veri türü: int

Aşağıdaki tabloda ve EditionIDiçin Edition olası değerler listelemektedir.

EditionID Edition
1804890536 Enterprise
1872460670 Enterprise Edition: Çekirdek Tabanlı Lisanslama
610778273 Kurumsal Değerlendirme
284895786 İş Zekası
-2117995310 Geliştirici 1 veya Developer Enterprise 2
-2509700633 Geliştirici Standardı 2
-1592396055 Express
-133711905 Gelişmiş Hizmetler ile Express
-1534726760 Standart
1293598313 Web 1
1674378470 SQL Veritabanı veya Azure Synapse Analytics
-1461570097 Azure SQL Edge Geliştirici 3
1994083197 Azure SQL Edge 4

1Şunlar için geçerlidir: SQL Server 2022 (16.x) ve önceki sürümler.
2 SQL Server 2025 (17.x) ve sonraki sürümler için geçerlidir.
3 Azure SQL Edge için yalnızca geliştirme sürümünü gösterir.
4 Azure SQL Edge için ücretli sürümü gösterir.

Dönüş türleri

sql_variant

Remarks

ServerName özelliği

ServerName işlevinin SERVERPROPERTY özelliği ve @@SERVERNAME benzer bilgiler döndürür. özelliği, ServerName benzersiz sunucu örneğini oluşturan Windows sunucusu ve örnek adını sağlar. @@SERVERNAME , şu anda yapılandırılmış olan yerel sunucu adını sağlar.

ServerName Özellik ve @@SERVERNAME, yükleme sırasında varsayılan sunucu adı değiştirilmediyse aynı bilgileri döndürür. Yerel sunucu adı aşağıdakiler yürütülerek yapılandırılabilir:

EXECUTE sp_dropserver 'current_server_name';
GO

EXECUTE sp_addserver 'new_server_name', 'local';
GO

Yükleme sırasında yerel sunucu adı varsayılan sunucu adından değiştirildiyse , @@SERVERNAME yeni adı döndürür.

ServerName İşlevin SERVERPROPERTY özelliği, kaydedilirken Windows sunucu adını döndürür. Önceki ana sürümlerde büyük harf döndürdü. Bu davranış, SQL Server 2019 (15.x) CU 9 ile CU 12 arasında yeniden büyük harfe döndü, ancak SQL Server 2019 (15.x) CU 13'ten başlayarak sunucu adı kaydedildikçe döndürülüyor.

Windows sunucu adında küçük harfler varsa, bu davranış değişikliği, sunucu için ad değişikliği olmasa bile işlevin ServerName özelliği ile SERVERPROPERTY (büyük ve küçük harf) arasında farklara neden olabilir.

adlı server01bir sunucunuz olduğunu ve sql server örneğinin adlı olduğunu INST1düşünün. Aşağıdaki tabloda, SQL Server 2019'un (15.x) farklı derlemeleri arasındaki davranış değişikliği özetlenmiştir:

SQL Server 2019 (15.x) sürümü SERVERPROPERTY('ServerName') Ek bilgiler
RTM SERVER01\INST1 ServerName Özelliği büyük harfle verir
CU 1 – CU 8 server01\INST1 ServerName Özelliği büyük harfe değiştirmeden olduğu gibi döndürür
CU 9 – CU 12 SERVER01\INST1 ServerName Özelliği büyük harfle verir
CU 13 ve sonraki sürümleri server01\INST1 büyük harfe ServerName değiştirmeden as-isözelliğini döndürür.

Sürüm özellikleri

İşlev, SERVERPROPERTY sürüm bilgileriyle ilişkili tek tek özellikleri döndürürken , @@VERSION işlevi çıkışı tek bir dizede birleştirir. Uygulamanız tek tek özellik dizeleri gerektiriyorsa, SERVERPROPERTY sonuçlarını ayrıştırmak yerine bunları döndürmek için işlevini kullanabilirsiniz.

Permissions

Tüm kullanıcılar sunucu özelliklerini sorgulayabilir.

Examples

Aşağıdaki örnek, geçerli SQL Server örneği hakkında bilgi döndürmek için deyimindeki SERVERPROPERTY işlevini kullanırSELECT.

SELECT SERVERPROPERTY('MachineName') AS ComputerName,
       SERVERPROPERTY('ServerName') AS InstanceName,
       SERVERPROPERTY('Edition') AS Edition,
       SERVERPROPERTY('ProductVersion') AS ProductVersion,
       SERVERPROPERTY('ProductLevel') AS ProductLevel;
GO