Meet latentie en valideer verbindingen voor transactionele replicatie

Van toepassing op:SQL ServerAzure SQL Managed Instance

Dit onderwerp beschrijft hoe je latentie kunt meten en verbindingen valideert voor transactionele replicatie in SQL Server met behulp van Replication Monitor, Transact-SQL of Replication Management Objects (RMO). Transactionele replicatie biedt de tracer-tokenfunctie, die een handige manier biedt om latentie in transactionele replicatietopologieën te meten en de verbindingen tussen de Publisher, Distributor en Subscribers te valideren. Een token (een kleine hoeveelheid data) wordt geschreven naar het transactielogboek van de publicatiedatabase, gemarkeerd alsof het een typische gerepliceerde transactie is, en via het systeem verzonden, waardoor een berekening mogelijk is van:

  • Hoeveel tijd verstrijkt tussen het uitvoeren van een transactie bij de Publisher en het invoeren van het bijbehorende commando in de distributiedatabase bij de Distributor.

  • Hoeveel tijd verstrijkt tussen het invoeren van een commando in de distributiedatabase en het toewijden van de overeenkomstige transactie aan een abonnee?

Uit deze berekeningen kun je een aantal vragen beantwoorden, waaronder:

  • Welke abonnees doen er het langst over om een wijziging van de Publisher te ontvangen?

  • Welke van de abonnees die het tracer-token zouden moeten ontvangen, hebben dit niet ontvangen?

Beperkingen en beperkingen

Tracer-tokens kunnen ook nuttig zijn bij het quiescen van een systeem, waarbij alle activiteiten worden stopgezet en gecontroleerd wordt dat alle nodes alle openstaande wijzigingen hebben ontvangen. Zie Een replicatietopologie onderbreken (Programmeren van replicatie in Transact-SQL) voor meer informatie.

Om tracertokens te gebruiken, moet je bepaalde versies van Microsoft SQL Server gebruiken:

  • De distributeur moet Microsoft SQL Server 2005 (9.x) of later zijn.

  • De Publisher moet SQL Server 2005 (9.x) of later zijn of een Oracle Publisher zijn.

  • Voor push-abonnementen worden tracer-tokenstatistieken verzameld van de Publisher, Distributor en Subscribers, als de Subscriber Microsoft SQL Server 7.0 of later is.

  • Voor pull-abonnementen worden tracer-tokenstatistieken alleen verzameld van abonnees als de abonnee SQL Server 2005 (9.x) of later is. Als de abonnee SQL Server 7.0 of Microsoft SQL Server 2000 (8.x) is, worden statistieken alleen verzameld van de Publisher en Distributor.

Er zijn ook een aantal andere kwesties en beperkingen waar je rekening mee moet houden:

  • Abonnementen moeten actief zijn om een tracer-token te ontvangen. Een abonnement is actief als het is geïnitialiseerd.

  • Herinitialisatie verwijdert alle lopende tracer-tokens voor de relevante abonnementen.

  • Abonnees ontvangen alleen tracertokens die zijn aangemaakt na hun initiële synchronisatie.

  • Tracer-tokens worden niet doorgestuurd door het opnieuw publiceren van abonnees.

  • Na failover naar een secundaire kan Replication Monitor de naam van de publicatie-instantie van SQL Server niet aanpassen en blijft replicatie-informatie weergeven onder de naam van de oorspronkelijke primaire instantie van SQL Server. Na failover kan een tracertoken niet worden ingevoerd met de Replication Monitor, maar een tracertoken dat op de nieuwe uitgever is ingevoerd met Transact-SQL, is zichtbaar in Replication Monitor.

Gebruik van SQL Server Replication Monitor

Zie Replicatiecontrole starten voor meer informatie over het starten van replicatiecontrole.

Om een tracer-token in te voegen en informatie op het token te bekijken

  1. Wijd een Publisher-groep uit in het linker paneel, selecteer een Publisher en klik vervolgens op een publicatie.

  2. Klik op het tabblad Tracer Tokens .

  3. Klik op Tracer invoegen.

  4. Bekijk de verstreken tijd voor het tracertoken in de volgende kolommen: Publisher to Distributor, Distributor to Subscriber, Total Latency. Een waarde van Pending geeft aan dat de token een bepaald punt nog niet heeft bereikt.

Om informatie te bekijken over een eerder ingevoegde tracertoken

  1. Wijd een Publisher-groep uit in het linker paneel, selecteer een Publisher en klik vervolgens op een publicatie.

  2. Klik op het tabblad Tracer Tokens .

  3. Selecteer een tijd in de keuzelijst Tijd ingevoegd.

  4. Bekijk de verstreken tijd voor het tracertoken in de volgende kolommen: Publisher to Distributor, Distributor to Subscriber, Total Latency. Een waarde van Pending geeft aan dat de token een bepaald punt nog niet heeft bereikt.

    Note

    Tracer-tokeninformatie wordt bewaard voor dezelfde periode als andere historische gegevens, wat wordt bepaald door de geschiedenisbewaarperiode van de distributiedatabase. Voor informatie over het wijzigen van eigenschappen van distributiedatabases, zie Bekijk en amodificeer Distributor en Publisher Properties.

Transact-SQL gebruiken

Om een tracer-token te plaatsen bij een transactionele publicatie

  1. (Optioneel) Voer bij de Publisher in de publicatiedatabase sp_helppublication (Transact-SQL) uit. Controleer of de publicatie bestaat en dat de status actief is.

  2. (Optioneel) Voer bij de Publisher in de publicatiedatabase sp_helpsubscription (Transact-SQL) uit. Controleer of het abonnement bestaat en dat de status actief is.

  3. Voer bij de Publisher in de publicatiedatabase sp_posttracertoken (Transact-SQL) uit, met opgave van @publication. Let op de waarde van de @tracer_token_id outputparameter.

Het bepalen van latentie en het valideren van verbindingen voor een transactionele publicatie

  1. Plaats een tracer-token naar de publicatie volgens de vorige procedure.

  2. Voer op de Publisher in de publicatiedatabase sp_helptracertokens (Transact-SQL) uit, waarbij u @publication opgeeft. Dit geeft een lijst op van alle tracer-tokens die in de publicatie zijn geplaatst. Noteer de gewenste tracer_id in de resultaatset.

  3. Voer Publisher in de publicatiedatabase sp_helptracertokenhistory (Transact-SQL) uit, waarbij @publication en de tracer-token ID uit stap 2 voor @tracer_id worden gespecificeerd. Dit geeft latentie-informatie terug voor het geselecteerde tracertoken.

Om tracer-tokens te verwijderen

  1. Voer op de Publisher in de publicatiedatabase sp_helptracertokens (Transact-SQL) uit, waarbij u @publication opgeeft. Dit geeft een lijst op van alle tracer-tokens die in de publicatie zijn geplaatst. Noteer de tracer_id van het tracer-token dat in de resultatenset moet worden verwijderd.

  2. Voer Publisher op de publicatiedatabase sp_deletetracertokenhistory uit (Transact-SQL), waarbij @publication en de ID van de tracer wordt gespecificeerd die uit stap 2 verwijderd moet worden voor @tracer_id.

Voorbeeld (Transact-SQL)

Dit voorbeeld plaatst een tracer-tokenrecord en gebruikt de teruggegeven ID van het geplaatste tracertoken om latentie-informatie te bekijken.

DECLARE @publication AS sysname;
DECLARE @tokenID AS int;
SET @publication = N'AdvWorksProductTran'; 

USE [AdventureWorks2022]

-- Insert a new tracer token in the publication database.
EXEC sys.sp_posttracertoken 
  @publication = @publication,
  @tracer_token_id = @tokenID OUTPUT;
SELECT 'The ID of the new tracer token is ''' + 
    CONVERT(varchar,@tokenID) + '''.'
GO

-- Wait 10 seconds for the token to make it to the Subscriber.
WAITFOR DELAY '00:00:10';
GO

-- Get latency information for the last inserted token.
DECLARE @publication AS sysname;
DECLARE @tokenID AS int;
SET @publication = N'AdvWorksProductTran'; 

CREATE TABLE #tokens (tracer_id int, publisher_commit datetime)

-- Return tracer token information to a temp table.
INSERT #tokens (tracer_id, publisher_commit)
EXEC sys.sp_helptracertokens @publication = @publication;
SET @tokenID = (SELECT TOP 1 tracer_id FROM #tokens
ORDER BY publisher_commit DESC)
DROP TABLE #tokens

-- Get history for the tracer token.
EXEC sys.sp_helptracertokenhistory 
  @publication = @publication, 
  @tracer_id = @tokenID;
GO

Replicatiebeheerobjecten (RMO) gebruiken

Om een tracer-token te plaatsen bij een transactionele publicatie

  1. Maak een verbinding met publisher met behulp van de ServerConnection klasse.

  2. Maak een exemplaar van de TransPublication-klasse.

  3. Stel voor de publicatie de eigenschappen Name en DatabaseName in, en stel de eigenschap ConnectionContext in op de verbinding die in stap 1 is aangemaakt.

  4. Roep de LoadProperties methode aan om de eigenschappen van het object op te halen. Als deze methode onwaar is, zijn ofwel de publicatie-eigenschappen in stap 3 verkeerd gedefinieerd of bestaat de publicatie niet.

  5. Roep de PostTracerToken methode aan. Deze methode voegt een tracer-token in in het transactielogboek van de publicatie.

Het bepalen van latentie en het valideren van verbindingen voor een transactionele publicatie

  1. Maak een verbinding met de distributeur met behulp van de ServerConnection klasse.

  2. Maak een exemplaar van de PublicationMonitor-klasse.

  3. Stel de Name, DistributionDBName, PublisherName, en PublicationDBName eigenschappen in, en stel de ConnectionContext eigenschap in op de verbinding die in stap 1 is aangemaakt.

  4. Roep de LoadProperties methode aan om de eigenschappen van het object op te halen. Als deze methode false retourneert, zijn ofwel de eigenschappen van de publicatiemonitor in stap 3 onjuist gedefinieerd of bestaat de publicatie niet.

  5. Roep de EnumTracerTokens methode aan. Cast het teruggestuurde ArrayList object naar een array van TracerToken objecten.

  6. Roep de EnumTracerTokenHistory methode aan. Geef een waarde van TracerTokenId door voor een tracer-token uit stap 5. Dit geeft latentie-informatie terug voor het geselecteerde tracer-token als object DataSet . Als alle tracer-tokeninformatie wordt teruggegeven, bestaan zowel de verbinding tussen de Publisher en de Distributor als de verbinding tussen de Distributor en de Subscriber en werkt de replicatietopologie.

Om tracer-tokens te verwijderen

  1. Maak een verbinding met de distributeur met behulp van de ServerConnection klasse.

  2. Maak een exemplaar van de PublicationMonitor-klasse.

  3. Stel de Name, DistributionDBName, PublisherName, en PublicationDBName eigenschappen in, en stel de ConnectionContext eigenschap in op de verbinding die in stap 1 is aangemaakt.

  4. Roep de LoadProperties methode aan om de eigenschappen van het object op te halen. Als deze methode false retourneert, zijn ofwel de eigenschappen van de publicatiemonitor in stap 3 onjuist gedefinieerd of bestaat de publicatie niet.

  5. Roep de EnumTracerTokens methode aan. Cast het teruggestuurde ArrayList object naar een array van TracerToken objecten.

  6. Roep de CleanUpTracerTokenHistory methode aan. Geef een van de volgende waarden door:

    • TracerTokenId voor een tracer-token uit stap 5. Dit verwijdert informatie voor een geselecteerd token.

    • Een DateTime-object. Dit verwijdert informatie voor alle tokens die ouder zijn dan de opgegeven datum en tijd.