sp_add_agent_profile (T-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL Managed Instance

Membuat profil baru untuk agen replikasi. Prosedur tersimpan ini dijalankan di Distributor pada database apa pun.

Konvensi sintaks transact-SQL

Sintaks

sp_add_agent_profile [ [ @profile_id = ] profile_id OUTPUT ]
      , [ @profile_name = ] 'profile_name'
      , [ @agent_type = ] agent_type
    [ , [ @profile_type = ] profile_type ]
    [ , [ @description = ] N'description' ]
    [ , [ @default = ] default ]

Argumen

[ @profile_id = ] profile_id

ID yang terkait dengan profil yang baru disisipkan. @profile_id adalah int dan merupakan parameter OUTPUT opsional. Jika ditentukan, nilai diatur ke ID profil baru.

[ @profile_name = ] 'profile_name'

Nama profil. @profile_name adalah sysname, tanpa default.

[ @agent_type = ] agent_type

Jenis agen replikasi. @agent_type int, tanpa default, dan dapat menjadi salah satu nilai ini.

Nilai Deskripsi
1 Agen Snapshot
2 Agen Pembaca Log
3 Agen distribusi
4 Gabungkan Agen
9 Agen Pembaca Antrean

[ @profile_type = ] profile_type

Jenis profil. profile_type int, dengan default 1.

0 menunjukkan profil sistem. 1 menunjukkan profil kustom. Hanya profil kustom yang dapat dibuat menggunakan prosedur tersimpan ini; oleh karena itu satu-satunya nilai yang valid adalah 1. Hanya SQL Server yang membuat profil sistem.

[ @description = ] N'description'

Deskripsi profil. @description adalah nvarchar(3000), tanpa default.

[ @default = ] default

Menunjukkan apakah profil adalah default untuk @agent_type. @default adalah bit, dengan default 0. 1 menunjukkan bahwa profil yang ditambahkan akan menjadi profil default baru untuk agen yang ditentukan oleh @agent_type.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_add_agent_profile digunakan dalam replikasi rekam jepret, replikasi transaksional, dan replikasi penggabungan.

Profil agen kustom ditambahkan dengan nilai parameter agen default. Gunakan sp_change_agent_parameter (Transact-SQL) untuk mengubah nilai default ini atau sp_add_agent_parameter (Transact-SQL) untuk menambahkan parameter tambahan.

Saat sp_add_agent_profile dijalankan, baris ditambahkan untuk profil kustom baru dalam tabel MSagent_profiles (Transact-SQL) dan parameter default terkait untuk profil ini ditambahkan ke tabel MSagent_parameters (Transact-SQL).

Izin

Hanya anggota peran server tetap sysadmin yang dapat menjalankan sp_add_agent_profile.

Konten terkait