sp_addsubscriber (Transact-SQL)

gäller för:SQL ServerAzure SQL Database

Lägger till en ny prenumerant till en utgivare, vilket gör det möjligt att ta emot publikationer. Denna lagrade procedur utförs hos förlaget i publikationsdatabasen för snapshot- och transaktionspublikationer; och för sammanslagningspublikationer med en fjärrdistributör utförs denna lagrade procedur hos distributören.

Viktigt!

Denna lagrade procedur har föråldrats. Du behöver inte längre uttryckligen registrera en prenumerant hos utgivaren.

Transact-SQL syntaxkonventioner

Syntax

sp_addsubscriber
    [ @subscriber = ] N'subscriber'
    [ , [ @type = ] type ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'password' ]
    [ , [ @commit_batch_size = ] commit_batch_size ]
    [ , [ @status_batch_size = ] status_batch_size ]
    [ , [ @flush_frequency = ] flush_frequency ]
    [ , [ @frequency_type = ] frequency_type ]
    [ , [ @frequency_interval = ] frequency_interval ]
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
    [ , [ @frequency_subday = ] frequency_subday ]
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]
    [ , [ @active_start_date = ] active_start_date ]
    [ , [ @active_end_date = ] active_end_date ]
    [ , [ @description = ] N'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Arguments

[ @subscriber = ] N'prenumerant'

Namnet på servern som ska läggas till som giltig prenumerant på publikationerna på denna server. @subscriber är sysname, utan standard.

[ @type = ] typ

Typen av prenumerant. @type är liten och kan vara ett av dessa värden.

Värde Description
0 (standardinställning) SQL Server-prenumerant
1 ODBC datakällaserver
2 Microsoft Jet-databas
3 OLE DB-provider

[ @login = ] N'login'

Inloggnings-ID för SQL Server-autentisering. @login är sysname med standardvärdet NULL.

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @password = ] N'password'

Lösenordet för SQL Server-autentisering. @password är nvarchar(524), med standardvärdet .NULL

Använd inte ett tomt lösenord. Använd ett starkt lösenord.

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @commit_batch_size = ] commit_batch_size

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript.

När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @status_batch_size = ] status_batch_size

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript.

När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @flush_frequency = ] flush_frequency

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript.

När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @frequency_type = ] frequency_type

Specificerar hur ofta replikationsagenten ska schemaliseras. @frequency_type är int, och kan vara ett av dessa värden.

Värde Description
1 En gång
2 På begäran
4 Varje dag
8 Weekly
16 Monthly
32 Månadssläkting
64 (standardinställning) Autostart
128 Återkommande

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @frequency_interval = ] frequency_interval

Värdet som tillämpas på frekvensen som @frequency_type. @frequency_interval är int, med standardvärdet .1

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @frequency_relative_interval = ] frequency_relative_interval

Datumet för replikationsagenten. Denna parameter används när @frequency_type sätts till 32 (månatlig relativ). @frequency_relative_interval är int, och kan vara ett av dessa värden.

Värde Description
1 (standardinställning) Först
2 Second
4 Tredje
8 Fjärde
16 Sist

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Upprepningsfaktorn som används av @frequency_type. @frequency_recurrence_factor är int, med standardvärdet .0

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @frequency_subday = ] frequency_subday

Hur ofta ska man boka om under den definierade perioden. @frequency_subday är int, och kan vara ett av dessa värden.

Värde Description
1 En gång
2 Second
4 (standardinställning) Minut
8 Timme

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @frequency_subday_interval = ] frequency_subday_interval

Pausen för frequency_subday. @frequency_subday_interval är int, med standardvärdet .5

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @active_start_time_of_day = ] active_start_time_of_day

Den tid på dygnet då replikationsagenten först schemaliseras, formaterad som HHmmss. @active_start_time_of_day är int, med standardvärdet .0

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @active_end_time_of_day = ] active_end_time_of_day

Den tid på dygnet då replikationsagenten slutar schemaläggas och formateras som HHmmss. @active_end_time_of_day är int, med en standard på 235959, vilket betyder 23:59:59 enligt en 24-timmarsklocka.

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @active_start_date = ] active_start_date

Datumet då replikationsagenten först schemaliseras, formaterad som yyyyMMdd. @active_start_date är int, med standardvärdet .0

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @active_end_date = ] active_end_date

Datumet då replikationsagenten slutar schemalagas, formaterad som yyyyMMdd. @active_end_date är int, med standardvärdet , 99991231vilket betyder 31 december 9999.

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @description = ] Ingen beskrivning'

En textbeskrivning av prenumeranten. @description är nvarchar(255), med en standard på NULL.

[ @security_mode = ] security_mode

Det implementerade säkerhetsläget. @security_mode är int, med standardvärdet .1

  • 0 specificerar autentisering av SQL Server.
  • 1 specificerar Windows-autentisering.

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Fastigheten specificeras nu per prenumeration vid sp_addsubscription. När ett värde anges används det som standard vid skapande av prenumerationer hos denna prenumerant och ett varningsmeddelande returneras.

[ @encrypted_password = ] encrypted_password

Denna parameter är föråldrad och tillhandahålls endast för bakåtkompatibilitet. Att ställa in @encrypted_password på vilket värde som helst men 0 resulterar i ett fel.

[ @publisher = ] N'publisher'

Specificerar en icke-SQL Server Publisher. @publisher är sysname, med standardvärdet .NULL

@publisher bör inte användas när man publicerar från en SQL Server Publisher.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

sp_addsubscriber används i replikering av ögonblicksbilder, transaktionsreplikering och sammanslagningsreplikering.

sp_addsubscriber krävs inte när prenumeranten bara har anonyma prenumerationer för att slå ihop publikationer.

sp_addsubscriber skriver till tabellen MSsubscriber_info i distributionsdatabasen .

Permissions

Endast medlemmar i den fasta serverrollen sysadmin kan köra sp_addsubscriber.