Replikációs pillanatkép-ügynök

A következőkre vonatkozik:SQL ServerAzure SQL Database

A replikációs pillanatkép-ügynök egy végrehajtható fájl, amely előkészíti a közzétett táblák és adatbázis-objektumok sémáját és adatait tartalmazó pillanatképfájlokat, tárolja a fájlokat a pillanatkép mappában, és rögzíti a szinkronizálási feladatokat a terjesztési adatbázisban.

Megjegyzés:

• A paraméterek bármilyen sorrendben megadhatók.

Megjegyzés:

A felügyelt Azure SQL-példány közzétevő, terjesztő és előfizető lehet a pillanatképek és a tranzakciós replikáció számára. Az Azure SQL Database adatbázisai csak pillanatkép- és tranzakciós replikáció push előfizetői lehetnek. További információ: Tranzakciós replikáció az Azure SQL Database-sel és a felügyelt Azure SQL-példányokkal.

Szemantika

  
snapshot [ -?]   
-Publisher server_name[\instance_name]   
-Publication publication_name   
[-70Subscribers]   
[-BcpBatchSize bcp_batch_size]  
[-DefinitionFile def_path_and_file_name]  
[-Distributor server_name[\instance_name]]  
[-DistributorDeadlockPriority [-1|0|1] ]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1] ]  
[-DynamicFilterHostName dynamic_filter_host_name]  
[-DynamicFilterLogin dynamic_filter_login]  
[-DynamicSnapshotLocation dynamic_snapshot_location]   
[-EncryptionLevel [0|1|2|3|4]]  
[-FieldDelimiter field_delimiter]  
[-HistoryVerboseLevel [0|1|2|3] ]  
[-HRBcpBlocks number_of_blocks ]  
[-HRBcpBlockSize block_size ]  
[-HRBcpDynamicBlocks ]  
[-KeepAliveMessageInterval keep_alive_interval]  
[-LoginTimeOut login_time_out_seconds]  
[-MaxBcpThreads number_of_threads ]  
[-MaxNetworkOptimization [0|1]]  
[-Output output_path_and_file_name]  
[-OutputVerboseLevel [0|1|2] ]  
[-PacketSize packet_size]  
[-PrefetchTables [0|1] ]  
[-ProfileName profile_name]  
[-PublisherDB publisher_database]  
[-PublisherDeadlockPriority [-1|0|1] ]  
[-PublisherFailoverPartner server_name[\instance_name] ]  
[-PublisherLogin publisher_login]  
[-PublisherPassword publisher_password]   
[-PublisherSecurityMode [0|1] ]  
[-QueryTimeOut query_time_out_seconds]  
[-ReplicationType [1|2] ]  
[-RowDelimiter row_delimiter]  
[-StartQueueTimeout start_queue_timeout_seconds]  
[-UsePerArticleContentsView use_per_article_contents_view]  

Érvek

-?
Kinyomtatja az összes elérhető paramétert.

-Kiadóserver_name[\instance_name]
A Közzétevő neve. Adja meg a microsoft SQL Server alapértelmezett példányának server_name az adott kiszolgálón. Adja meg server_name\instance_name az adott kiszolgálón található SQL Server egy nevesített példányához.

-Kiadvány
A kiadvány neve. Ez a paraméter csak akkor érvényes, ha a kiadvány úgy van beállítva, hogy mindig legyen elérhető pillanatkép új vagy újraincializált előfizetésekhez.

-70Subscribers
Akkor kell használni, ha bármely előfizető az SQL Server 7.0-s verzióját futtatja.

-BcpBatchSizebcp_ batch_ méret
A tömeges másolási műveletben küldendő sorok száma. A bcp művelet végrehajtásakor a köteg mérete a kiszolgálónak egyetlen tranzakcióként küldendő sorok száma, valamint azoknak a soroknak a száma, amelyeket el kell küldeni, mielőtt a terjesztési ügynök naplózza a bcp folyamatjelző üzenetét. A bcp out művelet végrehajtásakor a rendszer 1000-es rögzített kötegméretet használ. A 0 érték azt jelzi, hogy nincs üzenetnaplózás.

-DefinitionFiledef_path_and_file_name
Az ügynökdefiníciós fájl elérési útja. Az ügynökdefiníciós fájl parancssori argumentumokat tartalmaz az ügynökhöz. A fájl tartalma végrehajtható fájlként van elemezve. Használjon dupla idézőjeleket (") tetszőleges karaktereket tartalmazó argumentumértékek megadásához.

-Forgalmazóiserver_name[\instance_name]
A forgalmazó neve. Adja meg a server_name a kiszolgálón lévő SQL Server alapértelmezett példányához. Adja meg server_name\instance_name az adott kiszolgálón található SQL Server egy nevesített példányához.

-ForgalmazóDeadlockPrioritás [-1|0|1]
Holtpont esetén a Pillanatkép-ügynök kapcsolat prioritása a forgalmazóval. Ez a paraméter a Pillanatkép-ügynök és a felhasználói alkalmazások között a pillanatkép-létrehozás során előforduló holtpontok feloldására van megadva.

DistributorDeadlockPriority érték	Leírás
-1	A Pillanatkép-ügynökön kívüli alkalmazások elsőbbséget élveznek, ha holtpont lép fel a forgalmazónál.
0 (Alapértelmezett)	A prioritás nincs hozzárendelve.
1	A pillanatkép-ügynök prioritással rendelkezik, ha holtpont lép fel a forgalmazónál.

-DistributorLogindistributor_login
Az SQL Server-hitelesítéssel a forgalmazóhoz való csatlakozáskor használt bejelentkezés.

-DistributorPassworddistributor_password
Az SQL Server-hitelesítés használatával a forgalmazóhoz való csatlakozáskor használt jelszó.

-ForgalmazóBiztonsági Mód [ 0| 1]
A forgalmazó biztonsági módját adja meg. A 0 érték az SQL Server hitelesítési módot (alapértelmezett), az 1 érték pedig a Windows hitelesítési módot jelöli.

-DynamicFilterHostNamedynamic_filter_host_name
A dinamikus pillanatkép létrehozásakor a szűrés során HOST_NAME (Transact-SQL) értékének beállítására szolgál. Ha például az alhalmazszűrő záradék rep_id = HOST_NAME() meg van adva egy cikkhez, és a DynamicFilterHostName tulajdonságot "FBJones" értékre állítja az egyesítési ügynök meghívása előtt, a rendszer csak azokat a sorokat replikálja, amelyekben az "FBJones" szerepel a rep_id oszlopban.

-DynamicFilterLogindynamic_filter_login
A dinamikus pillanatkép létrehozásakor a szűrés során SUSER_SNAME (Transact-SQL) értékének beállítására szolgál. Ha például az alhalmazszűrő záradék user_id = SUSER_SNAME() meg van adva egy cikkhez, és a DynamicFilterLogin tulajdonságot "rsmith" értékre állítja, mielőtt meghívná az SQLSnapshot objektum futtatási metódusát, csak a user_id oszlopban "rsmith" értékű sorok lesznek belefoglalva a pillanatképbe.

-DynamicSnapshotLocationdynamic_snapshot_location
Az a hely, ahol létre kell hozni a dinamikus pillanatképet.

-Titkosítási szint [ 0 | 1 | 2 | 3 | 4]
A Transport Layer Security (TLS), korábbi nevén Secure Sockets Layer (SSL) titkosítás szintje, amelyet a pillanatkép-ügynök használ a kapcsolatok létrehozásakor.

EncryptionLevel érték	Leírás
0	Azt adja meg, hogy a TLS nincs használatban.
1	A TLS 1.2 használatát határozza meg, de az ügynök nem ellenőrzi, hogy a TLS/SSL-kiszolgáló tanúsítványát megbízható kiállító írta-e alá.
2	A TLS 1.2 használatát és a tanúsítvány ellenőrzését határozza meg.
3	Megadja, hogy a felügyelt Azure SQL-példányból, illetve az SQL Server 2025-ös és újabb verzióiból az Azure SQL Managed Instance-hez való kapcsolatok esetében a TLS 1.3 legyen használva, és a tanúsítvány hitelesítve legyen. Az SQL Serverrel (bármely támogatott verzióval) létesített kapcsolatok esetén a TLS 1.3 nem lesz kényszerítve a beállítással 3.
4	Megadja, hogy a felügyelt Azure SQL-példányból, illetve az SQL Server 2025-ös és újabb verzióiból az Azure SQL Managed Instance-hez való kapcsolatok esetében a TLS 1.3 legyen használva, és a tanúsítvány hitelesítve legyen. A felügyelt Azure SQL-példányról vagy az SQL Server 2025-ös és újabb verzióiról az SQL Serverre (bármely támogatott verzióra) irányuló kapcsolatok esetén a TLS 1.3-at használja a rendszer, és ellenőrzi a tanúsítványt. A tanúsítványt olyan SQL Server-gazdagépekre kell telepíteni, amelyek a következő beállítással EncryptionLevel4fogadnak kapcsolatokat: .

Az érvényes TLS/SSL-tanúsítvány az SQL Server teljes tartománynevével van definiálva. Ahhoz, hogy az ügynök sikeresen kapcsolódhasson a -EncryptionLevel 2 értékre állításakor, hozzon létre egy aliast a helyi SQL Serveren. Az "Alias neve" paraméternek a kiszolgálónévnek kell lennie, a "Kiszolgáló" paraméternek pedig az SQL Server teljes névre kell állítania.

További információ: Replikációs biztonsági beállítások megtekintése és módosítása.

-FieldDelimiterfield_delimiter
Az a karakter vagy karaktersorozat, amely az SQL Server tömeges másolási adatfájljában lévő mező végét jelöli. Az alapértelmezett érték \n<x 3> usd\n.

-TörténelemKiterjedt szint [1| ,2| ,3]
A pillanatkép-művelet során naplózott előzmények mennyiségét adja meg. Az 1 lehetőséget választva minimalizálhatja az előzménynaplózás teljesítményre gyakorolt hatását.

HistoryVerboseLevel érték	Leírás
0	A folyamatjelző üzeneteket a rendszer a konzolra vagy egy kimeneti fájlba írja. A rendszer nem naplózza az előzményrekordokat a terjesztési adatbázisban.
1	Mindig frissítsen egy korábbi, azonos állapotú előzményüzenetet (indítás, folyamat, siker stb.). Ha nincs ilyen állapotú korábbi rekord, szúrjon be egy új rekordot.
2 (alapértelmezett)	Új előzményrekordok beszúrása, kivéve, ha a rekord olyan dolgokra vonatkozik, mint az üresjárati üzenetek vagy a hosszú ideig futó feladatüzenetek, amely esetben frissíti az előző rekordokat.
3	Mindig szúrjon be új rekordokat, kivéve, ha üresjárati üzenetekről van szó.

-HRBcpBlocksnumber_of_blocks
Az író és olvasószálak között várólistára helyezett bcp-adatblokkok száma. Az alapértelmezett érték: 50. A HRBcpBlocks csak Oracle-kiadványokkal használható.

Megjegyzés:

Ez a paraméter az Oracle Publisher bcp-teljesítményének teljesítményhangolására szolgál.

- HRBcpBlockMéretblock_size
Az egyes bcp-adatblokkok mérete kilobájtban (KB). Az alapértelmezett érték 64 KB. A HRBcpBlocks csak Oracle-kiadványokkal használható.

Megjegyzés:

Ez a paraméter az Oracle Publisher bcp-teljesítményének teljesítményhangolására szolgál.

-HRBcpDynamicBlocks
Azt jelzi, hogy az egyes bcp-adatblokkok mérete dinamikusan növekedhet-e. A HRBcpBlocks csak Oracle-kiadványokkal használható.

Megjegyzés:

Ez a paraméter az Oracle Publisher bcp-teljesítményének teljesítményhangolására szolgál.

-KeepAliveMessageIntervalkeep_alive_interval
Az az idő másodpercben, amelyet a Pillanatkép-ügynök a "háttérüzenetre várva" naplózás előtt vár a MSsnapshot_history táblába. Az alapértelmezett érték 300 másodperc.

-LoginTimeOutlogin_time_out_seconds
A bejelentkezési idő túllépése előtti másodpercek száma. Az alapértelmezett érték 15 másodperc.

-MaxBcpThreadsnumber_of_threads
Megadja a párhuzamosan végrehajtható tömeges másolási műveletek számát. Az egyidejűleg létező szálak és ODBC-kapcsolatok maximális száma a MaxBcpThreads kisebb vagy a terjesztési adatbázisban a szinkronizálási tranzakcióban megjelenő tömeges másolási kérelmek száma. A MaxBcpThreads értékének 0-nál nagyobbnak kell lennie, és nincs rögzített felső korlátja. Az alapértelmezett érték a processzorok számának kétszerese.

Megjegyzés:

Ha a replikált objektum rendelkezik szűrővel, akkor a Pillanatkép-ügynök csak egy BCP-fájlt fog létrehozni a cikkhez ahelyett, hogy több BCP-fájlt hoz létre.

- MaxNetworkOptimalizáció [ 0| 1]
Az a kérdés, hogy a rendszer irreleváns törléseket küld-e az előfizetőnek. A irreleváns törlések olyan DELETE parancsok, amelyeket a rendszer az előfizetőknek küld olyan sorokhoz, amelyek nem tartoznak az előfizető partíciójára. A irreleváns törlések nem befolyásolják az adatok integritását vagy konvergenciáját, de szükségtelen hálózati forgalmat eredményezhetnek. A MaxNetworkOptimization alapértelmezett értéke 0. A MaxNetworkOptimization beállítása 1-es értékre, minimalizálva az irreleváns törlések esélyét, ezáltal csökkentve a hálózati forgalmat, és maximalizálja a hálózatoptimalizálást. Ha ezt a paramétert 1-re állítja, növelheti a metaadatok tárolását, és a Publisher teljesítménycsökkenését is okozhatja, ha több szintű illesztési szűrők és összetett részhalmazszűrők vannak jelen. Gondosan értékelje ki a replikációs topológiát, és csak akkor állítsa a MaxNetworkOptimizationértéket 1 értékre, ha az irreleváns törlésekből származó hálózati forgalom elfogadhatatlanul magas.

Megjegyzés:

A paraméter 1 értékre állítása csak akkor hasznos, ha az egyesítési kiadvány szinkronizálásoptimalizálási beállítása igaz (a @keep_partition_changes**sp_addmergepublication paramétere (Transact-SQL)).

-Kimenetioutput_path_and_file_name
Az ügynök kimeneti fájljának elérési útja. Ha a fájlnév nincs megadva, a rendszer elküldi a kimenetet a konzolnak. Ha a megadott fájlnév létezik, a kimenet hozzá lesz fűzve a fájlhoz.

-OutputVerboseLevel [ 0| 1| 2]
Megadja, hogy a kimenetnek részletesnek kell-e lennie.

OutputVerboseLevel érték	Leírás
0	A rendszer csak a hibaüzeneteket nyomtatja ki.
1 (alapértelmezett)	A folyamatjelentés összes üzenete ki lesz nyomtatva (alapértelmezett).
2	A rendszer minden hibaüzenetet és állapotjelentést kinyomtat, ami hibakereséshez hasznos.

-PacketSizepacket_size
A Pillanatkép-ügynök által az SQL Serverhez való csatlakozáskor használt csomagméret (bájtban kifejezve). Az alapértelmezett érték 8192 bájt.

Megjegyzés:

Ne módosítsa a csomagméretet, hacsak nem biztos abban, hogy az javítja a teljesítményt. A legtöbb alkalmazás esetében az alapértelmezett csomagméret a legjobb.

-PrefetchTables [ 0| 1]
Nem kötelező paraméter, amely meghatározza, hogy a táblaobjektumok előre be lesznek-e állítva és gyorsítótárazva lesznek-e. Az alapértelmezett viselkedés az, hogy egy belső számítás alapján előre leküld bizonyos táblatulajdonságokat az SMO-összetevő használatával. Ez a paraméter olyan helyzetekben lehet hasznos, amikor az SMO előfuttatási műveletének futtatása hosszabb időt vesz igénybe. Ha ezt a paramétert nem használja, a döntés futásidőben történik a kiadvány cikkekként hozzáadott táblák százalékos aránya alapján.

OutputVerboseLevel érték	Leírás
0	Az SMO-összetevő előzetes hívási metódusa le van tiltva.
1	A Pillanatkép-ügynök meghívja a Prefetch metódust néhány táblatulajdonság SMO használatával történő gyorsítótárazásához

-ProfileNameprofile_name
Megadja az ügynökparaméterekhez használandó ügynökprofilt. Ha a ProfileName null értékű, az ügynökprofil le van tiltva. Ha a ProfileName nincs megadva, a rendszer az ügynöktípus alapértelmezett profilját használja. További információ: Replikációs ügynök profiljai.

-PublisherDBpublisher_database
A közzétételi adatbázis neve. Ez a paraméter nem támogatott az Oracle Publishers esetében.

-KiadóDeadlockPrioritás [-1|0|1]
Holtpont esetén a Pillanatkép-ügynök kapcsolat prioritása a Publisherrel. Ez a paraméter a Pillanatkép-ügynök és a felhasználói alkalmazások között a pillanatkép-létrehozás során előforduló holtpontok feloldására van megadva.

PublisherDeadlockPriority érték	Leírás
-1	A Pillanatkép-ügynökön kívüli alkalmazások elsőbbséget élveznek, ha holtpont lép fel a Publisherben.
0 (Alapértelmezett)	A prioritás nincs hozzárendelve.
1	A Pillanatkép-ügynök prioritással rendelkezik, ha holtpont lép fel a Publisherben.

-PublisherFailoverPartnerserver_name[\instance_name]
A közzétételi adatbázis adatbázis-tükrözési munkamenetében részt vevő SQL Server feladatátvevő partnerpéldányát adja meg. További információ: Adatbázis-tükrözés és replikáció (SQL Server).

-PublisherLoginpublisher_login
Az SQL Server-hitelesítéssel a Publisherhez való csatlakozáskor használt bejelentkezés.

-PublisherPasswordpublisher_password
Az SQL Server-hitelesítéssel a Publisherhez való csatlakozáskor használt jelszó.

-PublisherSecurityMode [ 0| 1]
A Publisher biztonsági módját adja meg. A 0 érték az SQL Server-hitelesítést (alapértelmezett), az 1 érték pedig a Windows hitelesítési módot jelöli.

-QueryTimeOutquery_time_out_seconds
A lekérdezés időtúllépése előtti másodpercek száma. Az alapértelmezett érték 1800 másodperc.

-Replikációtípus [ 1| 2]
A replikáció típusát adja meg. Az 1 érték a tranzakciós replikációt, a 2 érték pedig az egyesítési replikációt jelöli.

-RowDelimiterrow_delimiter
Az SQL Server tömeges másolási adatfájl sorának végét jelző karakter vagy karaktersorozat. Az alapértelmezett érték \n<,@g>\n.

-StartQueueTimeoutstart_queue_timeout_seconds
Az a maximális másodpercszám, amíg a Pillanatkép-ügynök várakozik, amikor az egyidejűleg futó dinamikus pillanatkép-folyamatok száma a @max_concurrent_dynamic_snapshots tulajdonsága által megadott korlátnál van. Ha eléri a másodpercek maximális számát, és a Pillanatkép-ügynök továbbra is várakozik, az kilép. A 0 érték azt jelenti, hogy az ügynök határozatlan ideig várakozik, bár megszakítható.

- UsePerArticleTartalomNézzuse_per_article_contents_view
Ez a paraméter elavult, és csak a visszamenőleges kompatibilitást támogatja.

Megjegyzések

Fontos

Ha az SQL Server-ügynököt úgy telepítette, hogy a tartományfelhasználói fiók (alapértelmezett) helyett helyi rendszerfiókban fusson, a szolgáltatás csak a helyi számítógéphez férhet hozzá. Ha az SQL Server-ügynök alatt futó Pillanatkép-ügynök úgy van konfigurálva, hogy windowsos hitelesítési módot használjon, amikor bejelentkezik az SQL Serverbe, a Pillanatkép-ügynök sikertelen lesz. Az alapértelmezett beállítás az SQL Server-hitelesítés.

A Pillanatkép-ügynök elindításához hajtsa végre snapshot.exe a parancssorból. További információ: Replikációs ügynök végrehajthatók.

Kapcsolódó tartalom

• replikációs ügynök felügyelete