chdb: rewrite JupySQL guide on the NYC taxi dataset#6508
chdb: rewrite JupySQL guide on the NYC taxi dataset#6508ShawnChen-Sirius wants to merge 2 commits into
Conversation
The guide could no longer be followed end to end: - The example data came from the JeffSackmann/tennis_atp GitHub repo, which has been removed, so every download step 404s. - The JupySQL link pointed at jupysql.ploomber.io, whose domain no longer resolves; it now points at the project's GitHub repository. - The frontmatter description said 'How to install chDB for Bun', copied from another page. Rewritten around the NYC taxi dataset already hosted for the ClickHouse docs (datasets-documentation S3 bucket): three TSV trip files plus the taxi zone lookup CSV. The structure and teaching points are unchanged — glob queries over raw files, schema cleanup during import (String-to-Float64 casts and a borocode-to-borough transform), a two-table join, saved queries as CTEs, parametrized queries, and a histogram. Every query and output in the guide was run against chdb 4.1.8 on the real files. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
3 Skipped Deployments
|
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit feeb028. Configure here.
The saved query carries its own ORDER BY, but a CTE does not guarantee the outer SELECT preserves it. Order both follow-up queries explicitly so the shown output is what readers actually get. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
dhtclk
left a comment
dhtclk
left a comment
There was a problem hiding this comment.
Looks good, just one small suggestion before approval.
| [JupySQL](https://github.com/ploomber/jupysql) is a Python library that lets you run SQL in Jupyter notebooks and the IPython shell. | ||
| In this guide, we're going to learn how to query data using chDB and JupySQL. | ||
|
|
||
| <div class='vimeo-container'> |
There was a problem hiding this comment.
We may want to add an admonition note below this video indicating that it is referencing a stale dataset that no longer exists. I think the video content is still good and legitimate, but I think without a note the user experience is a little confusing if following the guide.
Perhaps something like this:
:::note
The video above follows an earlier version of this guide built on the tennis ATP dataset. The JupySQL and chDB workflow it shows is still accurate, but the written steps below use the New York City taxi dataset instead.
:::
There was a problem hiding this comment.
What if we removed the video here and linked it at the bottom rather? Something like:
## See also {#see-also}
- [Intro to JupySQL with chDB](https://www.youtube.com/watch?v=2wjl3OijCto&source_ve_path=MTc4NDI0)
There was a problem hiding this comment.
Ah that also works, probably the simpler solution! Your call on which you'd prefer @ShawnChen-Sirius
3 participants
Why
The chDB JupySQL guide can no longer be followed end to end:
JeffSackmann/tennis_atpGitHub repo, which has been removed — every download step in the guide now 404s.jupysql.ploomber.io, whose domain no longer resolves (the project itself is alive on GitHub/PyPI).What
Rewritten around the NYC taxi dataset already hosted for these docs (
datasets-documentationS3 bucket): three TSV trip files (~3M rows) plus the taxi zone lookup CSV. The structure and teaching points are unchanged from the original — glob queries over raw files, schema cleanup during import (String→Float64 casts and a borocode→boroughtransform), a two-table join, saved queries as CTEs, parametrized queries, and a histogram.The outdated tennis histogram image import is dropped; the JupySQL link now points at the project's GitHub repository.
Verification
Every query and output table in the guide was executed against chdb 4.1.8 on the real downloaded files (3,000,317 trips imported; join and tip results are pasted from actual runs).
🤖 Generated with Claude Code