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 positionDisplayOrder ConstructorChronology 、 PracticeResult 、 QualifyingResult 、 StartingGridPosition SeasonConstructorStanding RaceResult SeasonDriverStanding FastestLap 、 PitStop 、 DriverOfTheDayResult 、 RaceDriverStanding 、 RaceConstructorStanding 、Hstructson 演講、SHidasStone 飾品、Constructor）

為了適應這些（重大）更改，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 授權。