Limitations and Troubleshooting

Alation Cloud Service Applies to Alation Cloud Service instances of Alation

Customer Managed Applies to customer-managed instances of Alation

Core Connector Core connectors are included with all Alation platform tiers (subject to each tier’s connector limits) and are fully supported by Alation.

Troubleshooting

Refer to Log Collection.

Limitations

  1. Qlik Cloud API Usage

    The connector uses the Qlik Cloud API to catalog data sources (QVDs, files, and datasets), including tables and table columns, and to establish their lineage relationships. The connector does not use this API to catalog Qlik Cloud as a primary BI source.

  2. Cross-System Lineage Not Supported

    The connector does not currently support cross-system lineage due to Engine and Cloud Lineage API limitations.

  3. Column Name Mapping

    Some sheet columns may map to multiple table columns when identical column names exist across different tables. Qlik Sense combines values for all fields with the same name, so lineage will be represented in one-to-many mapping

  4. Incomplete Representation of Transformation Logic

    The lineage does not fully reflect certain Qlik transformation logic due to:

    • Limitations in the available Engine or Cloud APIs.

    • Missing or incomplete field-level mapping details from Qlik Sense in specific scenarios.

  5. Reduced Lineage When Cloud Lineage Is Disabled

    When Cloud Lineage is disabled, data source (QVD, file, and dataset) to table mappings are not created. In this mode, data sources and tables are cataloged from the Engine API response, which results in reduced lineage information.

  6. Master Items Not Linked

    Master items do not link to their upstream sources or tables.

  7. Tables Not Extracted for Apps Not Published to Cloud Lineage

    When Cloud Integration is enabled, the connector extracts tables and table columns from the Lineage Graph API, which only provides data for apps published to Cloud Lineage. The connector does not extract tables or table columns for apps that are not published to Cloud Lineage. The connector still catalogs other metadata such as sheets, visualizations, and master items for these apps.

    Workaround: To extract tables and table columns for these apps, do one of the following:

    • Publish the app to Cloud Lineage in Qlik Sense.

    • Disable Cloud Integration in the Connector Settings to use GetTablesAndKeys from the Engine API instead.

      Note

      This results in reduced lineage information as mentioned in Limitation step 5.