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 (Transact-SQL). Untuk mengonfigurasi Soft-NUMA, lihat Soft-NUMA (SQL Server).
Sintaks
-- Syntax for SQL Server
sp_configure [ [ @configname = ] 'option_name'
[ , [ @configvalue = ] 'value' ] ]
-- Syntax for Parallel Data Warehouse
-- List all of the configuration options
sp_configure
[;]
-- Configure Hadoop connectivity
sp_configure [ @configname= ] 'hadoop connectivity',
[ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[;]
RECONFIGURE
[;]
Argumen
[ @configname = ] 'option_name' Adalah nama opsi konfigurasi. option_name 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 (SQL Server).
[ @configvalue = ] 'value' Adalah pengaturan konfigurasi baru. nilai adalah int, dengan default NULL. Nilai maksimum tergantung pada opsi individual.
Untuk melihat nilai maksimum untuk setiap opsi, lihat kolom maksimum tampilan katalog sys.configurations.
Mengembalikan Nilai Kode
0 (keberhasilan) 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 setara secara otomatis. Setelah memperbarui pengaturan konfigurasi dengan menggunakan sp_configure, administrator sistem harus memperbarui nilai konfigurasi yang sedang berjalan dengan menggunakan KONFIGURASI ULANG atau KONFIGURASI ULANG DENGAN PENIMPAAN. Untuk informasi lebih lanjut, lihat bagian Keterangan.
| Nama kolom | Jenis data | Deskripsi |
|---|---|---|
| nama | nvarchar(35) | Nama opsi konfigurasi. |
| Minimum | int | Nilai minimum opsi konfigurasi. |
| Maksimum | 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 (SQL Server) dan sys.configurations (Transact-SQL). |
| run_value | int | Nilai opsi konfigurasi yang sedang berjalan (nilai dalam sys.configurations.value_in_use). Untuk informasi selengkapnya, lihat sys.configurations (Transact-SQL). |
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 ALTER SERVER CONFIGURATION (Transact-SQL).
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 Koneksi ke database pada replika utama.
Memperbarui Nilai Konfigurasi yang Sedang Berjalan
Saat Anda menentukan nilai baru untuk opsi, kumpulan hasil memperlihatkan nilai ini di kolom config_value. Nilai ini awalnya berbeda dari nilai di kolom run_value , yang menunjukkan nilai konfigurasi yang sedang berjalan. Untuk memperbarui nilai konfigurasi yang sedang berjalan di kolom run_value , administrator sistem harus menjalankan KONFIGURASI ULANG atau KONFIGURASI ULANG DENGAN PENIMPAAN.
Konfigurasi ULANG dan KONFIGURASI ULANG DENGAN PENIMPAAN berfungsi dengan setiap opsi konfigurasi. Namun, pernyataan KONFIGURASI ULANG dasar menolak nilai opsi apa pun yang berada di luar rentang yang wajar atau yang dapat menyebabkan konflik di antara opsi. Misalnya, KONFIGURASI ULANG menghasilkan kesalahan jika nilai interval pemulihan lebih besar dari 60 menit atau jika nilai masker afinitas tumpang tindih dengan nilai masker I/O afinitas. KONFIGURASI ULANG DENGAN AMBIL ALIH, 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 KONFIGURASI ULANG DENGAN MENGAMBIL ALIH dengan hati-hati.
Pernyataan KONFIGURASI ULANG memperbarui 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 menjalankan KONFIGURASI ULANG pada opsi konfigurasi, Anda dapat melihat apakah opsi telah diperbarui secara dinamis dengan menjalankan option_name sp_configure'. Nilai dalam kolom run_value dan config_value harus cocok dengan opsi yang diperbarui secara dinamis. Anda juga dapat memeriksa untuk melihat opsi mana yang dinamis dengan melihat kolom is_dynamic tampilan katalog sys.configurations .
Perubahan juga ditulis ke log kesalahan SQL Server.
Catatan
Jika nilai yang ditentukan terlalu tinggi untuk opsi, kolom run_value mencerminkan fakta bahwa Mesin Database telah default ke memori dinamis daripada menggunakan pengaturan yang tidak valid.
Untuk informasi selengkapnya, lihat KONFIGURASI ULANG (Transact-SQL).
Opsi Tingkat Lanjut
Beberapa opsi konfigurasi, seperti masker afinitas dan interval pemulihan, ditetapkan sebagai opsi tingkat lanjut. Secara default, opsi ini tidak tersedia untuk melihat dan mengubah. Untuk membuatnya tersedia, atur opsi Konfigurasi Tampilkan Opsi Tingkat Lanjut ke 1.
Perhatian
Saat opsi Perlihatkan Opsi Tingkat Lanjut diatur ke 1, pengaturan ini berlaku untuk semua pengguna. Disarankan untuk hanya menggunakan status ini untuk sementara dan beralih kembali ke 0 setelah selesai dengan tugas yang diperlukan melihat opsi tingkat lanjut.
Untuk informasi selengkapnya tentang opsi konfigurasi dan pengaturannya, lihat Opsi Konfigurasi Server (SQL Server).
Izin
Jalankan izin pada sp_configure tanpa 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 menjalankan pernyataan KONFIGURASI ULANG, Anda harus diberikan izin tingkat server ALTER SETTINGS. Izin UBAH PENGATURAN 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. Opsi konfigurasi tingkat lanjut ditampilkan dengan pengaturan show advanced options pertama ke 1. Setelah opsi ini diubah, menjalankan sp_configure tanpa parameter menampilkan semua opsi konfigurasi.
USE master;
GO
EXEC sp_configure 'show advanced options', '1';
Berikut adalah pesan: "Opsi konfigurasi 'tampilkan opsi tingkat lanjut' diubah dari 0 menjadi 1. Jalankan pernyataan KONFIGURASI ULANG untuk menginstal."
Jalankan RECONFIGURE dan tampilkan semua opsi konfigurasi:
RECONFIGURE;
EXEC sp_configure;
B. Mengubah opsi konfigurasi
Contoh berikut mengatur 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 akan 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 (Transact-SQL).
Lihat Juga
MENGUBAH KONFIGURASI SERVER (Transact-SQL)
KONFIGURASI ULANG (Transact-SQL)
Pernyataan SET (Transact-SQL)
Opsi Konfigurasi Server (SQL Server)
MENGUBAH DATABASE (T-SQL)
Prosedur Tersimpan Sistem (Transact-SQL)
sys.configurations (Transact-SQL)
ALTER DATABASE SCOPED CONFIGURATION (T-SQL)
Soft-NUMA (SQL Server)
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