Skip to main content

Ingest Data Models
App

You can use the Data Model Ingestion app to load logical and relational metadata from an Excel file into Atlan. This enables teams to define how data is structured, organized, and related within Atlan without manual setup.

Prerequisites​

Before you begin, make sure you have:

  • Access to the Data Model Ingestion app. Verify this by searching for Data Model Ingestion in the Atlan marketplace. If it's not available, contact Atlan support or your Atlan customer team.
  • Workflow execution permissions in Atlan.
  • A prepared Excel file that follows the required Data Model Ingestion format.

Set up workflow​

  1. In your Atlan workspace, go to the homepage and click New workflow in the top navigation bar.

  2. Search for Data Model Ingestion, and then select Set up workflow.

  3. In the Workflow name field, enter a descriptive name such as:

    Production Finance Data Model

  4. In the Import metadata from section, select Direct file upload and upload the prepared Excel template from your machine.

    For large-scale ingestion jobs, use Object storage (S3, GCS, or ADLS). See the Object storage reference for details.

  5. In the Excel input section, drag and drop the prepared file into the workflow configuration.

    The file must use the required Excel format. For detailed configuration, see the Excel input reference.

    • The Objects sheet is mandatory and defines the foundation of the model.
    • The Relations, Mappings, and Implementations sheets are optional, but must be included if your model captures relationships, conceptual mappings, or system-level implementations.

    You can also 📥 download a sample Excel template.

  6. In the Connection section, select Reuse and choose an existing connection from the list. This enables the ingested data model to attach to assets that are already cataloged in Atlan, keeping all related metadata grouped under the same integration.

    If you need to create a new connection instead, check the Connection reference for details on providing a connection name and assigning connection admins.

  7. In the Connection field, select the connection from the dropdown list. Choose the connection that matches the data source or domain the ingested model is intended to enrich.

  8. Choose Run to execute the workflow immediately, or Schedule and Run to configure recurring ingestion.

    Once the workflow completes successfully, the ingested data model becomes available in Atlan.

Need help?​

If you encounter issues with configuring or running the app, contact Atlan support.

See also​