cb-analytics-query

Write and optimize SQL++ queries for Couchbase Analytics with execution mode selection.

4|1|Updated May 28, 2026
One-click install
npx skills add https://github.com/celticht32/Couchbase-Skills-for-Claude.ai --skill cb-analytics-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cb-analytics-query
Source: https://github.com/celticht32/Couchbase-Skills-for-Claude.ai/tree/main/skills/couchbase-analytics/cb-analytics-query
Command: npx skills add https://github.com/celticht32/Couchbase-Skills-for-Claude.ai --skill cb-analytics-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you write, tune, and execute SQL++ queries against Couchbase Analytics without overloading the service, returning incomplete results, or choosing the wrong query tool.

Core Features & Use Cases

  • Tool selection: Chooses between full execution, cached readonly queries, paginated retrieval, and EXPLAIN based on the task.
  • Result handling: Detects truncation, surfaces warnings, and guides you to paginated follow-ups when result sets are large.
  • Query diagnostics: Supports slow-query analysis, plan inspection, scan consistency choices, and safe parameterized statements.
  • Use case: Ask for a query review, a faster rewrite, or a paginated fetch of a large dataset and the Skill will help produce correct, service-friendly Analytics access patterns.

Quick Start

Use the cb-analytics-query skill to help me write a safe, paginated SQL++ query for Couchbase Analytics and explain which tool I should use.

Frequently Asked Questions about cb-analytics-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a paginated SQL++ query for Couchbase Analytics to handle large result sets?

To write a paginated SQL++ query for Couchbase Analytics, you select a paginated retrieval execution mode that fetches results in batches. This approach prevents service overload, avoids result truncation, and ensures you retrieve complete datasets safely.

Why does my Couchbase Analytics query return incomplete results or truncation warnings?

Couchbase Analytics queries return incomplete results or truncation warnings when the result set exceeds execution limits. Using paginated retrieval or cached readonly queries helps detect truncation, surface service warnings, and guides follow-up fetches for full data.

What is the best way to troubleshoot slow SQL++ queries in Couchbase Analytics?

The best way to troubleshoot slow SQL++ queries in Couchbase Analytics is to use EXPLAIN analysis for plan inspection and adjust scan consistency. Query diagnostics support examining execution plans and identifying inefficiencies to produce optimized rewrites.

Can I use parameterized inputs with SQL++ queries in Couchbase Analytics?

Yes, you can use safe parameterized statements with SQL++ queries in Couchbase Analytics. Parameterized inputs ensure secure query execution by separating user input from the query logic, preventing injection issues while maintaining proper scan consistency.

When should I use cached readonly queries versus full execution in Couchbase Analytics?

Use cached readonly queries for repeated small result sets in Couchbase Analytics to improve performance, and full execution for dynamic or complex aggregations. Tool selection between these modes optimizes service workload and ensures correct, efficient query execution.