管理不同值缓存

InfluxDB 3 Core Distinct Value Cache (DVC) 允许您缓存表中一个或多个列的Distinct值，从而提高返回Distinct标签和字段值的查询性能。

DVC 是一个内存缓存，用于存储表中特定列的Distinct值。创建DVC时，您可以指定要缓存的列的Distinct值、要缓存的Distinct值组合的最大数量以及缓存值的最大年龄。DVC与表相关联，一个表可以有多个DVC。

• 创建唯一值缓存
• 查询唯一值缓存
• 显示关于Distinct Value Cache的信息
• 删除唯一值缓存

• 关于Distinct Value Cache的重要事项

  • 高基数限制

  • 服务器停止时Distinct Value Cache会被刷新

考虑一个具有以下模式的数据集

• wind_data (表)
  • 标签 (tags)
    • country
      • 多个欧洲国家
    • county
      • 多个欧洲郡
    • city
      • 多个欧洲城市
  • 字段 (fields)
    • wind_speed (float)
    • wind_direction (integer)

如果您缓存 country、county 和 city 的Distinct值，DVC 将类似于以下内容

influxdb3 create distinct_cache \
  --database example-db \
  --token 00xoXX0xXXx0000XxxxXx0Xx0xx0 \
  --table wind_data \
  --columns country,county,city \
  --max-cardinality 10000 \
  --max-age 24h \
  windDistinctCache

SELECT * FROM distinct_cache('table-name', 'cache-name')

influxdb3 show system \
  --database example-db \
  --token 00xoXX0xXXx0000XxxxXx0Xx0xx0 \
  table distinct_caches

influxdb3 delete distinct_cache \
  --database example-db \
  --token 00xoXX0xXXx0000XxxxXx0Xx0xx0 \
  --table wind_data \
  windDistinctCache

关于Distinct Value Cache的重要事项

DVC 存储在内存中；缓存越大，InfluxDB 3 节点维护它所需的内存就越多。请考虑以下几点

• 缓存数据加载

• 高基数限制

• 服务器停止时Distinct Value Cache会被刷新

缓存数据加载

创建缓存时，InfluxDB 3 Core 会将历史数据加载到缓存中。重启后，服务器会自动重新加载缓存数据。

高基数限制

“基数”是指缓存数据中唯一键列组合的数量，它基本上定义了DVC要存储的最大行数。虽然InfluxDB 3存储引擎不受基数限制，但它确实会影响DVC。您可以为DVC定义自定义的最大基数限制，但更高的基数会增加存储DVC的内存需求，并可能影响DVC的查询性能。

服务器停止时Distinct Value Cache会被刷新

由于DVC是内存缓存，因此服务器停止时缓存会被刷新。服务器重启后，InfluxDB 3 Core只在您写入数据时将新值写入DVC，因此可能存在一段时间内DVC中某些值不可用的情况。