From 11e8c80a64483a25c1b140f03c42395eb5a24992 Mon Sep 17 00:00:00 2001 From: Vonng Date: Thu, 29 Mar 2018 23:12:00 +0800 Subject: [PATCH] ch9 80% --- README.md | 2 +- ch7.md | 48 ++++++----- ch8.md | 2 +- ch9.md | 194 ++++++++++++++++++++++----------------------- img/ddia-wexin.JPG | Bin 109537 -> 108440 bytes 5 files changed, 121 insertions(+), 125 deletions(-) diff --git a/README.md b/README.md index 0067825..e7d1849 100644 --- a/README.md +++ b/README.md @@ -106,7 +106,7 @@ | 第六章:分区 | 初翻 | | | 第七章:事务 | 精翻 60% | Vonng | | 第八章:分布式系统中的问题 | 初翻 | | -| 第九章:一致性与共识 | 初翻 65% | Vonng | +| 第九章:一致性与共识 | 初翻 80% | Vonng | | 第三部分:前言 | 精翻 | | | 第十章:批处理 | 草翻 | | | 第十一章:流处理 | 草翻 | | diff --git a/ch7.md b/ch7.md index 93da2e4..464a341 100644 --- a/ch7.md +++ b/ch7.md @@ -82,7 +82,7 @@ ACID一致性的概念是,**对数据的一组特定陈述必须始终成立** 但是,一致性的这种概念取决于应用程序对不变量的观念,应用程序负责正确定义它的事务,并保持一致性。这并不是数据库可以保证的事情:如果你写入违反不变量的脏数据,数据库也无法阻止你。 (一些特定类型的不变量可以由数据库检查,例如外键约束或唯一约束,但是一般来说,是应用程序来定义什么样的数据是有效的,什么样是无效的。—— 数据库只管存储。) -原子性,隔离性和持久性是数据库的属性,而一致性(在ACID意义上)是应用程序的属性。应用程序可能依赖数据库的原子性和隔离属性来实现一致性,但这并不仅取决于数据库。因此,字母C不属于ACID[^i]。 +原子性,隔离性和持久性是数据库的属性,而一致性(在ACID意义上)是应用程序的属性。应用可能依赖数据库的原子性和隔离属性来实现一致性,但这并不仅取决于数据库。因此,字母C不属于ACID[^i]。 [^i]: 乔·海勒斯坦(Joe Hellerstein)指出,在论Härder与Reuter的论文中,“ACID中的C”是被“扔进去凑缩写单词的”【7】,而且那时候大家都不怎么在乎一致性。 @@ -90,7 +90,7 @@ ACID一致性的概念是,**对数据的一组特定陈述必须始终成立** 大多数数据库都会同时被多个客户端访问。如果它们各自读写数据库的不同部分,这是没有问题的,但是如果它们访问相同的数据库记录,则可能会遇到**并发**问题(**竞争条件(race conditions)**)。 -[图7-1](img/fig7-1.png)是这类问题的一个简单例子。假设你有两个客户端同时在数据库中增长一个计数器。(假设数据库中没有自增操作)每个客户端需要读取计数器的当前值,加1,再回写新值。[图7-1](img/fig7-1.png)中,因为发生了两次增长,计数器应该从42增至44;但由于竞态条件,实际上只增至43。 +[图7-1](img/fig7-1.png)是这类问题的一个简单例子。假设你有两个客户端同时在数据库中增长一个计数器。(假设数据库中没有自增操作)每个客户端需要读取计数器的当前值,加 1 ,再回写新值。[图7-1](img/fig7-1.png) 中,因为发生了两次增长,计数器应该从42增至44;但由于竞态条件,实际上只增至 43 。 ACID意义上的隔离性意味着,**同时执行的事务是相互隔离的**:它们不能相互冒犯。传统的数据库教科书将隔离性形式化为**可序列化(Serializability)**,这意味着每个事务可以假装它是唯一在整个数据库上运行的事务。数据库确保当事务已经提交时,结果与它们按顺序运行(一个接一个)是一样的,尽管实际上它们可能是并发运行的【10】。 @@ -131,7 +131,7 @@ ACID意义上的隔离性意味着,**同时执行的事务是相互隔离的** ***原子性*** -如果在一系列写操作的中途发生错误,则应中止事务处理,并丢弃当前事务的所有写入。换句话说,数据库免去了用户对部分失败的担忧——通过提供“**宁为玉碎,不为瓦全**(all-or-nothing)”的保证。 +如果在一系列写操作的中途发生错误,则应中止事务处理,并丢弃当前事务的所有写入。换句话说,数据库免去了用户对部分失败的担忧——通过提供“**宁为玉碎,不为瓦全(all-or-nothing)**”的保证。 ***隔离性*** @@ -145,7 +145,7 @@ SELECT COUNT(*)FROM emails WHERE recipient_id = 2 AND unread_flag = true 但如果邮件太多,你可能会觉得这个查询太慢,并决定用单独的字段存储未读邮件的数量(一种反规范化)。现在每当一个新消息写入时,必须也增长未读计数器,每当一个消息被标记为已读时,也必须减少未读计数器。 -在[图7-2](img/fig7-2.png)中,用户2遇到异常情况:邮件列表里显示有未读消息,但计数器显示为零未读消息,因为计数器增长还没有发生[^ii]。隔离性可以避免这个问题:通过确保用户2要么同时看到新邮件和增长后的计数器,要么都看不到。反正不会看到执行到一半的中间结果。 +在[图7-2](img/fig7-2.png)中,用户2 遇到异常情况:邮件列表里显示有未读消息,但计数器显示为零未读消息,因为计数器增长还没有发生[^ii]。隔离性可以避免这个问题:通过确保用户2 要么同时看到新邮件和增长后的计数器,要么都看不到。反正不会看到执行到一半的中间结果。 [^ii]: 可以说邮件应用中的错误计数器并不是什么特别重要的问题。但换种方式来看,你可以把未读计数器换成客户账户余额,把邮件收发看成支付交易。 @@ -159,7 +159,7 @@ SELECT COUNT(*)FROM emails WHERE recipient_id = 2 AND unread_flag = true **图7-3 原子性确保发生错误时,事务先前的任何写入都会被撤消,以避免状态不一致** -多对象事务需要某种方式来确定哪些读写操作属于同一个事务。在关系型数据库中,通常基于客户端与数据库服务器的TCP连接:在任何特定连接上,`BEGIN TRANSACTION`和`COMMIT`语句之间的所有内容,被认为是同一事务的一部分.[^iii] +多对象事务需要某种方式来确定哪些读写操作属于同一个事务。在关系型数据库中,通常基于客户端与数据库服务器的TCP连接:在任何特定连接上,`BEGIN TRANSACTION` 和 `COMMIT` 语句之间的所有内容,被认为是同一事务的一部分.[^iii] [^iii]: 这并不完美。如果TCP连接中断,则事务必须中止。如果中断发生在客户端请求提交之后,但在服务器确认提交发生之前,客户端并不知道事务是否已提交。为了解决这个问题,事务管理器可以通过一个唯一事务标识符来对操作进行分组,这个标识符并未绑定到特定TCP连接。后续再“[数据库端到端的争论](ch12.md#数据库端到端的争论)”一节将回到这个主题。 @@ -167,30 +167,30 @@ SELECT COUNT(*)FROM emails WHERE recipient_id = 2 AND unread_flag = true #### 单对象写入 -当单个对象发生改变时,原子性和隔离也是适用的。例如,假设您正在向数据库写入一个20 KB的JSON文档: +当单个对象发生改变时,原子性和隔离也是适用的。例如,假设您正在向数据库写入一个 20 KB的 JSON文档: -- 如果在发送第一个10 KB之后网络连接中断,数据库是否存储了不可解析的10 KB JSON片段? +- 如果在发送第一个10 KB之后网络连接中断,数据库是否存储了不可解析的10KB JSON片段? - 如果在数据库正在覆盖磁盘上的前一个值的过程中电源发生故障,是否最终将新旧值拼接在一起? - 如果另一个客户端在写入过程中读取该文档,是否会看到部分更新的值? -这些问题非常让人头大,故存储引擎一个几乎普遍的目标是:对单节点上的单个对象(例如键值对)上提供原子性和隔离性。原子性可以通过使用日志来实现崩溃恢复(请参阅第82页的“[使B树可靠]()”),并且可以使用每个对象上的锁来实现隔离(每次只允许一个线程访问对象) )。 +这些问题非常让人头大,故存储引擎一个几乎普遍的目标是:对单节点上的单个对象(例如键值对)上提供原子性和隔离性。原子性可以通过使用日志来实现崩溃恢复(参阅“[使B树可靠]()”),并且可以使用每个对象上的锁来实现隔离(每次只允许一个线程访问对象) )。 -一些数据库也提供更复杂的原子操作,例如自增操作,这样就不再需要像[图7-1](img/fig7-1.png)那样的读取-修改-写入序列了。同样流行的是**[比较和设置(CAS, compare-and-set)](#比较并设置(CAS))**操作,当值没有并发被其他人修改过时,才允许执行写操作。 +一些数据库也提供更复杂的原子操作,例如自增操作,这样就不再需要像 [图7-1](img/fig7-1.png) 那样的读取-修改-写入序列了。同样流行的是**[比较和设置(CAS, compare-and-set)](#比较并设置(CAS))**操作,当值没有并发被其他人修改过时,才允许执行写操作。 -这些单对象操作很有用,因为它们可以防止在多个客户端尝试同时写入同一个对象时丢失更新(参阅“[防止丢失更新](#防止丢失更新)”)。但是,它们不是通常意义上的事务。CAS以及其他单一对象操作被称为“轻量级事务”,甚至出于营销目的被称为“ACID”【20,21,22】,但是这个术语是误导性的。事务通常被理解为,**将多个对象上的多个操作合并为一个执行单元的机制**。[^iv] +这些单对象操作很有用,因为它们可以防止在多个客户端尝试同时写入同一个对象时丢失更新(参阅“[防止丢失更新](#防止丢失更新)”)。但它们不是通常意义上的事务。CAS以及其他单一对象操作被称为“轻量级事务”,甚至出于营销目的被称为“ACID”【20,21,22】,但是这个术语是误导性的。事务通常被理解为,**将多个对象上的多个操作合并为一个执行单元的机制**。[^iv] [^iv]: 严格地说,**原子自增(atomic increment)**这个术语在多线程编程的意义上使用了原子这个词。 在ACID的情况下,它实际上应该被称为**孤立(isolated)**的或**可序列化(serializable)**的增量。 但这就太吹毛求疵了。 #### 多对象事务的需求 -许多分布式数据存储已经放弃了多对象事务,因为多对象事务很难跨分区实现,而且在需要高可用性或高性能的情况下,它们可能会碍事。但说到底,在分布式数据库中实现事务,并没有什么根本性的障碍。[第9章](ch9.md)将讨论分布式事务的实现。 +许多分布式数据存储已经放弃了多对象事务,因为多对象事务很难跨分区实现,而且在需要高可用性或高性能的情况下,它们可能会碍事。但说到底,在分布式数据库中实现事务,并没有什么根本性的障碍。[第9章](ch9.md) 将讨论分布式事务的实现。 但是我们是否需要多对象事务?**是否有可能只用键值数据模型和单对象操作来实现任何应用程序?** 有一些场景中,单对象插入,更新和删除是足够的。但是许多其他场景需要协调写入几个不同的对象: * 在关系数据模型中,一个表中的行通常具有对另一个表中的行的外键引用。 (类似的是,在一个图数据模型中,一个顶点有着到其他顶点的边)。多对象事务使你确信这些引用始终有效:当插入几个相互引用的记录时,外键必须是正确的,最新的,不然数据就没有意义。 -* 在文档数据模型中,需要一起更新的字段通常在同一个文档中,这被视为单个对象——更新单个文档时不需要多对象事务。但是,缺乏连接功能的文档数据库会鼓励非规范化(参阅“[关系型数据库与文档数据库在今日的对比](ch2.md#关系型数据库与文档数据库在今日的对比)”)。当需要更新非规范化的信息时,如[图7-2](img/fig7-2.png)所示,需要一次更新多个文档。事务在这种情况下非常有用,可以防止非规范化的数据不同步。 +* 在文档数据模型中,需要一起更新的字段通常在同一个文档中,这被视为单个对象——更新单个文档时不需要多对象事务。但是,缺乏连接功能的文档数据库会鼓励非规范化(参阅“[关系型数据库与文档数据库在今日的对比](ch2.md#关系型数据库与文档数据库在今日的对比)”)。当需要更新非规范化的信息时,如 [图7-2](img/fig7-2.png) 所示,需要一次更新多个文档。事务在这种情况下非常有用,可以防止非规范化的数据不同步。 * 在具有二级索引的数据库中(除了纯粹的键值存储以外几乎都有),每次更改值时都需要更新索引。从事务角度来看,这些索引是不同的数据库对象:例如,如果没有事务隔离性,记录可能出现在一个索引中,但没有出现在另一个索引中,因为第二个索引的更新还没有发生。 这些应用仍然可以在没有事务的情况下实现。然而,**没有原子性,错误处理就要复杂得多,缺乏隔离性,就会导致并发问题**。我们将在“[弱隔离级别](#弱隔离级别)”中讨论这些问题,并在[第12章]()中探讨其他方法。 @@ -248,7 +248,7 @@ SELECT COUNT(*)FROM emails WHERE recipient_id = 2 AND unread_flag = true 设想一个事务已经将一些数据写入数据库,但事务还没有提交或中止。另一个事务可以看到未提交的数据吗?如果是的话,那就叫做**脏读(dirty reads)**【2】。 -在**读已提交**隔离级别运行的事务必须防止脏读。这意味着事务的任何写入操作只有在该事务提交时才能被其他人看到(然后所有的写入操作都会立即变得可见)。如[图7-4]()所示,用户1设置了`x = 3`,但用户2的`get x`仍旧返回旧值2,而用户1尚未提交。 +在**读已提交**隔离级别运行的事务必须防止脏读。这意味着事务的任何写入操作只有在该事务提交时才能被其他人看到(然后所有的写入操作都会立即变得可见)。如[图7-4]()所示,用户1 设置了`x = 3`,但用户2 的 `get x `仍旧返回旧值2 ,而用户1 尚未提交。 ![](img/fig7-4.png) @@ -267,7 +267,7 @@ SELECT COUNT(*)FROM emails WHERE recipient_id = 2 AND unread_flag = true 通过防止脏写,这个隔离级别避免了一些并发问题: -- 如果事务更新多个对象,脏写会导致不好的结果。例如,考虑[图7-5](img/fig7-5.png),[图7-5](img/fig7-5.png)以一个二手车销售网站为例,Alice和Bob两个人同时试图购买同一辆车。购买汽车需要两次数据库写入:网站上的商品列表需要更新,以反映买家的购买,销售发票需要发送给买家。在[图7-5](img/fig7-5.png)的情况下,销售是属于Bob的(因为他成功更新了商品列表),但发票却寄送给了爱丽丝(因为她成功更新了发票表)。读已提交会阻止这样这样的事故。 +- 如果事务更新多个对象,脏写会导致不好的结果。例如,考虑 [图7-5](img/fig7-5.png),[图7-5](img/fig7-5.png) 以一个二手车销售网站为例,Alice和Bob两个人同时试图购买同一辆车。购买汽车需要两次数据库写入:网站上的商品列表需要更新,以反映买家的购买,销售发票需要发送给买家。在[图7-5](img/fig7-5.png)的情况下,销售是属于Bob的(因为他成功更新了商品列表),但发票却寄送给了爱丽丝(因为她成功更新了发票表)。读已提交会阻止这样这样的事故。 - 但是,提交读取并不能防止[图7-1]()中两个计数器增量之间的竞争状态。在这种情况下,第二次写入发生在第一个事务提交后,所以它不是一个脏写。这仍然是不正确的,但是出于不同的原因,在“[防止更新丢失](#防止丢失更新)”中将讨论如何使这种计数器增量安全。 ![](img/fig7-5.png) @@ -338,7 +338,7 @@ SELECT COUNT(*)FROM emails WHERE recipient_id = 2 AND unread_flag = true 表中的每一行都有一个`created_by`字段,其中包含将该行插入到表中的的事务ID。此外,每行都有一个`deleted_by`字段,最初是空的。如果某个事务删除了一行,那么该行实际上并未从数据库中删除,而是通过将`deleted_by`字段设置为请求删除的事务的ID来标记为删除。在稍后的时间,当确定没有事务可以再访问已删除的数据时,数据库中的垃圾收集过程会将所有带有删除标记的行移除,并释放其空间。[^译注ii] -[^译注ii]: 在PostgreSQL中,`created_by`实际名称为`xmin`,`deleted_by`实际名称为`xmax` +[^译注ii]: 在PostgreSQL中,`created_by` 实际名称为`xmin`,`deleted_by` 实际名称为`xmax` `UPDATE`操作在内部翻译为`DELETE`和`INSERT`。例如,在[图7-7]()中,事务13从账户2中扣除100美元,将余额从500美元改为400美元。实际上包含两条账户2的记录:余额为\$500的行被标记为**被事务13删除**,余额为\$400的行**由事务13创建**。 @@ -626,7 +626,7 @@ COMMIT; 在这种交互式的事务方式中,应用程序和数据库之间的网络通信耗费了大量的时间。如果不允许在数据库中进行并发处理,且一次只处理一个事务,则吞吐量将会非常糟糕,因为数据库大部分的时间都花费在等待应用程序发出当前事务的下一个查询。在这种数据库中,为了获得合理的性能,需要同时处理多个事务。 -出于这个原因,具有单线程串行事务处理的系统不允许交互式的多语句事务。取而代之,应用程序必须提前将整个事务代码作为存储过程提交给数据库。这些方法之间的差异如[图7-9](img/fig7-9.png)所示。如果事务所需的所有数据都在内存中,则存储过程可以非常快地执行,而不用等待任何网络或磁盘I/O。 +出于这个原因,具有单线程串行事务处理的系统不允许交互式的多语句事务。取而代之,应用程序必须提前将整个事务代码作为存储过程提交给数据库。这些方法之间的差异如[图7-9](img/fig7-9.png) 所示。如果事务所需的所有数据都在内存中,则存储过程可以非常快地执行,而不用等待任何网络或磁盘I/O。 ![](img/fig7-9.png) @@ -673,7 +673,7 @@ VoltDB还使用存储过程进行复制:但不是将事务的写入结果从 大约30年来,在数据库中只有一种广泛使用的序列化算法:**两阶段锁定(2PL,two-phase locking)**[^xi] -[^xi]: 有时也称为严格两阶段锁定(SS2PL, strict two-phas locking),以便和其他2PL变体区分。 +[^xi]: 有时也称为**严格两阶段锁定(SS2PL, strict two-phas locking)**,以便和其他2PL变体区分。 > #### 2PL不是2PC > @@ -692,8 +692,6 @@ VoltDB还使用存储过程进行复制:但不是将事务的写入结果从 2PL用于MySQL(InnoDB)和SQL Server中的可序列化隔离级别,以及DB2中的可重复读隔离级别【23,36】。 -[^xi]: 有时被称为强有力的严格的两阶段锁定(SS2PL),以区别于2PL的其他变种。 - 读与写的阻塞是通过为数据库中每个对象添加锁来实现的。锁可以处于**共享模式(shared mode)**或**独占模式(exclusive mode)**。锁使用如下: - 若事务要读取对象,则须先以共享模式获取锁。允许多个事务同时持有共享锁。但如果另一个事务已经在对象上持有排它锁,则这些事务必须等待。 @@ -719,7 +717,7 @@ VoltDB还使用存储过程进行复制:但不是将事务的写入结果从 在前面关于锁的描述中,我们掩盖了一个微妙而重要的细节。在“[导致写入偏差的幻读](#导致写入偏差的幻读)”中,我们讨论了**幻读(phantoms)**的问题。即一个事务改变另一个事务的搜索查询的结果。具有可序列化隔离级别的数据库必须防止**幻读**。 -在会议室预订的例子中,这意味着如果一个事务在某个时间窗口内搜索了一个房间的现有预订(见例7-2),则另一个事务不能同时插入或更新同一时间窗口与同一房间的另一个预订 (可以同时插入其他房间的预订,或在不影响另一个预定的条件下预定同一房间的其他时间段)。 +在会议室预订的例子中,这意味着如果一个事务在某个时间窗口内搜索了一个房间的现有预订(见[例7-2]()),则另一个事务不能同时插入或更新同一时间窗口与同一房间的另一个预订 (可以同时插入其他房间的预订,或在不影响另一个预定的条件下预定同一房间的其他时间段)。 如何实现这一点?从概念上讲,我们需要一个**谓词锁(predicate lock)**【3】。它类似于前面描述的共享/排它锁,但不属于特定的对象(例如,表中的一行),它属于所有符合某些搜索条件的对象,如: @@ -732,7 +730,7 @@ WHERE room_id = 123 AND 谓词锁限制访问,如下所示: -- 如果事务A想要读取匹配某些条件的对象,就像在这个`SELECT`查询中那样,它必须获取查询条件上的**共享谓词锁(shared-mode predicate lock)**。如果另一个事务B持有任何满足这一查询条件对象的排它锁,那么A必须等到B释放它的锁之后才允许进行查询。 +- 如果事务A想要读取匹配某些条件的对象,就像在这个 `SELECT` 查询中那样,它必须获取查询条件上的**共享谓词锁(shared-mode predicate lock)**。如果另一个事务B持有任何满足这一查询条件对象的排它锁,那么A必须等到B释放它的锁之后才允许进行查询。 - 如果事务A想要插入,更新或删除任何对象,则必须首先检查旧值或新值是否与任何现有的谓词锁匹配。如果事务B持有匹配的谓词锁,那么A必须等到B已经提交或中止后才能继续。 这里的关键思想是,谓词锁甚至适用于数据库中尚不存在,但将来可能会添加的对象(幻象)。如果两阶段锁定包含谓词锁,则数据库将阻止所有形式的写入偏差和其他竞争条件,因此其隔离实现了可串行化。 @@ -743,7 +741,7 @@ WHERE room_id = 123 AND 通过使谓词匹配到一个更大的集合来简化谓词锁是安全的。例如,如果你有在中午和下午1点之间预订123号房间的谓词锁,则锁定123号房间的所有时间段,或者锁定12:00~13:00时间段的所有房间(不只是123号房间)是一个安全的近似,因为任何满足原始谓词的写入也一定会满足这种更松散的近似。 -在房间预订数据库中,您可能会在`room_id`列上有一个索引,并且/或者在`start_time`和`end_time`上有索引(否则前面的查询在大型数据库上的速度会非常慢): +在房间预订数据库中,您可能会在`room_id`列上有一个索引,并且/或者在`start_time` 和 `end_time`上有索引(否则前面的查询在大型数据库上的速度会非常慢): - 假设您的索引位于`room_id`上,并且数据库使用此索引查找123号房间的现有预订。现在数据库可以简单地将共享锁附加到这个索引项上,指示事务已搜索123号房间用于预订。 - 或者,如果数据库使用基于时间的索引来查找现有预订,那么它可以将共享锁附加到该索引中的一系列值,指示事务已经将12:00~13:00时间段标记为用于预定。 @@ -817,7 +815,7 @@ WHERE room_id = 123 AND 当事务写入数据库时,它必须在索引中查找最近曾读取受影响数据的其他事务。这个过程类似于在受影响的键范围上获取写锁,但锁并不会阻塞事务到其他事务完成,而是像一个引线一样只是简单通知其他事务:你们读过的数据可能不是最新的啦。 -在[图7-11]()中,事务43通知事务42其先前读已过时,反之亦然。事务42首先提交并成功,尽管事务43的写影响了42,但因为事务43尚未提交,所以写入尚未生效。然而当事务43想要提交时,来自事务42的冲突写入已经被提交,所以43必须中止。 +在[图7-11]()中,事务43 通知事务42 其先前读已过时,反之亦然。事务42首先提交并成功,尽管事务43 的写影响了42 ,但因为事务43 尚未提交,所以写入尚未生效。然而当事务43 想要提交时,来自事务42 的冲突写入已经被提交,所以事务43 必须中止。 #### 可序列化的快照隔离的性能 @@ -829,7 +827,7 @@ WHERE room_id = 123 AND 与串行执行相比,可序列化快照隔离并不局限于单个CPU核的吞吐量:FoundationDB将检测到的序列化冲突分布在多台机器上,允许扩展到很高的吞吐量。即使数据可能跨多台机器进行分区,事务也可以在保证可序列化隔离等级的同时读写多个分区中的数据【54】。 -中止率显着影响SSI的整体表现。例如,长时间读取和写入数据的事务很可能会发生冲突并中止,因此SSI要求同时读写的事务尽量短(长时间运行的只读事务可能没问题)。对于慢事务,SSI可能比两阶段锁定或串行执行更不敏感。 +中止率显着影响SSI的整体表现。例如,长时间读取和写入数据的事务很可能会发生冲突并中止,因此SSI要求同时读写的事务尽量短(只读长事务可能没问题)。对于慢事务,SSI可能比两阶段锁定或串行执行更不敏感。 @@ -871,7 +869,7 @@ WHERE room_id = 123 AND ***字面意义上的串行执行*** -​ 如果每个事务的执行速度非常快,并且事务吞吐量足够低,足以在单个CPU内核上处理,这是一个简单而有效的选择。 +​ 如果每个事务的执行速度非常快,并且事务吞吐量足够低,足以在单个CPU核上处理,这是一个简单而有效的选择。 ***两阶段锁定*** diff --git a/ch8.md b/ch8.md index f291598..ff9ad0c 100644 --- a/ch8.md +++ b/ch8.md @@ -588,7 +588,7 @@ Web应用程序确实需要预期受终端用户控制的客户端(如Web浏 ***单调序列*** -​ 如果请求$x$返回了令牌$t_x$,并且请求$y$返回了令牌$t_y$,并且$x$在$y$开始之前已经完成,那么$t_x n$)可以获得“强一致性”。这取决于法定人数的具体配置,以及强一致性如何定义(通常不完全正确)。 +对于无领导者复制的系统(Dynamo风格;参阅“[无主复制](ch5.md#无主复制)”),有时候人们会声称通过要求法定人数读写( $w + r> n$ )可以获得“强一致性”。这取决于法定人数的具体配置,以及强一致性如何定义(通常不完全正确)。 -基于时钟(例如,在Cassandra中;参见“[依赖同步时钟](ch8.md#依赖同步时钟)”)的“最后写入胜利”冲突解决方法几乎可以确定是非线性的,由于时钟偏差,不能保证时钟的时间戳与实际事件顺序一致。松散的法定人数(第183页的“[松散法定人数与暗示接力](#马虎法定人数和暗示交接)”)也破坏了线性一致的可能性。即使使用严格的法定人数,非线性一致的行为也是可能的,如下一节所示。 +基于时钟(例如,在Cassandra中;参见“[依赖同步时钟](ch8.md#依赖同步时钟)”)的“最后写入胜利”冲突解决方法几乎可以确定是非线性的,由于时钟偏差,不能保证时钟的时间戳与实际事件顺序一致。[松散的法定人数](ch5.md#马虎法定人数和暗示交接)也破坏了线性一致的可能性。即使使用严格的法定人数,非线性一致的行为也是可能的,如下节所示。 #### 线性一致性和法定人数 @@ -236,9 +236,9 @@ **图9-6 非线性一致的执行,尽管使用了严格的法定人数** -在[图9-6](img/fig9-6.png)中,$x$ 的初始值为0,写入客户端通过向所有三个副本($n = 3, w = 3$)发送写入将 $x$ 更新为1。客户端A并发地从两个节点组成的法定人群($r = 2$)中读取数据,并在其中一个节点上看到新值1。客户端B也并发地从两个不同的节点组成的法定人数中读取,并从两个节点中取回了旧值0。 +在[图9-6](img/fig9-6.png)中,$x$ 的初始值为0,写入客户端通过向所有三个副本( $n = 3, w = 3$ )发送写入将 $x$ 更新为 `1`。客户端A并发地从两个节点组成的法定人群( $r = 2$ )中读取数据,并在其中一个节点上看到新值 `1` 。客户端B也并发地从两个不同的节点组成的法定人数中读取,并从两个节点中取回了旧值 `0` 。 -仲裁条件满足($w + r> n$),但是这个执行是非线性一致的:B的请求在A的请求完成后开始,但是B返回旧值,而A返回新值。 (又一次,如同Alice和Bob的例子 [图9-1]()) +仲裁条件满足( $w + r> n$ ),但是这个执行是非线性一致的:B的请求在A的请求完成后开始,但是B返回旧值,而A返回新值。 (又一次,如同Alice和Bob的例子 [图9-1]()) 有趣的是,通过牺牲性能,可以使Dynamo风格的法定人数线性化:读取者必须在将结果返回给应用程序之前,同步执行读取修复(参阅“[读时修复与反熵过程](ch5.md#读时修复与反熵过程)”) ,并且写入者必须在发送写入之前,读取法定数量节点的最新状态【24,25】。然而,由于性能损失,Riak不执行同步读取修复【26】。 Cassandra在进行法定人数读取时,**确实**在等待读取修复完成【27】;但是由于使用了最后写入为准的冲突解决方案,当同一个键有多个并发写入时,将不能保证线性一致性。 @@ -279,7 +279,7 @@ 因此不需要线性一致性的应用对网络问题有更强的容错能力。这种见解通常被称为CAP定理【29,30,31,32】,由Eric Brewer于2000年命名,尽管70年代的分布式数据库设计者早就知道了这种权衡【33,34,35,36】。 -CAP最初是作为一个经验法则提出的,没有准确的定义,目的是开始讨论数据库的权衡。那时候许多分布式数据库侧重于在共享存储的集群上提供线性一致性的语义【18】,CAP定理鼓励数据库工程师向分布式无共享系统的设计领域深入探索,这类架构更适合实现大规模的网络服务【37】。 对于这种文化上的转变,CAP值得赞扬——它见证了自00年代中期以来新数据库的技术爆炸(即NoSQL)。 +CAP最初是作为一个经验法则提出的,没有准确的定义,目的是开始讨论数据库的权衡。那时候许多分布式数据库侧重于在共享存储的集群上提供线性一致性的语义【18】,CAP定理鼓励数据库工程师向分布式无共享系统的设计领域深入探索,这类架构更适合实现大规模的网络服务【37】。 对于这种文化上的转变,CAP值得赞扬 —— 它见证了自00年代中期以来新数据库的技术爆炸(即NoSQL)。 > ### CAP定理没有帮助 > @@ -344,7 +344,7 @@ CAP定理的正式定义仅限于很狭隘的范围【30】,它只考虑了一 然而数学集合并不完全是全序的:`{a, b}` 比 `{b, c}` 更大吗?好吧,你没法真正比较它们,因为二者都不是对方的子集。我们说它们是**无法比较(incomparable)**的,因此数学集合是**偏序(partially order)**的:在某些情况下,可以说一个集合大于另一个(如果一个集合包含另一个集合的所有元素),但在其他情况下它们是无法比较的[^译注i]。 -[^译注i]: 设R为非空集合A上的关系,如果R是自反的、反对称的和可传递的,则称R为A上的偏序关系。简称偏序,通常记作≦。一个集合A与A上的偏序关系R一起叫作偏序集,记作$$或$$。全序、偏序、关系、集合,这些概念的精确定义可以参考任意一本离散数学教材。 +[^译注i]: 设R为非空集合A上的关系,如果R是自反的、反对称的和可传递的,则称R为A上的偏序关系。简称偏序,通常记作≦。一个集合A与A上的偏序关系R一起叫作偏序集,记作$(A,R)$或$(A, ≦)$。全序、偏序、关系、集合,这些概念的精确定义可以参考任意一本离散数学教材。 全序和偏序之间的差异反映在不同的数据库一致性模型中: @@ -358,13 +358,13 @@ CAP定理的正式定义仅限于很狭隘的范围【30】,它只考虑了一 因此,根据这个定义,在线性一致的数据存储中是不存在并发操作的:必须有且仅有一条时间线,所有的操作都在这条时间线上,构成一个全序关系。可能有几个请求在等待处理,但是数据存储确保了每个请求都是在唯一时间线上的某个时间点自动处理的,不存在任何并发。 -并发意味着时间线会分岔然后合并——在这种情况下,不同分支上的操作是无法比较的(即并发操作)。在[第五章](ch5.md)中我们看到了这种现象:例如,[图5-14](img/fig5-14.md)并不是一条直线的全序关系,而是一堆不同的操作并发进行。图中的箭头指明了因果依赖——操作的偏序。 +并发意味着时间线会分岔然后合并——在这种情况下,不同分支上的操作是无法比较的(即并发操作)。在[第五章](ch5.md)中我们看到了这种现象:例如,[图5-14](img/fig5-14.md) 并不是一条直线的全序关系,而是一堆不同的操作并发进行。图中的箭头指明了因果依赖——操作的偏序。 如果你熟悉像Git这样的分布式版本控制系统,那么其版本历史与因果关系图极其相似。通常,一个**提交(Commit)**发生在另一个提交之后,在一条直线上。但是有时你会遇到分支(当多个人同时在一个项目上工作时),**合并(Merge)**会在这些并发创建的提交相融合时创建。 #### 线性一致性强于因果一致性 -那么因果顺序和线性一致性之间的关系是什么?答案是线性一致性**隐含着(implies)**因果关系:任何线性一致的系统都能正确保持因果性【7】。特别是,如果系统中有多个通信通道(如[图9-5](img/fig9-5.png)中的消息队列和文件存储服务),线性一致性可以自动保证因果性,系统无需任何特殊操作(如在不同组件间传递时间戳)。 +那么因果顺序和线性一致性之间的关系是什么?答案是线性一致性**隐含着(implies)**因果关系:任何线性一致的系统都能正确保持因果性【7】。特别是,如果系统中有多个通信通道(如[图9-5](img/fig9-5.png) 中的消息队列和文件存储服务),线性一致性可以自动保证因果性,系统无需任何特殊操作(如在不同组件间传递时间戳)。 线性一致性确保因果性的事实使线性一致系统变得简单易懂,更有吸引力。然而,正如“[线性一致性的代价](#线性一致性的代价)”中所讨论的,使系统线性一致可能会损害其性能和可用性,尤其是在系统具有严重的网络延迟的情况下(例如,如果系统在地理上散布)。出于这个原因,一些分布式数据系统已经放弃了线性一致性,从而获得更好的性能,但它们用起来也更为困难。 @@ -440,7 +440,7 @@ CAP定理的正式定义仅限于很狭隘的范围【30】,它只考虑了一 迄今,这个描述与上节所述的奇偶计数器基本类似。使兰伯特时间戳因果一致的关键思想如下所示:每个节点和每个客户端跟踪迄今为止所见到的最大**计数器**值,并在每个请求中包含这个最大计数器值。当一个节点收到最大计数器值大于自身计数器值的请求或响应时,它立即将自己的计数器设置为这个最大值。 -这如 [图9-8](img/fig9-8.png) 所示,其中客户端 A 从节点 2 接收计数器值 5 ,然后将最大值 5 发送到节点 1 。此时,节点 1 的计数器仅为 1 ,但是它立即前移至 5 ,所以下一个操作的计数器的值为 6 。 +这如 [图9-8](img/fig9-8.png) 所示,其中客户端 A 从节点2 接收计数器值 `5` ,然后将最大值 `5` 发送到节点1 。此时,节点1 的计数器仅为 `1` ,但是它立即前移至 `5` ,所以下一个操作的计数器的值为 `6` 。 只要每一个操作都携带着最大计数器值,这个方案确保兰伯特时间戳的排序与因果一致,因为每个因果依赖都会导致时间戳增长。 @@ -534,17 +534,15 @@ CAP定理的正式定义仅限于很狭隘的范围【30】,它只考虑了一 上一节介绍了如何从全序广播构建一个线性一致的CAS操作。我们也可以把它反过来,假设我们有线性一致的存储,接下来会展示如何在此基础上构建全序广播。 -最简单的方法是假设你有一个线性一致的寄存器来存储一个整数,并且有一个原子**增量和获取**操作【28】。或者CAS操作也可以完成这项工作。 +最简单的方法是假设你有一个线性一致的寄存器来存储一个整数,并且有一个原子**自增并返回**操作【28】。或者原子CAS操作也可以完成这项工作。 -该算法很简单:对于每个要通过全部顺序广播发送的消息,你将递增并获取线性一致性的整数,然后将从寄存器获得的值作为序号附加到消息中。然后,你可以将消息发送到所有节点(重新发送任何丢失的消息),并且收件人将按序号连续发送消息。 +该算法很简单:每个要通过全序广播发送的消息首先对线性一致寄存器执行**自增并返回**操作。然后将从寄存器获得的值作为序列号附加到消息中。然后你可以将消息发送到所有节点(重新发送任何丢失的消息),而收件人将按序列号连续发送消息。 -请注意,与兰伯特时间戳不同,你通过递增线性一致性寄存器获得的数字形成一个没有间隙的序列。因此,如果一个节点已经发送了消息4并且接收到序列号为6的传入消息,则它知道它在传递消息6之前必须等待消息5.同样的情况并非如此 +请注意,与兰伯特时间戳不同,通过自增线性一致性寄存器获得的数字形式上是一个没有间隙的序列。因此,如果一个节点已经发送了消息 4 并且接收到序列号为 6 的传入消息,则它知道它在传递消息 6 之前必须等待消息 5 。兰伯特时间戳则与之不同 ——事实上,这是全序广播和时间戳排序间的关键区别。 -与兰伯特时间戳——事实上,这是全序广播和时间戳顺序之间的关键区别。 +实现一个带有原子性**自增并返回**操作的线性一致寄存器有多困难?像往常一样,如果事情从来不出差错,那很容易:你可以简单地把它保存在单个节点内的变量中。问题在于处理当该节点的网络连接中断时的情况,并在该节点失效时能恢复这个值【59】。一般来说,如果你对线性一致性的序列号生成器进行深入过足够深入的思考,你不可避免地会得出一个共识算法。 -使用原子增量和获取操作来创建线性一致性整数有多困难?像往常一样,如果事情从来没有失败过,那很容易:你可以把它保存在一个节点的变量中。问题在于处理当该节点的网络连接中断时的情况,并在该节点失败时恢复该值【59】。一般来说,如果你对线性一致性序列号的产生者认真思考,你不可避免地会得出一个一致的算法。 - -这并非巧合:可以证明,线性一致性的比较和设置(或增量和取得)寄存器和全序广播都相当于【28,67】。也就是说,如果你能解决其中的一个问题,你可以把它转化成为其他问题的解决方案。这是相当深刻和令人惊讶的洞察力! +这并非巧合:可以证明,线性一致的CAS(或自增并返回)寄存器与全序广播都都等价于**共识**问题【28,67】。也就是说,如果你能解决其中的一个问题,你可以把它转化成为其他问题的解决方案。这是相当深刻和令人惊讶的洞察! 现在是时候正面处理共识问题了,我们将在本章的其余部分进行讨论。 @@ -552,125 +550,125 @@ CAP定理的正式定义仅限于很狭隘的范围【30】,它只考虑了一 ## 分布式事务与共识 -共识是分布式计算中最重要也是最基本的问题之一。从表面上看,似乎很简单:非正式地说,目标只是让几个节点达成一致。你可能会认为这不应该太难。不幸的是,许多破损的系统已经被误认为这个问题很容易解决。 +**共识**是分布式计算中最重要也是最基本的问题之一。从表面上看似乎很简单:非正式地讲,目标只是**让几个节点达成一致(get serveral nodes to agree on something)**。你也许会认为这不会太难。不幸的是,许多出故障的系统都是因为错误地轻信这个问题很容易解决。 -虽然共识是非常重要的,但关于它的部分在本书的后半部分已经出现了,因为这个主题非常微妙,欣赏细微之处需要一些必要的知识。即使在学术研究界,对共识的理解也只是在几十年的时间内逐渐显现出来,一路上有许多误解。现在我们已经讨论了复制([第5章](ch5.md)),事务([第7章](ch7.md)),系统模型([第8章](ch8.md)),线性一致性以及全序([本章](ch9.md)),我们终于准备好解决共识问题了。 +尽管共识非常重要,但关于它的内容出现在本书的后半部分,因为这个主题非常微妙,欣赏细微之处需要一些必要的知识。即使在学术界,对共识的理解也是在几十年的过程中逐渐沉淀而来,一路上也有着许多误解。现在我们已经讨论了复制([第5章](ch5.md)),事务([第7章](ch7.md)),系统模型([第8章](ch8.md)),线性一致以及全序([本章](ch9.md)),我们终于准备好解决共识问题了。 -在节点达成一致的情况下,有许多情况是很重要的。例如: +节点能达成一致,在很多场景下都非常重要,例如: ***领导选举*** -​ 在具有单引导程序复制的数据库中,所有节点需要就哪个节点是领导者达成一致。如果一些节点由于网络故障而无法与其他节点通信,则可能会引起争议。在这种情况下,一致性对于避免错误的故障切换非常重要,从而导致两个节点都认为自己是领导者的脑裂情况(参阅“[处理节点宕机](ch5.md#处理节点宕机)”)。如果有两个领导者,它们都会接受写入,他们的数据会发生分歧,导致不一致和数据丢失。 +​ 在单主复制的数据库中,所有节点需要就哪个节点是领导者达成一致。如果一些节点由于网络故障而无法与其他节点通信,则可能会对领导权的归属引起争议。在这种情况下,共识对于避免错误的故障切换非常重要。错误的故障切换会导致两个节点都认为自己是领导者(**脑裂**,参阅“[处理节点宕机](ch5.md#处理节点宕机)”)。如果有两个领导者,它们都会接受写入,它们的数据会发生分歧,从而导致不一致和数据丢失。 ***原子提交*** -在支持跨越多个节点或分区的事务的数据库中,有一个事务可能在某些节点上失败,但在其他节点上成功。如果我们想要维护事务的原子性(就ACID而言,请参“[原子性](ch7.md#原子性)”),我们必须让所有节点对事务的结果达成一致:要么全部中止/回滚(如果出现任何错误)或者他们都承诺(如果没有出错)。这个共识的例子被称为原子提交问题[^xii]。 +在支持跨多节点或跨多分区事务的数据库中,一个事务可能在某些节点上失败,但在其他节点上成功。如果我们想要维护事务的原子性(就ACID而言,请参“[原子性](ch7.md#原子性)”),我们必须让所有节点对事务的结果达成一致:要么全部中止/回滚(如果出现任何错误),要么它们全部提交(如果没有出错)。这个共识的例子被称为**原子提交(atomic commit)**问题[^xii]。 -[^xii]: 原子提交的形式化与共识稍有不同:原子事务只有在所有参与者投票提交的情况下才能提交,如果有任何参与者需要中止,则必须中止。 允许共识决定其中一位参与者提出的任何值。 然而,原子的承诺和共识是可以相互压缩的【70,71】。 非阻塞原子提交比共识更难——参阅“[三阶段提交](#三阶段提交)”。 +[^xii]: 原子提交的形式化与共识稍有不同:原子事务只有在**所有**参与者投票提交的情况下才能提交,如果有任何参与者需要中止,则必须中止。 共识则允许就**任意一个**被参与者提出的候选值达成一致。 然而,原子提交和共识可以相互简化为对方【70,71】。 **非阻塞**原子提交则要比共识更为困难 —— 参阅“[三阶段提交](#三阶段提交)”。 > ### 共识的不可能性 > -> 你可能已经听说过作者Fischer,Lynch和Paterson之后的FLP结果【68】,这证明如果存在节点可能崩溃的风险,则不存在总是能够达成一致的算法。在分布式系统中,我们必须假设节点可能会崩溃,所以可靠的共识是不可能的。然而,在这里,我们正在讨论达成共识的算法。这里发生了什么? +> 你可能已经听说过作者Fischer,Lynch和Paterson之后的FLP结果【68】,它证明,如果存在节点可能崩溃的风险,则不存在**总是**能够达成共识的算法。在分布式系统中,我们必须假设节点可能会崩溃,所以可靠的共识是不可能的。然而这里我们正在讨论达成共识的算法,到底是怎么回事? > -> 答案是FLP结果在异步系统模型中得到了证明(参阅“[系统模型与现实](#系统模型与现实)”),这是一个非常有限的模型,它假定确定性算法不能使用任何时钟或超时。如果算法被允许使用超时或其他方法来识别可疑的崩溃节点(即使怀疑有时是错误的),那么共识就变得可以解决了【67】。即使只允许算法使用随机数也足以绕过不可能的结果【69】。 +> 答案是FLP结果在**异步系统模型**中得到了证明(参阅“[系统模型与现实](ch8.md#系统模型与现实)”),这是一种限制性很强的模型,它假定确定性算法不能使用任何时钟或超时。如果允许算法使用**超时**或其他方法来识别可疑的崩溃节点(即使怀疑有时是错误的),则共识变为一个可解的问题【67】。即使仅仅允许算法使用随机数,也足以绕过这个不可能的结果【69】。 > -> 因此,FLP虽然不可能达成共识,但理论上具有重要意义,但实际上分布式系统通常可以达成共识。 +> 因此,FLP是关于共识不可能性的重要理论结果,但现实中的分布式系统通常是可以达成共识的。 -在本节中,我们将首先更详细地检查原子提交问题。具体来说,我们将讨论两阶段提交(2PC)算法,这是解决原子提交最常见的方法,并在各种数据库、消息传递系统和应用服务器中实现。事实证明,2PC是一种一致的算法,但并不是一个很好的算法【70,71】。 +在本节中,我们将首先更详细地研究**原子提交**问题。具体来说,我们将讨论**两阶段提交(2PC, two-phase commit)**算法,这是解决原子提交问题最常见的办法,并在各种数据库、消息队列和应用服务器中实现。事实证明2PC是一种共识算法,但不是一个非常好的算法【70,71】。 -通过对2PC学习,我们将继续努力实现更好的一致性算法,比如ZooKeeper(Zab)和etcd(Raft)中使用的算法。 +通过对2PC的学习,我们将继续努力实现更好的一致性算法,比如ZooKeeper(Zab)和etcd(Raft)中使用的算法。 ### 原子提交与二阶段提交(2PC) -在[第7章](ch7.md)中,我们了解到事务原子性的目的是在出现几次写错的情况下提供简单的语义。事务的结果要么是成功的提交,在这种情况下,所有事务的写入都是持久的,或者中止,在这种情况下,所有事务的写入都被回滚(即撤消或丢弃)。 +在[第7章](ch7.md)中我们了解到,事务原子性的目的是在多次写操作中途出错的情况下,提供一种简单的语义。事务的结果要么是成功提交,在这种情况下,事务的所有写入都是持久化的;要么是中止,在这种情况下,事务的所有写入都被回滚(即撤消或丢弃)。 -原子性可以防止失败的事务搅乱数据库,其结果是半成品和半更新状态。这对于多对象事务(参阅“[单对象和多对象操作](ch7.md#单对象和多对象操作)”)和维护二级索引的数据库尤其重要。每个辅助索引都是与主数据分离的数据结构——因此,如果你修改了一些数据,则还需要在辅助索引中进行相应的更改。原子性确保二级索引与主数据保持一致(如果索引与主数据不一致,则不会很有用)。 +原子性可以防止失败的事务搅乱数据库,避免数据库陷入半成品结果和半更新状态。这对于多对象事务(参阅“[单对象和多对象操作](ch7.md#单对象和多对象操作)”)和维护次级索引的数据库尤其重要。每个辅助索引都是与主数据相分离的数据结构—— 因此,如果你修改了一些数据,则还需要在辅助索引中进行相应的更改。原子性确保二级索引与主数据保持一致(如果索引与主数据不一致,就没什么用了)。 #### 从单节点到分布式原子提交 -对于在单个数据库节点执行的事务,原子性通常由存储引擎执行。当客户端请求数据库节点提交事务时,数据库使事务的写入持久化(通常在预写式日志中:参阅“[使B树可靠](ch3.md#使B树可靠)”),然后将提交记录追加到日志中磁盘。如果数据库在这个过程中间崩溃,当节点重新启动时,事务从日志中恢复:如果提交记录在崩溃之前成功地写入磁盘,则认为事务被提交;否则来自该事务的任何写入都被回滚。 +对于在单个数据库节点执行的事务,原子性通常由存储引擎实现。当客户端请求数据库节点提交事务时,数据库将使事务的写入持久化(通常在预写式日志中:参阅“[使B树可靠](ch3.md#使B树可靠)”),然后将提交记录追加到磁盘中的日志里。如果数据库在这个过程中间崩溃,当节点重启时,事务会从日志中恢复:如果提交记录在崩溃之前成功地写入磁盘,则认为事务被提交;否则来自该事务的任何写入都被回滚。 -因此,在单个节点上,事务承诺主要取决于数据持久写入磁盘的顺序:首先是数据,然后是提交记录【72】。事务提交或放弃的关键决定时刻是磁盘完成写入提交记录的时刻:在此之前,仍有可能中止(由于崩溃),但在此之后,事务已经提交(即使数据库崩溃)。因此,这是一个单一的设备(一个特定的磁盘驱动器的控制器,连接到一个特定的节点),使得提交具有原子性。 +因此,在单个节点上,事务的提交主要取决于数据持久化落盘的**顺序**:首先是数据,然后是提交记录【72】。事务提交或终止的关键决定时刻是磁盘完成写入提交记录的时刻:在此之前,仍有可能中止(由于崩溃),但在此之后,事务已经提交(即使数据库崩溃)。因此,是单一的设备(连接到单个磁盘驱动的控制器,且挂载在单台机器上)使得提交具有原子性。 -但是,如果一个事务中涉及多个节点呢?例如,也许在分区数据库中有一个多对象事务,或者是一个由关键词分区的二级索引(其中索引条目可能位于与主数据不同的节点上;参阅“[分区和二级索引](ch6.md#分区和二级索引)”)。大多数“NoSQL”分布式数据存储不支持这种分布式事务,而是各种集群关系系统(请参见“[实践中的分布式事务](#实践中的分布式事务)”)。 +但是,如果一个事务中涉及多个节点呢?例如,你也许在分区数据库中会有一个多对象事务,或者是一个按关键词分区的二级索引(其中索引条目可能位于与主数据不同的节点上;参阅“[分区和二级索引](ch6.md#分区和二级索引)”)。大多数“NoSQL”分布式数据存储不支持这种分布式事务,但是很多关系型数据库集群支持(参见“[实践中的分布式事务](#实践中的分布式事务)”)。 -在这些情况下,仅向所有节点发送提交请求并且独立提交每个节点的事务是不够的。这样做很容易发生:提交在某些节点上成功,在其他节点上失败,这违反了原子性保证: +在这些情况下,仅向所有节点发送提交请求并独立提交每个节点的事务是不够的。这样很容易发生违反原子性的情况:提交在某些节点上成功,而在其他节点上失败: * 某些节点可能会检测到约束冲突或冲突,因此需要中止,而其他节点则可以成功进行提交。 * 某些提交请求可能在网络中丢失,最终由于超时而中止,而其他提交请求则通过。 * 在提交记录完全写入之前,某些节点可能会崩溃,并在恢复时回滚,而其他节点则成功提交。 -如果某些节点提交了事务,但其他节点却放弃了这些事务,那么这些节点就会彼此不一致(如[图7-3](img/fig7-3.png)所示)。而且一旦在一个节点上提交了一个事务,如果事后证明它在另一个节点上被中止,它将不能被撤回。出于这个原因,一旦确定事务中的所有其他节点也将提交,节点就必须进行提交。 +如果某些节点提交了事务,但其他节点却放弃了这些事务,那么这些节点就会彼此不一致(如 [图7-3](img/fig7-3.png) 所示)。而且一旦在某个节点上提交了一个事务,如果事后发现它在其它节点上被中止了,它是无法撤回的。出于这个原因,一旦确定事务中的所有其他节点也将提交,节点就必须进行提交。 -事务提交必须是不可撤销的——你不能改变主意,并在事务提交后追溯中止事务。这个规则的原因是,一旦数据被提交,其他事务就可以看到,因此其他客户可能会开始依赖这些数据。这个原则构成了读已提交隔离等级的基础,在“[读已提交](ch7.md#读已提交)”一节中讨论了这个问题。如果一个事务在提交后被允许中止,所有读取提交数据的事务将基于被追溯声明不存在的数据,所以它们也必须恢复。 +事务提交必须是不可撤销的 —— 事务提交之后,你不能改变主意,并追溯性地中止事务。这个规则的原因是,一旦数据被提交,其结果就对其他事务可见,因此其他客户端可能会开始依赖这些数据。这个原则构成了**读已提交**隔离等级的基础,在“[读已提交](ch7.md#读已提交)”一节中讨论了这个问题。如果一个事务在提交后被允许中止,所有那些读取了**已提交却又被追溯声明不存在数据**的事务也必须回滚。 -(提交事务的效果有可能后续通过另一个补偿事务取消【73,74】,但从数据库的角度来看,这是一个单独的事务,因此任何关于交叉事务正确性的保证是应用自己的问题。) +(提交事务的结果有可能通过事后执行另一个补偿事务来取消【73,74】,但从数据库的角度来看,这是一个单独的事务,因此任何关于跨事务正确性的保证都是应用自己的问题。) -#### 介绍两阶段提交 +#### 两阶段提交简介 -两阶段提交是一种用于实现跨多个节点的原子事务提交的算法,即确保所有节点提交或所有节点中止。 它是分布式数据库中的经典算法【13,35,75】。 2PC在某些数据库内部使用,并且还以XA事务【76,77】(例如Java Transaction API支持)或通过`WS-AtomicTransaction for SOAP Web`服务的形式提供给应用程序【78,79】。 +**两阶段提交(two-phase commit)**是一种用于实现跨多个节点的原子事务提交的算法,即确保所有节点提交或所有节点中止。 它是分布式数据库中的经典算法【13,35,75】。 2PC在某些数据库内部使用,也以**XA事务**的形式对应用可用【76,77】(例如Java Transaction API支持)或以SOAP Web服务的`WS-AtomicTransaction` 形式提供给应用程序【78,79】。 -[图9-9](img/fig9-9)说明了2PC的基本流程。 与单节点事务一样,2PC中的提交/终止进程分为两个阶段(因此而得名),而不是单个提交请求。 +[图9-9](img/fig9-9)说明了2PC的基本流程。2PC中的提交/中止过程分为两个阶段(因此而得名),而不是单节点事务中的单个提交请求。 ![](img/fig9-9.png) **图9-9 两阶段提交(2PC)的成功执行** -> #### 不要混淆2PC和2PL +> #### 不要把2PC和2PL搞混了 > -> 两阶段提交(2PC)和两阶段锁定(参阅“[两阶段锁定(2PL)](ch7.md#两阶段锁定(2PL))”)是两个完全不同的事情。 2PC在分布式数据库中提供原子提交,而2PL提供可序列化的隔离。为了避免混淆,最好把它们看作完全独立的概念,并忽略名称中的不幸的相似性。 +> 两阶段提交(2PC)和两阶段锁定(参阅“[两阶段锁定(2PL)](ch7.md#两阶段锁定(2PL))”)是两个完全不同的东西。 2PC在分布式数据库中提供原子提交,而2PL提供可序列化的隔离等级。为了避免混淆,最好把它们看作完全独立的概念,并忽略名称中不幸的相似性。 -2PC使用一个通常不会出现在单节点事务中的新组件:**协调者(coordinator)**(也称为事务管理器)。协调者通常在请求事务的相同应用程序进程(例如,嵌入在Java EE容器中)中实现为库,但也可以是单独的进程或服务。这种协调者的例子包括Narayana,JOTM,BTM或MSDTC。 +2PC使用一个通常不会出现在单节点事务中的新组件:**协调者(coordinator)**(也称为**事务管理器(transaction manager)**)。协调者通常在请求事务的相同应用程序进程中以库的形式实现(例如,嵌入在Java EE容器中),但也可以是单独的进程或服务。这种协调者的例子包括Narayana,JOTM,BTM或MSDTC。 -正常情况下,2PC事务从应用程序在多个数据库节点上读写数据开始。我们把这些数据库节点称为事务参与者。当应用程序准备提交时,协调者开始阶段1:它发送一个准备请求到每个节点,询问他们是否能够提交。协调者然后跟踪参与者的回应: +正常情况下,2PC事务以应用程序在多个数据库节点上读写数据开始。我们称这些数据库节点为**参与者(participants)**。当应用程序准备提交时,协调者开始阶段 1 :它发送一个**准备(prepare)**请求到每个节点,询问它们是否能够提交。然后协调者会跟踪参与者的响应: -* 如果所有参与者都回答“是”,表示他们已经准备好提交,那么协调者在阶段2发出**提交(commit)**请求,实际发生提交。 -* 如果任何参与者回复“否”,则协调者在阶段2中向所有节点发送**中止(abort)**请求。 +* 如果所有参与者都回答“是”,表示它们已经准备好提交,那么协调者在阶段 2 发出**提交(commit)**请求,然后提交真正发生。 +* 如果任意一个参与者回复了“否”,则协调者在阶段2 中向所有节点发送**中止(abort)**请求。 这个过程有点像西方传统婚姻仪式:司仪分别询问新娘和新郎是否要结婚,通常是从两方都收到“我愿意”的答复。收到两者的回复后,司仪宣布这对情侣成为夫妻:事务就提交了,这一幸福事实会广播至所有的参与者中。如果新娘与新郎之一没有回复”我愿意“,婚礼就会中止【73】。 #### 承诺系统 -从这个简短的描述可能不清楚为什么两阶段提交确保了原子性,而跨几个节点的一阶段提交没有。准备和提交请求当然可以在两阶段的情况下轻易地丢失。 2PC有什么不同? +这个简短的描述可能并没有说清楚为什么两阶段提交保证了原子性,而跨多个节点的一阶段提交却没有。在两阶段提交的情况下,准备请求和提交请求当然也可以轻易丢失。 2PC又有什么不同呢? 为了理解它的工作原理,我们必须更详细地分解这个过程: -1. 当应用想要开启一个分布式事务时,它向协调者请求一个事务ID。此事务ID是全局唯一的。 -2. 应用在每个参与者上开始单节点事务,并将全局唯一事务ID附到单节点事务上。所有的读写都是在这些单节点事务之一中完成的。如果在这个阶段出现任何问题(例如,节点崩溃或请求超时),则协调者或任何参与者都可以中止。 -3. 当应用程序准备提交时,协调者向所有参与者发送一个准备请求,标记为全局事务ID。如果这些请求中的任何一个失败或超时,则协调者向所有参与者发送针对该事务ID的放弃请求。 -4. 参与者收到准备请求时,确保在任何情况下都可以明确地进行事务。这包括将所有事务数据写入磁盘(出现故障,电源故障或硬盘空间不足以拒绝稍后提交)以及检查是否存在任何冲突或约束违规。通过向协调者回答“是”,节点承诺在没有错误的情况下提交事务。换句话说,参与者放弃了中止事务的权利,但没有实际提交。 -5. 当协调者收到所有准备请求的答复时,就是否提交或中止事务作出明确的决定(只有在所有参与者投赞成票的情况下才提交)。协调者必须把这个决定写到磁盘上的事务日志中,以便它知道它决定的方式,以防随后发生崩溃。这被称为**提交点(commit point)**。 -6. 一旦协调者的决定写入磁盘,提交或放弃请求被发送给所有参与者。如果此请求失败或超时,则协调者必须一直重试,直到成功为止。没有更多的事情要做,如果做出决定,那么决定必须执行,不管它需要多少次重试。如果参与者在此期间崩溃,事务将在恢复时进行——由于参与者投票“是”,因此恢复时不能拒绝提交。 +1. 当应用想要启动一个分布式事务时,它向协调者请求一个事务ID。此事务ID是全局唯一的。 +2. 应用在每个参与者上启动单节点事务,并在单节点事务上捎带上这个全局事务ID。所有的读写都是在这些单节点事务中各自完成的。如果在这个阶段出现任何问题(例如,节点崩溃或请求超时),则协调者或任何参与者都可以中止。 +3. 当应用准备提交时,协调者向所有参与者发送一个**准备**请求,并打上全局事务ID的标记。如果任意一个请求失败或超时,则协调者向所有参与者发送针对该事务ID的中止请求。 +4. 参与者收到准备请求时,需要确保在任意情况下都的确可以提交事务。这包括将所有事务数据写入磁盘(出现故障,电源故障,或硬盘空间不足都不能是稍后拒绝提交的理由)以及检查是否存在任何冲突或违反约束。通过向协调者回答“是”,节点承诺,只要请求,这个事务一定可以不出差错地提交。换句话说,参与者放弃了中止事务的权利,但没有实际提交。 +5. 当协调者收到所有准备请求的答复时,会就提交或中止事务作出明确的决定(只有在所有参与者投赞成票的情况下才会提交)。协调者必须把这个决定写到磁盘上的事务日志中,如果它随后就崩溃,恢复后也能知道自己所做的决定。这被称为**提交点(commit point)**。 +6. 一旦协调者的决定落盘,提交或放弃请求会发送给所有参与者。如果这个请求失败或超时,协调者必须永远保持重试,直到成功为止。没有回头路:如果已经做出决定,不管需要多少次重试它都必须被执行。如果参与者在此期间崩溃,事务将在其恢复后提交——由于参与者投了赞成,因此恢复后它不能拒绝提交。 -因此,该协议包含两个关键的“不归路”点:当参与者投票“是”时,它承诺它肯定能够稍后提交(尽管协调者可能仍然选择放弃)。一旦协调者决定,这个决定是不可撤销的。这些承诺保证了2PC的原子性。 (单节点原子提交将这两个事件合并为一个:将提交记录写入事务日志。) +因此,该协议包含两个关键的“不归路”点:当参与者投票“是”时,它承诺它稍后肯定能够提交(尽管协调者可能仍然选择放弃)。一旦协调者做出决定,这一决定是不可撤销的。这些承诺保证了2PC的原子性。 (单节点原子提交将这两个事件混为一谈:将提交记录写入事务日志。) -回到婚姻的比喻,在说“我是”之前,你和你的新娘/新郎有“中止”这个事务的自由,通过回复“不行!”(或者差不多效果的话)。然而,在说“我愿意”之后,你就不能收回那个声明了。如果你说“我愿意”后晕倒了,而你没有听到司仪说“你们现在是夫妻了”,那并不会改变事务已经提交的事实。当你稍后恢复意识时,你可以通过查询司仪的全局事务ID状态来查明你是否已婚,或者你可以等待司仪重试下一次提交请求(因为重试将在你无意识期间一直持续)。 +回到婚姻的比喻,在说“我是”之前,你和你的新娘/新郎有中止这个事务的自由,通过回复 “没门!”(或者有类似效果的话)。然而在说了“我愿意”之后,你就不能撤回那个声明了。如果你说“我愿意”后晕倒了,没有听到司仪说“你们现在是夫妻了”,那也并不会改变事务已经提交的现实。当你稍后恢复意识时,可以通过查询司仪的全局事务ID状态来确定你是否已经成婚,或者你可以等待司仪重试下一次提交请求(因为重试将在你无意识期间一直持续)。 #### 协调者失效 -我们已经讨论了在2PC期间如果其中一个参与者或网络发生故障会发生什么情况:如果任何一个准备请求失败或者超时,协调者就中止事务。如果任何提交或中止请求失败,协调者将无条件重试。但是,如果协调者崩溃,会发生什么情况并不太清楚。 +我们已经讨论了在2PC期间,如果参与者之一或网络发生故障时会发生什么情况:如果任何一个**准备**请求失败或者超时,协调者就会中止事务。如果任何提交或中止请求失败,协调者将无条件重试。但是如果协调者崩溃,会发生什么情况就不太清楚了。 -如果协调者在发送准备请求之前失败,参与者可以安全地中止事务。但是,一旦参与者收到了准备请求并投了“是”,就不能再单方面放弃——必须等待协调者回答事务是否已经发生或中止。如果此时协调者崩溃或网络出现故障,参与者只能等待。参与者在这个状态下的事务是存疑的或不确定的。 +如果协调者在发送**准备**请求之前失败,参与者可以安全地中止事务。但是,一旦参与者收到了准备请求并投了“是”,就不能再单方面放弃 —— 必须等待协调者回答事务是否已经提交或中止。如果此时协调者崩溃或网络出现故障,参与者什么也做不了只能等待。参与者的这种事务状态称为**存疑(in doubt)**的或**不确定(uncertain)**的。 -情况如[图9-10](img/fig9-10)所示。在这个特定的例子中,协调者实际上决定提交,数据库2收到提交请求。但是,协调者在将提交请求发送到数据库1之前发生崩溃,因此数据库1不知道是否提交或中止。即使超时在这里也没有帮助:如果数据库1在超时后单方面中止,它将最终与提交的数据库2不一致。同样,单方面犯也是不安全的,因为另一个参与者可能已经中止了。 +情况如[图9-10](img/fig9-10) 所示。在这个特定的例子中,协调者实际上决定提交,数据库2 收到提交请求。但是,协调者在将提交请求发送到数据库1 之前发生崩溃,因此数据库1 不知道是否提交或中止。即使**超时**在这里也没有帮助:如果数据库1 在超时后单方面中止,它将最终与执行提交的数据库2 不一致。同样,单方面提交也是不安全的,因为另一个参与者可能已经中止了。 ![](img/fig9-10.png)  **图9-10 参与者投赞成票后,协调者崩溃。数据库1不知道是否提交或中止** -没有协调者的消息,参与者无法知道是否承诺或放弃。原则上,参与者可以相互沟通,找出每个参与者如何投票并达成一致,但这不是2PC协议的一部分。 +没有协调者的消息,参与者无法知道是提交还是放弃。原则上参与者可以相互沟通,找出每个参与者是如何投票的,并达成一致,但这不是2PC协议的一部分。 -2PC可以完成的唯一方法是等待协调者恢复。这就是为什么协调者必须在向参与者发送提交或中止请求之前将其提交或中止决定写入磁盘上的事务日志:协调者恢复后,通过读取其事务日志来确定所有存疑事务的状态。任何在协调者日志中没有提交记录的事务都会中止。因此,2PC的**提交点**归结为协调者上的常规单节点原子提交。 +可以完成2PC的唯一方法是等待协调者恢复。这就是为什么协调者必须在向参与者发送提交或中止请求之前,将其提交或中止决定写入磁盘上的事务日志:协调者恢复后,通过读取其事务日志来确定所有存疑事务的状态。任何在协调者日志中没有提交记录的事务都会中止。因此,2PC的**提交点**归结为协调者上的常规单节点原子提交。 #### 三阶段提交 -两阶段提交被称为阻塞原子提交协议,因为2PC可能卡住,等待协调者恢复。理论上,可以使一个原子提交协议非阻塞,以便在节点失败时不会卡住。但在实践中这个工作并不那么简单。 +两阶段提交被称为**阻塞(blocking)**原子提交协议,因为存在2PC可能卡住并等待协调者恢复的情况。理论上,可以使一个原子提交协议变为**非阻塞(nonblocking)**的,以便在节点失败时不会卡住。但是让这个协议能在实践中工作并没有那么简单。 -作为2PC的替代方案,已经提出了一种称为三阶段提交(3PC)的算法【13,80】。然而,3PC假定一个有界延迟的网络和有限响应时间的节点;在大多数具有无限网络延迟和进程暂停的实际系统中(见[第8章](ch8.md)),它并不能保证原子性。 +作为2PC的替代方案,已经提出了一种称为**三阶段提交(3PC)**的算法【13,80】。然而,3PC假定网络延迟有界,节点响应时间有限;在大多数具有无限网络延迟和进程暂停的实际系统中(见[第8章](ch8.md)),它并不能保证原子性。 -通常,非阻塞原子提交需要一个完美的故障检测器【67,71】—— 即一个可靠的机制来判断一个节点是否已经崩溃。在无限延迟的网络中,超时不是可靠的故障检测器,因为即使没有节点崩溃,请求也可能由于网络问题而超时。出于这个原因,2PC仍然被使用,尽管大家都清楚可能存在协调者故障的问题。 +通常,非阻塞原子提交需要一个**完美的故障检测器(perfect failure detector)**【67,71】—— 即一个可靠的机制来判断一个节点是否已经崩溃。在具有无限延迟的网络中,超时并不是一种可靠的故障检测机制,因为即使没有节点崩溃,请求也可能由于网络问题而超时。出于这个原因,2PC仍然被使用,尽管大家都清楚可能存在协调者故障的问题。 @@ -678,7 +676,7 @@ CAP定理的正式定义仅限于很狭隘的范围【30】,它只考虑了一 分布式事务,尤其是那些通过两阶段提交实现的事务,毁誉参半。一方面,它们被看作是提供一个难以实现的重要的安全保证;另一方面,他们被批评为造成运维问题,造成性能下降,承诺超过他们能够实现的目标【81,82,83,84】。许多云服务由于其导致的运维问题而选择不实现分布式事务【85,86】。 -分布式事务的某些实现会带来严重的性能损失——例如,MySQL中的分布式事务被报告比单节点事务慢10倍以上【87】,所以当人们建议不要使用这些事务时就不足为奇了。两阶段提交所固有的大部分性能成本是由于崩溃恢复所需的额外强制刷盘(`fsync`)【88】以及额外的网络往返。 +分布式事务的某些实现会带来严重的性能损失—— 例如,MySQL中的分布式事务被报告比单节点事务慢10倍以上【87】,所以当人们建议不要使用这些事务时就不足为奇了。两阶段提交所固有的大部分性能成本是由于崩溃恢复所需的额外强制刷盘(`fsync`)【88】以及额外的网络往返。 但是,我们不应该直接抛弃分布式事务,而应该更加仔细地审视这些事务,因为从中可以汲取重要的经验教训。首先,我们应该精确地说明“**分布式事务**”的含义。两种截然不同的分布式事务类型经常被混淆: @@ -739,11 +737,11 @@ XA假定你的应用程序使用网络驱动程序或客户端库来与参与者 XA事务解决了保持多个参与者数据系统一致的真实而重要的问题,但正如我们所看到的那样,它们也引入了主要的运维问题。特别是,关键的实现是事务协调者本身就是一种数据库(在其中存储事务结果),因此需要像其他重要数据库一样小心: * 如果协调者没有被复制,而是只在一台机器上运行,那么整个系统是一个失效的单点(因为它的失效会导致其他应用程序服务器阻塞在有问题的事务处理的锁上)。令人惊讶的是,许多协调者实现默认情况下不是高度可用,或者只有基本的复制支持。 -* 许多服务器端应用程序都是在无状态模式下开发的(受到HTTP的青睐),所有持久状态都存储在数据库中,具有应用程序服务器可随意添加和删除的优点。但是,当协调者是应用程序服务器的一部分时,它会改变部署的性质。突然间,协调者的日志成为持久系统状态的关键部分——与数据库本身一样重要,因为协调者日志是为了在崩溃后恢复疑问事务所必需的。这样的应用程序服务器不再是无状态的。 +* 许多服务器端应用程序都是在无状态模式下开发的(受到HTTP的青睐),所有持久状态都存储在数据库中,具有应用程序服务器可随意添加和删除的优点。但是,当协调者是应用程序服务器的一部分时,它会改变部署的性质。突然间,协调者的日志成为持久系统状态的关键部分—— 与数据库本身一样重要,因为协调者日志是为了在崩溃后恢复疑问事务所必需的。这样的应用程序服务器不再是无状态的。 * 由于XA需要与各种数据系统兼容,因此它是必须的最小公分母。例如,它不能检测到不同系统间的死锁(因为这将需要一个标准化的协议来让系统交换每个事务正在等待的锁的信息),而且它不适用于[SSI](ch7.md#可串行快照隔离(SSI) ),因为这需要一个协议来识别不同系统之间的冲突。 * 对于数据库内部的分布式事务(而不是XA),限制不是很大,例如SSI的分布式版本是可能的。然而,仍然存在2PC成功进行事务的问题,所有参与者都必须作出回应。因此,如果系统的任何部分损坏,事务也会失败。因此,分布式事务有扩大故障的趋势,这与我们构建容错系统的目标背道而驰。 -这些事实是否意味着我们应该放弃保持几个系统一致的所有希望?不完全是——有其他的方法可以让我们在没有异构分布式事务的痛苦的情况下实现同样的事情。我们将在[第十一章](ch11.md)和[第十二章](ch12.md)回到这些章节。但首先,我们应该总结共识的话题。 +这些事实是否意味着我们应该放弃保持几个系统一致的所有希望?不完全是——有其他的方法可以让我们在没有异构分布式事务的痛苦的情况下实现同样的事情。我们将在[第11章](ch11.md) 和[第12章](ch12.md) 回到这些章节。但首先,我们应该总结共识的话题。 @@ -784,7 +782,7 @@ XA事务解决了保持多个参与者数据系统一致的真实而重要的问 因此,终止属性受到不到一半的节点崩溃或不可达的假设。然而,即使大多数节点出现故障或存在严重的网络问题,大多数共识的实施都能确保始终满足安全属性——同意,完整性和有效性【92】。因此,大规模的中断可能会阻止系统处理请求,但是它不能通过使系统做出无效的决定来破坏共识系统。 -大多数一致性算法假定没有**拜占庭式错误**,正如在“[拜占庭式错误](#拜占庭式错误)”一节中所讨论的那样。也就是说,如果一个节点没有正确地遵循协议(例如,如果它发送矛盾的消息到不同的节点),它可能会破坏协议的安全属性。只要少于三分之一的节点是拜占庭故障【25,93】,就可以对拜占庭故障形成共识,但我们没有地方在本书中详细讨论这些算法。 +大多数一致性算法假定没有**拜占庭式错误**,正如在“[拜占庭式错误](#拜占庭式错误)”一节中所讨论的那样。也就是说,如果一个节点没有正确地遵循协议(例如,如果它发送矛盾的消息到不同的节点),它可能会破坏协议的安全属性。只要少于三分之一的节点是拜占庭故障【25,93】,就可以对拜占庭故障达成共识,但我们没有地方在本书中详细讨论这些算法。 #### 共识算法和全序广播 @@ -792,7 +790,7 @@ XA事务解决了保持多个参与者数据系统一致的真实而重要的问 这些算法中的大多数实际上并不直接使用这里描述的形式化模型(建议和决定单个值,一致同意,完整性,有效性和终止性质)。相反,它们决定了值的顺序,这使得它们成为了全序广播算法,正如本章前面所讨论的那样(参阅“[全序广播](#全序广播)”)。 -请记住,全序广播要求将消息按照相同的顺序准确传送到所有节点。如果仔细思考,这相当于进行了几轮的共识:在每一轮中,节点提出下一个要发送的消息,然后决定下一个要发送的消息总数【67】。 +请记住,全序广播要求将消息按照相同的顺序准确传送到所有节点。如果仔细思考,这相当于进行了几轮共识:在每一轮中,节点提出下一个要发送的消息,然后决定下一个要发送的消息总数【67】。 所以,全序广播相当于重复的一轮共识(每个共同的决定对应于一个消息传递): @@ -809,7 +807,7 @@ XA事务解决了保持多个参与者数据系统一致的真实而重要的问 在[第5章](ch5.md)中,我们讨论了单领导者复制(参见“[领导者和追随者](ch5.md#领导者和追随者)”),它将所有的写入操作都交给领导者,并以相同的顺序将他们应用到追随者,从而使副本保持最新状态。这不是基本上全序广播?我们怎么不用担心[第五章](ch5.md)的共识? -答案取决于如何选择领导者。如果领导人是由你的运营团队中的人员手动选择和配置的,那么你基本上拥有独裁种类的“一致性算法”:只允许一个节点接受写入(即,决定写入的顺序复制日志),如果该节点发生故障,则系统将无法写入,直到运维手动配置其他节点作为主管。这样的制度在实践中可以很好地发挥作用,但是不能达到共识的终止属性,因为它需要人为干预才能取得进展。 +答案取决于如何选择领导者。如果领导人是由你的运维团队人员手动选择和配置的,那么你基本上拥有独裁类型的“一致性算法”:只允许一个节点接受写入(即,决定写入的顺序复制日志),如果该节点发生故障,则系统将无法写入,直到运维手动配置其他节点作为领导者。这样的制度在实践中效果很好,但是无法达到共识的**终止**属性,因为它需要人为干预才能取得进展。 一些数据库执行自动领导者选举和故障转移,如果旧领导者失败,则促使追随者成为新的领导者(参见“[处理节点宕机](ch5.md#处理节点宕机)”)。这使我们更接近容错的全面命令播出,从而达成共识。 @@ -839,13 +837,13 @@ XA事务解决了保持多个参与者数据系统一致的真实而重要的问 节点在决定之前对节点进行投票的过程是一种同步复制。如“[同步与异步复制](ch5.md#同步与异步复制)”中所述,通常将数据库配置为使用异步复制。在这种配置中,一些承诺的数据在故障转移时可能会丢失——但是为了获得更好的性能,许多人选择接受这种风险。 -共识体系总是需要严格的多数来操作。这意味着你至少需要三个节点才能容忍一个故障(其余三个为大多数),或者至少有五个节点容忍两个故障(其余三个为五分之一)。如果网络故障切断了其余节点的某些节点,则只有大部分网络可以继续工作,其余部分将被阻塞(另参阅“[线性一致性的代价](#线性一致性的代价)”(第295页))。 +共识体系总是需要严格多数来运转。这意味着你至少需要三个节点才能容忍单节点故障(其余三个为大多数),或者至少有五个节点来容忍两个节点发生故障(其余三个为五分之一)。如果网络故障切断了其余节点的某些节点,则只有大部分网络可以继续工作,其余部分将被阻塞(另参阅“[线性一致性的代价](#线性一致性的代价)”)。 大多数一致性算法假定一组参与投票的节点,这意味着你不能只添加或删除集群中的节点。对共识算法的动态成员扩展允许集群中的节点集随着时间的推移而变化,但是它们比静态成员算法要好得多。 共识系统通常依靠超时来检测失败的节点。在网络延迟高度变化的环境中,特别是在地理上分布的系统中,经常发生一个节点错误地认为由于暂时的网络问题,导致失败的原因。虽然这个错误不会损害安全属性,但频繁的领导者选举会导致糟糕的表现,因为系统最终会花费更多的时间来选择领导者而不是做任何有用的工作。 -有时,共识算法对网络问题特别敏感。例如,Raft已被证明有不愉快的边缘情况【106】:如果整个网络工作正常,除了一个特定的网络连接一直不可靠,Raft可以进入领导层不断在两个节点之间弹跳的情况,或者目前的领导者不断被迫辞职,所以这个制度从来没有取得进展。其他一致性算法也存在类似的问题,而对不可靠网络更具鲁棒性的设计算法仍然是一个开放的研究问题。 +有时共识算法对网络问题特别敏感。例如Raft已被证明存在不愉快的边缘情况【106】:如果整个网络工作正常,除了一个特定的网络连接一直不可靠,Raft可以进入领导层不断在两个节点之间弹跳的情况,或者目前的领导者不断被迫辞职,所以这个制度从来没有取得进展。其他一致性算法也存在类似的问题,而对不可靠网络更具鲁棒性的设计算法仍然是一个开放的研究问题。 ### 成员与协调服务 @@ -859,7 +857,7 @@ ZooKeeper模仿Google的Chubby锁定服务【14,98】,不仅实现了全序广 ***线性一致性的原子操作*** -使用原子比较和设置操作,可以实现锁定:如果多个节点同时尝试执行相同的操作,则只有其中一个节点会成功。共识协议保证了操作将是原子性和线性一致性的,即使节点发生故障或网络在任何时候都被中断。分布式锁通常作为一个租约来实现,这个租约有一个到期时间,以便在客户端失败的情况下最终被释放(参阅“[进程暂停](ch8.md#进程暂停)”)。 +使用原子CAS操作可以实现锁:如果多个节点同时尝试执行相同的操作,则只有一个节点会成功。共识协议保证了操作的原子性和线性一致性,即使节点发生故障或网络在任意时刻中断。分布式锁通常作为一个租约来实现,这个租约有一个到期时间,以便在客户端失败的情况下最终被释放(参阅“[进程暂停](ch8.md#进程暂停)”)。 ***操作的全序*** @@ -883,11 +881,11 @@ ZooKeeper/Chubby模型运行良好的一个例子是,如果你有几个流程 另一个例子是,当你有一些分区资源(数据库,消息流,文件存储,分布式参与者系统等),并需要决定将哪个分区分配给哪个节点时。当新节点加入群集时,需要将某些分区从现有节点移动到新节点,以便重新平衡负载(参阅“[重新平衡分区](ch6.md#重新平衡分区)”)。当节点被移除或失败时,其他节点需要接管失败节点的工作。 -这些类型的任务可以通过在ZooKeeper中明智地使用原子操作,各种节点和通知来实现。如果正确完成,这种方法允许应用程序自动从故障中恢复,无需人工干预。尽管Apache Curator 【17】等库已经出现在ZooKeeper客户端API的顶层提供了更高级别的工具,但这样做并不容易,但它仍然比尝试从头开始实现必要的一致性算法要好得多,成绩不佳【107】。 +这些类型的任务可以通过在ZooKeeper中明智地使用原子操作,各种节点和通知来实现。如果正确完成,这种方法允许应用程序自动从故障中恢复,无需人工干预。尽管Apache Curator 【17】等库已经出现在ZooKeeper客户端API的顶层提供了更高层的工具,但这样做并不容易,但它仍然比尝试从头开始实现必要的一致性算法要好得多,成绩不佳【107】。 -应用最初只能在单个节点上运行,但最终可能会增长到数千个节点。试图在如此之多的节点上进行多数选票将是非常低效的。相反,ZooKeeper在固定数量的节点(通常是三到五个)上运行,并在这些节点之间执行其多数票,同时支持潜在的大量客户端。因此,ZooKeeper提供了一种将协调节点(共识,操作排序和故障检测)的一些工作“外包”到外部服务的方式。 +应用最初只能在单个节点上运行,但最终可能会增长到数千个节点。试图在如此之多的节点上进行多数投票将是非常低效的。相反,ZooKeeper在固定数量的节点(通常是三到五个)上运行,并在这些节点之间执行其多数票,同时支持潜在的大量客户端。因此,ZooKeeper提供了一种将协调节点(共识,操作排序和故障检测)的一些工作“外包”到外部服务的方式。 -通常,由ZooKeeper管理的数据的类型变化十分缓慢:代表“分区7中的节点运行在`10.1.1.23`上”的信息可能会在几分钟或几小时的时间内发生变化。它不是用来存储应用程序的运行时状态的,每秒可能会改变数千甚至数百万次。如果应用程序状态需要从一个节点复制到另一个节点,则可以使用其他工具(如Apache BookKeeper 【108】)。 +通常,由ZooKeeper管理的数据的类型变化十分缓慢:代表“分区 7 中的节点运行在 `10.1.1.23` 上”的信息可能会在几分钟或几小时的时间内发生变化。它不是用来存储应用程序的运行时状态的,每秒可能会改变数千甚至数百万次。如果应用程序状态需要从一个节点复制到另一个节点,则可以使用其他工具(如Apache BookKeeper 【108】)。 #### 服务发现 @@ -903,7 +901,7 @@ ZooKeeper和它的小伙伴们可以看作是成员服务研究的悠久历史 成员资格服务确定哪些节点当前处于活动状态并且是群集的活动成员。正如我们在[第8章](ch8.md)中看到的那样,由于无限的网络延迟,无法可靠地检测到另一个节点是否发生故障。但是,如果你通过一致的方式进行故障检测,那么节点可以就哪些节点应该被认为是存在或不存在达成一致。 -即使它确实存在,仍然可能发生一个节点被错误地宣布死于共识。但是对于一个系统来说,在哪些节点构成当前的成员关系方面是非常有用的。例如,选择领导者可能意味着简单地选择当前成员中编号最小的成员,但如果不同的节点对现有成员的成员有不同意见,则这种方法将不起作用。 +即使它确实存在,仍然可能发生一个节点被共识错误地宣告死亡。但是对于一个系统来说,在哪些节点构成当前的成员关系方面是非常有用的。例如,选择领导者可能意味着简单地选择当前成员中编号最小的成员,但如果不同的节点对现有成员的成员有不同意见,则这种方法将不起作用。 diff --git a/img/ddia-wexin.JPG b/img/ddia-wexin.JPG index 0e114085c96c8284675a0337e088f311412a4506..ade3f3d39c3d56a9b5501aaabaede814146d3a4e 100644 GIT binary patch delta 75091 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 delta 76245 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 C^8Hr;