MATIH Platform is in active MVP development. Documentation reflects current implementation status.
10. Data Catalog & Governance
Catalog Statistics

Catalog Statistics

The Catalog Service provides aggregate statistics about the catalog's contents, coverage, and health. These metrics help data teams understand their metadata landscape.


Get Catalog Statistics

GET /api/v1/catalog/stats
curl "http://localhost:8086/api/v1/catalog/stats" \
  -H "X-Tenant-ID: 550e8400-e29b-41d4-a716-446655440000"

Response

{
  "totalDatabases": 12,
  "totalTables": 847,
  "totalColumns": 15230,
  "totalTags": 45,
  "totalDataSources": 5,
  "tablesWithDescriptions": 623,
  "tablesWithTags": 412,
  "descriptionCoverage": 73.5,
  "tagCoverage": 48.6,
  "recentlyUpdated": 34,
  "staleAssets": 89
}

Trending Assets

Track which catalog assets are most viewed and queried:

GET /api/v1/catalog/discovery/trending?limit=10&daysBack=7
{
  "assets": [
    {
      "assetId": "tbl-001",
      "name": "customer_orders",
      "assetType": "TABLE",
      "viewCount": 145,
      "queryCount": 89,
      "trendScore": 312.5,
      "lastAccessed": "2026-02-12T08:30:00Z"
    }
  ],
  "period": "7 days",
  "generatedAt": "2026-02-12T10:00:00Z"
}

Recently Added Assets

GET /api/v1/catalog/discovery/recent?page=0&size=20

Personalized Recommendations

GET /api/v1/catalog/discovery/recommendations?limit=10
{
  "userId": "user-001",
  "recommendations": [
    {
      "assetId": "tbl-042",
      "name": "revenue_metrics",
      "assetType": "TABLE",
      "reason": "Trending in your organization",
      "score": 8.5
    },
    {
      "assetId": "tbl-100",
      "name": "new_product_catalog",
      "assetType": "TABLE",
      "reason": "Recently added",
      "score": 5.0
    }
  ],
  "generatedAt": "2026-02-12T10:00:00Z"
}

Source Reference

ComponentFile
Statistics endpointCatalogController.java -- getCatalogStatistics()
Trending assetsCatalogDiscoveryController.java -- getTrendingAssets()
RecommendationsCatalogDiscoveryController.java -- getRecommendations()
Related assetsCatalogDiscoveryController.java -- getRelatedAssets()
View trackingCatalogDiscoveryController.java -- recordAssetView()