Asset export (advanced) App
The Asset export (advanced) app exports a filtered set of assets from Atlan to a destination you specify. It translates the filter criteria you define into an asset query, retrieves the matching assets, generates a CSV file, and delivers it to the selected output.
This reference provides complete configuration details for the app, including output destination options, filter logic, asset filters, custom metadata filters, and export attribute selection.
Access
The Asset export (advanced) app isn't enabled by default. To use this app, contact Atlan support and request it be added to your tenant. Once enabled, the app can be set up and run by admins or users with workflow permissions.
Select output destination
This section defines where the exported CSV file is delivered. Select one output type per workflow run.
File name
The name of the file generated by the workflow. The .csv extension is automatically appended and doesn't need to be included. Leave blank to use the default file name.
The File name field is ignored when Google Sheet or CSV download is selected as the output destination.
- S3 bucket
- Google Sheet
- CSV download
- GCS
- ADLS
Delivers the export as a CSV attachment to one or more email addresses.
Atlan API token
Required to generate dynamic filter dropdowns in the Apply asset filters and Apply custom metadata filters sections.
Email addresses
A comma-separated list of email addresses that receive the CSV export as an attachment.
Email subject (optional)
Subject line of the email sent by Atlan. If left blank, the default subject is used.
Email body (optional)
Body text of the email sent by Atlan. If left blank, the default body is used.
The maximum size for email attachments is 25 MB. If the generated file exceeds 25 MB, use another output destination such as S3 bucket, GCS, or ADLS.
Delivers the export to a path in an Amazon S3 bucket.
Atlan API token
Required to generate dynamic filter dropdowns in the Apply asset filters and Apply custom metadata filters sections.
Use this option to upload the exported CSV to an Amazon S3 bucket. You can authenticate using IAM user credentials or an IAM role. Object storage is recommended for larger exports, automated pipelines, or recurring runs where the destination bucket is managed outside Atlan.
For detailed information on configuring storage credentials, access methods, and required fields for each provider, see Object storage configuration for apps.
If you are using an IAM role for cross-account access, contact your Customer Success representative to set up the required cross-account bucket policy.
Delivers the export directly into a Google Sheet worksheet.
Atlan API token
Required to generate dynamic filter dropdowns in the Apply asset filters and Apply custom metadata filters sections.
Google sheet key
The unique identifier of the target Google Sheet. See How do I find my Google Sheet key?
Worksheet name
The name of the tab (worksheet) within the Google Sheet where the data is written. Also referred to as the sheet tab.
Service account JSON
A Google service account key in JSON format. The service account must be granted edit access to the target spreadsheet.
Generates a CSV file that can be downloaded directly from the Atlan UI.
Atlan API token
Required to generate dynamic filter dropdowns in the Apply asset filters and Apply custom metadata filters sections.
When CSV download is selected, the exported file is always compressed, regardless of the Zipped setting in Configure export attributes.
Delivers the export to a path in a Google Cloud Storage bucket.
Atlan API token
Required to generate dynamic filter dropdowns in the Apply asset filters and Apply custom metadata filters sections.
Use this option to upload the exported CSV to a Google Cloud Storage bucket. Object storage is recommended for larger exports, automated pipelines, or recurring runs where the destination bucket is managed outside Atlan.
For detailed information on configuring storage credentials, access methods, required permissions, and required fields, see Object storage configuration for apps.
Delivers the export to a path in an Azure Data Lake Storage container.
Atlan API token
Required to generate dynamic filter dropdowns in the Apply asset filters and Apply custom metadata filters sections.
Use this option to upload the exported CSV to an Azure Data Lake Storage container. Object storage is recommended for larger exports, automated pipelines, or recurring runs.
For detailed information on configuring storage credentials, access methods, and required fields, see Object storage configuration for apps.
Set filter logic
This section controls how multiple filter conditions are combined and which additional attributes are included in the export.
Filter combination mode
Defines how the conditions applied in Apply asset filters and Apply custom metadata filters are evaluated together.
- Match all: All filter conditions must be satisfied for an asset to be included. Equivalent to a logical AND across all active filters.
- Match any: At least one filter condition must be satisfied for an asset to be included. Equivalent to a logical OR across all active filters.
Additional attributes
Specifies additional asset attributes to include as columns in the export file, beyond the predefined set.
The Additional attributes option doesn't support relationship attributes. Only scalar and enumerated attributes can be selected.
Export user-defined relationships
Controls whether user-defined relationships between assets are included in the export file.
- Enabled: Relationship data between assets defined by users is included.
- Disabled: User-defined relationship data is excluded from the export.
Apply asset filters
This section defines which assets are included in the export. Each filter consists of an operator and a value. A filter is applied only when both the operator and value are provided.
The Is empty and Isn't empty operators don't require a value. Any value provided for these operators is ignored.
The following filters are available:
- Connector
- Connection
- Asset type
- Name
- Certificate
- Qualified name
- GUID
- Tag
- Domain
- Description
- Has lineage
- Announcement
- Owner user
- Owner group
- Is archived
- Has terms
- Asset (source) tag
- Created (in Atlan)
- Last updated (in Atlan)
Apply custom metadata filters
This section enables filtering based on custom metadata attributes. Each filter consists of a custom metadata selector, an operator, and a value. A filter is applied only when both the operator and value are provided.
The Is empty and Isn't empty operators don't require a value. Any value provided for these operators is ignored.
If a custom metadata attribute supports multiple values, use comma-separated strings with the Is one of or Isn't one of operator to filter on multiple values simultaneously.
Configure export attributes
This section controls which attributes are exported and how the output file is structured.
Importable
Controls whether the export is formatted for use as input to the Asset Import app.
- Yes: Ensures appropriate details are included in the output so that the file can be used directly with the Asset Import app. Exposes an additional Timestamp format option:
- Unix: Exports timestamp attributes in Unix epoch format.
- ISO 8601: Exports timestamp attributes in ISO 8601 format.
- No (default): Produces a business-friendly output with a fixed predefined set of columns.
Column selection
- Fixed
- Dynamic
When Importable is set to No, the following predefined columns are exported:
- Description
- Alias
- Usage queries (last 30 days)
- Usage users (last 30 days)
- User owners
- Group owners
- Linked terms
- Tags
- Certificate status
- Announcement
- Created by (in Atlan)
- Last updated by (in Atlan)
- Created (in Atlan)
- Last updated (in Atlan)
- Connection name
- Last queried
- Last updated (on source)
- Source updated by
- Readme
- Labels
- Links
- Category *
- Linked assets *
- Related terms *
- Glossary *
- Parent category *
- Inputs *
- Outputs *
- All custom metadata
Columns marked with * are included only under specific conditions:
- Category, Linked assets, and Related terms are exported only when Atlan glossary term is selected in the Asset type filter.
- Glossary is exported only when Atlan glossary term or Atlan glossary category is selected in the Asset type filter.
- Parent category is exported only when Atlan glossary category is selected in the Asset type filter.
- awsArn is automatically included when the export contains at least one S3 bucket or S3 object asset.
- Inputs and Outputs are automatically included for process assets.
When Dynamic column selection is enabled, the columns to export are selected from a dropdown menu. Use this option to customize the output to specific asset attributes needed for your use case.
Zipped
Controls whether the output file is compressed before delivery.
- When Google Sheet is selected, this option is ignored.
- When CSV download is selected, the file is always compressed regardless of this setting.