Espacio de trabajo SQL

El Espacio de trabajo SQL ejecuta DuckDB Spatial SQL directamente en la aplicación, contra sus capas cargadas, archivos locales y URLs remotas. Ábralo desde Procesamiento → Espacio de trabajo SQL. La extensión espacial se carga automáticamente, de modo que las funciones ST_* están disponibles.

Consultar capas cargadas

Cada capa vectorial cargada se expone como una tabla consultable; el diálogo muestra los nombres de tabla disponibles en la parte superior. Escriba una consulta en el editor y haga clic en Ejecutar para ver los resultados.

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

Leer archivos y URLs

Puede consultar archivos y URLs remotas directamente. El espacio de trabajo envuelve automáticamente una URL directa en el lector correspondiente (por ejemplo Parquet, CSV, JSON o GeoJSON) y transmite los archivos remotos mediante peticiones de rango HTTP, de modo que no tiene que descargarlos primero.

SELECT NAME, CONTINENT, POP_EST, geom
FROM https://data.source.coop/giswqs/opengeos/countries.parquet
LIMIT 100;

URLs en la nube (s3://, gs://, az://)

Las URLs de almacenes de objetos en la nube se reescriben de forma transparente a sus equivalentes HTTPS públicas, de modo que puede usarlas directamente en las consultas:

-- Amazon S3
SELECT * FROM read_parquet('s3://bucket/path/to/data.parquet') LIMIT 10;

-- Google Cloud Storage
SELECT * FROM read_parquet('gs://bucket/path/to/data.parquet') LIMIT 10;

-- Azure Blob Storage
SELECT * FROM read_parquet('az://account/container/data.parquet') LIMIT 10;

La forma directa FROM s3://… también funciona — el espacio de trabajo la envuelve automáticamente en el lector correspondiente.

!!! note “Solo acceso público” La traducción de URLs en la nube está dirigida a buckets anónimos / públicos. Los buckets privados que requieren credenciales aún no están soportados.

!!! tip “CORS” Las lecturas desde el navegador requieren que la política CORS del bucket permita peticiones de origen cruzado. La mayoría de buckets públicos de conjuntos de datos (p. ej. AWS Open Data, Source Cooperative) ya lo permiten. Si obtiene un error CORS, revise la configuración CORS del bucket.

Elegir un motor SQL

El menú Motor (arriba a la derecha) selecciona qué motor SQL ejecuta su consulta. Los tres cargan una extensión espacial, por lo que las funciones ST_* están disponibles en cada uno.

DuckDB (predeterminado) — DuckDB Spatial, en el navegador. Consulta las capas cargadas, los archivos locales y las URLs remotas (incluidos los datos públicos s3:///gs:///az://). Funciona sin conexión tras el primer uso.
PostGIS — PGlite + PostGIS, en el navegador. Consulta las capas cargadas usando PostGIS SQL completo. La primera ejecución carga un motor de ~19 MB.
Apache Sedona — Sedona spatial SQL sobre sus capas cargadas. Se ejecuta en el navegador sobre CereusDB, una compilación WebAssembly de Apache SedonaDB. En la aplicación de escritorio usa el sidecar SedonaDB cuando está instalado el extra opcional sedona (mejor para capas grandes); de lo contrario vuelve al motor del navegador automáticamente. El motor CereusDB se descarga de forma diferida en el primer uso.

!!! note “Sedona lee las capas cargadas” Como PostGIS, el motor Apache Sedona consulta las capas que haya cargado en el mapa (listadas como Capas consultables). La columna de geometría se llama geometry, así que las funciones espaciales se ven como ST_Centroid(geometry), ST_Area(geometry) o ST_Buffer(geometry, 0.1).

!!! note “Columnas de atributos en el motor del navegador” Con el motor CereusDB del navegador, SELECT * devuelve los atributos de cada capa como columnas (y «Añadir como capa» los conserva), pero todavía no puede hacer referencia a un atributo por su nombre en SQL (p. ej. WHERE name = 'Texas') — esa compilación expone los atributos solo a través de la columna geometry y las funciones espaciales. Ejecute el sidecar SedonaDB (instale el extra sedona) para disponer de SQL completo sobre atributos.

Consultas de ejemplo e historial

Los menús Consultas de ejemplo y Consulta de ejemplo para capa insertan consultas ya preparadas en el editor para empezar con rapidez.
Sus consultas anteriores se guardan en un historial para poder volver a ejecutarlas.

Usar los resultados

Cuando una consulta devuelve geometría, puede añadir el resultado al mapa como una nueva capa (con un nombre de capa opcional). La capa resultado se comporta como cualquier capa vectorial, con identificación, selección y tabla de atributos. También puede exportar los resultados como CSV o GeoParquet.

!!! tip “Varias capas de resultados” Puede añadir varias capas de resultados de consultas DuckDB al mismo proyecto y mantenerlas todas abiertas a la vez.

Véase el tutorial de SQL espacial para un recorrido completo de principio a fin. El Espacio de trabajo SQL funciona tanto en el navegador como en la aplicación de escritorio porque se ejecuta sobre DuckDB-WASM.