Delen via


sp_addsubscriber (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Database

Voegt een nieuwe abonnee toe aan een uitgever, waardoor deze publicaties kan ontvangen. Deze opgeslagen procedure wordt uitgevoerd bij de uitgever in de publicatiedatabase voor snapshot- en transactionele publicaties; en voor merge-publicaties met een externe distributeur wordt deze opgeslagen procedure uitgevoerd bij de distributeur.

Belangrijk

Deze opgeslagen procedure is verouderd. Je bent niet langer verplicht om een abonnee expliciet bij de uitgever te registreren.

Transact-SQL syntaxis-conventies

Syntaxis

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'abonnee'

De naam van de server die als geldige abonnee wordt toegevoegd aan de publicaties op deze server. @subscriber is een systeemnaam, zonder standaard.

[ @type = ] type

Het type abonnee. @type is heel klein en kan een van deze waarden zijn.

Waarde Description
0 (standaard) SQL Server-abonnee
1 ODBC databronserver
2 Microsoft Jet-database
3 OLE DB-provider

[ @login = ] N'login'

De inlog-ID voor SQL Server-authenticatie. @login is sysname, met een standaardwaarde van NULL.

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @password = ] N'wachtwoord'

Het wachtwoord voor SQL Server-authenticatie. @password is nvarchar(524), met een standaard van NULL.

Gebruik geen leeg wachtwoord. Gebruik een sterk wachtwoord.

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @commit_batch_size = ] commit_batch_size

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts.

Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @status_batch_size = ] status_batch_size

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts.

Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @flush_frequency = ] flush_frequency

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts.

Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @frequency_type = ] frequency_type

Specificeert de frequentie waarmee de replicatieagent gepland moet worden. @frequency_type is int, en kan een van deze waarden zijn.

Waarde Description
1 Eenmaal
2 Op aanvraag
4 Dagelijks
8 Weekly
16 Monthly
32 Maandelijkse verwant
64 (standaard) Autostart
128 Terugkerend

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @frequency_interval = ] frequency_interval

De waarde toegepast op de frequentie die door @frequency_type wordt ingesteld. @frequency_interval is int, met als standaard .1

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @frequency_relative_interval = ] frequency_relative_interval

De datum van het replicatiemiddel. Deze parameter wordt gebruikt wanneer @frequency_type is ingesteld op 32 (maandelijkse relatieve). @frequency_relative_interval is int, en kan een van deze waarden zijn.

Waarde Description
1 (standaard) Eerst
2 Second
4 Derde
8 Vierde
16 Laatste

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

De door @frequency_type gebruikte recurrence factor @frequency_recurrence_factor is int, met als standaard .0

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @frequency_subday = ] frequency_subday

Hoe vaak moet je verzetten tijdens de vastgestelde periode? @frequency_subday is int, en kan een van deze waarden zijn.

Waarde Description
1 Eenmaal
2 Second
4 (standaard) Minute
8 Uur

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @frequency_subday_interval = ] frequency_subday_interval

De pauze voor frequency_subday. @frequency_subday_interval is int, met als standaard .5

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @active_start_time_of_day = ] active_start_time_of_day

Het tijdstip waarop de replicatieagent voor het eerst wordt gepland, geformatteerd als HHmmss. @active_start_time_of_day is int, met als standaard .0

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @active_end_time_of_day = ] active_end_time_of_day

Het tijdstip waarop de replicatieagent stopt met worden gepland, geformatteerd als HHmmss. @active_end_time_of_day is int, met een standaard van 235959, wat betekent 23:59:59 uur, gemeten op een 24-uurs klok.

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @active_start_date = ] active_start_date

De datum waarop de replicatieagent voor het eerst wordt gepland, geformatteerd als yyyyMMdd. @active_start_date is int, met een standaard van 0.

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @active_end_date = ] active_end_date

De datum waarop de replicatieagent stopt met het plannen, geformatteerd als yyyyMMdd. @active_end_date is int, met een standaard van 99991231, wat betekent 31 december 9999.

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @description = ] Geen beschrijving'

Een tekstbeschrijving van de abonnee. @description is nvarchar(255), met een standaard van NULL.

[ @security_mode = ] security_mode

De geïmplementeerde beveiligingsmodus. @security_mode is int, met als standaard .1

  • 0 specificeert SQL Server-authenticatie.
  • 1 specificeert Windows-authenticatie.

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. De eigendom wordt nu gespecificeerd op basis van een abonnement bij het uitvoeren van sp_addsubscription. Wanneer een waarde wordt opgegeven, wordt deze standaard gebruikt bij het aanmaken van abonnementen bij deze abonnee en wordt er een waarschuwingsbericht teruggegeven.

[ @encrypted_password = ] encrypted_password

Deze parameter is verouderd en alleen beschikbaar voor achterwaartse compatibiliteit. Het instellen van @encrypted_password op een willekeurige waarde resulteert 0 in een fout.

[ @publisher = ] N'uitgever'

Specificeert een niet-SQL Server Publisher. @publisher is sysname, met als standaard NULL.

@publisher mag niet worden gebruikt bij het publiceren vanuit een SQL Server Publisher.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

sp_addsubscriber wordt gebruikt in momentopnamereplicatie, transactionele replicatie en samenvoegingsreplicatie.

sp_addsubscriber is niet vereist wanneer de abonnee alleen anonieme abonnementen heeft om publicaties samen te voegen.

sp_addsubscriber schrijft naar de MSsubscriber_info tabel in de distributiedatabase .

Permissions

Alleen leden van de vaste serverrol sysadmin kunnen worden uitgevoerd sp_addsubscriber.