Skapa och tillämpa den initiala snapshoten

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

Detta ämne beskriver hur man skapar och tillämpar den initiala ögonblicksbildskopian 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.
Snapshots genereras av Snapshot Agent efter att en publikation har skapats. De kan genereras:

  • Omedelbart. Som standard genereras en ögonblicksbild för en sammanslagningspublikation omedelbart efter att publikationen skapats i Ny publiceringsguiden.
  • 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 sammanslagningsreplikering genereras en ögonblicksbild varje gång ögonblicksbildsagenten körs. För transaktionell replikation beror snapshot-generering på inställningen av publiceringsegenskapen immediate_sync. Om egenskapen är satt till SANT (standarden vid användning av New Publication Wizard) genereras en snapshot varje gång Snapshot Agent körs, och den kan tillämpas på en prenumerant när som helst. Om egenskapen är satt till FALSE (standarden vid användning av sp_addpublication), genereras snapshoten endast om en ny prenumeration har lagts till sedan senaste Snapshot Agent körning; Prenumeranter måste vänta tills Snapshot Agent är klar innan de kan synkronisera.

Som standard, när snapshots genereras, sparas de 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 i standardmappen för snapshot. Dessutom kan du komprimera filerna så att de är lättare att lagra och överföra, och köra skript före eller efter att snapshoten appliceras på prenumeranten. För mer information om dessa alternativ, se Snapshot Options.

Om snapshoten är för en merge-publikation som använder parameteriserade filter, skapas snapshoten med en tvådelad process. Först skapas en schema-snapshot som innehåller replikeringsskripten och schemat för de publicerade objekten, men inte datan. Varje prenumeration initieras 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 snapshoten skapats hos Publisher och lagrats på en standard- eller alternativ snapshot-plats kan snapshoten överföras till prenumeranten och appliceras. Distribution Agent (för snapshot eller transaktionell replikering) eller Merge Agent (för merge-replikering) överför snapshoten och applicerar schemat och datafilerna på prenumerationsdatabasen på abonnenten under den initiala synkroniseringen. Som standard sker den initiala synkroniseringen omedelbart efter att en prenumeration skapats om du använder New Subscription Wizard. Detta beteende styrs av alternativet Initialisera när, på guidens sida Initialisera prenumerationer . När ögonblicksbilder genereras efter att en prenumeration har initierats tillämpas de inte på en prenumerant, såvida inte prenumerationen har markerats 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 i 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>, klicka på 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 måste ha skrivbehörigheter för den katalog du anger, och Distribution Agent eller Merge Agent måste ha läsbehörigheter. Om pull-prenumerationer används måste du ange en delad katalog som en universell namngivningskonvention (UNC)-vä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, genereras en snapshot av Snapshot Agent omedelbart efter att en publikation skapats med New Publication Wizard. Som standard tillämpas det sedan av Distribution Agent (för snapshot och transaktionell replikering) eller Merge Agent (för merge-prenumerationer) för alla prenumerationer. En snapshot kan också genereras med 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 klicka sedan på View Snapshot Agent Status.
  4. I dialogrutan Visa status för ögonblicksbildagent – <publikation> klickar du på 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 skapa en snapshot, och klicka sedan på Generate Snapshot.
  3. För att se statusen för Snapshot Agent, klicka på fliken Agents. För mer detaljerad information, högerklicka på Snapshot Agent i rutnätet och klicka sedan på Visa detaljer.

Använda Transact-SQL

Initiala snapshots kan programmatiskt skapas antingen 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 när 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 måste du skydda 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) Ett värde på 0 för @publisher_security_mode om agenten kommer att använda 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 utgivare med en fjärransluten distributör skickas de värden som anges för alla parametrar, inklusive job_login och job_password, till distributören som oformaterad text. Du bör kryptera anslutningen mellan Utgivaren och dess fjärranslutna distributör innan du kör den här lagrade proceduren. 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

  1. Efter att snapshoten har genererats tillämpas den genom att synkronisera prenumerationen med Distribution Agent eller Merge Agent:

    • Om agenten är inställd att köras kontinuerligt (standarden för transaktionell replikering) tillämpas snapshoten automatiskt efter att den har genererats.
    • Om agenten är inställd på att köras enligt ett schema appliceras snapshoten nästa gång agenten schemaläggs att köras.
    • Om agenten är inställd på att köra på begäran tillämpas den nästa gång du kör agenten.

    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 måste du också ange 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 kommandon göras 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 en publikation har skapats. Du kan generera dessa snapshots programmatiskt 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. Snapshot Agent kan startas synkront med objektet SnapshotGenerationAgent eller asynkront med agentjobbet. Efter att den initiala snapshoten har genererats överförs den till och appliceras på prenumeranten när prenumerationen först synkroniseras. Du behöver köra agenten igen när den befintliga ögonblicksbilden inte längre innehåller giltiga och aktuella 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 den här metoden returnerar falsehar publikationsegenskaperna i steg 2 definierats felaktigt eller så finns 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 den här metoden returnerar falsehar publikationsegenskaperna i steg 2 definierats felaktigt eller så finns 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 i en databas hos prenumeranten/prenumeranterna, märker du att endast en publikation kan använda sin snapshot åt gången, samtidigt som du applicerar den initiala snapshoten/snapshoten.

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

  • Last updated on