armor-tags

Data Classification with Tags

Organize and classify database objects with tags for governance, compliance, and business categorization.

Prerequisites

• AnomalyArmor API key configured (~/.armor/config.yaml or ARMOR_API_KEY env var)
• Python SDK installed (pip install anomalyarmor)

When to Use

• "Tag this table as PII"
• "Apply financial reporting tag"
• "List all tags for this asset"
• "Mark these columns as sensitive"
• "Classify this data as confidential"
• "Add governance labels"

Concepts

Tag Categories

• business: Business domain tags (e.g., "finance", "marketing", "sales")
• technical: Technical classification (e.g., "fact_table", "dimension", "staging")
• governance: Compliance and security (e.g., "pii", "confidential", "gdpr")

Tag Scope

Tags can be applied to:

• Tables: Full table classification
• Columns: Column-level classification (for PII, sensitive data)

Steps

Creating a Tag

1. Identify the asset and object (table or column) to tag
2. Choose the tag name and category
3. Call client.tags.create() with the object path

Applying Multiple Tags

1. Prepare list of tag names to apply
2. Prepare list of object paths
3. Call client.tags.apply() for batch operations

Bulk Tagging Across Assets

1. Create tag name
2. List asset IDs to tag
3. Call client.tags.bulk_apply()

Example Usage

List Existing Tags

from anomalyarmor import Client

client = Client()

# List all tags for an asset
tags = client.tags.list(asset="postgresql.analytics")
for tag in tags:
    print(f"  {tag.name} ({tag.category}): {tag.object_path}")

# Filter by category
governance_tags = client.tags.list(
    asset="postgresql.analytics",
    category="governance"
)

Tag a Table as PII

tag = client.tags.create(
    asset="postgresql.analytics",
    name="pii_data",
    object_path="public.customers",
    object_type="table",
    category="governance",
    description="Contains personally identifiable information"
)
print(f"Created tag: {tag.id}")