PULL FOREIGN CATALOG METADATA

This guide shows you how to pull catalog metadata from other namespaces to discover what models and data are available in a shared datastore.

Prerequisites

• A repository with a namespace assigned
• Other namespaces in the shared datastore that have published data

Pull catalog metadata

Specify which foreign namespaces to pull from:

$ swamp datastore catalog pull --namespaces infra,security

This fetches the catalog entries from the infra and security namespaces into your local catalog cache. The pulled metadata includes model names, types, data output names, and version counts — enough to know what is available without downloading the actual data.

Use the pulled metadata

After pulling, foreign models appear in catalog queries. Use the namespace prefix syntax in CEL expressions to reference their data:

globalArguments:
  vpc_id: "${{ data.latest('infra:my-vpc', 'result').attributes.vpcId }}"

Refer to Query Across Namespaces for the full query syntax.

Refresh stale metadata

The pulled catalog is a snapshot. If the foreign namespace has changed since the last pull, re-run the command:

$ swamp datastore catalog pull --namespaces infra

There is no automatic refresh or TTL. Pull explicitly when you need current information.