KeyValueStoreReplica Klasse

Definition

Namespace:

System.Fabric

Assembly:

System.Fabric.dll

Paket:

Microsoft.ServiceFabric v9.1.1833

Stellt eine transaktionsbasierte, replizierte, assoziative Datenspeicherkomponente für Dienstautoren bereit, die für die Integration in jeden Service Fabric-Dienst bereit ist.

Dies wird von älteren Service Fabric-Diensten verwendet. Alle neuen Dienste sollten die Reliable Collections verwenden.

public class KeyValueStoreReplica : System.Fabric.IStatefulServiceReplica

type KeyValueStoreReplica = class
    interface IStatefulServiceReplica

Public Class KeyValueStoreReplica
Implements IStatefulServiceReplica

Vererbung

Object

KeyValueStoreReplica

Implementiert

IStatefulServiceReplica

Konstruktoren

KeyValueStoreReplica(String)	Initialisiert einen neuen instance der KeyValueStoreReplica -Klasse mit dem angegebenen Schlüssel-Wert-Speichernamen.
KeyValueStoreReplica(String, LocalStoreSettings)	Initialisiert eine neue instance der KeyValueStoreReplica -Klasse mit dem angegebenen Schlüssel-Wert-Speichernamen und lokalen Speichereinstellungen.
KeyValueStoreReplica(String, LocalStoreSettings, ReplicatorSettings)	Initialisiert eine neue instance der KeyValueStoreReplica -Klasse mit dem angegebenen Schlüssel-Wert-Speichernamen, lokalen Speichereinstellungen und Replikattoreinstellungen.
KeyValueStoreReplica(String, LocalStoreSettings, ReplicatorSettings, KeyValueStoreReplica+SecondaryNotificationMode)	Initialisiert eine neue instance der KeyValueStoreReplica -Klasse mit dem angegebenen Schlüssel-Wert-Speichernamen, lokalen Speichereinstellungen und Replikattoreinstellungen. Sekundäre Replikatbenachrichtigungen werden über den Benachrichtigungsmodus aktiviert.
KeyValueStoreReplica(String, LocalStoreSettings, ReplicatorSettings, KeyValueStoreReplicaSettings)	Initialisiert eine neue instance der KeyValueStoreReplica-Klasse mit dem angegebenen Schlüssel-Wert-Speichernamen, lokalen Speichereinstellungen, Replikationsgebereinstellungen und Replikateinstellungen.
KeyValueStoreReplica(String, ReplicatorSettings)	Initialisiert eine neue instance der KeyValueStoreReplica -Klasse mit dem angegebenen Schlüssel-Wert-Speichernamen und den einstellungen für den Speicherreplikator.

Felder

IgnoreSequenceNumberCheck

Gibt an, dass die Sequenznummernüberprüfung nicht erfolgen soll.

Eigenschaften

KeyValueStoreReplicaSettings	Ruft die Optionseinstellungen für den ab oder legt sie KeyValueStoreReplicafest.
LocalStoreSettings	Ruft die Optionseinstellungen für den lokalen Schlüssel-Wert-Speicher ab oder legt diese fest.
NotificationMode	Ruft den sekundären Benachrichtigungsmodus ab, der beim Erstellen dieses Replikats angegeben wurde.
ReplicatorSettings	Ruft die Optionseinstellungen für den Schlüssel-Wert-Speicherreplikator ab oder legt diese fest.
StoreName	Ruft den Namen des Schlüssel-Wert-Speichers ab oder legt den Namen fest.

Methoden

Abort()	Bricht diese instance der KeyValueStoreReplica -Klasse ab.
Add(TransactionBase, String, Byte[])	Fügt dem Schlüssel-Wert-Speicher einen Wert hinzu, der vom angegebenen Schlüssel indiziert wird.
Backup(String)	Veraltet. VERALTET. Führt eine vollständige Sicherung des lokalen Speichers des Replikats im angegebenen Zielverzeichnis aus.
BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>)	Erstellt asynchron eine Sicherung des Schlüssel-Wert-Speichers.
BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>, CancellationToken)	Erstellt asynchron eine Sicherung des Schlüssel-Wert-Speichers.
ChangeRoleAsync(ReplicaRole, CancellationToken)	Ändert die Replikatrolle des Replikats und seines Replikatgebers.
CloseAsync(CancellationToken)	Schließt das Replikat und den zugehörigen Replikattor, um den Offlinemodus einer Replikatmenge vorzubereiten.
Contains(TransactionBase, String)	Bestimmt, ob ein Wert im Schlüssel-Wert-Speicher enthalten ist.
CreateTransaction()	Erstellt eine eindeutige Transaction instance, die zum Committen oder Rollback von Schlüssel-Wert-Speichervorgängen verwendet wird.
CreateTransaction(KeyValueStoreTransactionSettings)	Erstellt eine eindeutige Transaction instance, die zum Committen oder Rollback von Schlüssel-Wert-Speichervorgängen verwendet wird.
Enumerate(TransactionBase)	Gibt einen Enumerator zurück, der die KeyValueStoreItem Werte im Schlüssel-Wert-Speicher durchläuft.
Enumerate(TransactionBase, String)	Gibt einen Enumerator zurück, der die KeyValueStoreItem Werte im Schlüssel-Wert-Speicher durchläuft, wobei die Wertschlüssel mit dem angegebenen Schlüsselpräfix übereinstimmen.
Enumerate(TransactionBase, String, Boolean)	Gibt einen Enumerator zurück, der die KeyValueStoreItem Werte im Schlüssel-Wert-Speicher durchläuft.
EnumerateBySequenceNumber(TransactionBase, Int64)	Gibt einen Enumerator zurück, der die KeyValueStoreItem Werte im Schlüssel-Wert-Speicher in der Reihenfolge der Sequenznummer durchläuft.
EnumerateKeysAndTombstonesBySequenceNumber(TransactionBase, Int64)	Gibt einen Enumerator zurück, der die KeyValueStoreItem Werte und Grabsteine im Schlüssel-Wert-Speicher in der Reihenfolge der Sequenznummer durchläuft.
EnumerateMetadata(TransactionBase)	Gibt einen Enumerator zurück, der die KeyValueStoreItemMetadata Werte im Schlüssel-Wert-Speicher durchläuft.
EnumerateMetadata(TransactionBase, String)	Gibt einen Enumerator zurück, der die KeyValueStoreItemMetadata Werte im Schlüssel-Wert-Speicher durchläuft, wobei die Wertschlüssel mit dem angegebenen Schlüsselpräfix übereinstimmen.
EnumerateMetadata(TransactionBase, String, Boolean)	Gibt einen Enumerator zurück, der die KeyValueStoreItemMetadata Werte im Schlüssel-Wert-Speicher durchläuft.
Get(TransactionBase, String)	Ruft den gespeicherten Wert als KeyValueStoreItem Objekt ab, der dem angegebenen Schlüssel zugeordnet ist.
GetCurrentEpoch()	Ruft die aktuelle Epoche für den Schlüssel-Wert-Speicher ab.
GetLastCommittedSequenceNumber()	Ruft die letzte committete Sequenznummer ab.
GetLSNSplitPercentile(Int32)	Ruft eine LSN ab, die ungefähr perzentil % des Weges durch den KVS-Speicher ist.
GetMetadata(TransactionBase, String)	Ruft die Metadaten als KeyValueStoreItemMetadata -Objekt für den Wert ab, der dem angegebenen Schlüssel zugeordnet ist.
GetValue(TransactionBase, String)	Ruft den gespeicherten Wert als Bytearray ab, das dem angegebenen Schlüssel zugeordnet ist.
Initialize(StatefulServiceInitializationParameters)	Initialisiert das Replikat als Vorbereitung für das Öffnen.
OnAbort()	Wird aufgerufen, um diesen instance herunterzufahren.
OnChangeRoleAsync(ReplicaRole, CancellationToken)	Gibt an, dass dieses Replikat die Rollen ändert.
OnCloseAsync(CancellationToken)	Wird aufgerufen, wenn dieses Dienstreplikat heruntergefahren wird und geschlossen werden muss.
OnCopyComplete(KeyValueStoreEnumerator)	Wird vom System auf sekundären Replikaten aufgerufen, wenn diese die Erstellung aus dem primären Replikat abgeschlossen haben und bereit sind, mit der Anwendung von Replikationsvorgängen zu beginnen. Diese Methode wird nur auf sekundären Replikaten aufgerufen, wenn das KeyValueStoreReplica Objekt mit einem gültigen KeyValueStoreReplica.SecondaryNotificationMode Parameter erstellt wurde.
OnDataLossAsync(CancellationToken)	Signalisiert, dass beim Replikatsatz möglicherweise Datenverlust aufgetreten ist. Die Anwendung kann entweder diese Methode überschreiben, um das Ereignis asynchron zu verarbeiten, oder das Ereignis für die DataLossReported synchrone Verarbeitung verwenden. Beide stellen dasselbe Ereignis dar.
OnDatalossReported(EventArgs)	Signalisiert, dass beim Replikatsatz möglicherweise Datenverlust aufgetreten ist. Die Anwendung kann diese Methode entweder überschreiben oder auf das DataLossReported Ereignis lauschen. Beide stellen dasselbe Ereignis dar.
OnInitialize(StatefulServiceInitializationParameters)	Initialisiert ein neu erstelltes Dienstreplikat.
OnOpenAsync(ReplicaOpenMode, IStatefulServicePartition, CancellationToken)	Wird für ein initialisiertes Dienstreplikat aufgerufen, um es zu öffnen, damit zusätzliche Aktionen ausgeführt werden können.
OnReplicationOperation(IEnumerator<KeyValueStoreNotification>)	Wird vom System auf sekundären Replikaten für eingehende Replikationsvorgänge aufgerufen. Jedes KeyValueStoreNotification Objekt enthält alle Daten für einen einzelnen atomischen Replikationsvorgang.
OnRestoreCompletedAsync(CancellationToken)	Signalisiert, dass der Status des Replikats erfolgreich vom System wiederhergestellt wurde. Dies wird nur aufgerufen, wenn das System intern eine Wiederherstellung über den Sicherungswiederherstellungsdienst auslöst.
OpenAsync(ReplicaOpenMode, IStatefulServicePartition, CancellationToken)	Öffnet das Replikat und seinen Replizierer als Vorbereitung auf das Online-Schalten in einer Replikatmenge.
Remove(TransactionBase, String)	Entfernt den Wert, der mit dem angegebenen Schlüssel indiziert wird.
Remove(TransactionBase, String, Int64)	Entfernt den Wert, der mit dem angegebenen Schlüssel indiziert wird.
Restore(String)	Veraltet. Stellt die lokale Speicherdatenbank dieses Replikats aus einer Sicherung wieder her, die zuvor durch Aufrufen BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>)von erstellt wurde.
RestoreAsync(String)	Stellt die lokale Speicherdatenbank dieses Replikats aus einer Sicherung wieder her, die zuvor durch Aufrufen BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>)von erstellt wurde.
RestoreAsync(String, CancellationToken)	Stellt die lokale Speicherdatenbank dieses Replikats aus einer Sicherung wieder her, die zuvor durch Aufrufen BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>)von erstellt wurde.
RestoreAsync(String, RestoreSettings, CancellationToken)	Stellt das Schlüssel-Wert-Speicherreplikat asynchron wieder her.
TryAbortExistingTransactionsAndRejectWrites()	Dient zum Migrieren von Daten aus KVS zu einem anderen Datenspeicher. Nach dem Aufruf bleiben Schreibvorgänge bis zum Neustart des Replikats blockiert. Überprüft, ob KVS für die endgültige Migration zu einem anderen Speicher bereit ist. Wenn dies aufgerufen wird, KVS aber noch nicht mit der Migrationsvorbereitung begonnen hat (was bei einem KVS-Failover der Fall wäre), beginnt die Vorbereitung erneut.
TryAdd(TransactionBase, String, Byte[])	Versucht, dem Schlüssel-Wert-Speicher einen Wert hinzuzufügen, der mit dem angegebenen Schlüssel indiziert ist.
TryGet(TransactionBase, String)	Versucht, den gespeicherten Wert als KeyValueStoreItem Objekt abzurufen, der dem angegebenen Schlüssel zugeordnet ist.
TryGetMetadata(TransactionBase, String)	Versucht, die Metadaten als KeyValueStoreItemMetadata Objekt für den Wert abzurufen, der dem angegebenen Schlüssel zugeordnet ist.
TryGetValue(TransactionBase, String)	Versucht, den gespeicherten Wert als Bytearray abzurufen, das dem angegebenen Schlüssel zugeordnet ist.
TryRemove(TransactionBase, String)	Versucht, den mit dem angegebenen Schlüssel indizierten Wert zu entfernen.
TryRemove(TransactionBase, String, Int64)	Versucht, den mit dem angegebenen Schlüssel indizierten Wert zu entfernen.
TryUpdate(TransactionBase, String, Byte[])	Versucht, den mit dem angegebenen Schlüssel indizierten Wert zu aktualisieren.
TryUpdate(TransactionBase, String, Byte[], Int64)	Versucht, den mit dem angegebenen Schlüssel indizierten Wert zu aktualisieren.
Update(TransactionBase, String, Byte[])	Updates den gespeicherten Wert, der dem angegebenen Schlüssel zugeordnet ist.
Update(TransactionBase, String, Byte[], Int64)	Updates den Wert, der vom angegebenen Schlüssel indiziert wird.
UpdateReplicatorSettings(ReplicatorSettings)	Updates den Schlüssel-Wert-Speicherreplikator mit den Einstellungen im angegebenen ReplicatorSettings Objekt.

Ereignisse

DataLossReported

Handler für Datenverlustereignisse.