Docs: add PostGIS integration guide with GeoPandas and ADBC examples #543
Conversation
|
Thank you for opening! I see a few CI issues ( I'm sorry I didn't get to this today...I will take a look Monday! |
|
Thanks for the review and for the pointers! I’ll add the Apache license header to the first cell of the notebook (following the pattern from the existing docs) and run I’ll push the updates shortly — thanks, and no worries at all. Looking forward to your review on Monday! |
|
I’ve added the Apache license header to the first cell of the notebook and addressed the formatting concerns. The updates are pushed. |
| > Note: | ||
| > SedonaDB is not currently distributed via PyPI. | ||
| > To run the SedonaDB examples in this notebook, you must install SedonaDB | ||
| > from source or use a development environment where SedonaDB is available. |
There was a problem hiding this comment.
You can remove this part (SedonaDB is distributed via PyPI)
| ## PostGIS Setup | ||
|
|
||
| Keep SQL static(do NOT execute). | ||
|
|
||
| ### Preparing a PostGIS table | ||
|
|
||
| ```md | ||
|
|
||
| The following SQL creates a simple PostGIS table that SedonaDB can read. | ||
|
|
||
| ```sql | ||
| CREATE TABLE my_places ( | ||
| id SERIAL PRIMARY KEY, | ||
| name VARCHAR(100), | ||
| geom GEOMETRY(Point, 4326) | ||
| ); | ||
|
|
||
| INSERT INTO my_places (name, geom) VALUES | ||
| ('New York', ST_SetSRID(ST_MakePoint(-74.006, 40.7128), 4326)), | ||
| ('Los Angeles', ST_SetSRID(ST_MakePoint(-118.2437, 34.0522), 4326)), | ||
| ('Chicago', ST_SetSRID(ST_MakePoint(-87.6298, 41.8781), 4326)); |
There was a problem hiding this comment.
Instead of leaving this as unexecuted, I think it would be better to (1) use the built-in PostGIS container we have in the repo (you can start it via docker compose up --detach) and (2) start the tutorial by writing a simple GeoDataFrame into PostGIS. That way when this tutorial needs editing somebody else can easily recreate the data required.
| sd = sedona.db.connect() | ||
| df = sd.create_data_frame(gdf) | ||
| df.show() | ||
| df.schema |
There was a problem hiding this comment.
I think outputs like df.show() and df.schema should be shown. If you implement the suggestion about making the notebook reproducible above, it should be easy to execute all cells in the notebook and have the output rendered automatically.
| ```python | ||
| df.head(5).show() | ||
| ``` |
There was a problem hiding this comment.
This is another output that would be great to show.
3 participants
Fixes #177
This PR adds a PostGIS integration guide for SedonaDB.
The documentation is written as a Jupyter notebook and rendered to Markdown
using the existing docs build pipeline.
The page covers:
adbc_ingest()andfetch_arrow()to avoid row-wise iteration and intermediate Pandas DataFrames
This PR only updates documentation and does not modify any source code.