Table: `ndb.datasetpis`#

Description#

No description available in database.

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: No description available

Statistics#

Metric	Value
Row Count	139,420
Total Size	39 MB
Table Size	8328 kB
Indexes Size	30 MB

Relationships#

Foreign Keys:

contactid → contacts.contactid
datasetid → datasets.datasetid

Referenced By:

TODO: Document which tables reference this table (will be auto-detected in validation).

Data Dictionary#

Column	Type	Nullable	Default	Constraints	Description
`datasetid`	integer	✗	`-`	FOREIGN KEY	Dataset identification number. Field links to Dataset table.
`contactid`	integer	✗	`-`	FOREIGN KEY	Contact identification number. Field links to Contacts table.
`piorder`	integer	✓	`-`	-	Order in which PIs are listed.
`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 datasetpis
SELECT *
FROM datasetpis
ORDER BY datasetid DESC
LIMIT 10;

Purpose: Retrieve the 10 most recent records from datasetpis

Example 2: Count Records#

-- Count total records
SELECT COUNT(*) as total_records
FROM datasetpis;

Purpose: Get the total number of records in datasetpis

Example 3: Filter by Date Range#

-- Get records within a date range
SELECT *
FROM datasetpis
WHERE recdatecreated >= '2024-01-01'
  AND recdatecreated < '2025-01-01'
ORDER BY recdatecreated DESC;

Purpose: Retrieve records from datasetpis within a specific date range

Example 4: Join with contacts#

-- Join with related table
SELECT 
    t1.*,
    t2.*
FROM datasetpis t1
INNER JOIN contacts t2 
    ON t1.contactid = t2.contactid
LIMIT 100;

Purpose: Retrieve datasetpis records with related data from contacts

Example 5: Aggregate Data#

-- Aggregate records by contactid
SELECT 
    contactid,
    COUNT(*) as count
FROM datasetpis
GROUP BY contactid
ORDER BY count DESC
LIMIT 10;

Purpose: Count records grouped by contactid

TODO: Add more specific examples relevant to common research questions or operational tasks.

Data Quality Notes#

Automated Data Quality Tests#

This table is subject to the following automated quality checks:

❌ comp_001: datasets_have_investigators

Severity: WARNING
Status: FAILED
Description: Datasets should have at least one principal investigator
Suggested Remediation: - Research and add PI information
Contact data owner to identify responsible investigator

See the Data Quality Report for details.

Maintenance#

Data Owner: TODO: Assign owner
Update Frequency: TODO: Document frequency
Last Major Schema Change: TODO: Document when schema last changed

Table: ndb.datasetpis#