Skip to main content
Version: v4.12

Data Map

The Data Map is an inventory of your data locations that allows you to establish a short name, called a data label, for each data location (like a table, collection, or S3 bucket) that you want to protect. Optionally, you can use tags to group or categorize your data labels.

Learn more in the Data Map section of the policy framework documentation.

Add or edit a Data Map

Prerequisite: Before you set up your Data Map entries, make sure you have tracked your database locations or S3 locations in Cyral.

Procedure: There are three ways to work on your Data Maps in Cyral:

Add or edit a Data Map through the UI

In the Cyral control plane UI:

  1. Click Data Repos ➡️ your repository's name ➡️ Data Map ➡️ Mappings

  2. Add or edit:

    • To add a new mapping, click Add Mapping
    • To edit a mapping, find the data label you want to edit, click the 🔽 to expand it, and click ✏️ to edit.
  3. In the Edit Mapping window specify the data label's name and the data location it will apply to:

    • LABEL: If you're creating a new data label, name it here. Think of this as a shorthand name you can use in your policy to refer to one or many database columns or other locations. The label name is case sensitive; when you write your policy, take care to write it exactly as it is written here.
    • The remaining fields describe a location to be included in this data label:
      • Schema or Database: name of the schema, database, or Dremio space
      • Table, Collection, or Bucket: name of the database table, MongoDB collection, or AWS bucket
      • Column, Field, or Object Key: database column name or AWS object key

        The fields describing your data location are case insensitive. For example, if you include a table name, credit_card_number, in your label, and you have tables called credit_card_number and Credit_Card_Number, then both will be covered by the label.

  4. Click Create or Save to save your Data Map.

Add or edit a Data Map as a YAML file

In the Cyral control plane UI:

  1. Click Data Repos ➡️ your repository's name ➡️ Data Map ➡️ View as YAML

  2. Click the Edit button.

  3. Use the test editing field to type or paste your Data Map. See the Structure section of the Data Map Guide.

  4. Click Save to save your Data Map.