sp_addserver (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Menentukan nama instans lokal SQL Server. Ketika komputer yang menghosting SQL Server diganti namanya, gunakan sp_addserver untuk menginformasikan instans Mesin Database SQL Server dari nama komputer baru. Prosedur ini harus dijalankan pada semua instans Mesin Database yang dihosting di komputer. Nama instans Mesin Database tidak dapat diubah. Untuk mengubah nama instans instans bernama, instal instans baru dengan nama yang diinginkan, lepaskan file database dari instans lama, lampirkan database ke instans baru, dan lepaskan instans lama. Atau, Anda dapat membuat nama alias klien di komputer klien, mengalihkan koneksi ke server dan nama instans yang berbeda atau kombinasi server:port tanpa mengubah nama instans di komputer server.

Konvensi sintaks transact-SQL

Sintaks

sp_addserver
    [ @server = ] N'server'
    [ , [ @local = ] 'LOCAL' ]
    [ , [ @duplicate_ok = ] 'duplicate_OK' ]
[ ; ]

Argumen

[ @server = ] N'server'

Nama server. Nama server harus unik dan mengikuti aturan untuk nama komputer Microsoft Windows, meskipun spasi tidak diizinkan. @server adalah sysname, tanpa default.

Saat beberapa instans SQL Server diinstal di komputer, instans beroperasi seolah-olah berada di server terpisah. Tentukan instans bernama dengan menyebut @server sebagai <servername>\<instancename>.

[ @local = ] 'LOCAL'

Menentukan bahwa server sedang ditambahkan sebagai server lokal. @local adalah varchar(10), dengan default NULL. Menentukan @local sebagai mendefinisikan @server sebagai nama server lokal, dan menyebabkan @@SERVERNAME fungsi mengembalikan nilai @server.LOCAL

Penyetelan SQL Server mengatur variabel ini ke nama komputer selama penginstalan. Secara default, nama komputer adalah cara pengguna terhubung ke instans SQL Server tanpa memerlukan konfigurasi tambahan.

Definisi lokal berlaku hanya setelah Mesin Database dimulai ulang. Hanya satu server lokal yang dapat didefinisikan dalam setiap instans Mesin Database.

[ @duplicate_ok = ] 'duplicate_OK'

Menentukan apakah nama server duplikat diizinkan. @duplicate_ok adalah varchar(13), dengan default NULL. @duplicate_ok hanya dapat memiliki nilai duplicate_OK atau NULL. Jika @duplicate_ok ditentukan dan nama server yang sedang ditambahkan sudah ada, tidak ada kesalahan yang muncul. Jika parameter bernama tidak digunakan, @local harus ditentukan.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Untuk mengatur atau menghapus opsi server, gunakan sp_serveroption.

sp_addserver tidak dapat digunakan di dalam transaksi yang ditentukan pengguna.

Menggunakan sp_addserver untuk menambahkan server jarak jauh dihentikan. Gunakan sp_addlinkedserver sebagai gantinya.

Menggunakan sp_addserver untuk mengubah nama server lokal dapat menyebabkan efek yang tidak diinginkan atau konfigurasi yang tidak didukung saat menggunakan grup ketersediaan atau Replikasi.

Izin

Memerlukan keanggotaan dalam peran server tetap setupadmin .

Contoh

Contoh berikut mengubah entri Mesin Database untuk nama komputer yang menghosting SQL Server menjadi ACCOUNTS.

EXEC sp_addserver 'ACCOUNTS', 'local';

Konten terkait