Skapa och applicera den initiala snapshoten

gäller för:SQL ServerAzure SQL Managed Instance

Den här artikeln beskriver hur man skapar och tillämpar den initiala snapshoten i SQL Server genom att använda SQL Server Management Studio, Transact-SQL eller Replication Management Objects (RMO). Sammanslagningspublikationer som använder parameteriserade filter kräver en tvådelad ögonblicksbild. För mer information, se Skapa en ögonblicksbild för en sammanslagningspublikation med parameteriserade filter.
Snapshot Agent genererar snapshots efter att en publikation har skapats. Du kan generera ögonblicksbilder:

  • Omedelbart. Som standard genererar Guiden för ny publikation en ögonblicksbild för en sammanslagningspublikation omedelbart efter att du skapat publikationen.
  • Vid en bestämd tid. Ange ett schema på sidan Snapshot Agent i New Publication Wizard eller när du använder lagrade procedurer eller Replication Management Objects (RMO).
  • Manuellt. Kör Snapshot Agent från kommandotolken eller från SQL Server Management Studio. För mer information om att köra agenter, se Replication Agent Executables Concepts och Start and Stop a Replication Agent (SQL Server Management Studio).

För merge-replikering genererar Snapshot Agent en snapshot varje gång den körs. För transaktionell replikering beror snapshot-genereringen på inställningen av publiceringsegenskapen immediate_sync. Om egenskapen är satt till SANT (standarden vid användning av New Publication Wizard), genererar Snapshot Agent en snapshot varje gång den körs, och den kan applicera snapshoten på en prenumerant när som helst. Om egenskapen är inställd på FALSE (standarden vid användning av sp_addpublication) genererar Snapshot Agent en snapshot endast om en ny prenumeration läggs till sedan senaste Snapshot Agent körning; Prenumeranter måste vänta tills Snapshot Agent är klar innan de kan synkronisera.

Som standard sparar Snapshot Agent genererade snapshots i standardmappen för snapshots som finns på Distributor. Du kan också spara snapshot-filer på flyttbara medier som flyttbara diskar, CD-ROM:er eller på andra platser än standardmappen för snapshot. Du kan också komprimera filerna för att göra dem enklare att lagra och överföra, och köra skript före eller efter att Snapshot Agent applicerar snapshoten hos prenumeranten. För mer information om dessa alternativ, se Snapshot Options.

Om snapshoten gäller en merge-publikation som använder parameteriserade filter, skapar Snapshot Agent snapshoten genom att använda en tvådelad process. Först skapar den en schema-snapshot som innehåller replikeringsskripten och schemat för de publicerade objekten, men inte datan. Varje prenumeration initierar sedan med en snapshot som inkluderar skript och schema kopierade från schemasnapshoten samt data som tillhör prenumerationens partition. Mer information finns i Ögonblicksbilder för sammanslagning av publikationer med parameteriserade filter.

Efter att Snapshot Agent skapat snapshoten hos Publisher och lagrat den på en standard- eller alternativ snapshot-plats kan du överföra snapshoten till prenumeranten och applicera den. Distribution Agent (för snapshot eller transaktionell replikering) eller Merge Agent (för merge-replikering) överför ögonblicksbilden och applicerar schemat och datafilerna på prenumerationsdatabasen på abonnenten under den initiala synkroniseringen. Som standard sker den initiala synkroniseringen omedelbart efter att du skapat en prenumeration om du använder New Subscription Wizard. Alternativet Initialisera när, på sidan Initialisera prenumerationer i guiden, styr detta beteende. När Snapshot Agent genererar snapshots efter att en prenumeration initierats, appliceras de inte på en prenumerant om du inte markerar en prenumeration för ominitialisering. Mer information finns i Initiera prenumerationer igen.

Efter att Distribution Agent eller Merge Agent har applicerat den initiala snapshoten, sprider agenten efterföljande uppdateringar och andra dataändringar. När snapshots distribueras och appliceras på prenumeranter påverkas endast de prenumeranter som väntar på initiala eller nya snapshots. Andra prenumeranter på den publikationen (de som redan får inlägg, uppdateringar, borttagningar eller andra ändringar av den publicerade datan) påverkas inte.

För att se eller ändra standardplatsen för snapshot-mappen, se

Standardplats för snapshot

Ange standardplatsen för snapshot på sidan Snapshot-mappen i Configure Distribution Wizard. För mer information om hur man använder denna guide, se Konfigurera publicering och distribution. Om du skapar en publikation på en server som inte är konfigurerad som en distributör, ange en standardplats för snapshot på sidan Snapshot Folder i New Publication Wizard. För mer information om att använda denna guide, se Skapa en publikation.

Ändra standardplatsen för snapshot på Publicist-sidan i dialogrutan Distributor Properties - <Distributor> . För mer information, se Visa och modifiera distributör och Publisher Properties. Ställ in snapshot-mappen för varje publikation i dialogrutan Publikationsegenskaper - <Publikation> . Mer information finns i Visa och ändra publikationsegenskaper.

Ändra standardplatsen för snapshot

  1. På sidan Publishers i dialogrutan Distributor Properties - <Distributor>, välj egenskapsknappen (...) för den Publisher där du vill ändra standardplatsen för snapshot.

  2. I dialogrutan Publisher Properties - <Publisher>, ange ett värde för egenskapen Default Snapshot Folder.

    Note

    Snapshot Agent behöver skrivbehörigheter för den katalog du anger, och Distribution Agent eller Merge Agent behöver läsbehörigheter. Om du använder pull-prenumerationer måste du ange en delad katalog som en universell namngivningskonvention (UNC)-sökväg, såsom \\computername\snapshot. Mer information finns i Skydda mappen Ögonblicksbild.

  3. Välj OK.

Skapa ögonblicksbild

Som standard, om SQL Server Agent körs, genererar Snapshot Agent en snapshot omedelbart efter att du skapat en publikation genom att använda New Publication Wizard. Som standard tillämpar Distribution Agent (för snapshot och transaktionell replikering) eller Merge Agent (för merge-prenumerationer) sedan snapshoten för alla prenumerationer. Du kan också generera en ögonblicksbild genom att använda SQL Server Management Studio och Replication Monitor. Information om hur du startar Replikeringsövervakaren finns i Starta replikeringsövervakaren.

Använda SQL Server Management Studio

  1. Anslut till Publisher i Management Studio och expandera sedan servernoden.
  2. Expandera mappen Replikering och expandera sedan mappen Lokala publikationer .
  3. Högerklicka på publikationen där du vill skapa en snapshot och välj sedan View Snapshot Agent Status.
  4. I dialogrutan View Snapshot Agent Status - <Publication> väljer Start.
    När Snapshot Agent är klar med att generera ögonblicksbilden visas ett meddelande, såsom "[100%] En ögonblicksbild av 17 artiklar genererades."

I Replikationsövervakaren

  1. I Replikeringsövervakaren expanderar du en Publisher-grupp i den vänstra rutan och expanderar sedan en Utgivare.
  2. Högerklicka på publikationen där du vill generera en snapshot, och välj sedan Generate Snapshot.
  3. För att se statusen för Snapshot Agent, välj fliken Agents. För mer detaljerad information, högerklicka på Snapshot Agent i rutnätet och välj sedan View Details.

Använda Transact-SQL

Du kan skapa initiala snapshots programmatiskt genom att skapa och köra ett Snapshot Agent-jobb eller genom att köra Snapshot Agent-filen från en batchfil. Efter att en initial snapshot har genererats överförs den till och tillämpas på prenumeranten när prenumerationen först synkroniseras. Om du kör Snapshot Agent från en kommandoprompt eller en batchfil måste du köra om agenten varje gång den befintliga snapshoten blir ogiltig.

Important

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 skyddar du filen för att förhindra obehörig åtkomst.

  1. Skapa en snapshot-, transaktions- eller sammanslagningspublikation. Mer information finns i Skapa en publikation.

  2. Utför sp_addpublication_snapshot (Transact-SQL). Specificera @publication och följande parametrar:

    • @job_login, som specificerar de Windows autentiseringsuppgifter under vilka Snapshot Agent körs hos distributören.

    • Det @job_password, som är lösenordet för de angivna Windows-autentiseringsuppgifterna.

    • (Valfritt) Värdet 0 för @publisher_security_mode om agenten använder SQL Server Authentication vid anslutning till Publisher. I detta fall måste du också ange inloggningsinformationen för SQL Server autentisering för @publisher_login och @publisher_password.

    • (Valfritt) Ett synkroniseringsschema för Snapshot Agent-jobbet. Mer information finns i Ange synkroniseringsscheman.

    Important

    När du konfigurerar en Publisher med en fjärrdistributör skickas de värden du tillhandahåller för alla parametrar, inklusive job_login och job_password, till distributören som klartext. Kryptera anslutningen mellan Publisher och dess fjärrdistributör innan du utför denna lagrade procedur. Mer information finns i Aktivera krypterade anslutningar till databasmotorn (SQL Server Configuration Manager).

  3. Lägg till artiklar i publikationen. Mer information finns i Definiera en artikel.

  4. Vid Publisher i publikationsdatabasen, kör sp_startpublication_snapshot (Transact-SQL), där värdet av @publication från steg 1 specificeras.

Använd en ögonblicksbild

Använda SQL Server Management Studio

Efter att snapshoten har genererats, synkronisera prenumerationen med Distribution Agent eller Merge Agent för att tillämpa den:

  • Om agenten körs kontinuerligt (standarden för transaktionell replikering) applicerar den automatiskt snapshoten efter att den genererat den.

  • Om agenten körs enligt ett schema applicerar den snapshoten nästa gång den körs.

  • Om agenten körs på begäran applicerar den snapshoten nästa gång du kör den.

    Mer information om hur du synkroniserar prenumerationer finns i Synkronisera en push-prenumeration och Synkronisera en pull-prenumeration.

Använda Transact-SQL

  1. Skapa en snapshot-, transaktions- eller sammanslagningspublikation. Mer information finns i Skapa en publikation.

  2. Lägg till artiklar i publikationen. Mer information finns i Definiera en artikel.

  3. Från kommandoprompten eller i en batchfil startar du replikeringsfilen Snapshot Agent genom att köra snapshot.exe, och specificera följande kommandoradsargument:

    • -Publikation
    • -Förläggare
    • -Distributör
    • -PublisherDB
    • -Replikationstyp

    Om du använder SQL Server-autentisering, ange också följande argument:

    • -DistributorLogin
    • -DistributorPassword
    • -DistributorSecurityMode = 0
    • -PublisherLogin
    • -PublisherPassword
    • -PublisherSecurityMode = 0

Exempel (Transact-SQL)

Detta exempel visar hur man skapar en transaktionell publikation och lägger till ett Snapshot Agent-jobb för den nya publikationen (med sqlcmd-skriptvariabler). Exemplet startar också jobbet.

-- To avoid storing the login and password in the script file, the values 
-- are passed into SQLCMD as scripting variables. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2022'; --publication database
SET @publication = N'AdvWorksCustomerTran'; -- transactional publication name
SET @login = $(Login);
SET @password = $(Password);

USE [AdventureWorks]

-- Enable transactional and snapshot replication on the publication database.
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'publish',
  @value = N'true';

-- Execute sp_addlogreader_agent to create the agent job. 
EXEC sp_addlogreader_agent 
  @job_login = @login, 
  @job_password = @password,
  -- Explicitly specify the security mode used when connecting to the Publisher.
  @publisher_security_mode = 1;

-- Create new transactional publication, using the defaults. 
USE [AdventureWorks2022]
EXEC sp_addpublication 
  @publication = @publication, 
  @description = N'transactional publication';

-- Create a new snapshot job for the publication, using the defaults.
EXEC sp_addpublication_snapshot 
  @publication = @publication,
  @job_login = @login,
  @job_password = @password;

-- Start the Snapshot Agent job.
EXEC sp_startpublication_snapshot @publication = @publication;
GO

Detta exempel skapar en sammanslagningspublikation och lägger till ett Snapshot Agent-jobb (med sqlcmd-variabler) för publikationen. Detta exempel startar också jobbet.

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2022'; 
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @login = $(Login);
SET @password = $(Password);

-- Enable merge replication on the publication database.
USE master
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname=N'merge publish',
  @value = N'true';

-- Create new merge publication, using the defaults. 
USE [AdventureWorks]
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication.';

-- Create a new snapshot job for the publication, using the defaults.
EXEC sp_addpublication_snapshot 
  @publication = @publication,
  @job_login = @login,
  @job_password = @password;

-- Start the Snapshot Agent job.
EXEC sp_startpublication_snapshot @publication = @publication;
GO

Följande kommandoradsargument startar Snapshot Agent för att generera snapshoten för en sammanslagningspublicering.

Note

Radbrytningar lades till för att förbättra läsbarheten. I en batchfil måste du göra kommandon på en enda rad.

  
REM -- Declare variables  
SET Publisher=%InstanceName%  
SET PublicationDB=AdventureWorks2022   
SET Publication=AdvWorksSalesOrdersMerge   
  
REM --Start the Snapshot Agent to generate the snapshot for AdvWorksSalesOrdersMerge.  
"C:\Program Files\Microsoft SQL Server\120\COM\SNAPSHOT.EXE" -Publication %Publication%   
-Publisher %Publisher% -Distributor %Publisher% -PublisherDB %PublicationDB%   
-ReplicationType 2 -OutputVerboseLevel 1 -DistributorSecurityMode 1

Använda replikeringshanteringsobjekt (RMO)

Snapshot Agent genererar snapshots efter att du skapat en publikation. Du kan programmerat generera dessa snapshots genom att använda Replication Management Objects (RMO) och direkt hanterad kodåtkomst till replikationsagentfunktioner. De objekt du använder beror på vilken typ av replikation det är. Du kan starta Snapshot Agent synkront genom att använda objektet SnapshotGenerationAgent eller asynkront genom att använda agentjobbet. Efter att den initiala snapshoten har genererats överför Snapshot Agent den till prenumeranten och applicerar den när prenumerationen först synkroniseras. Du behöver köra agenten igen när den befintliga snapshoten inte längre innehåller giltig up-to-date-data. För mer information, se Underhåll publikationer.

Important

När det är möjligt uppmanar du användarna att ange säkerhetsautentiseringsuppgifter vid körning. Om du måste lagra autentiseringsuppgifter använder du de kryptografiska tjänster som tillhandahålls av Microsoft Windows .NET Framework.

Generera den initiala ögonblicksbilden för en ögonblicksbildspublikation eller en transaktionspublicering genom att starta jobbet för Snapshot Agent (asynkront)

  1. Skapa en anslutning till Publisher med hjälp av klassen ServerConnection.

  2. Skapa en instans av TransPublication klassen. Ställ in egenskaperna Name och DatabaseName för publikationen och ställ in egenskapen ConnectionContext till den anslutning som skapades i steg 1.

  3. Anropa LoadProperties metoden för att ladda de återstående egenskaperna hos objektet. Om denna metod ger falskt, är antingen publiceringsegenskaperna i steg 2 felaktigt definierade eller så existerar publikationen inte.

  4. Om värdet på SnapshotAgentExists är falskt, anropa CreateSnapshotAgent för att skapa snapshot-agentjobbet för denna publikation.

  5. Anropa metoden StartSnapshotGenerationAgentJob för att starta agentjobbet som genererar ögonblicksbilden för publikationen.

  6. (Valfritt) När värdet för SnapshotAvailable är sant är ögonblicksbilden tillgänglig för prenumeranter.

För att generera den initiala snapshoten för en snapshot eller transaktionell publikation genom att köra Snapshot Agent (synkront)

  1. Skapa en instans av SnapshotGenerationAgent klassen och ange följande nödvändiga egenskaper:

  2. Sätt ett värde på Transactional eller Snapshot för ReplicationType.

  3. Anropa GenerateSnapshot metoden.

För att generera den initiala snapshoten för en merge-publikation genom att starta Snapshot Agent-jobbet (asynkront)

  1. Skapa en anslutning till Publisher med hjälp av klassen ServerConnection.

  2. Skapa en instans av MergePublication klassen. Ställ in egenskaperna Name och DatabaseName för publikationen och ställ in egenskapen ConnectionContext till den anslutning som skapades i steg 1.

  3. Anropa LoadProperties metoden för att ladda de återstående egenskaperna hos objektet. Om denna metod ger falskt, är antingen publiceringsegenskaperna i steg 2 felaktigt definierade eller så existerar publikationen inte.

  4. Om värdet på SnapshotAgentExists är falskt, anropa CreateSnapshotAgent för att skapa snapshot-agentjobbet för denna publikation.

  5. Anropa metoden StartSnapshotGenerationAgentJob för att starta agentjobbet som genererar ögonblicksbilden för publikationen.

  6. (Valfritt) När värdet för SnapshotAvailable är sant är ögonblicksbilden tillgänglig för prenumeranter.

För att generera den initiala snapshoten för en merge-publikation genom att köra Snapshot Agent (synkron)

  1. Skapa en instans av SnapshotGenerationAgent klassen och ange följande nödvändiga egenskaper:

  2. Sätt ett värde på Merge för ReplicationType.

  3. Anropa GenerateSnapshot metoden.

Exempel (RMO)

Detta exempel kör synkront Snapshot Agent för att generera den initiala snapshoten för en transaktionell publicering.

// Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2022";
string publisherName = publisherInstance;
string distributorName = publisherInstance;

SnapshotGenerationAgent agent;

try
{
    // Set the required properties for Snapshot Agent.
    agent = new SnapshotGenerationAgent();
    agent.Distributor = distributorName;
    agent.DistributorSecurityMode = SecurityMode.Integrated;
    agent.Publisher = publisherName;
    agent.PublisherSecurityMode = SecurityMode.Integrated;
    agent.Publication = publicationName;
    agent.PublisherDatabase = publicationDbName;
    agent.ReplicationType = ReplicationType.Transactional;

    // Start the agent synchronously.
    agent.GenerateSnapshot();

}
catch (Exception ex)
{
    // Implement custom application error handling here.
    throw new ApplicationException(String.Format(
        "A snapshot could not be generated for the {0} publication."
        , publicationName), ex);
}

' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2022"
Dim publisherName As String = publisherInstance
Dim distributorName As String = publisherInstance

Dim agent As SnapshotGenerationAgent

Try
    ' Set the required properties for Snapshot Agent.
    agent = New SnapshotGenerationAgent()
    agent.Distributor = distributorName
    agent.DistributorSecurityMode = SecurityMode.Integrated
    agent.Publisher = publisherName
    agent.PublisherSecurityMode = SecurityMode.Integrated
    agent.Publication = publicationName
    agent.PublisherDatabase = publicationDbName
    agent.ReplicationType = ReplicationType.Transactional

    ' Start the agent synchronously.
    agent.GenerateSnapshot()

Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
     "A snapshot could not be generated for the {0} publication." _
     , publicationName), ex)
End Try

Detta exempel startar agentjobbet asynkront för att generera den initiala snapshoten för en transaktionell publikation.

// Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2022";
string publisherName = publisherInstance;

TransPublication publication;

// Create a connection to the Publisher using Windows Authentication.
ServerConnection conn;
conn = new ServerConnection(publisherName);

try
{
    // Connect to the Publisher.
    conn.Connect();

    // Set the required properties for an existing publication.
    publication = new TransPublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;

    if (publication.LoadProperties())
    {
        // Start the Snapshot Agent job for the publication.
        publication.StartSnapshotGenerationAgentJob();
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The {0} publication does not exist.", publicationName));
    }
}
catch (Exception ex)
{
    // Implement custom application error handling here.
    throw new ApplicationException(String.Format(
        "A snapshot could not be generated for the {0} publication."
        , publicationName), ex);
}
finally
{
    conn.Disconnect();
}

' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2022"
Dim publisherName As String = publisherInstance

Dim publication As TransPublication

' Create a connection to the Publisher using Windows Authentication.
Dim conn As ServerConnection
conn = New ServerConnection(publisherName)

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Set the required properties for an existing publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    If publication.LoadProperties() Then
        ' Start the Snapshot Agent job for the publication.
        publication.StartSnapshotGenerationAgentJob()
    Else
        Throw New ApplicationException(String.Format( _
         "The {0} publication does not exist.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
     "A snapshot could not be generated for the {0} publication." _
     , publicationName), ex)
Finally
    conn.Disconnect()
End Try

Blockering vid applicering av initial snapshot

Om du har flera publikationer som publicerar data till en databas hos prenumeranterna märker du att endast en publikation i taget kan tillämpa sin ögonblicksbild när de initiala ögonblicksbilderna tillämpas.

Du kan se en väntresurs liknande följande när du granskar SQL-aktivitet:

APP: 18:16384:[snapshot_delivery_in_progress_Tr]:(9bcdaf92)
APP: 5:16384:[snapshot_delivery_in_progress_Er]:(3c3b7db9)

Att söka efter låsbeteende kan visa resurser liknande följande:

APP 16384:[appname]:(fbe42d68) XAPP 16384:[snapshot_del]:(9bcdaf92) X

Det här beteendet är avsiktligt. Det uppstår eftersom ett applikationslås används för att förhindra att flera replikeringsagenter samtidigt applicerar snapshots av olika publikationer på samma prenumerationsdatabas. Eftersom applikationslåset innehåller namnet på abonnentdatabasen kommer alla publikationer som publiceras i samma abonnentdatabas att påverkas. Resultatet är att endast en ögonblicksbild kan infogas i abonnentdatabasen åt gången.

Exklusiva lås används i denna situation för att undvika risken att replikationsagenter fastnar med varandra.

För att kringgå detta problem, ange en separat prenumerantdatabas för varje publikation.

Relaterat innehåll

  • Uppdaterades senast