Triplets

In Anjana Data, a triplet is a label made up of three parts that identifies a specific point within a technology or plugin.

Example:

Virtualizador/Denodo/Territorio

• Virtualizador → general category of the technology in the organization's data architecture

• Denodo → specific tool/technology

• Territorio → scope or domain within that tool

The triplet works like a postal address: it indicates where the Anjana Data functionalities should be applied (metadata extraction, sampling, tag updates, permission management, etc.).

In this way, each action on the platform is combined with a triplet so that Anjana Data knows what it has to do and where it must do it.

Design and Definition of Triplets

Activating a plugin for metadata extraction, data sampling and/or access permission management is based on the definition and use of a triplet.

These triplets consist of a triple formed by reference metadata (Attribute Definition Values) that take the following attributes (Attribute Definitions):

• Infrastructure (infrastructure). For example: “Azure”, “AWS”, “Virtualizador”, “DWH”, “Reporting”

• Technology (technology). For example: “Azure Storage”, “Amazon S3”, “Denodo”, “Oracle”, “Tableau”

• Zone (zone). For example: “Silver”, “Gold”, “Territorio”

Triplets are characterised by the following:

• They are 100% customisable; each organisation can establish the logic of the collections using any triple of reference values for the infrastructure/technology/zone attributes.

• Each triplet must be unique, meaning that triples cannot be repeated in the configuration of more than one plugin.

• Each triplet resolves a connection to a technology using credentials that have permissions for metadata extraction, data sampling and/or access permission management, among others. This is configured in the YAML of each plugin.

🔎 Example of a triplet for connecting to virtualised data in Denodo:

• Triplet: Virtualizador/Denodo/Territorio

• Plugin: JDBC Denodo

• Enabled functions: metadata extraction, sampling, access permission management and tag management.

• YAML snippet showing how the triplet resolves a single connection and enables a variety of functionalities:

  • The ari is the YAML property that allows linking the triplet with the plugin functionalities (updateTags, sample, extract…)

  • The ari must be configured with the values set in the name field of Attribute Definition Values, not with the translation values (value of Translations)
    

    YAML

      connection:
        - name: pro
          technology:
            driver: com.denodo.vdp.jdbc.Driver
            url: jdbc:vdb://entornodenodo.anjanadata.org:9999/poc?ssl=true
            user:
            password:
            imType: "LDAP"
            sampleRows: 15
            path-separator: "/"
            obfuscation-string: "*****"
          aris:
            - ari: "anja:totplugin:updateTags:/Virtualizador/Denodo/Territorio/"    # Tripleta sirve para actualización de tags
            - ari: "anja:totplugin:sample:/Virtualizador/Denodo/Territorio/"        # Tripleta sirve para sampleo
            - ari: "anja:totplugin:extract:/Virtualizador/Denodo/Territorio/"       # Tripleta sirve para extracción de metadatos
            - ari: "anja:totplugin:edit:/Virtualizador/Denodo/Territorio/"          # Tripleta sirve para edicion
            - ari: "anja:totplugin:im:/Virtualizador/Denodo/Territorio/"            # Tripleta sirve para gestión de permisos de acceso, creación del rol en Denodo
              imAri: "anja:totplugin:im:/ldap/ldap/ldap/"                           # Tripleta sirve para gestión de permisos de acceso, creación del grupo en el AD via protocolo LDAP
    

Triplet Configuration

Once the triplets have been designed and defined, the functional configuration must be performed. To do so, review the Metamodel and metadata templates configuration, which explains how to configure:

• The infrastructure, technology and zone attributes in Attribute Definitions.

• Configure the values that the infrastructure, technology and zone attributes can take in Attribute Definition Values.

• Assign the attributes in the metamodel object templates in Template Attribute.

• Configure the dependency validation between infrastructure --> technology --> zone in Template Attribute Validation.

• Configure the relationships between triplet values in Attribute Relationships.

Once the functional configuration has been completed, the technical configuration must be performed, including the configuration of the triplets that have been defined at the functional level. To do so:

• Open the plugin's configuration YAML file

• Configure the ari in the YAML linking the plugin functionality with the triplet. The ari must be configured with the values set in the name field of Attribute Definition Values, not with the translation values (value of Translations)

Important:

If during the metadata import in the Data Portal creation wizard, selecting a triplet shows an error stating “No plugin exists for extract”, the error is likely due to one of the following reasons:

• The ari is not correctly configured in the plugin's YAML:

  • The ari must exactly match the values configured in the name field of Attribute Definition Values, never with the translation values (value of Translations)

• The translation values selected by the user in the wizard do not correspond to the plugin values.

  • Check that the key values in the Languages table corresponding to the translations selected in the wizard (value) match the name values in the Attribute Definition Value table.

  • Check that the name values in the Attribute Definition Value table match those configured in the ari.

Enabling Functionalities

Once the plugin has been deployed and the triplet configured, Anjana Data automatically validates in which context each functionality should be activated.

• Metadata extraction: activated when creating an object with “automatic metadata” in the Object Creation wizard of the Data Portal, allowing discovery of source structures.

• Sample Data: when accessing the Sample Data tab of a DATASET, it launches queries to retrieve data samples, obfuscating the content of fields (DATASET_FIELD) marked with the pi attribute set to true.

• Access management: includes the following capabilities:

  • Upon completion of a DSA creation workflow, it creates a group in the AD, IAM or identity management system where authentication of the enabled technology's users is delegated, and a role with permissions in the technology.

    • For example, creation of a group in the AD with a name formed by <prefix configured in the plugin><DSA name><DSA version>
      

      

    • For example, creation of the role and assignment of permissions in Denodo with a name formed by <prefix configured in the plugin><DSA name><DSA version>
      

      

  • Upon completion of an adherence workflow, the adhered user is added to the group and granted the role. In this way, when the user accesses Denodo, they can run queries on the DATASETs included in the DSA they have adhered to.
    

    

Conditions for Enabling Plugin Functionalities

For the data sampling, access permission management, tag and other functionalities enabled in the plugin YAML to be executed on a governed asset in Anjana Data Platform, the following is required:

1. The governed object must have been created with the triplet values of the plugin

2. The object must be in Approved status.

3. The isGoverned attribute must be enabled in the template (indicates that the asset is connected to the platform).

4. To enable the Sample Data tab, the sampleData attribute must additionally be enabled in the template.