跳转到主要内容

FireCloud数据库扩展

项目描述

Hound

FireCloud数据库扩展

目的

此存储库包含Hound数据库扩展系统的源代码。此系统旨在为FireCloud工作空间中的更改日志提供一个低延迟系统。

这允许通过查询数据库历史记录来重建属性来源,以及外部工具也可以记录更改。

用法

  1. 启用hound软件的用户在继续工作时会自动生成日志
  2. Hound可以从日志中重新创建属性值历史记录以生成来源

格式

Hound将日志数据记录在桶文件夹中。条目根据以下列表组织。 snowflake 指的是Hound的雪花实现自动生成的ID。雪花几乎保证是唯一的(见下文)

  • hound/: 桶中hound数据的根文件夹
    • (samples|pairs|participants|sets)/: 实体元数据更改日志的文件夹
      • (entity-id)/: 实体数据的文件夹
        • (attribute)/: 每个实体上的属性数据的文件夹
          • (snowflake): 包含 更新对象 的序列编号文件
    • workspace/: 工作空间级元数据的文件夹
      • (attribute)/: 工作空间上的属性数据的文件夹
        • (snowflake): 包含 更新对象 的序列编号文件
    • logs/: 事件日志的文件夹
      • (job|upload|meta|other)/: 特定事件条目的文件夹
        • (snowflake): 包含 日志条目 的文件

Snowflake规范

将22字节的雪花编码为44字节(十六进制编码)的对象名称

  • 64位(8字节)Unix时间戳(8字节浮点数)
  • 64位(8字节)机器ID(基于节点名称)仅使用6字节
  • 16位(2字节)随机客户端ID(在Snowflake对象初始化期间生成)
  • 16位(2字节)序列标识符(每个客户端从0开始,从那里递增)
  • 8位(1字节)零字段(保留)
  • 8位(1字节)校验和字段(剩余字段的和)

唯一性

雪花结构几乎可以保证其唯一性。如果来自同一台机器(或具有相同MAC地址的机器)的两个客户端在完全相同的时间(在它们系统时钟的精度范围内)创建雪花,并且客户端至今生成的雪花数量相同(客户端具有相同的序列ID),那么基于客户端ID,雪花发生冲突的概率为1/65536。

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源代码分发

hound-1.0.1.tar.gz (9.6 kB 查看哈希值)

上传时间 源代码

构建分发

hound-1.0.1-py3-none-any.whl (10.3 kB 查看哈希值)

上传时间 Python 3

支持