Execute SQL query against Databend database.

SAFETY RULES (when DATABEND_MCP_SAFE_MODE is enabled):

• Read operations (SELECT/SHOW/DESCRIBE/EXPLAIN/LIST): allowed on ALL objects

• Write operations (CREATE/DROP/INSERT/UPDATE/DELETE/...): ONLY allowed on current session's sandbox

• Current session sandbox prefix: use get_session_sandbox_prefix() to get it

• Set DATABEND_MCP_SAFE_MODE=false to disable sandbox validation

Args: sql: SQL query string to execute

Returns: Dictionary containing query results or error information

Execute multiple SQL queries against Databend database with MCP safe mode protection.

Safe mode (enabled by default) restricts write operations to the current session sandbox. Set DATABEND_MCP_SAFE_MODE=false to disable sandbox validation.

Args: sqls: List of SQL query strings to execute

Returns: List of dictionaries containing either query results or error information

List available Databend databases (safe operation, not affected by MCP safe mode)

List available Databend tables in a database (safe operation, not affected by MCP safe mode) Args: database: The database name filter: The filter string, eg: "name like 'test%'"

Returns: Dictionary containing either query results or error information

List available Databend functions (safe operation, not affected by MCP safe mode) Args: filter: The filter string, eg: "name like 'add%'" Returns: Dictionary containing either query results or error information

Describe a Databend table (safe operation, not affected by MCP safe mode) Args: table: The table name database: The database name

Returns: Dictionary containing either query results or error information

List available Databend stages (safe operation, not affected by MCP safe mode)

List files in a Databend stage (safe operation, not affected by MCP safe mode) Args: stage_name: The stage name (with @ prefix) path: Optional path within the stage

Returns: Dictionary containing either query results or error information

List available Databend connections (safe operation, not affected by MCP safe mode)

Create a Databend stage with connection Args: name: The stage name url: The stage URL (e.g., 's3://bucket-name') connection_name: Optional connection name to use

Returns: Dictionary containing either query results or error information

Get current session's sandbox prefix for writable objects.

All write operations (CREATE/DROP/INSERT/UPDATE/DELETE/...) are ONLY allowed on objects with this prefix. This is enforced by code, not just guidelines.

Returns: Dictionary with session_id and prefix

List sandbox databases owned by current session.

Only these databases can be modified. Other databases are read-only.

Returns: Dictionary containing current session's sandbox database list

Create a new sandbox database for current session.

The database name will be automatically prefixed with current session's sandbox prefix.

Args: name: Database name suffix (without prefix)

Example: create_session_sandbox_database('analytics') -> Creates 'mcp_sandbox_a1b2c3d4_analytics'

Returns: Dictionary containing result or error