f1db

F1DB

F1DB é o banco de dados de código aberto gratuito mais abrangente com dados e estatísticas de corridas de Fórmula 1 de todos os tempos.

Esteja você construindo um site personalizado, um aplicativo móvel ou apenas usando F1DB para consultar dados, aqui está o que oferecemos:

• Todos os motoristas
• Todos os construtores (incluindo chassis)
• Todos os fabricantes de motores (incluindo motores)
• Todos os fabricantes de pneus
• Todos os circuitos e dados de localização
• Todas as temporadas de 1950 até o presente; incluindo:
  • participantes
  • classificação
• Todas as raças; incluindo:
  • resultados de treinos livres e aquecimento
  • resultados de qualificação e pré-qualificação
  • resultados da corrida de velocidade
  • posições iniciais da grade
  • resultados da corrida
  • voltas mais rápidas
  • paradas nos boxes
  • resultados do piloto do dia
  • classificação

Novos lançamentos estarão disponíveis o mais rápido possível após cada corrida. Consulte também Versionamento.

Os artefatos de lançamento estão disponíveis nos seguintes formatos:

• CSV
• JSON
• JSON dividido (vários arquivos de dados)
• Smile (variante binária do formato JSON)
• SQL (arquivos dump MySQL, PostgreSQL ou SQLite .sql para criar e preencher um banco de dados personalizado)
• Banco de dados SQLite

Mudanças notáveis ​​​​e importantes na v2024.19.0

• Adicionados dados de chassi e motor.
• Adicionados detalhes da posição de qualificação ( qualificationPositionNumber e qualificationPositionText ) aos resultados da corrida e às posições iniciais do grid.
• Adicionada estatística de total de pontos ( totalPoints ) para construtores e fabricantes de motores.
• Adicionadas extensas estatísticas de temporada para pilotos, construtores, fabricantes de motores e fabricantes de pneus.
• ConstructorPreviousNextConstructor para ConstructorChronology
• Adicionado positionDisplayOrder explícito a DriverFamilyRelationship , ConstructorChronology , PracticeResult , QualifyingResult , StartingGridPosition , RaceResult , FastestLap , PitStop , DriverOfTheDayResult , RaceDriverStanding , RaceConstructorStanding , SeasonDriverStanding e SeasonConstructorStanding .

Para acomodar essas alterações (rupturas), o esquema JSON foi transferido para a versão v5.0.0 .

Esquema JSON F1DB

O arquivo de esquema principal f1db.schema.json contém todas as definições de objeto F1DB e serve como documentação principal.

Para as distribuições divididas, os arquivos de esquema divididos devem ser usados.

Os artefatos JSON e Smile são validados no esquema F1DB Json.

Compatibilidade/histórico da versão do esquema

Versão	Versão do esquema
>= 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

Banco de dados SQL/SQLite F1DB

O artefato de banco de dados SQLite contém todos os dados em um formato de banco de dados relacional e pode ser usado para consultar diretamente os dados em vez de processar o formato JSON.

O arquivo de banco de dados também pode servir aos alunos que desejam aprender SQL.

Sugerimos usar SQLiteStudio para consultar o arquivo do banco de dados. É claro que qualquer cliente SQL compatível com SQLite também pode ser usado.

Desde v2024.3.0 artefatos SQL estão disponíveis para MySQL, PostgreSQL e SQLite que fornecem arquivos dump .sql para importar o esquema e os dados diretamente nesses sistemas de banco de dados.

Se você deseja preencher outro sistema de banco de dados (por exemplo, H2), provavelmente o arquivo de despejo .sql do PostgreSQL é sua melhor opção. Se isso não funcionar e você quiser que um arquivo de despejo .sql para outro sistema de banco de dados seja adicionado aos artefatos de lançamento, crie uma solicitação de recurso.

Versionamento

As versões são versionadas usando um esquema de versionamento CalVer "personalizado":

 YYYY.RR.MICRO(.MODIFIER)

que usa as seguintes convenções:

• AAAA – Ano completo da temporada – 2024 , ..
• RR – Número da rodada dentro da temporada – 0 , 1 , 2 , .., 10 , 11 , ..
• MICRO – Versão do patch – 0 , 1 , 2 , ..
• MODIFIER – Uma tag de texto opcional como dev , alpha , beta , rc , ..

Observe que este é basicamente o padrão YYYY.MINOR.MICRO(.MODIFIER) onde MINOR indica o número redondo ( RR ).

Exemplos:

• 2024.0.0.alpha – Lançamento alfa da pré-temporada antes da ^1ª rodada da temporada de 2024.
• 2024.0.0.beta – Lançamento do beta da pré-temporada antes da ^1ª rodada de corrida da temporada de 2024.
• 2024.0.0 – Lançamento final da pré-temporada antes da ^1ª rodada da temporada de 2024.
• 2024.0.1 – Lançamento do primeiro patch de pré-temporada antes da ^1ª rodada de corrida da temporada de 2024.
• 2024.1.0 – Lançamento final após a ^1ª etapa da temporada de 2024.
• 2024.2.0 – Lançamento final após a ^2ª etapa da temporada de 2024.
• 2024.2.1 – Lançamento do primeiro patch após a ^2ª rodada de corrida da temporada de 2024.
• 2.024.2.2 – Lançamento do segundo patch após a ^2ª rodada de corrida da temporada de 2024.

Como você pode ver, usamos um RR 0 especial para lançamentos de pré-temporada.

Comunidade

A comunidade F1DB pode ser encontrada nas discussões do GitHub, onde você pode fazer e responder perguntas, expressar ideias e compartilhar seus projetos.

Mantenha contato conosco seguindo-nos no X — @F1DB_com.

Relatando problemas de dados

Usamos GitHub Issues para rastrear problemas de dados ou problemas relacionados.

Se você encontrou um problema de dados que ainda não foi relatado, crie um novo problema.

Construindo a partir da fonte

Para construir os zips de distribuição basta executar:

 ./gradlew clean dist assemble

Requer Java 21.

Liberando

GitHub Actions é usado para construir e fazer upload de novos lançamentos criando uma nova tag git.

Siga estas etapas:

1. Atualize o número da versão em 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>

e a ação de liberação é acionada automaticamente ao enviar a nova tag.

Licença

F1DB está licenciado sob uma Licença Internacional Creative Commons Attribution 4.0.