Table: ndb.aggregatesamples#
Description#
This table stores the samples in Aggregate Datasets.
TODO: Expand this description with: - What data does this table store? - What is the business/research purpose? - How is this data collected or generated? - Are there any important caveats or data quality issues?
Table Structure#
Schema: ndb | Table Comment: This table stores the samples in Aggregate Datasets.
Statistics#
| Metric | Value |
|---|---|
| Row Count | 5,001 |
| Total Size | 416 kB |
| Table Size | 256 kB |
| Indexes Size | 128 kB |
Relationships#
Primary Key: aggregatedatasetid, sampleid
Foreign Keys:
aggregatedatasetid→aggregatedatasets.aggregatedatasetidsampleid→samples.sampleid
Referenced By:
TODO: Document which tables reference this table (will be auto-detected in validation).
Data Dictionary#
| Column | Type | Nullable | Default | Constraints | Description |
|---|---|---|---|---|---|
aggregatedatasetid |
integer | ✗ | - |
PRIMARY KEY, FOREIGN KEY | An arbitrary Aggregate Dataset identification number. Field links to the AggregateDatasets table. |
sampleid |
integer | ✗ | - |
PRIMARY KEY, FOREIGN KEY | Sample ID number. Field links to the Samples table. |
recdatecreated |
timestamp without time zone | ✗ | timezone('UTC'::text, now()) |
- | |
recdatemodified |
timestamp without time zone | ✗ | - |
- |
TODO: Review column descriptions and add comments where missing.
Usage Examples#
Example 1: Basic Selection#
-- Get recent records from aggregatesamples
SELECT *
FROM aggregatesamples
ORDER BY aggregatedatasetid DESC
LIMIT 10;
Purpose: Retrieve the 10 most recent records from aggregatesamples
Example 2: Count Records#
Purpose: Get the total number of records in aggregatesamples
Example 3: Filter by Date Range#
-- Get records within a date range
SELECT *
FROM aggregatesamples
WHERE recdatecreated >= '2024-01-01'
AND recdatecreated < '2025-01-01'
ORDER BY recdatecreated DESC;
Purpose: Retrieve records from aggregatesamples within a specific date range
Example 4: Join with aggregatedatasets#
-- Join with related table
SELECT
t1.*,
t2.*
FROM aggregatesamples t1
INNER JOIN aggregatedatasets t2
ON t1.aggregatedatasetid = t2.aggregatedatasetid
LIMIT 100;
Purpose: Retrieve aggregatesamples records with related data from aggregatedatasets
Example 5: Aggregate Data#
-- Aggregate records by sampleid
SELECT
sampleid,
COUNT(*) as count
FROM aggregatesamples
GROUP BY sampleid
ORDER BY count DESC
LIMIT 10;
Purpose: Count records grouped by sampleid
TODO: Add more specific examples relevant to common research questions or operational tasks.
Data Quality Notes#
TODO: Document: - Known data quality issues - Validation rules - Expected data ranges - Update frequency and mechanisms - Any ETL processes that populate this table
Maintenance#
- Data Owner: TODO: Assign owner
- Update Frequency: TODO: Document frequency
- Last Major Schema Change: TODO: Document when schema last changed
Related Documentation#
TODO: Link to: - Related API endpoints - Data collection procedures - Analysis notebooks or reports that use this table - External ontologies or standards