Etcd教程 — 第六章 Etcd之核心API V3

前言

Etcd是云原生架构中重要的基础组件，由CNCF孵化托管。Etcd在微服务和Kubernates集群中不仅可以作为服务注册与发现，还可以作为key-value存储的中间件。

本文介绍的Etcd3 API的核心设计，主要针对常见的API接口服务。对于理解Etcd基本思想有很大的帮助。所有Etcd3 API均在 gRPC服务中定义，该服务对Etcd服务器可以理解的远程过程调用（RPC）进行分类。

1 Protocol Buffer

关于 Protocol Buffer 这里只是简单介绍了下，如果需要深入了解，请自行百度。同时在另一篇文章：gRPC教程 — 第一章 2、3、4 中也有部分protocol buffers的介绍。

etcd v3 的通信基于 gRPC，proto 文件是定义服务端和客户端通讯接口的标准。即客户端该传什么样的参数，服务端该返回什么样子的参数，客户端该怎么调用，是阻塞还是非阻塞，是同步还是异步。在进行核心 API 的学习之前，gRPC 推荐使用 proto3，我们需要对 proto3 的基本语法有初步的了解。proto3 是原有 Protocol Buffer 2(被称为 proto2)的升级版本，删除了一部分特性，优化了对移动设备的支持，另外增加了对android和ios的支持，使得 gRPC 可以顺利的在移动设备上使用。

1.1 Protocol Buffer 是什么

Protocol buffer是一个灵活、高效、自动化的结构化数据序列化机制–类似于 xml，但是更小、更快并且更简单。一旦定义好数据如何构造，就可以使用特殊生成的源代码轻松地在各种数据流中使用各种语言编写和读取结构化数据。甚至可以更新之前定义的数据结构而不打破已部署的使用”旧有”格式编译的程序。

1.2 定义消息类型

定义一个搜索请求消息，每个消息都包含一个查询字符串，和你感兴趣的特定页面编号，以及每个页面的命中个数。

syntax = "proto3";

message SearchRequest {
   
   
  string query = 1; //查询条件
  int32 page_number = 2; //页码
  int32 result_per_page = 3; //希望返回的页码
}

1. 文件的第一行定义了使用的是 proto3 的语法：如果你不指定，Protocol Buffer编译器就会认为你使用的是proto2的语法。这个语句必须出现在.proto文件的非空非注释的第一行。

2. 搜索请求消息结构中定义指定了三个字段（name/value pairs）。每个字段都有一个名称和类型。

1.3 指定字段类型

在上述例子中，所有的字段都是值类型：两个整形(page_number and result_per_page) 和一个字符串 (query)。然而，你也可以指定你的字段的组合类型，包括枚举和其他消息类型。

1.4 分配标识 — tag

消息中的每个字段都有一个唯一的数字标识。这些标识用来在消息的二进制格式中识别字段，并且，一旦定义的消息投入使用，这些数字标识就不应该再被修改。

注意，标识是由1到15使用一个字节来编码，包括标识数字和字段类型（你可以在Protocol Buffer 编码中查看更多详细）。

标识16到2047占用两个字节。所以应该保留1到15，用作出现最频繁的消息类型的标识。记得为将来会继续增加并可能频繁出现的元素留一点儿标识区间，也就是说，不要一下子把1—15全部用完，为将来预留一点儿。

可以指定的最小的标识数字是1，最大是228，或者536,870,911。也不能使用19000 到 19999之间的数字，因为它们被Protocol Buffers保留使用——如果在.proto文件中使用了一个保留数字，Protocol Buffers编译器将会提示。同样的，不能使用任何之前保留的标识，因为标识的作用就是标定唯一性，如果重复使用则会发生冲突。

1.5 指定字段规则

消息字段可以是下边中的一种：

1. singular(单个)：符合语法规则的消息包含零个或者一个这样的字段（最多一个）。
2. repeated(重复)： 一个字段在合法的消息中可以重复出现一定次数（包括零次）。重复出现的值的次序将被保留。在proto3中，重复出现的值类型字段默认采用压缩编码。

注意：可以观察一下repeated定义的字段生成go后对应的字段类型及名称，会发现是切片类型，因为重复就意味着多个相同的数据，还要存到同一个字段中，所以切片类型符合。

1.6 添加更多消息类型

多个消息类型可以定义在一个.proto文件中。这个在定义多个关联的消息的时候非常有用，例如，如果想定义搜索消息类型的响应消息格式，可以在同一个.proto文件中添加如下的内容：

message SearchRequest {
   
   
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
}

message SearchResponse {
   
   
 ...
}

1.7 添加注释

在 .proto 文件中添加注释：

message SearchRequest {
   
   
  string query = 1