f1db

F1DB

F1DB는 역대 Formula 1 경주 데이터 및 통계를 포함하는 가장 포괄적인 무료 오픈 소스 데이터베이스입니다.

사용자 정의 웹사이트, 모바일 애플리케이션을 구축하거나 F1DB를 사용하여 데이터를 쿼리하는 경우 다음과 같은 서비스를 제공합니다.

• 모든 운전자
• 모든 생성자(섀시 포함)
• 모든 엔진 제조사(엔진 포함)
• 모든 타이어 제조사
• 모든 회로 및 위치 데이터
• 1950년부터 현재까지 모든 시즌; 포함:
  • 참가자
  • 순위
• 모든 인종; 포함:
  • 자유연습 및 워밍업 결과
  • 예선 및 예선 결과
  • 스프린트 경주 결과
  • 시작 그리드 위치
  • 경주 결과
  • 가장 빠른 랩
  • 피트 스톱
  • 오늘의 드라이버 결과
  • 순위

새로운 릴리스는 모든 경주가 끝난 후 가능한 한 빨리 제공될 예정입니다. 버전 관리도 참조하세요.

릴리스 아티팩트는 다음 형식으로 제공됩니다.

• CSV
• JSON
• JSON 분할(여러 데이터 파일)
• 스마일(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 부터 MySQL, PostgreSQL 및 SQLite에서 .sql 덤프 파일을 제공하는 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 , ..와 같은 선택적 텍스트 태그입니다.

이는 기본적으로 MINOR 라운드 수( RR )를 나타내는 YYYY.MINOR.MICRO(.MODIFIER) 패턴입니다.

예:

• 2024.0.0.alpha – 2024년 시즌의 첫 ^번째 레이스 라운드 전에 프리시즌 알파 출시.
• 2024.0.0.beta – 2024 시즌의 첫 ^번째 레이스 라운드 전에 프리시즌 베타 출시.
• 2024.0.0 – 2024년 시즌 1 ^차 레이스 라운드 전 최종 프리시즌 출시.
• 2024.0.1 – 2024년 시즌 1 ^차 레이스 라운드 전 첫 번째 프리시즌 패치 출시.
• 2024.1.0 – 2024년 시즌 1 ^차 레이스 라운드 이후 최종 출시.
• 2024.2.0 – 2024년 시즌 2 ^차 레이스 라운드 이후 최종 출시.
• 2024.2.1 – 2024 시즌 2 ^차 레이스 라운드 이후 첫 번째 패치 출시.
• 2024.2.2 – 2024 시즌 2 ^차 레이스 라운드 이후 두 번째 패치가 출시됩니다.

보시다시피 우리는 프리시즌 릴리스에 특별한 RR 0 사용합니다.

지역 사회

F1DB 커뮤니티는 GitHub 토론에서 찾을 수 있으며, 여기에서 질문하고 답변하고, 아이디어를 말하고, 프로젝트를 공유할 수 있습니다.

X — @F1DB_com에서 우리를 팔로우하여 계속 연락하세요.

데이터 문제 보고

우리는 GitHub Issues를 사용하여 데이터 문제 또는 관련 문제를 추적합니다.

아직 보고되지 않은 데이터 문제를 발견한 경우 새 문제를 생성해 주세요.

소스에서 빌드

배포 zip을 빌드하려면 다음을 실행하세요.

 ./gradlew clean dist assemble

자바 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 국제 라이선스에 따라 라이선스가 부여됩니다.