> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nikaplanet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Managed DuckDB

> Execute SQL queries using built-in editor or AI generation

Execute spatial SQL queries on your managed DuckDB instance using the built-in query editor or AI assistance.

## Step 1: Open Query Editor

1. Click `Databases` in the left bar of a NikaWorkspace
2. Select a **managed DuckDB** from the database list
3. Double click or right click to select **"Open SQL Query Editor"**
4. The query interface opens with your database context

## Step 2: Open Query Editor

1. Click `Files` in the left bar
2. Right click on a spatial file of your interest to `Copy Path`

<img src="https://mintcdn.com/nika/WfnfgNXWvw6fNgHH/guides/database-management/query-managed-duckdb-1.jpg?fit=max&auto=format&n=WfnfgNXWvw6fNgHH&q=85&s=b51c2f86c5f152a133e555e5a44952ae" alt="Query Managed DuckDB Step 1" width="622" height="1010" data-path="guides/database-management/query-managed-duckdb-1.jpg" />

## Step 3: Write SQL Query

### Manual SQL Writing

1. Type your spatial SQL query in the editor of a NikaWorkspace
2. Use spatial functions from DuckDB SQL like `ST_READ()`, `ST_AsText()`, `ST_DWithin()`
3. Click **"Execute"** to run the query

<img src="https://mintcdn.com/nika/WfnfgNXWvw6fNgHH/guides/database-management/query-managed-duckdb-2.jpg?fit=max&auto=format&n=WfnfgNXWvw6fNgHH&q=85&s=30e49cc8005b88f5178db4ebfc451884" alt="Query Managed DuckDB Step 2" width="1696" height="1300" data-path="guides/database-management/query-managed-duckdb-2.jpg" />

### AI-Powered SQL Generation

1. \[Optional] Select AI model (GPT-4, Claude, etc.)
2. Describe your query in natural language
3. Click **"Generate SQL"** button
4. AI generates SQL based on your table schema

<img src="https://mintcdn.com/nika/WfnfgNXWvw6fNgHH/guides/database-management/query-managed-duckdb-3.jpg?fit=max&auto=format&n=WfnfgNXWvw6fNgHH&q=85&s=7964b4ad7b957a375e3000981b5e7f73" alt="Query Managed DuckDB Step 3" width="1698" height="1298" data-path="guides/database-management/query-managed-duckdb-3.jpg" />

## Step 4: View Results

1. Query results display in the results table
2. **Download CSV** for data export
3. **Add to Map** to visualize spatial results (WIP)

<Note>
  AI SQL generation understands your table schema if you mention it with '/' trigger and suggests optimal spatial queries for your data.
</Note>

<img src="https://mintcdn.com/nika/WfnfgNXWvw6fNgHH/guides/database-management/query-managed-duckdb-4.jpg?fit=max&auto=format&n=WfnfgNXWvw6fNgHH&q=85&s=3172ca9b4057352ebdae6d9306a4f5c4" alt="Query Managed DuckDB Step 4" width="1197" height="559" data-path="guides/database-management/query-managed-duckdb-4.jpg" />
