---
title: Understand the Discovery YAML file content
description: Each Metadata Repository contains a discoveries folder (See Understand the Project Metadata Repository content).  In this folder, there is one subfolder for each Source System.  In each Source System folder, the corresponding Discovery YAML files are stored.  Each file contains all the metadata for a Discovery.  It is identical to the Discovery YAML file produced by the Discovery application. Only the Source System type is added.
---

[Skip to content](https://knowledge.bigenius-x.com/understand-the-discovery-yaml-file-content#main-content)

[Contact us](https://knowledge.bigenius-x.com/kb-tickets/new?hsLang=en) [Go to Customer Portal](https://knowledge.bigenius-x.com/customer-portal?hsLang=en)

[![TRI\_Logo\_biGENIUS\_2020\_RGB\_s](https://knowledge.bigenius-x.com/hs-fs/hubfs/Marketing/TRI_Logo_biGENIUS_2020_RGB_s.png?width=150&height=42&name=TRI_Logo_biGENIUS_2020_RGB_s.png)](https://www.bigenius-x.com/)

Open main navigation

Close main navigation

- [Contact us](https://knowledge.bigenius-x.com/kb-tickets/new)
- [Go to Customer Portal](https://knowledge.bigenius-x.com/customer-portal)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [biGENIUS-X Knowledge Base](https://knowledge.bigenius-x.com/?hsLang=en)
2. [Application Modules](https://knowledge.bigenius-x.com/application-modules?hsLang=en)
3. [Data Connections](https://knowledge.bigenius-x.com/application-modules?hsLang=en#data-connections)

# Understand the Discovery YAML file content

Each Metadata Repository contains a **discoveries** folder (See [Understand the Project Metadata Repository content](https://knowledge.bigenius-x.com/understand-the-project-metadata-repository-content?hsLang=en)).

In this folder, there is one subfolder for each **Source System**.

In each **Source System** folder, the corresponding **Discovery** YAML files are stored.

Each file contains **all the metadata for a Discovery**.

It is identical to the Discovery YAML file produced by the Discovery application. Only the Source System type is added.

### Discovery file details

After the discovery is created, the file should look like the following:

```
id: 6adc0785-993a-4e39-9984-4bd1fd3f2351name: mssql_adw_production_output.jsontimestamp: 'XXXX-05-22T09:38:24.9555608+00:00'appVersion: '1.2.0'sourceSystem:  type: Microsoft SQL ServersourceObjects:  - name: Product    fullyQualifiedName: AdventureWorks2017.Production.Product    objectType: {}    terms:      - name: ProductID        sourceDataType:          name: INTEGER          isNullable: false        dataType:          name: int        isIdentity: false        isBusinessKey: true        isForeignKey: false      - name: Name        sourceDataType:          name: NVARCHAR          length: 50          isNullable: false        dataType:          name: NVARCHAR          length: 50        isIdentity: false        isBusinessKey: false        isForeignKey: false        ....
```

The **Source data type** is the data type from the **Source technology used**.

The **Target data type** is the data type depending on the **Target technology of the Generator**.

The Generator Configuration sets the **mapping** between a Source data type ("INTEGER" in this example) and a Target data type ("int" in this example).

The different nodes contain:

| ** Node name** | ** Node description** | ** Node value example** |
| --- | --- | --- |
| ** id** |  Discovery's internal ID   (GUID format) | 6adc0785-993a-4e39-9984-4bd1fd3f2351 |
| ** name** |  Name of the file used to   create the Discovery |  mssql\_adw\_production\_output.json |
| ** timestamp** |  Date and Time of the   Discovery creation |  This is the project used to document   Data Vault modeling. |
| **appVersion** | Discovery application version which produces the Discovery file | 1.2.0 |
| ** sourceSystem \>   type** |  Source Technology of the   Source System |  Microsoft SQL Server |
| ** sourceObjects** |  List of objects in the   Discovery | - |
| ** sourceObjects \>   name** |  Name of an Object in the   Discovery |  Product |
| ** sourceObjects \>   fullyQualifiedName** |  Complete name of an   Object in the Discovery. For   a database,   *databaseName.schemaName.tbaleName*. |  AdventureWorks2017.Production.Produc t |
| ** sourceObjects \>   terms** |  List of terms in the Object | - |
| ** sourceObjects \>   terms \> name** | Name of a Term | ProductID |
| ** sourceObjects \>   terms \>   sourceDataType** | Description of the Source data type for the Term | - |
| ** sourceObjects \>   terms \>   sourceDataType \>   name** | Name of the Source data type | INTEGER |
| ** sourceObjects \>   terms \>   sourceDataType \>   length** | Length of the Source data type (if relevant) | - |
| ** sourceObjects \>   terms \>   sourceDataType \>   isNullable** | Property is nullable for the Source data type | false |
| ** sourceObjects \>   terms \> dataType** | Description of the Target data type for the Term | - |
| **  sourceObjects \>   terms \> dataType   \> name** | Name of the Target data type | int |
| ** sourceObjects \>   terms \> dataType   \> length** | Length of the Target data type (if relevant) | - |
| ** sourceObjects \>   terms \> isIdentity** | True if the Term is an identity | false |
| ** sourceObjects \>   terms \>   isBusinessKey** | True if the Term is a Business Key. This will be true if the Source Term is a primary key. |  true |
| ** sourceObjects \>   terms \>   isForeignKey** |  True if the Term is a foreign   key |  false |

 

- [Getting started](https://knowledge.bigenius-x.com/getting-started?hsLang=en#main-content)

    - [Guidelines](https://knowledge.bigenius-x.com/getting-started?hsLang=en#guidelines)
    - [Start working](https://knowledge.bigenius-x.com/getting-started?hsLang=en#start-working)
    - [Account](https://knowledge.bigenius-x.com/getting-started?hsLang=en#account)
- [General overview](https://knowledge.bigenius-x.com/general-overview?hsLang=en)
- [Artificial Intelligence](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en)
- [Application Modules](https://knowledge.bigenius-x.com/application-modules?hsLang=en#main-content)

    - [Administration](https://knowledge.bigenius-x.com/application-modules?hsLang=en#administration)
    - [Solutions](https://knowledge.bigenius-x.com/application-modules?hsLang=en#solutions)
    - [Global Features](https://knowledge.bigenius-x.com/application-modules?hsLang=en#global-features)
    - [Projects](https://knowledge.bigenius-x.com/application-modules?hsLang=en#projects)
    - [Branches](https://knowledge.bigenius-x.com/application-modules?hsLang=en#branches)
    - [Data Connections](https://knowledge.bigenius-x.com/application-modules?hsLang=en#data-connections)
    - [Dataflow Modeling - Overview](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-overview)
    - [Dataflow Modeling - Wizard Steps](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-wizard-steps)
    - [Dataflow Modeling - Terms](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-terms)
    - [Dataflow Modeling - Term Mapping](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-term-mapping)
    - [Dataflow Modeling - Relationships](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-relationships)
    - [Dataflow Modeling - Data Quality](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-data-quality)
    - [Dataflow Modeling - Indexes](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-indexes)
    - [Relationship Modeling](https://knowledge.bigenius-x.com/application-modules?hsLang=en#relationship-modeling)
    - [Generate Artifacts](https://knowledge.bigenius-x.com/application-modules?hsLang=en#generate-artifacts)
    - [Project Settings](https://knowledge.bigenius-x.com/application-modules?hsLang=en#project-settings)
    - [Data Marketplace](https://knowledge.bigenius-x.com/application-modules?hsLang=en#data-marketplace)
- [Generators](https://knowledge.bigenius-x.com/generators?hsLang=en#main-content)

    - [Fabric Warehouse](https://knowledge.bigenius-x.com/generators?hsLang=en#fabric-warehouse)
    - [Fabric Lakehouse](https://knowledge.bigenius-x.com/generators?hsLang=en#fabric-lakehouse)
    - [Databricks](https://knowledge.bigenius-x.com/generators?hsLang=en#databricks)
    - [Snowflake](https://knowledge.bigenius-x.com/generators?hsLang=en#snowflake)
    - [Microsoft SQL Server](https://knowledge.bigenius-x.com/generators?hsLang=en#microsoft-sql-server)
    - [Artifacts](https://knowledge.bigenius-x.com/generators?hsLang=en#artifacts)
    - [Replace Placeholders](https://knowledge.bigenius-x.com/generators?hsLang=en#replace-placeholders)
    - [Target solution environment](https://knowledge.bigenius-x.com/generators?hsLang=en#target-solution-environment)
    - [Deployment](https://knowledge.bigenius-x.com/generators?hsLang=en#deployment)
    - [Deployment with an Azuze DevOps pipeline](https://knowledge.bigenius-x.com/generators?hsLang=en#deployment-with-an-azuze-devops-pipeline)
    - [Delta Deployment](https://knowledge.bigenius-x.com/generators?hsLang=en#delta-deployment)
    - [Load control environment](https://knowledge.bigenius-x.com/generators?hsLang=en#load-control-environment)
    - [Load data with a native load control](https://knowledge.bigenius-x.com/generators?hsLang=en#load-data-with-a-native-load-control)
    - [Load data with Apache Airflow](https://knowledge.bigenius-x.com/generators?hsLang=en#load-data-with-apache-airflow)
    - [Model Object Type](https://knowledge.bigenius-x.com/generators?hsLang=en#model-object-type)
    - [Properties](https://knowledge.bigenius-x.com/generators?hsLang=en#properties)
    - [Default Terms](https://knowledge.bigenius-x.com/generators?hsLang=en#default-terms)
- [Discovery application](https://knowledge.bigenius-x.com/discovery-application?hsLang=en#main-content)

    - [Discovery configurations](https://knowledge.bigenius-x.com/discovery-application?hsLang=en#discovery-configurations)
- [Best practices](https://knowledge.bigenius-x.com/best-practices?hsLang=en#main-content)

    - [Modeling Approaches](https://knowledge.bigenius-x.com/best-practices?hsLang=en#modeling-approaches)
    - [Use Cases](https://knowledge.bigenius-x.com/best-practices?hsLang=en#use-cases)
    - [Business Rules](https://knowledge.bigenius-x.com/best-practices?hsLang=en#business-rules)
    - [Data Quality Rules](https://knowledge.bigenius-x.com/best-practices?hsLang=en#data-quality-rules)
- [FAQs](https://knowledge.bigenius-x.com/faqs?hsLang=en)
- [Product Release Notes](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#main-content)

    - [SaaS Application](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#saas-application)
    - [Discovery application](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#discovery-application)
    - [Generators](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#generators)
- [Legal Documents](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#main-content)

    - [Current legal docs](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#current-legal-docs)
    - [Software Product and Limits](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#software-product-and-limits)

- [Contact us](https://knowledge.bigenius-x.com/kb-tickets/new?hsLang=en)
- [Customer Portal](https://knowledge.bigenius-x.com/customer-portal)
- [Sign in](https://knowledge.bigenius-x.com/_hcms/mem/login)

[![biGENIUS logo](https://knowledge.bigenius-x.com/hubfs/TRI_Logo_biGENIUS_2020_RGB-1.svg "biGENIUS logo")](https://www.bigenius-x.com)

<https://www.linkedin.com/company/bigenius> <https://www.youtube.com/@biGENIUS_DWA>

All rights reserved © 2025, biGENIUS AG