mcpField
P
purview-data-map

purview-data-map

github.com/vinayaklattheData & databases17876 installsUpdated 19w ago
Repository

About purview-data-map

A skill for data governance teams planning Microsoft Purview Data Map to discover, scan, and map metadata and classifications across cloud, SaaS, and on-premises sources. It covers collections, runtimes, scanning, and curation to support catalog, lineage, and protection decisions.

Key features

  1. 01Plan collection hierarchy and asset access
  2. 02Register cloud and on-premises sources
  3. 03Select managed or self-hosted integration runtime
  4. 04Configure scans, classification, and lineage extraction
  5. 05Curate assets and assign owners

Use cases

  1. 01Build an enterprise data asset inventory
  2. 02Plan discovery across cloud and on-premises sources
  3. 03Configure scans and classification for data sources
  4. 04Organize data assets by business domain

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/vinayaklatthe/microsoft-security-skills --skill purview-data-map

After installing, type/purview-data-mapin Claude Code to confirm it loaded.

Details

From the project README

Microsoft Purview Data Map

The Data Map is the foundational layer of Microsoft Purview data governance: it discovers, scans, and maps metadata and classifications from data sources across Azure, multicloud, SaaS, and on-premises - powering the Unified Catalog, lineage, and downstream protection decisions.

When to use

Building an enterprise-wide inventory of data assets and their classifications as the basis for governance, security, and data product publishing.

Do not use this skill for in-tenant Microsoft 365 classification (use purview-data-classification) or for AI prompt visibility (use purview-dspm-ai).

Pick the right integration runtime

Source locationUse this runtime
Azure (Storage, SQL, Synapse, Fabric, Cosmos)Managed (Azure-hosted) runtime
AWS S3 / RDS, GCP BigQuery, public SaaSManaged runtime, with credentials in Key Vault
On-premises SQL, Oracle, file sharesSelf-hosted integration runtime (SHIR) on a domain-joined Windows host
Private-endpoint-only Azure sourcesSHIR or VNet-integrated managed runtime
Power BI tenantNative connector, no runtime config

Rule of thumb: managed runtime first; deploy SHIR only when network or private-endpoint reach requires it - and treat the SHIR host as Tier-0 infrastructure.

Approach

  1. Plan collections - Design the collection hierarchy (by business domain or geography) before registering sources; collections drive RBAC and asset organisation. Verify: a draft collection tree exists and maps to data-owner accountability.
  2. Register sources - Connect data sources (Azure Storage, SQL, Synapse, Fabric, AWS S3, databases, Power BI, etc.) into the right collection with appropriate credentials. Verify: each registered source shows correct subscription/account and target collection.
  3. Choose an integration runtime - Use the managed runtime for cloud sources; deploy a self-hosted integration runtime to reach on-premises or private-network sources securely. Verify: SHIR status is Running and self-update is enabled.
  4. Configure scans and rule sets - Schedule scans with scan rule sets; apply classifications (built-in SITs and custom) and lineage extraction where supported. Start incremental, not full. Verify: scan history shows successful runs with classified assets counted.
  5. Curate - Review discovered assets, apply glossary terms, and assign data owners/stewards; tune custom classifications based on real matches. Verify: top assets have owners and at least one glossary term.
  6. Govern access - Use collections to organise assets and scope permissions by domain; prefer collection-level role assignment over root. Verify: collection-admin roles assigned to domain owners, not platform team only.
  7. Operate - Monitor scan failures, classification drift, and cost; right-size scan frequency per source criticality. Verify: a weekly scan-health report exists.

Guardrails

  • Scope and schedule scans to manage cost and source load; avoid scanning everything at full depth on day one - sampling first, full second.
  • Secure the self-hosted integration runtime host as sensitive infrastructure - it holds credentials and reaches into production data sources; patch, restrict logon, monitor.
  • Validate classification accuracy before relying on it for downstream protection - sample matches per SIT and tune confidence levels.
  • Use Key Vault for credentials; never embed secrets in scan configuration.
  • Plan capacity - Data Map is metered by capacity units; oversized scans inflate cost without governance value.

Common anti-patterns

  • Registering every source into the root collection and assigning everyone Data Reader.
  • Scheduling weekly full scans on petabyte data lakes - blows out capacity and budget.
  • Running SHIR on a workstation or shared jump host.
  • Skipping the glossary and ownership step - assets get classified but nobody acts on them.
  • Treating Data Map as a one-off load instead of a continuously curated catalogue.

Example prompts

  • Register and scan data sources in the Purview Data Map.
  • Configure an integration runtime for multicloud data scanning.
  • How do I map enterprise data and run classification scans?
  • Plan data discovery across cloud and on-prem sources.
  • Design a Purview collection hierarchy aligned to business domains.

Microsoft Learn

Comments

Markdown supported