IMembershipTable Interface

Définition

Espace de noms:

Orleans

Assembly:

Orleans.Core.dll

Paquet:

Microsoft.Orleans.Core v8.2.0

Interface pour la table d’appartenance.

public interface IMembershipTable

type IMembershipTable = interface

Public Interface IMembershipTable

Dérivé

Orleans.IMembershipTableGrain

Orleans.IMembershipTableSystemTarget

Orleans.Runtime.Host.ConsulBasedMembershipTable

Orleans.Runtime.Host.ZooKeeperBasedMembershipTable

Orleans.Runtime.Membership.ConsulBasedMembershipTable

Orleans.Runtime.Membership.ZooKeeperBasedMembershipTable

Orleans.Runtime.MembershipService.AdoNetClusteringTable

Méthodes

CleanupDefunctSiloEntries(DateTimeOffset)	Supprimer toutes les entrées de silo mortes antérieures à beforeDate
DeleteMembershipTableEntries(String)	Supprime toutes les entrées de table du clusterId donné
InitializeMembershipTable(Boolean)	Initialise la table d’appartenance, sera appelé avant toutes les autres méthodes
InsertRow(MembershipEntry, TableVersion)	Atomically essaie d’insérer (ajouter) un nouveau MembershipEntry pour un silo et de mettre à jour la TableVersion. Si l’opération réussit, les modifications suivantes sont apportées à la table : La nouvelle propriété MembershipEntry sera ajoutée à la table. Le nouvel élément MembershipEntry sera également ajouté avec le nouvel eTag unique généré automatiquement. TableVersion.Version dans la table sera mis à jour vers la nouvelle TableVersion.Version. L’etag TableVersion dans la table sera mis à jour vers le nouvel eTag unique généré automatiquement. Toutes ces modifications apportées à la table, l’insertion d’une nouvelle ligne et la mise à jour de la version de la table et des etags associés, doivent se produire de manière atomique ou échouer de manière atomique sans effets secondaires. L’opération doit échouer dans chacune des conditions suivantes : Un MembershipEntry pour un silo donné existe déjà dans la table La mise à jour de tableVersion a échoué, car l’etag TableVersion donné (comme spécifié par la propriété TableVersion.VersionEtag) ne correspondait pas à l’etag TableVersion dans la table.
ReadAll()	Lit atomiquement le contenu complet de la table d’appartenance. L’élément MembershipTableData retourné inclut toutes les entrées MembershipEntry pour tous les silos de la table et la TableVersion pour cette table. Les éléments MembershipEntries et TableVersion doivent être lus de manière atomique.
ReadRow(SiloAddress)	Lit atomiquement les informations de la table d’appartenance sur un silo donné. L’élément MembershipTableData retourné inclut une entrée MembershipEntry pour un silo donné et la TableVersion pour cette table. MembershipEntry et TableVersion doivent être lus de manière atomique.
UpdateIAmAlive(MembershipEntry)	Mises à jour la partie IAmAlive (colonne) de l’élément MembershipEntry pour ce silo. Cette opération doit uniquement mettre à jour la colonne IAmAlive et ne pas modifier les autres colonnes. Cette opération est une « écriture incorrecte » ou une « mise à jour en place » et est effectuée sans validation etag. En ce qui concerne la mise à jour des eTags : cette opération peut mettre à jour automatiquement l’eTag associé à la ligne de silo donnée, mais elle n’est pas nécessaire. Il peut également laisser l’etag non modifié (« écriture sale »). En ce qui concerne TableVersion : cette opération ne doit pas modifier la TableVersion de la table. Il devrait le laisser intact. Il n’existe aucun scénario où cette opération pourrait échouer pour des raisons sémantiques de table. Il ne peut échouer qu’en raison de problèmes réseau ou d’indisponibilité de table.
UpdateRow(MembershipEntry, String, TableVersion)	Atomically essaie de mettre à jour MembershipEntry pour un silo et de mettre également à jour TableVersion. Si l’opération réussit, les modifications suivantes sont apportées à la table : L’élément MembershipEntry de ce silo sera mis à jour vers la nouvelle MembershipEntry (l’ancienne entrée sera entièrement remplacée par la nouvelle entrée) L’eTag pour l’élément MembershipEntry mis à jour sera également eTag avec le nouvel eTag unique généré automatiquement. TableVersion.Version dans la table sera mis à jour vers la nouvelle TableVersion.Version. L’etag TableVersion dans la table sera mis à jour vers le nouvel eTag unique généré automatiquement. Toutes ces modifications apportées à la table, à savoir la mise à jour d’une nouvelle ligne et la mise à jour de la version de la table et des etags associés, doivent se produire de manière atomique ou échouer de manière atomique sans effets secondaires. L’opération doit échouer dans chacune des conditions suivantes : Un MembershipEntry pour un silo donné n’existe pas dans la table Un MembershipEntry pour un silo donné existe dans la table, mais son etag dans la table ne correspond pas à l’etag fourni. La mise à jour de tableVersion a échoué, car l’etag TableVersion donné (comme spécifié par la propriété TableVersion.VersionEtag) ne correspondait pas à l’etag TableVersion dans la table.