sp_attachsubscription (Transact-SQL)

Gäller för:SQL ServerAzure SQL DatabaseSQL-databas i Microsoft Fabric

Bifogar en befintlig prenumerationsdatabas till vilken prenumerant som helst. Denna lagrade procedur körs på den nya prenumeranten i databasen master .

Viktigt!

Denna funktion är föråldrad och kommer att tas bort i en framtida version. Denna funktion bör inte användas i nytt utvecklingsarbete. För sammanslagningspublikationer som är partitionerade med parameteriserade filter rekommenderar vi att använda de nya funktionerna i partitionerade snapshots, som förenklar initialiseringen av ett stort antal prenumerationer. För mer information, se Skapa en ögonblicksbild för en sammanslagningspublikation med parameteriserade filter. För publikationer som inte är partitionerade kan du initiera en prenumeration med en backup. Mer information finns i Initiera en transaktionsprenumeration utan en ögonblicksbild.

Transact-SQL syntaxkonventioner

Syntax

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'

Specificerar namnet på destinationsprenumerationsdatabasen. @dbname är sysname, utan standard.

[ @filename = ] N'filnamn'

Namnet och den fysiska platsen för primärfilen (.mdf). @filename är nvarchar(260), utan standard.

[ @subscriber_security_mode = ] subscriber_security_mode

Säkerhetsläget för abonnenten att använda vid anslutning till en abonnent vid synkronisering. @subscriber_security_mode är int, med standardvärdet .NULL

Anmärkning

Windows-autentisering måste användas. Om @subscriber_security_mode inte 1 är det (Windows-autentisering) får du ett felmeddelande.

[ @subscriber_login = ] N'subscriber_login'

Prenumerantens inloggningsnamn att använda vid anslutning till en prenumerant vid synkronisering. @subscriber_login är sysname, med standardvärdet .NULL

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Om @subscriber_security_mode inte 1 är det och @subscriber_login är specificerat får du ett felmeddelande.

[ @subscriber_password = ] N'subscriber_password'

Prenumerantlösenordet. @subscriber_password är sysname, med standardvärdet .NULL

Anmärkning

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Om @subscriber_security_mode inte 1 är det och @subscriber_password anges får du ett felmeddelande.

[ @distributor_security_mode = ] distributor_security_mode

Säkerhetsläget att använda när man ansluter till en distributör vid synkronisering. @distributor_security_mode är int, med standardvärdet .1

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

Använd Windows-autentisering när det är möjligt.

[ @distributor_login = ] N'distributor_login'

Distributörens inloggning används vid anslutning till en distributör vid synkronisering. @distributor_login är sysname, med standardvärdet .NULL @distributor_login krävs om @distributor_security_mode är satt till 0.

[ @distributor_password = ] N'distributor_password'

Distributörens lösenord. @distributor_password är sysname, med standardvärdet .NULL @distributor_password krävs om @distributor_security_mode är satt till 0. Värdet på @distributor_password måste vara kortare än 120 Unicode-tecken.

Viktigt!

Använd inte ett tomt lösenord. Använd ett starkt lösenord. När det är möjligt uppmanar du användarna att ange säkerhetsautentiseringsuppgifter vid körning. Om du måste lagra autentiseringsuppgifter i en skriptfil måste du skydda filen för att förhindra obehörig åtkomst.

[ @publisher_security_mode = ] publisher_security_mode

Säkerhetsläget att använda när man ansluter till en Publisher vid synkronisering. @publisher_security_mode är int, med standardvärdet .1

• Om 0, specificerar SQL Server-autentisering.
• Om 1, specificerar Windows-autentisering. Använd Windows-autentisering när det är möjligt.

[ @publisher_login = ] N'publisher_login'

Inloggningen att använda när man ansluter till en utgivare vid synkronisering. @publisher_login är sysname, med standardvärdet .NULL

[ @publisher_password = ] N'publisher_password'

Lösenordet som används vid anslutning till utgivaren. @publisher_password är sysname, med standardvärdet .NULL Värdet på @publisher_password måste vara kortare än 120 Unicode-tecken.

Viktigt!

Använd inte ett tomt lösenord. Använd ett starkt lösenord. När det är möjligt uppmanar du användarna att ange säkerhetsautentiseringsuppgifter vid körning. Om du måste lagra autentiseringsuppgifter i en skriptfil måste du skydda filen för att förhindra obehörig åtkomst.

[ @job_login = ] N'job_login'

Inloggningen för Windows-kontot där agenten körs. @job_login är nvarchar(257), utan standard. Detta Windows-konto används alltid för agentanslutningar till distributören.

[ @job_password = ] N'job_password'

Lösenordet till Windows-kontot som agenten körs under. @job_password är sysname, med standardvärdet .NULL Värdet av job_password måste vara kortare än 120 Unicode-tecken.

Viktigt!

Använd inte ett tomt lösenord. Använd ett starkt lösenord. När det är möjligt uppmanar du användarna att ange säkerhetsautentiseringsuppgifter vid körning. Om du måste lagra autentiseringsuppgifter i en skriptfil måste du skydda filen för att förhindra obehörig åtkomst.

[ @db_master_key_password = ] N'db_master_key_password'

Lösenordet till en användardefinierad databashuvudnyckel (DMK). @db_master_key_password är nvarchar(524), med en standard på NULL. Om @db_master_key_password inte specificeras tas en befintlig DMK bort och återskapas.

Viktigt!

Använd inte ett tomt lösenord. Använd ett starkt lösenord. När det är möjligt uppmanar du användarna att ange säkerhetsautentiseringsuppgifter vid körning. Om du måste lagra autentiseringsuppgifter i en skriptfil måste du skydda filen för att förhindra obehörig åtkomst.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

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

En prenumeration kan inte kopplas till publikationen om lagringstiden för publikationen har löpt ut. Om en prenumeration med en förfluten lagringsperiod anges uppstår ett fel när prenumerationen antingen är ansluten eller först synkroniserad. Publikationer med en lagringstid på 0 (aldrig förfaller) ignoreras.

Permissions

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

Relaterat innehåll

• System sparade procedurer (Transact-SQL)