MappView

Manual/Guías

SQL espacial

El espacio de trabajo SQL permite analizar datos con SQL espacial de DuckDB y añadir los resultados al mapa. Se ejecuta sobre DuckDB-WASM, por lo que funciona tanto en el navegador como en la aplicación de escritorio. Ábralo desde Procesamiento → Espacio de trabajo SQL.

1. Consultar una capa cargada

Cada capa vectorial cargada es una tabla consultable. Cargue la capa de países de ejemplo (consulte Su primer mapa) y ejecute:

SELECT NAME, CONTINENT, GDP_MD_EST
FROM countries
ORDER BY GDP_MD_EST DESC
LIMIT 10;

Haga clic en Ejecutar para ver los diez países con el PIB estimado más alto.

!!! note “Columnas del conjunto de datos de ejemplo” NAME, CONTINENT, POP_EST y GDP_MD_EST son nombres de campos de Natural Earth en el archivo countries.parquet de ejemplo, cuya columna de geometría es geom. Un conjunto de datos distinto tendrá sus propios nombres de columna. Para descubrirlos, ejecute primero DESCRIBE SELECT * FROM 'your-file-url'.

2. Consultar un archivo remoto directamente

No es necesario cargar primero un archivo. El espacio de trabajo detecta una URL pura en una cláusula FROM y la envuelve automáticamente en el lector adecuado; después transmite el archivo mediante peticiones de rango HTTP, de modo que no se descarga completo. Esta abreviatura de URL pura es una comodidad del espacio de trabajo SQL; en la CLI estándar de DuckDB se escribiría explícitamente read_parquet('https://...').

SELECT COUNT(*) AS n
FROM https://data.source.coop/giswqs/opengeos/countries.parquet;

3. Usar funciones espaciales

La extensión espacial está cargada, por lo que las funciones ST_* están disponibles. Por ejemplo, calcule el área y conserve la columna geom para que el resultado pueda representarse en el mapa:

-- area is in square degrees because the data is in EPSG:4326;
-- the ranking is valid, but use ST_Area_Spheroid(geom) / 1e6 for km2.
SELECT NAME, ST_Area(geom) AS area, geom
FROM https://data.source.coop/giswqs/opengeos/countries.parquet
WHERE CONTINENT = 'Africa'
ORDER BY area DESC;

4. Añadir el resultado al mapa

Cuando una consulta devuelve una columna de geometría, use añadir al mapa para crear una nueva capa a partir del resultado, con nombre opcional. La capa resultante admite identificación, selección y tabla de atributos como cualquier capa vectorial, y puede añadir varias capas de resultados a la vez.

5. Exportar

Exporte el resultado de la consulta como CSV o GeoParquet directamente desde el espacio de trabajo. Consulte Espacio de trabajo SQL.

!!! tip “Consultas de ejemplo e historial” Use los menús de Consultas de ejemplo para partir de una consulta funcional, y el historial para volver a ejecutar una anterior.

Siguientes pasos