For the complete documentation index, see llms.txt. This page is also available as Markdown.

Troubleshooting & FAQs

Troubleshootings

If incorrect parameters are entered, error messages may appear. Ensure all inputs are accurate to resolve these issues. If issues persist, contact the assigned support team.

S. No
Error Message
Error Description & Resolution

1

Connection validation fails for a SharePoint site using a /teams/ address

The current SharePoint connector searches for sites under /sites/. It does not connect to a site whose address uses /teams/.

Resolution:

  • Confirm the site address in SharePoint and identify whether it uses /sites/ or /teams/.

  • For a /teams/ site, note that the current connector cannot validate or crawl the site.

2

Microsoft Fabric Managed Airflow connection fails with Microsoft Entra ID

The Apache Airflow connector supports Basic Authentication with a username and password. Microsoft Entra ID authentication is not currently supported.

Resolution:

  • Confirm the Airflow endpoint uses the native REST API and supports Basic Authentication.

  • If the environment requires Microsoft Entra ID, record this as a connector capability gap.

3

Connection to an S3 compatible storage endpoint fails

The current S3 connector does not support non-AWS S3 endpoints or on-premises S3 compatible deployments.

Resolution:

  • Confirm that the endpoint is AWS S3 and that the configured region is valid.

  • For buckets in different AWS regions, provide the correct region for each bucket.

4

Microsoft Fabric Managed Airflow connection is rejected

The Apache Airflow connector supports Basic Authentication against the native Airflow REST API. Microsoft Entra ID authentication is not currently supported.

Resolution:

  • Confirm the authentication method required by the Fabric Airflow endpoint.

  • If Microsoft Entra ID is mandatory, treat support as an enhancement request for feasibility review.

5

A connection stops working after a server migration

OvalEdge connects to source systems using a DNS name or IP address, not a MAC address.

Resolution:

  • If the configured DNS name remains unchanged, an IP address change alone does not require a connector update.

  • If the configured DNS name changes, update the connection details.

S. No
Error Message
Error Descriptionm & Resolution

1

A connector cannot connect to a compatible database or storage system

Protocol compatibility does not guarantee full compatibility. A derived product may differ in query behavior, APIs, endpoints, or deployment requirements.

Resolution:

  • Confirm the exact product name and version.

  • Collect the official technical documentation and details of any compatibility layer or custom settings.

2

Metadata crawling fails for a SingleStore database

SingleStore is MySQL protocol-compatible, but its metadata behavior has not been validated for the OvalEdge MySQL connector.

Resolution:

  • Record the exact SingleStore version and the metadata operations required.

  • Do not assume that MySQL permissions or queries behave identically in SingleStore.

3

NetSuite Finance metadata is missing

NetSuite Finance use cases are associated with the NetSuite ERP connector, not the NetSuite CRM connector. The ERP connector is in Pilot status with limited coverage and has not been recently validated.

Resolution:

  • Confirm the required Finance objects and use cases.

  • Review the available connector documentation and treat capabilities as subject to validation.

4

A Z Drive location cannot be identified for crawling

The name Z Drive can refer to different products or storage solutions, so connector compatibility cannot be confirmed from the name alone.

Resolution:

  • Identify the product name, vendor, access method, and storage technology.

  • Provide product documentation or a sample location for assessment.

S. No
Error Message
Error Description & Resolution

1

Lineage is missing for YAML files

Automatic lineage parsing for YAML files is not available out of the box. A custom approach may be possible after reviewing the file structure and transformation logic.

Resolution:

  • Collect representative YAML samples and confirm where the files are stored.

  • Document the ETL platform name, version, and transformations described in the files.

2

Lineage is missing for custom Java code

Native automatic lineage extraction from Java code is not currently supported. An AI-based approach may be explored, but complete accuracy is not guaranteed.

Resolution:

  • Confirm which Java files and transformation steps need lineage.

  • Provide representative source code and expected lineage examples for assessment.

3

Lineage is not available for a pilot or beta connector

Pilot and beta connectors may have limited capabilities and may not have been validated against current product versions or environments.

Resolution:

  • Review the connector documentation and its stated capability limits.

  • Confirm the exact source product and version that must be connected.

4

SSAS metadata cannot be crawled from exported files alone

The current SSAS connector uses live connectivity for metadata crawling. Model files such as ASDATABASE or XMLA files are used for lineage building, not for file-based metadata crawling. Profiling requires live access to the SSAS model.

Resolution:

  • Confirm whether live SSAS connectivity is available.

  • If only files are available, identify the required metadata and lineage use cases before planning an alternative.

5

Salesforce lineage or data quality results are unavailable

The current Salesforce integration does not capture enough object flow information for Auto Lineage. Salesforce data structures and SOQL also limit Data Quality coverage compared with SQL systems.

Resolution:

  • Use the connector documentation to confirm the supported metadata and profiling operations.

  • For lineage, assess whether Apex methods or triggers meet the use case; this requires further evaluation.

S. No
Error Message
Error Description & Resolution

1

Profiling runs for an unexpectedly long time

Profiling duration depends on data volume, table size, selected attributes, and the amount of data scanned. Large data volumes can increase processing time and source-system load.

Resolution:

  • Review the selected profiling attributes and whether full or sample profiling is required.

  • Review the profiling schedule and consider smaller batches where supported.

2

A large cataloging workload does not meet expected performance

Processing capacity depends on the number and type of catalog objects, job scheduling frequency, and workload distribution. Horizontal scaling is not configured automatically for job pods.

Resolution:

  • Estimate the number of schemas, tables, reports, columns, and other objects by source system.

  • Document the expected crawl schedule and frequency.

3

A custom reporting application does not appear in the catalog

Applications built with a general programming framework do not receive automatic connector support unless the reporting system is supported.

Resolution:

  • Check whether the reporting product appears in the supported connector documentation.

  • Identify available APIs, SDKs, or export files that contain the required metadata.

4

SAP ECC metadata cannot be retrieved

The SAP Tables integration can retrieve raw table metadata from the underlying SAP ECC database, but the integration is classified as Pilot and may require custom BAPI functions in the SAP environment.

Resolution:

  • Confirm whether the required BAPI functions already exist or need development.

  • Arrange access to an SAP ECC test environment and an SAP subject matter expert for validation.

FAQs

S. No
Question
Answer

1

Does the Apache Airflow connector support Microsoft Entra ID authentication?

  • The current Apache Airflow connector supports Basic Authentication with a username and password against the native Airflow REST API.

  • Microsoft Entra ID authentication is not currently supported.

  • A managed Airflow service that requires Entra ID is not supported out of the box and requires a feasibility assessment for any enhancement.

2

Does OvalEdge support Kerberos authentication?

  • Kerberos authentication is supported for legacy SQL Server environments through the underlying Microsoft JDBC Driver.

  • Windows Authentication can use the configured Active Directory and Kerberos infrastructure.

  • Support for other source systems depends on the connector and its authentication options.

3

What permissions are required for connector setup?

  • Required permissions depend on the source system, authentication method, and connector operations.

  • Common prerequisites include valid credentials, read access to required metadata, access to configured paths, and network connectivity.

  • Review the specific connector guide for required roles, ports, and permissions before validation.

4

Can SharePoint On Premises be connected?

  • The final internal clarification in the supplied table confirms that SharePoint on-premises is supported.

  • Confirm the deployment details and authentication requirements against the applicable connector documentation before setup.

5

Will a server IP address change require a new connector?

  • No, not if the connector uses a DNS name that remains unchanged.

  • If the configured DNS name changes, update the connection details.

  • If the connector uses an IP address and that address changes, update the IP address. The connector does not need to be recreated.

S. No
Question
Answer

1

Can PDF, Word, and text files be previewed?

  • PDF, DOC, DOCX, and TXT preview support is not confirmed as a general capability in the source assessment.

  • The reviewed response explicitly states that DOC, DOCX, and TXT previews are not supported.

  • File cataloging support and file data preview are separate capabilities; confirm the supported file types for the specific connector.

2

Can selective report crawling be used with Power BI?

  • Selective report crawling is not currently supported.

  • Delta crawling is available for Power BI. It avoids fetching subreports, PBIX files, and associated metadata when the main report has not changed since the previous crawl.

  • Delta crawling is not the same as selecting individual reports for crawling.

3

What does Delta crawling do for Power BI?

  • Delta crawling checks whether the main report has changed since the previous crawl.

  • When the report has not changed, the connector avoids fetching associated subreports, PBIX files, and other related metadata.

  • This can reduce unnecessary processing compared with fetching all associated content on every crawl.

4

Can cataloged objects be deleted directly from the application?

  • For connectors that synchronize source objects during a recrawl, removed objects may be deactivated after they are removed from the source and a fresh crawl completes.

  • Some connectors do not provide direct deletion of crawled metadata from the application.

  • Filtering and removal behavior depends on the connector, so review the connector-specific instructions before changing source content.

5

Can JSON and XML files be cataloged?

  • JSON and XML do not require a separate database connector in the described file connector approach.

  • Cataloging can work when these files are stored in a supported file location, such as S3 or an NFS accessible location.

  • Supported operations depend on the file connector and the required metadata or preview capability.

6

Are images supported by the file connector?

  • Image files can be cataloged when stored in S3 or an NFS accessible location, according to the reviewed support assessment.

  • Image cataloging does not mean that image content can be profiled or previewed in every case.

  • Confirm the required operation and file connector before implementation.

7

Can a SharePoint site that uses a /teams/ address be crawled?

  • The current SharePoint connector searches for sites under /sites/ and does not support /teams/ site paths.

  • Entering a /teams/ path or a full Teams site URL in the Site field does not change this behavior.

  • Sites using /sites/ continue to work, subject to normal connection and permission requirements.

S. No
Question
Answer

1

How can connector compatibility be confirmed for a specific product or version?

  • Confirm the exact product name and version or release.

  • Identify whether the product is a standard implementation or a compatible or derived implementation.

  • For compatible products, identify the API or compatibility layer in use.

  • Share official technical documentation and details of custom configurations.

  • Confirm the deployment model, network restrictions, private endpoints, VPNs, firewalls, and allowlists.

2

Does a connector for one product automatically support a compatible product?

  • No. Protocol or query compatibility does not guarantee that every connector feature works.

  • Product versions may differ in SQL behavior, APIs, endpoints, authentication, or deployment architecture.

  • Compatibility must be validated against the specific product version and required use cases.

3

What is needed before requesting a new connector?

  • Identify the source product, version, deployment type, and business use cases.

  • List the objects and metadata required, expected crawl frequency, and lineage needs.

  • Provide official documentation, API or driver details, sample metadata, and access to a representative environment when available.

  • The technical team reviews feasibility, validates key use cases, confirms scope, and then estimates effort and timeline.

4

Can a custom connector be developed for an unsupported application?

  • Yes, subject to technical assessment and source type.

  • The public Connector SDK supports application connectors that crawl metadata and data.

  • Reporting, ETL, and file system connectors are not currently covered by the public SDK and may require OvalEdge-led development.

  • The usual process includes requirements gathering, feasibility review, proof of concept, scope confirmation, development, testing, and documentation.

5

Where is the public Connector SDK documentation available?

  • The SDK and Getting Started guide are available at https://github.com/ovaledge/oe_csp_sdk.

  • Product documentation is available at https://docs.ovaledge.com/.

  • The public SDK scope is limited to application connectors; other source types may require a separate development engagement.

6

Does the S3 connector support non AWS or on premises S3 compatible storage?

  • No. The current S3 connector does not support custom endpoints or non-AWS S3 backends.

  • AWS S3 connection setup uses the configured region and the AWS authentication flow.

  • A nonstandard region or a location response that does not map to a supported AWS region will not work.

7

Can the S3 connector work without AWS STS?

  • No. The current AWS S3 connection validation uses STS to retrieve the AWS account ID.

  • The current implementation does not provide a supported no-STS mode.

8

Can one region be used for buckets in different AWS regions?

  • Provide the correct region for each bucket when buckets are located in different regions.

  • A single fixed region is not appropriate for buckets that belong to different regions.

9

Is SingleStore officially supported through the MySQL connector?

  • SingleStore is not officially supported in the reviewed assessment.

  • MySQL protocol compatibility does not confirm metadata compatibility.

  • Validate the required metadata queries, routine definitions, and permissions against the exact SingleStore version before relying on the connector.

10

What permission is required to retrieve MySQL routine definitions?

  • For MySQL version 8.0.20 or later, the reviewed technical response states that SHOW_ROUTINE is sufficient for the service account to retrieve procedure definitions.

  • The exact SQL commands and permission requirements should be confirmed against the supported MySQL version and connector operations.

  • This permission guidance does not confirm equivalent behavior in SingleStore.

11

Is Percona MySQL confirmed as compatible?

  • Compatibility has not yet been confirmed through environment testing.

  • Identify whether the deployment uses standalone Percona Server or Percona XtraDB Cluster and record the exact version.

  • For a clustered deployment, validate query log visibility across nodes before confirming compatibility.

12

Can Percona MySQL replace standard MySQL for an OvalEdge deployment?

  • Compatibility has not been confirmed through testing.

  • The technical assessment must distinguish between standalone Percona Server and Percona XtraDB Cluster and record the exact version.

  • A local environment test is required before confirming compatibility, particularly where query logs are accessed across cluster nodes.

S. No
Question
Answer

1

What is automatic lineage?

  • Automatic lineage identifies how data moves and changes between supported source systems, transformation tools, databases, and reporting tools.

  • Depending on the connector and source metadata, lineage can show relationships at the table and column level.

  • Lineage availability varies by connector and may require an add-on or a separate lineage build job.

2

Does every standard connector include automatic lineage?

  • No. A standard connector collects supported metadata from a source system.

  • Automatic lineage is an additional capability for supported connectors and use cases.

  • The supported connector documentation identifies the available lineage capabilities and limitations.

3

Can OvalEdge build lineage from YAML files?

  • YAML lineage parsing is not available out of the box.

  • A custom solution may be evaluated after reviewing sample files, their structure, storage location, ETL platform, and transformation logic.

  • Feasibility and accuracy must be assessed before confirming a solution.

4

Can OvalEdge extract lineage from custom Java code?

  • Native automatic lineage extraction from Java code is not currently supported.

  • An AI-based approach may be explored, but complete accuracy cannot be guaranteed.

  • The required source code, expected lineage, and acceptable accuracy should be reviewed before any custom work.

5

Can OvalEdge build lineage from SSAS model files without a live connection?

  • The current SSAS connector uses model files such as ASDATABASE files for lineage building.

  • The files do not currently provide file-based metadata crawling through the connector.

  • Profiling requires live access to the SSAS model.

6

Why might a supported database table be missing from lineage?

  • The related database may not yet be cataloged through its own connector.

  • Lineage may use a temporary table name until the source or target database is cataloged.

  • Catalog the related database and rebuild lineage to resolve the object reference, where supported.

7

What is needed to assess lineage for a pilot connector such as Domo?

  • The feasibility assessment reviews existing connector capabilities, available APIs and metadata, and the requested lineage scenarios.

  • Access to a test environment or representative sample data may be required.

  • An effort estimate can be provided after feasibility and scope are understood; the timeline depends on complexity.

8

Does the Salesforce connector support Auto Lineage?

  • Auto Lineage is currently unsupported for Salesforce because the available cataloged objects do not provide sufficient information to capture data flows.

  • Support for lineage through Apex methods and triggers may be considered in the future, but it is not confirmed as a current capability.

9

Why is Salesforce Data Quality coverage limited?

  • Salesforce data is retrieved through SOQL and REST APIs rather than standard SQL queries.

  • Nested and custom object types, along with the lack of aggregate functions, limit profiling and Data Quality capabilities compared with SQL-based systems.

10

Can OvalEdge derive lineage from custom Java or Spark transformations?

  • Native automatic lineage extraction from custom Java and Spark code is not currently supported in the reviewed assessment.

  • Custom development may be technically assessable, but feasibility and prior implementation are not confirmed by the source information.

  • Representative code, expected lineage, and transformation details are needed for an assessment.

11

Why can profiling take a long time?

  • Profiling duration depends on the number of objects, table sizes, total data volume, selected profiling attributes, and whether full or sample profiling is selected.

  • Profiling a large source can take longer and may place additional load on the source system.

  • Review the required profiling scope and schedule, and share job logs with support if processing remains unexpectedly slow.

12

Can Snowflake Data Metric Function results be displayed in OvalEdge?

  • Support for reading and displaying Snowflake Data Metric Function results requires technical validation against the required OvalEdge version and connector configuration.

  • The expected use case is to associate results with the corresponding catalog tables or columns.

  • An API based approach may also be assessed if direct retrieval is not suitable.

13

Can custom Data Quality integrations use APIs?

  • OvalEdge APIs are one option for custom Data Quality integrations.

  • Other options identified in the technical assessment include LMDF, MCP, and AskEdgi.

  • The suitable approach depends on where the rules run, how results are represented, and how results must map to catalog objects.

14

Does the Apache Airflow connector support Python based DAG lineage?

  • The connector catalogs DAGs and tasks.

  • Automatic lineage for Python-based DAGs is not supported in the reviewed assessment.

  • For SQL-based DAGs, AI-augmented lineage can generate automatic lineage.


Copyright © 2026, OvalEdge LLC, Peachtree Corners, GA, USA.

Last updated

Was this helpful?