Memcache使用指南
概述
Memcache 服务为您的应用程序提供了高性能的内存键值缓存，您可通过应用程序的多个实例访问该缓存。Memcache 对于那些不需要数据库的永久性功能和事务功能的数据很有用，例如临时数据或从数据库复制到缓存以进行高速访问的数据。Memcache API 与 Danga Interactive 开发的 Memcached 有类似的功能并兼容。
Memcache API 可通过以下方式让您提高应用程序的性能并减少数据库的负载：
- 显著地减少数据库查询的次数。
- 减少使用率非常高的页面的数据库配额的使用。
- 缓存操作量巨大的查询和操作的结果。
- 让使用临时计数器成为可能。
通过使用 Memcache API，您可以为应用程序中的数据创建一致的缓存。缓存可用于应用程序中的所有实例，而且数据只有通过内存压力（例如缓存中的数据过多）或开发人员设置的缓存政策才能清除。可以在存储在缓存中的每个键-值对上设置缓存政策。您可以清除所有缓存或针对每份数据设置缓存过期时间。
Client 类
Memcache API 提供一个基于类的接口，以便与其他 Memcache API 兼容。另请参阅提供相同功能的函数接口。
- Client()
- 实例方法：
- set()
- set_multi()
- get()
- get_multi()
- delete()
- delete_multi()
- add()
- add_multi()
- replace()
- replace_multi()
- incr()
- decr()
- flush_all()
- get_stats()
· 构造函数
· class Client()
· 与 Memcache 服务通信的客户端。
· 实例方法
· Client 实例有以下方法：
· set(key, value, time=0, min_compress_len=0)
· 设置键的值，与先前缓存中的内容无关。
· 参数：
· key
· 要设置的键。Key 可以是字符串或 (哈希值, 字符串) 格式的元组，其中哈希值（通常用于分片为 Memcache 实例）会被忽略。
· value
· 要设置的值。
· time
· 可选的过期时间，可以是相对当前时间的秒数（最多 1 个月），也可以是绝对 Unix 时间戳时间。默认情况下，项目永不过期，虽然项目可能由于内存压力而被去除。浮点值将四舍五入为最接近的整秒。
· min_compress_len
· 为了兼容性而忽略的选项。
· 如果设置的话，则返回值为 True，如果错误，则返回值为 False。
· set_multi(mapping, time=0, key_prefix='', min_compress_len=0)
· 同时设置多个键的值。减少连续执行多个请求时的网络延迟。
· 参数：
· mapping
· 键到值的参照表。
· time
· 可选的过期时间，可以是相对当前时间的秒数（最多 1 个月），也可以是绝对 Unix 时间戳时间。默认情况下，项目永不过期，虽然项目可能由于内存压力而被去除。浮点值将四舍五入为最接近的整秒。
· key_prefix
· 用于预置所有键的前缀。
· min_compress_len
· 为了兼容性而忽略的选项。
· 返回值是未设置值的键的列表。全部成功时，该列表应为空。
· get(key)
· 在 Memcache 中查找一个键。
· 参数：
· key
· 要在 Memcache 中查找的键。Key 可以是字符串或 (哈希值, 字符串) 格式的元组，其中哈希值（通常用于分片为 Memcache 实例）会被忽略。
· 如果在 Memcache 中找到键，则返回值为该键的值，否则为 None。
· get_multi(keys, key_prefix='')
· 通过一个操作从 Memcache 中查找多个键。
· 参数：
· keys
· 要查找的键的列表。Key 可以是字符串或 (哈希值, 字符串) 格式的元组，其中哈希值（通常用于分片为 Memcache 实例）会被忽略。
· key_prefix
· 与服务器通讯期间用于预置所有键的前缀，不包含在返回的参照表中。
· 返回的值是曾存在于 Memcache 中的键和值的参照表。即使指定了 key_prefix，在返回的参照表中，键也不会包含 key_prefix。
· delete(key, seconds=0)
· 从 Memcache 删除键。
· 参数：
· key
· 要删除的键。Key 可以是字符串或 (哈希值, 字符串) 格式的元组，其中哈希值（通常用于分片为 Memcache 实例）会被忽略。
· seconds
· 使删除的项目对 [添加] 操作 [锁定] 的可选秒数。值可以是从当前时间开始的增量（最多 1 个月），也可以是绝对 Unix 时间戳时间。默认值为 0，表示可以立即添加项目。无论是否有此选项，[设置] 操作都始终有效。浮点值将四舍五入为最接近的整秒。
· 网络故障时返回值为 0 (DELETE_NETWORK_FAILURE)，如果服务器尝试删除项目但其实并没有项目，则返回值为 1 (DELETE_ITEM_MISSING)；如果确实删除了项目，则返回值为 2 (DELETE_SUCCESSFUL)。这可以用作布尔值，其中网络故障是唯一的不良状况。
· delete_multi(keys, seconds=0, key_prefix='')
· 同时删除多个键。
· 参数：
· keys
· 要删除的键的列表。Key 可以是字符串或 (哈希值, 字符串) 格式的元组，其中哈希值（通常用于分片为 Memcache 实例）会被忽略。
· seconds
· 使删除的项目对 [添加] 操作 [锁定] 的可选秒数。值可以是从当前时间开始的增量（最多 1 个月），也可以是绝对 Unix 时间戳时间。默认值为 0，表示可以立即添加项目。无论是否有此选项，[设置] 操作都始终有效。浮点值将四舍五入为最接近的整秒。
· key_prefix
· 当向 Memcache 发送指定的键时要添加到所有键的前缀。请参阅 get_multi() 和 set_multi() 的文档。
· 如果所有操作成功完成，则返回值为 True。如果一个或多个操作没有完成，则返回 False。
· add(key, value, time=0, min_compress_len=0)
· 仅当项目尚未在 Memcache 中时，才设置键的值。
· 参数：
· key
· 要设置的键。Key 可以是字符串或 (哈希值, 字符串) 格式的元组，其中哈希值（通常用于分片为 Memcache 实例）会被忽略。
· value
· 要设置的值。
· time
· 可选的过期时间，可以是相对当前时间的秒数（最多 1 个月），也可以是绝对 Unix 时间戳时间。默认情况下，项目永不过期，虽然项目可能由于内存压力而被去除。浮点值将四舍五入为最接近的整秒。
· min_compress_len
· 为了兼容性而忽略的选项。
· 如果已添加，则返回值为 True，如果错误，则返回值为 False。
· add_multi(mapping, time=0, key_prefix='', min_compress_len=0)
· 同时添加多个值，对于已经在 Memcache 中的键没有影响。
· 参数：
· mapping
· 键到值的映射。
· time
· 可选的过期时间，可以是相对当前时间的秒数（最多 1 个月），也可以是绝对 Unix 时间戳时间。默认情况下，项目永不过期，虽然项目可能由于内存压力而被去除。浮点值将四舍五入为最接近的整秒。
· key_prefix
· 当向 Memcache 发送指定的键时要添加到所有键的前缀。请参阅 get_multi()。
· min_compress_len
· 为了兼容性而忽略的选项。
· 返回值是键的列表，这些键的值未设置，因为它们已在 Memcache 中设置；返回值也可能是空列表。
· replace(key, value, time=0, min_compress_len=0)
· 替换键的值，如果项目尚未在 Memcache 中，则会失败。
· 参数：
· key
· 要设置的键。Key 可以是字符串或 (哈希值, 字符串) 格式的元组，其中哈希值（通常用于分片为 Memcache 实例）会被忽略。
· value
· 要设置的值。
· time
· 可选的过期时间，可以是相对当前时间的秒数（最多 1 个月），也可以是绝对 Unix 时间戳时间。默认情况下，项目永不过期，虽然项目可能由于内存压力而被去除。浮点值将四舍五入为最接近的整秒。
· min_compress_len
· 为了兼容性而忽略的选项。
· 如果替换掉，则返回值为 True。如果出现错误或者缓存未命中，则返回值为 False。
· replace_multi(mapping, time=0, key_prefix='', min_compress_len=0)
· 同时替换多个值，对于不在 Memcache 中的键没有影响。
· 参数：
· mapping
· 键到值的映射。
· time
· 可选的过期时间，可以是相对当前时间的秒数（最多 1 个月），也可以是绝对 Unix 时间戳时间。默认情况下，项目永不过期，虽然项目可能由于内存压力而被去除。浮点值将四舍五入为最接近的整秒。
· key_prefix
· 当向 Memcache 发送指定的键时要添加到所有键的前缀。请参阅 get_multi()。
· min_compress_len
· 为了兼容性而忽略的选项。
· 返回值是键的列表，这些键的值未设置，因为它们未在 Memcache 中设置；返回值也可能是空列表。
· incr(key, delta=1)
· 自动增加键的值。在内部，值是无符号 64 位整数。Memcache 不检查 64 位溢出。值如果过大则会换行。
· 键必须已存在于缓存中才能增加值。要初始化计数器，请使用 set() 将其设置为初始值，如 ASCII 十进制整数。将来，在增加以后，使用 get() 获取的键将仍是 ASCII 十进制值。
· 参数：
· key
· 要增加的键。Key 可以是字符串或 (哈希值, 字符串) 格式的元组，其中哈希值（通常用于分片为 Memcache 实例）会被忽略。
· delta
· 作为键的增加量的非负整数值（整型或长整型），默认为 1。
· 返回值为新的长整型整数值，或者是 None（如果键不在缓存中或因任何其他原因无法增加）。
· decr(key, delta=1)
· 自动减少键的值。在内部，值是无符号 64 位整数。Memcache 不检查 64 位溢出。值如果过大则会换行。
· 键必须已存在于缓存中才能减少值。要初始化计数器，请使用 set() 将其设置为初始值，如 ASCII 十进制整数。将来，在减少以后，使用 get() 获取的键将仍是 ASCII 十进制值。
· 参数：
· key
· 要减少的键。Key 可以是字符串或 (哈希值, 字符串) 格式的元组，其中哈希值（通常用于分片为 Memcache 实例）会被忽略。
· delta
· 作为键的减少量的非负整数值（整型或长整型），默认为 1。
· 返回值为新的长整型整数值，或者是 None（如果键不在缓存中或因任何其他原因无法减少）。
· flush_all()
· 删除 Memcache 中的所有内容。
· 如果成功，则返回值为 True，如果是 RPC 或服务器错误，则返回值为 False。
· get_stats()
· 获取该应用程序的 Memcache 统计信息。所有这些统计信息都可以根据不同的临时条件而重设。它们会提供在被调用时可用的最佳信息。
· 返回值是将统计信息名称映射到相关值的参照表。统计信息及其相关意义：
· hits：导致缓存命中的缓存 get 请求的次数。 misses：导致缓存未命中的缓存 get 请求的次数。 byte_hits：get 请求时转移的总字节。溢出时转为零。 items：缓存中键/值对的数量。 bytes：缓存中所有项目的总大小。 oldest_item_age：从访问缓存中最早的项目起过了多少秒。实际上，这表示新项目在不被访问的情况下在缓存中继续有效的时间。这并不是从项目创建开始后经过的时间量。