Skip to content

docs: add Metrics SQL API integration page#992

Merged
owlas merged 2 commits into
mainfrom
docs/metrics-sql-api
Jul 13, 2026
Merged

docs: add Metrics SQL API integration page#992
owlas merged 2 commits into
mainfrom
docs/metrics-sql-api

Conversation

@owlas

@owlas owlas commented Jul 13, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a new Metrics SQL API page under the Integrations section, documenting the Postgres wire protocol compatible interface for querying the Lightdash semantic layer.

The page covers:

  • Connecting: host (pg.<instance>.lightdash.cloud), port 5432, database = project UUID, token-based auth (service account token recommended, PAT supported), sslmode=disable requirement with a TLS warning, and a pointer to the new project settings page
  • Querying model: explores as tables, field IDs as columns, pre-aggregated metrics with optional GROUP BY, supported SQL surface, 500-row default limit
  • Examples: catalog discovery via information_schema, metric queries, filters, calculated expressions, and Python via psycopg2
  • Limitations: no SQL joins/subqueries/CTEs/DML, simple query protocol only, no pg_catalog emulation
  • Marked as beta (sidebar tag) and Enterprise-only, disabled by default

Content is based on PROD-8742 (docs spec), PROD-8743 (settings page spec), and PROD-8835 (implementation findings).

Notes for reviewers

Documents the new Postgres wire protocol compatible interface for
querying the Lightdash semantic layer. Covers connection details,
the querying model, examples, and current limitations, based on
PROD-8742/PROD-8743/PROD-8835. Marked as beta and Enterprise-only.
@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

Status

⚠️ 1 broken link needs manual attention


🔗 Broken Links (Manual Fix Required)

Click to view details
   📄 references/workspace/custom-roles.mdx:22 → /references/roles#roles-and-permissions

@mintlify

mintlify Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Jul 13, 2026, 10:35 PM

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

Status

⚠️ 1 broken link needs manual attention


🔗 Broken Links (Manual Fix Required)

Click to view details
   📄 references/workspace/custom-roles.mdx:22 → /references/roles#roles-and-permissions

@owlas
owlas merged commit 698f608 into main Jul 13, 2026
5 of 6 checks passed
@owlas
owlas deleted the docs/metrics-sql-api branch July 13, 2026 22:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant