Aracılığıyla paylaş


sp_configure (Transact-SQL)

Şunlar için geçerlidir:SQL ServerAzure SQL Yönetilen ÖrneğiAnalytics Platform Sistemi (PDW)

Geçerli sunucu için genel yapılandırma ayarlarını görüntüler veya değiştirir.

Uyarı

Veritabanı düzeyinde yapılandırma seçenekleri için bkz. ALTER DATABASE SCOPED CONFIGURATION. Geçici NUMA'yı yapılandırmak için bkz. Soft-NUMA (SQL Server).

Transact-SQL söz dizimi kuralları

Sözdizimi

SQL Server için söz dizimi.

sp_configure
    [ [ @configname = ] 'configname' ]
    [ , [ @configvalue = ] configvalue ]
[ ; ]

Analiz Platformu Sistemi (PDW) söz dizimi.

sp_configure
[ ; ]

Arguments

[ @configname = ] 'configname'

Yapılandırma seçeneğinin adı. @configname , varsayılan değeri olan varchar(35)'dir NULL. SQL Server Veritabanı Altyapısı, yapılandırma adının parçası olan tüm benzersiz dizeleri tanır. Belirtilmezse, seçeneklerin tam listesi döndürülür.

Kullanılabilir yapılandırma seçenekleri ve ayarları hakkında bilgi için bkz . Sunucu yapılandırma seçenekleri.

[ @configvalue = ] configvalue

Yeni yapılandırma ayarı. @configvalue, varsayılan değeri olan int'tirNULL.

Maksimum değer, tek tek seçeneğe bağlıdır. Her seçeneğin en yüksek değerini görmek için katalog görünümünün maximum sütununa sys.configurations bakın.

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Sonuç kümesi

Parametre olmadan yürütürken, sp_configure beş sütunlu bir sonuç kümesi döndürür ve aşağıdaki tabloda gösterildiği gibi seçenekleri alfabetik olarak artan sırada sıralar.

ve config_value değerleri run_value otomatik olarak eşdeğer değildir. kullanarak bir yapılandırma ayarını sp_configuregüncelleştirdikten sonra veya RECONFIGUREkullanarak RECONFIGURE WITH OVERRIDE çalışan yapılandırma değerini de güncelleştirmeniz gerekir. Daha fazla bilgi için Açıklamalar bölümüne bakın.

Sütun adı Veri türü Description
name nvarchar(35) Yapılandırma seçeneğinin adı.
minimum Int Yapılandırma seçeneğinin en düşük değeri.
maximum Int Yapılandırma seçeneğinin en yüksek değeri.
config_value Int Yapılandırma seçeneğinin kullanılarak sp_configure ayarlandığı değer (içindeki sys.configurations.valuedeğer).

Bu seçenekler hakkında daha fazla bilgi için bkz . Sunucu yapılandırma seçenekleri ve sys.configurations.
run_value Int Şu anda yapılandırma seçeneğinin değeri çalışıyor (içindeki sys.configurations.value_in_usedeğer).

Daha fazla bilgi için bkz. sys.configurations.

Açıklamalar

Sunucu düzeyi ayarlarını görüntülemek veya değiştirmek için kullanın sp_configure . Veritabanı düzeyi ayarlarını değiştirmek için kullanın ALTER DATABASE. Yalnızca geçerli kullanıcı oturumunu etkileyen ayarları değiştirmek için deyimini SET kullanın.

Bazı sunucu yapılandırma seçenekleri yalnızca ALTER SERVER CONFIGURATION aracılığıyla kullanılabilir.

Çalışan yapılandırma değerini güncelleştirme

bir @configname için yeni bir @configvalue belirttiğinizde sonuç kümesi bu değeri sütunda config_value gösterir. Bu değer başlangıçta şu anda çalışan yapılandırma değerini gösteren sütundaki run_value değerden farklıdır. Sütunda run_value çalışan yapılandırma değerini güncelleştirmek için sistem yöneticisinin veya RECONFIGUREkomutunu çalıştırması RECONFIGURE WITH OVERRIDE gerekir.

Her ikisini de RECONFIGURE yapın ve RECONFIGURE WITH OVERRIDE her yapılandırma seçeneğiyle çalışın. Ancak, temel RECONFIGURE deyimi makul bir aralığın dışında olan veya seçenekler arasında çakışmalara neden olabilecek tüm seçenek değerlerini reddeder. Örneğin, RECONFIGUREkurtarma aralığı değeri 60 dakikadan büyükse veya benşim maskesi değeri benşimG/Ç maske değeriyle çakışıyorsa bir hata oluşturur. RECONFIGURE WITH OVERRIDE, buna karşılık, doğru veri türüne sahip herhangi bir seçenek değerini kabul eder ve belirtilen değerle yeniden yapılandırmayı zorlar.

Dikkat

Uygunsuz bir seçenek değeri, sunucu örneğinin yapılandırmasını olumsuz etkileyebilir. Dikkatli kullanın RECONFIGURE WITH OVERRIDE .

deyimi RECONFIGURE bazı seçenekleri dinamik olarak güncelleştirir; diğer seçenekler için sunucunun durdurulması ve yeniden başlatılması gerekir. Örneğin, en düşük sunucu belleği ve en fazla sunucu belleği sunucusu bellek seçenekleri Veritabanı Altyapısı'nda dinamik olarak güncelleştirilir. Bu nedenle, sunucuyu yeniden başlatmadan bunları değiştirebilirsiniz. Buna karşılık, doldurma faktörü seçeneğinin çalışan değerini yeniden yapılandırmak için Veritabanı Altyapısı'nın yeniden başlatılması gerekir.

Bir yapılandırma seçeneği üzerinde çalıştırdıktan RECONFIGURE sonra, komutunu yürüterek sp_configure '<configname>'seçeneğin dinamik olarak güncelleştirilip güncelleştirilmediğini görebilirsiniz. dinamik olarak güncelleştirilen bir seçenek için ve run_value sütunlarındaki config_value değerler eşleşmelidir. Ayrıca katalog görünümünün sütununa is_dynamic bakarak hangi seçeneklerin sys.configurations dinamik olduğunu kontrol edebilirsiniz.

Değişiklik, SQL Server hata günlüğüne de yazılır.

Belirtilen bir @configvalue bir seçenek için çok yüksekse, run_value sütun Veritabanı Altyapısı'nın geçerli olmayan bir ayar kullanmak yerine varsayılan olarak dinamik belleğe ayarlandığını yansıtır.

Daha fazla bilgi için bkz. RECONFIGURE.

Gelişmiş seçenekler

Benzinim maskesi ve kurtarma aralığı gibi bazı yapılandırma seçenekleri gelişmiş seçenekler olarak belirlenir. Varsayılan olarak, bu seçenekler görüntüleme ve değiştirme için kullanılamaz. Bunları kullanılabilir hale getirmek için gelişmiş seçenekleri göster yapılandırma seçeneğini olarak 1ayarlayın.

Dikkat

Gelişmiş seçenekleri göster seçeneği olarak ayarlandığında1, bu ayar tüm kullanıcılar için geçerlidir. Bu durumun yalnızca geçici olarak kullanılması ve gelişmiş seçeneklerin görüntülenmesini 0 gerektiren görevle işiniz bittiğinde bu duruma geri dönmeniz önerilir.

Yapılandırma seçenekleri ve ayarları hakkında daha fazla bilgi için bkz . Sunucu yapılandırma seçenekleri.

Permissions

Üzerinde parametre olmadan veya yalnızca ilk parametreyle yürütme izinleri sp_configure varsayılan olarak tüm kullanıcılara verilir. Yapılandırma seçeneğini değiştirmek veya deyimini çalıştırmak için her iki parametreyle de yürütmek sp_configureRECONFIGURE için sunucu düzeyinde izin verilmelidir ALTER SETTINGS . İzin ALTER SETTINGS , sysadmin ve serveradmin sabit sunucu rolleri tarafından örtük olarak tutulur.

Örnekler

A. Gelişmiş yapılandırma seçeneklerini listeleme

Aşağıdaki örnekte tüm yapılandırma seçeneklerinin nasıl ayarlanacağı ve listelanacağı gösterilmektedir. gelişmiş yapılandırma seçeneklerini ilk olarak ayarlayarak show advanced options1görüntüleyebilirsiniz. Bu seçenek değiştikten sonra, parametresiz yürüterek sp_configure tüm yapılandırma seçeneklerini görüntüleyebilirsiniz.

USE master;
GO

EXECUTE sp_configure 'show advanced options', '1';

Sonuç kümesi aşağıdadır.

Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.

Tüm yapılandırma seçeneklerini çalıştırın RECONFIGURE ve gösterin:

RECONFIGURE;

EXECUTE sp_configure;

B. Yapılandırma seçeneğini değiştirme

Aşağıdaki örnek, sistem recovery interval yapılandırma seçeneğini dakika olarak 3 ayarlar.

USE master;
GO

EXECUTE sp_configure 'recovery interval', '3';

RECONFIGURE WITH OVERRIDE;

Örnekler: Analiz Platformu Sistemi (PDW)

C. Tüm kullanılabilir yapılandırma ayarlarını listeleme

Aşağıdaki örnekte tüm yapılandırma seçeneklerinin nasıl listelenmiştir.

EXECUTE sp_configure;

Sonuç, seçenek adını ve ardından seçenek için en düşük ve en yüksek değerleri döndürür. config_value, Azure Synapse Analytics'in yeniden yapılandırma tamamlandığında kullandığı değerdir. run_value, şu anda kullanılmakta olan değerdir. config_value değeri değiştirilme sürecinde olmadığı sürece ve run_value genellikle aynıdır.

D. Bir yapılandırma adı için yapılandırma ayarlarını listeleme

EXECUTE sp_configure @configname = 'hadoop connectivity';

E. Hadoop bağlantısını ayarlama

Hadoop bağlantısını ayarlamak için çalıştırmaya sp_configureek olarak birkaç adım daha gerekir. Yordamın tamamı için bkz. EXTERNAL DATA SOURCE OLUŞTURMA.

sp_configure [ @configname = ] 'hadoop connectivity',
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[ ; ]
RECONFIGURE;
[ ; ]