find-hypertable-candidates

Identify PostgreSQL tables for TimescaleDB hypertable conversion using schema analysis and candidacy scoring.

1.8k|104|Updated Jul 23, 2025
One-click install
npx skills add https://github.com/timescale/pg-aiguide --skill find-hypertable-candidates
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: find-hypertable-candidates
Source: https://github.com/timescale/pg-aiguide/tree/main/skills/find-hypertable-candidates
Command: npx skills add https://github.com/timescale/pg-aiguide --skill find-hypertable-candidates

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps database engineers quickly pinpoint PostgreSQL tables that would benefit from TimescaleDB hypertable conversion, enabling faster time-series workloads and easier data management.

Core Features & Use Cases

  • Schema analysis: Evaluates table statistics, sizes, and index patterns to identify hypertable candidates.
  • Candidacy scoring: Applies a multi-criteria rubric (time-based patterns, scale, and data types) to rank tables as strong candidates.
  • Guidance and patterns: Provides best-practice patterns for time-series data, events, and sequential data conversion.

Quick Start

To start, run the hypertable-candidate analysis against your PostgreSQL schema and review the ranked results with recommended next steps.

Frequently Asked Questions about find-hypertable-candidates

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

FAQPage Schema
How do I find PostgreSQL tables that are good candidates for TimescaleDB hypertable conversion?

To find TimescaleDB hypertable candidates, analyze PostgreSQL schema statistics, table sizes, and index patterns to identify tables storing time-series data, event logs, or sequential records that require an 8+ points candidacy rubric score.

What makes a PostgreSQL table a strong hypertable candidate for time-series workloads?

A strong hypertable candidate contains time-based patterns, sequential data, and timestamp indexes that meet a multi-criteria scoring rubric. Tables with large scale and specific data types suited for time-series workloads score 8 or higher for conversion.

How do I analyze a large PostgreSQL schema to identify time-series tables?

Analyze large PostgreSQL schemas by evaluating table statistics, sizes, and index patterns to detect time-based columns. This schema analysis ranks tables using a candidacy scoring rubric to pinpoint sequential data and event logs ideal for hypertable conversion.

When should I convert PostgreSQL event logs to TimescaleDB hypertables?

Convert PostgreSQL event logs to TimescaleDB hypertables when schema analysis reveals high-volume sequential data with timestamp indexes. Tables scoring 8+ points on the candidacy rubric benefit from faster time-series workloads and easier data management.

Can I use schema analysis to detect timestamp patterns across multiple PostgreSQL tables?

Yes, schema analysis detects timestamp patterns and index structures across large PostgreSQL schemas. By applying a multi-criteria rubric, it evaluates table sizes and data types to score and rank tables for time-series hypertable conversion.

What is the best way to rank PostgreSQL tables for TimescaleDB migration?

The best way to rank PostgreSQL tables for TimescaleDB migration is applying a candidacy scoring rubric. This multi-criteria evaluation scores time-based patterns, table scale, and data types, identifying tables with 8+ points as strong hypertable candidates.