f1db

F1数据库

F1DB 是最全面的免费开源数据库，包含历史上一级方程式赛车数据和统计数据。

无论您是构建自定义网站、移动应用程序还是只是使用 F1DB 查询数据，我们都提供以下服务：

• 所有司机
• 所有构造器（包括底盘）
• 所有发动机制造商（包括发动机）
• 所有轮胎制造商
• 所有电路和位置数据
• 从 1950 年至今的所有季节；包括：
  • 进入者
  • 积分榜
• 所有种族；包括：
  • 自由练习和热身结果
  • 排位赛和资格预审结果
  • 短跑比赛成绩
  • 起始网格位置
  • 比赛结果
  • 最快圈速
  • 进站
  • 当日车手结果
  • 积分榜

每场比赛后都会尽快发布新版本。另请参见版本控制。

发布工件有以下格式：

• CSV
• JSON
• JSON 分割（多个数据文件）
• Smile（JSON 格式的二进制变体）
• SQL（MySQL、PostgreSQL 或 SQLite .sql 转储文件以创建和填充自定义数据库）
• SQLite数据库

v2024.19.0中的显着和重大变化

• 添加了底盘和发动机数据。
• 为比赛结果和起跑位置添加了资格位置详细信息（ qualificationPositionNumber和qualificationPositionText ）。
• 向建造商和发动机制造商添加了总积分统计 ( totalPoints )。
• 添加了车手、施工人员、发动机制造商和轮胎制造商的广泛赛季统计数据。
• 已将ConstructorPreviousNextConstructor重命名为ConstructorChronology
• 向DriverFamilyRelationship 、 ConstructorChronology 、 PracticeResult 、 QualifyingResult 、 StartingGridPosition 、 RaceResult 、 FastestLap 、 PitStop 、 DriverOfTheDayResult 、 RaceDriverStanding 、 RaceConstructorStanding 、 SeasonDriverStanding和SeasonConstructorStanding添加了显式的positionDisplayOrder 。

为了适应这些（重大）更改，JSON 架构已升级到版本v5.0.0 。

F1DB JSON 架构

主f1db.schema.json模式文件包含所有 F1DB 对象定义并用作主要文档。

对于分割的发行版，必须使用分割的模式文件。

JSON 和 Smile 工件均根据 F1DB Json 架构进行验证。

架构版本兼容性/历史记录

版本	架构版本
>= v2024.19.0	f1db.schema.json v5.0.0 、 f1db-*.schema.json v5.0.0 splitted
>= v2024.0.0.beta2	f1db.schema.json v4.1.0 、 f1db-*.schema.json v4.1.0 splitted
>= v2024.0.0.beta1	f1db.schema.json v4.0.0 、 f1db-*.schema.json v4.0.0 splitted
>= v2023.22.0	onlyf1-db.schema.json v3.2.0 , onlyf1-db-*.schema.json v3.2.0 splitted
>= v2023.8.0	onlyf1-db.schema.json v3.1.0 , onlyf1-db-*.schema.json v3.1.0 splitted
>= v2023.4.0	onlyf1-db.schema.json v3.0.0 , onlyf1-db-*.schema.json v3.0.0 splitted
>= v2023.0.0.beta1	onlyf1-db.schema.json v2.0.0 , onlyf1-db-*.schema.json v2.0.0 splitted
>= v2022.1.1	f1db-json-schema-v1.4.0.json
>= v2022.0.0	f1db-json-schema-v1.3.0.json
>= v2022.0.0.beta4	f1db-json-schema-v1.3.0.json
>= v2022.0.0.beta3	f1db-json-schema-v1.2.0.json
>= v2022.0.0.beta2	f1db-json-schema-v1.1.0.json
>= v2022.0.0.alpha1	f1db-json-schema-v1.0.0.json

F1DB SQL / SQLite 数据库

SQLite数据库工件包含关系数据库格式的所有数据，可用于直接查询数据而不是处理JSON格式。

该数据库文件还可以为想要学习 SQL 的学生提供服务。

我们建议使用SQLiteStudio来查询数据库文件。当然，也可以使用任何兼容 SQLite 的 SQL 客户端。

自v2024.3.0起，SQL 工件可用于 MySQL、PostgreSQL 和 SQLite，它们提供 .sql 转储文件以直接在这些数据库系统中导入架构和数据。

如果您想填充另一个数据库系统（例如 H2），那么 PostgreSQL .sql 转储文件很可能是您的最佳选择。如果这不起作用，并且您希望将另一个数据库系统的 .sql 转储文件添加到发布工件中，那么请创建一个功能请求。

版本控制

使用“自定义”CalVer 版本控制方案对版本进行版本控制：

 YYYY.RR.MICRO(.MODIFIER)

它使用以下约定：

• YYYY – 全年 – 2024 ，..
• RR – 赛季内的轮数 – 0 , 1 , 2 , .., 10 , 11 , ..
• MICRO – 补丁版本 – 0 , 1 , 2 , ..
• MODIFIER – 可选的文本标签，如dev 、 alpha 、 beta 、 rc 、 ..

请注意，这基本上是YYYY.MINOR.MICRO(.MODIFIER)模式，其中MINOR表示整数 ( RR )。

示例：

• 2024.0.0.alpha – 2024 年赛季^第一轮比赛之前季前阿尔法版本发布。
• 2024.0.0.beta – 2024 年赛季^第一轮比赛之前季前测试版发布。
• 2024.0.0 – 2024 赛季第一^轮比赛之前季前赛的最终版本。
• 2024.0.1 – 2024 赛季^第一轮比赛之前发布第一个季前补丁。
• 2024.1.0 – 2024 赛季^第一轮比赛后最终发布。
• 2024.2.0 – 2024 赛季^第二轮比赛后最终发布。
• 2024.2.1 – 2024 赛季^第二轮比赛后发布的第一个补丁。
• 2024.2.2 – 2024 赛季^第二轮比赛后发布第二个补丁。

正如您所看到的，我们在季前发布中使用了特殊的RR 0 。

社区

F1DB 社区可以在 GitHub 讨论中找到，您可以在其中提问和回答问题、表达想法并分享您的项目。

通过在 X — @F1DB_com 上关注我们来与我们保持联系。

报告数据问题

我们使用 GitHub Issues 来跟踪数据问题或相关问题。

如果您发现尚未报告的数据问题，请创建新问题。

从源头构建

要构建发行版 zip，只需运行：

 ./gradlew clean dist assemble

需要 Java 21。

释放

GitHub Actions 用于通过创建新的 git 标签来构建和上传新版本。

请按照下列步骤操作：

1. 更新gradle.properties中的版本号
2. git commit -am "Release v<version>"
3. git push
4. git tag -a v<version> -m "Release v<version>"
5. git push origin v<version>

按下新标签会自动触发释放动作。

执照

F1DB 根据 Creative Commons Attribution 4.0 International License 获得许可。