sp_configure (T-SQL)
Berlaku untuk: 
SQL Server Azure SQL Managed Instance
Azure Synapse Analytics Analytics Platform System (PDW)
Menampilkan atau mengubah pengaturan konfigurasi global untuk server saat ini.
Catatan
Untuk opsi konfigurasi tingkat database, lihat MENGUBAH KONFIGURASI CAKUPAN DATABASE. Untuk mengonfigurasi Soft-NUMA, lihat Soft-NUMA (SQL Server).
Sintaks
Sintaks untuk SQL Server.
sp_configure
[ [ @configname = ] 'configname' ]
[ , [ @configvalue = ] configvalue ]
[ ; ]
Sintaks untuk Analytics Platform System (PDW).
sp_configure
[ ; ]
Argumen
[ @configname = ] 'configname'
Nama opsi konfigurasi. @configname adalah varchar(35), dengan default NULL. Mesin Database SQL Server mengenali string unik apa pun yang merupakan bagian dari nama konfigurasi. Jika tidak ditentukan, daftar lengkap opsi dikembalikan.
Untuk informasi tentang opsi konfigurasi yang tersedia dan pengaturannya, lihat Opsi konfigurasi server.
[ @configvalue = ] configvalue
Pengaturan konfigurasi baru. @configvalue int, dengan default NULL.
Nilai maksimum tergantung pada opsi individual. Untuk melihat nilai maksimum untuk setiap opsi, lihat maximum kolom sys.configurations tampilan katalog.
Mengembalikan nilai kode
0 (berhasil) atau 1 (kegagalan).
Tataan hasil
Saat dijalankan tanpa parameter, sp_configure mengembalikan tataan hasil dengan lima kolom dan mengurutkan opsi menurut abjad dalam urutan naik, seperti yang ditunjukkan dalam tabel berikut.
Nilai untuk config_value dan run_value tidak secara otomatis setara. Setelah memperbarui pengaturan konfigurasi dengan menggunakan sp_configure, Anda juga harus memperbarui nilai konfigurasi yang sedang berjalan, dengan menggunakan RECONFIGURE atau RECONFIGURE WITH OVERRIDE. Untuk informasi selengkapnya, lihat bagian Keterangan.
| Nama kolom | Jenis data | Deskripsi |
|---|---|---|
name |
nvarchar(35) | Nama opsi konfigurasi. |
minimum |
int | Nilai minimum opsi konfigurasi. |
maximum |
int | Nilai maksimum opsi konfigurasi. |
config_value |
int | Nilai tempat opsi konfigurasi diatur menggunakan sp_configure (nilai dalam sys.configurations.value).Untuk informasi selengkapnya tentang opsi ini, lihat Opsi konfigurasi server dan sys.configurations. |
run_value |
int | Nilai opsi konfigurasi yang sedang berjalan (nilai dalam sys.configurations.value_in_use).Untuk informasi selengkapnya, lihat sys.configurations. |
Keterangan
Gunakan sp_configure untuk menampilkan atau mengubah pengaturan tingkat server. Untuk mengubah pengaturan tingkat database, gunakan ALTER DATABASE. Untuk mengubah pengaturan yang hanya memengaruhi sesi pengguna saat ini, gunakan SET pernyataan .
Beberapa opsi konfigurasi server hanya tersedia melalui KONFIGURASI ALTER SERVER.
Kluster Big Data SQL Server
Operasi tertentu, termasuk mengonfigurasi pengaturan server (tingkat instans), atau menambahkan database secara manual ke grup ketersediaan, memerlukan koneksi ke instans SQL Server. Operasi seperti sp_configure, RESTORE DATABASE, atau perintah DDL apa pun dalam database milik grup ketersediaan memerlukan koneksi ke instans SQL Server. Secara default, kluster big data tidak menyertakan titik akhir yang memungkinkan koneksi ke instans. Anda harus mengekspos titik akhir ini secara manual.
Untuk petunjuknya, lihat Menyambungkan ke database pada replika utama.
Memperbarui nilai konfigurasi yang sedang berjalan
Saat Anda menentukan @configvalue baru untuk @configname, kumpulan hasil memperlihatkan nilai ini di config_value kolom . Nilai ini awalnya berbeda dari nilai di run_value kolom, yang menunjukkan nilai konfigurasi yang sedang berjalan. Untuk memperbarui nilai konfigurasi yang run_value sedang berjalan di kolom, administrator sistem harus menjalankan atau RECONFIGURE RECONFIGURE WITH OVERRIDE.
Baik RECONFIGURE dan RECONFIGURE WITH OVERRIDE bekerja dengan setiap opsi konfigurasi. Namun, pernyataan dasar RECONFIGURE menolak nilai opsi apa pun yang berada di luar rentang yang wajar atau yang dapat menyebabkan konflik di antara opsi. Misalnya, RECONFIGURE menghasilkan kesalahan jika nilai interval pemulihan lebih besar dari 60 menit atau jika nilai masker afinitas tumpang tindih dengan nilai masker I/O afinitas. RECONFIGURE WITH OVERRIDE, sebaliknya, menerima nilai opsi apa pun dengan jenis data yang benar dan memaksa konfigurasi ulang dengan nilai yang ditentukan.
Perhatian
Nilai opsi yang tidak pantas dapat berdampak buruk pada konfigurasi instans server. Gunakan RECONFIGURE WITH OVERRIDE dengan hati-hati.
Pernyataan memperbarui RECONFIGURE beberapa opsi secara dinamis; opsi lain memerlukan server berhenti dan menghidupkan ulang. Misalnya, memori server min dan opsi memori server memori server maks diperbarui secara dinamis di Mesin Database. Oleh karena itu, Anda dapat mengubahnya tanpa memulai ulang server. Sebaliknya, mengonfigurasi ulang nilai yang sedang berjalan dari opsi faktor pengisian memerlukan menghidupkan ulang Mesin Database.
Setelah berjalan RECONFIGURE pada opsi konfigurasi, Anda dapat melihat apakah opsi diperbarui secara dinamis dengan menjalankan sp_configure '<configname>'. Nilai dalam run_value kolom dan config_value harus cocok untuk opsi yang diperbarui secara dinamis. Anda juga dapat memeriksa untuk melihat opsi mana yang dinamis dengan melihat is_dynamic kolom sys.configurations tampilan katalog.
Perubahan juga ditulis ke log kesalahan SQL Server.
Jika @configvalue tertentu terlalu tinggi untuk opsi, run_value kolom mencerminkan fakta bahwa Mesin Database default ke memori dinamis, daripada menggunakan pengaturan yang tidak valid.
Untuk informasi selengkapnya, lihat KONFIGURASI ULANG.
Opsi tingkat lanjut
Beberapa opsi konfigurasi, seperti masker afinitas dan interval pemulihan, ditetapkan sebagai opsi tingkat lanjut. Secara default, opsi ini tidak tersedia untuk menampilkan dan mengubah. Untuk membuatnya tersedia, atur opsi konfigurasi tampilkan opsi tingkat lanjut ke 1.
Perhatian
Saat opsi memperlihatkan opsi tingkat lanjut diatur ke 1, pengaturan ini berlaku untuk semua pengguna. Disarankan untuk hanya menggunakan status ini untuk sementara dan beralih kembali 0 ketika selesai dengan tugas yang diperlukan melihat opsi tingkat lanjut.
Untuk informasi selengkapnya tentang opsi konfigurasi dan pengaturannya, lihat Opsi konfigurasi server.
Izin
Jalankan izin tanpa sp_configure parameter atau hanya dengan parameter pertama yang diberikan kepada semua pengguna secara default. Untuk menjalankan sp_configure dengan kedua parameter untuk mengubah opsi konfigurasi atau untuk menjalankan RECONFIGURE pernyataan, Anda harus diberikan ALTER SETTINGS izin tingkat server. Izin ALTER SETTINGS secara implisit dipegang oleh peran server tetap sysadmin dan serveradmin .
Contoh
J. Mencantumkan opsi konfigurasi tingkat lanjut
Contoh berikut menunjukkan cara mengatur dan mencantumkan semua opsi konfigurasi. Anda dapat menampilkan opsi konfigurasi tingkat lanjut dengan terlebih dahulu mengatur show advanced options ke 1. Setelah opsi ini berubah, Anda dapat menampilkan semua opsi konfigurasi dengan menjalankan sp_configure tanpa parameter.
USE master;
GO
EXEC sp_configure 'show advanced options', '1';
Berikut set hasilnya.
Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.
Jalankan RECONFIGURE dan tampilkan semua opsi konfigurasi:
RECONFIGURE;
EXEC sp_configure;
B. Mengubah opsi konfigurasi
Contoh berikut mengatur opsi konfigurasi sistem recovery interval ke 3 menit.
USE master;
GO
EXEC sp_configure 'recovery interval', '3';
RECONFIGURE WITH OVERRIDE;
Contoh: Analytics Platform System (PDW)
C. Mencantumkan semua pengaturan konfigurasi yang tersedia
Contoh berikut menunjukkan cara mencantumkan semua opsi konfigurasi.
EXEC sp_configure;
Hasilnya mengembalikan nama opsi diikuti dengan nilai minimum dan maksimum untuk opsi tersebut. config_value adalah nilai yang digunakan Azure Synapse Analytics saat konfigurasi ulang selesai. run_value adalah nilai yang saat ini sedang digunakan. config_value dan run_value biasanya sama kecuali nilainya sedang dalam proses diubah.
D. Mencantumkan pengaturan konfigurasi untuk satu nama konfigurasi
EXEC sp_configure @configname = 'hadoop connectivity';
E. Mengatur konektivitas Hadoop
Mengatur konektivitas Hadoop memerlukan beberapa langkah lagi selain menjalankan sp_configure. Untuk prosedur lengkapnya, lihat MEMBUAT SUMBER DATA EKSTERNAL.
sp_configure [ @configname = ] 'hadoop connectivity',
[ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[ ; ]
RECONFIGURE;
[ ; ]