sp_attachsubscription (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseSQL-database in Microsoft Fabric

Voegt een bestaande abonnementsdatabase toe aan elke abonnee. Deze opgeslagen procedure wordt uitgevoerd bij de nieuwe abonnee in de master database.

Belangrijk

Deze functie is verouderd en zal in een toekomstige release worden verwijderd. Deze functie zou niet gebruikt moeten worden in nieuw ontwikkelingswerk. Voor mergepublicaties die gepartitioneerd zijn met geparametriseerde filters, raden we aan om de nieuwe functies van gepartitioneerde snapshots te gebruiken, die de initialisatie van een groot aantal abonnementen vereenvoudigen. Voor meer informatie, zie Create a Snapshot for a Merge Publication with Parameterized Filters. Voor publicaties die niet gepartitioneerd zijn, kun je een abonnement initialiseren met een back-up. Zie Een transactioneel abonnement initialiseren zonder momentopname voor meer informatie.

Transact-SQL syntaxis-conventies

Syntaxis

sp_attachsubscription
    [ @dbname = ] N'dbname'
    , [ @filename = ] N'filename'
    [ , [ @subscriber_security_mode = ] subscriber_security_mode ]
    [ , [ @subscriber_login = ] N'subscriber_login' ]
    [ , [ @subscriber_password = ] N'subscriber_password' ]
    [ , [ @distributor_security_mode = ] distributor_security_mode ]
    [ , [ @distributor_login = ] N'distributor_login' ]
    [ , [ @distributor_password = ] N'distributor_password' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] N'publisher_login' ]
    [ , [ @publisher_password = ] N'publisher_password' ]
    [ , [ @job_login = ] N'job_login' ]
    [ , [ @job_password = ] N'job_password' ]
    [ , [ @db_master_key_password = ] N'db_master_key_password' ]
[ ; ]

Arguments

[ @dbname = ] N'dbname'

Geeft de naam van de bestemmingsabonnementsdatabase op. @dbname is een systeemnaam, zonder standaard.

[ @filename = ] N'bestandsnaam'

De naam en fysieke locatie van het primaire databestand (.mdf). @filename is nvarchar(260), zonder standaard.

[ @subscriber_security_mode = ] subscriber_security_mode

De beveiligingsmodus van de abonnee om te gebruiken bij het verbinden met een abonnee tijdens synchronisatie. @subscriber_security_mode is int, met als standaard NULL.

Opmerking

Windows-authenticatie moet worden gebruikt. Als @subscriber_security_mode dat niet 1 is (Windows-authenticatie), krijg je een foutmelding.

[ @subscriber_login = ] N'subscriber_login'

De inlognaam van de abonnee die gebruikt moet worden bij het verbinden met een abonnee tijdens het synchroniseren. @subscriber_login is een systeemnaam, met als standaard .NULL

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. Als @subscriber_security_mode dat niet 1 is en @subscriber_login is gespecificeerd, krijg je een foutmelding.

[ @subscriber_password = ] N'subscriber_password'

Het wachtwoord van de abonnee. @subscriber_password is een systeemnaam, met als standaard NULL.

Opmerking

Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts. Als @subscriber_security_mode dat niet 1 is en @subscriber_password is gespecificeerd, krijg je een foutmelding.

[ @distributor_security_mode = ] distributor_security_mode

De beveiligingsmodus om te gebruiken bij het verbinden met een distributeur tijdens synchronisatie. @distributor_security_mode is int, met als standaard .1

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

Gebruik waar mogelijk Windows-verificatie.

[ @distributor_login = ] N'distributor_login'

De Distributor-login om te gebruiken bij het verbinden met een Distributor tijdens synchronisatie. @distributor_login is een systeemnaam, met als standaard NULL. @distributor_login is vereist als @distributor_security_mode is ingesteld op 0.

[ @distributor_password = ] N'distributor_password'

Het wachtwoord van de distributeur. @distributor_password is sysname, met als standaard .NULL @distributor_password is vereist als @distributor_security_mode is ingesteld op 0. De waarde van @distributor_password moet korter zijn dan 120 Unicode-tekens.

Belangrijk

Gebruik geen leeg wachtwoord. Gebruik een sterk wachtwoord. Indien mogelijk vraagt u gebruikers om beveiligingsreferenties in te voeren tijdens runtime. Als u referenties in een scriptbestand moet opslaan, moet u het bestand beveiligen om onbevoegde toegang te voorkomen.

[ @publisher_security_mode = ] publisher_security_mode

De beveiligingsmodus die je gebruikt bij het verbinden met een uitgever bij synchronisatie. @publisher_security_mode is int, met als standaard .1

• Als 0, specificeert SQL Server-authenticatie.
• Als 1, specificeert Windows-authenticatie. Gebruik waar mogelijk Windows-verificatie.

[ @publisher_login = ] N'publisher_login'

De login die gebruikt wordt bij het verbinden met een uitgever bij synchronisatie. @publisher_login is een systeemnaam, met als standaard .NULL

[ @publisher_password = ] N'publisher_password'

Het wachtwoord dat wordt gebruikt bij het verbinden met de uitgever. @publisher_password is een systeemnaam, met als standaard NULL. De waarde van @publisher_password moet korter zijn dan 120 Unicode-tekens.

Belangrijk

Gebruik geen leeg wachtwoord. Gebruik een sterk wachtwoord. Indien mogelijk vraagt u gebruikers om beveiligingsreferenties in te voeren tijdens runtime. Als u referenties in een scriptbestand moet opslaan, moet u het bestand beveiligen om onbevoegde toegang te voorkomen.

[ @job_login = ] N'job_login'

De login voor het Windows-account waaronder de agent draait. @job_login is nvarchar(257), zonder standaard. Dit Windows-account wordt altijd gebruikt voor agentverbindingen met de Distributor.

[ @job_password = ] N'job_password'

Het wachtwoord voor het Windows-account waaronder de agent draait. @job_password is systeemnaam, met als standaard .NULL De waarde van job_password moet korter zijn dan 120 Unicode-tekens.

Belangrijk

Gebruik geen leeg wachtwoord. Gebruik een sterk wachtwoord. Indien mogelijk vraagt u gebruikers om beveiligingsreferenties in te voeren tijdens runtime. Als u referenties in een scriptbestand moet opslaan, moet u het bestand beveiligen om onbevoegde toegang te voorkomen.

[ @db_master_key_password = ] N'db_master_key_password'

Het wachtwoord van een door de gebruiker gedefinieerde database-hoofdsleutel (DMK). @db_master_key_password is nvarchar(524), met een standaard van NULL. Als @db_master_key_password niet wordt gespecificeerd, wordt een bestaande DMK verwijderd en opnieuw aangemaakt.

Belangrijk

Gebruik geen leeg wachtwoord. Gebruik een sterk wachtwoord. Indien mogelijk vraagt u gebruikers om beveiligingsreferenties in te voeren tijdens runtime. Als u referenties in een scriptbestand moet opslaan, moet u het bestand beveiligen om onbevoegde toegang te voorkomen.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

sp_attachsubscription wordt gebruikt in momentopnamereplicatie, transactionele replicatie en samenvoegingsreplicatie.

Er kan geen abonnement aan de publicatie worden gekoppeld als de bewaartermijn van de publicatie is verstreken. Als een abonnement met een verstreken retentieperiode wordt gespecificeerd, ontstaat er een fout wanneer het abonnement wordt gekoppeld of eerst wordt gesynchroniseerd. Publicaties met een publicatiebehoudsduur van 0 (nooit verlopen) worden genegeerd.

Permissions

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

Verwante inhoud

• systeemopslagprocedures (Transact-SQL)