Common Errors

If a query encounters an error, the query results return an error name and description instead of query results.

In this section

• Common errors
• Other errors

Common errors

The following errors can occur in your Metadata API query.

Other errors

Some edge names do not exist on CanHaveLabels interface

Starting with Tableau Cloud March 2023 and Tableau Server 2023.1, DataQualityWarning.asset and DataQualityCertification.asset point to the CanHaveLabels interface instead of the Warnable and Certifiable interfaces. Though they share many of the same edge names, some edge names available on the Warnable and Certifiable interfaces do not exist on the CanHaveLabels interface, and queries that use those edges will now produce an error similar to the following:

Validation error of type FieldUndefined: Field 'dataQualityWarnings' in type 'CanHaveLabels' is undefined @ 'dataQualityWarnings/asset/dataQualityWarnings'

The following edges will produce an error like the above if referenced through DataQualityWarning.asset or DataQualityCertification.asset:

• hasActiveWarning
• dataQualityWarnings
• dataQualityWarningsConnection
• isCertified
• dataQualityCertifications
• dataQualityCertificationsConnection

Example query that produces an error:

query myQuery {
  dataQualityWarnings {
    asset {
      dataQualityWarnings {
        message
      }
    }
  }
}

The above query produces an error because the dataQualityWarnings.asset (which points to the CanHaveLabels interface) does not have a field named dataQualityWarnings. Before Tableau Cloud March 2023 and Tableau Server 2023.1, the query did not produce an error because dataQualityWarnings.asset pointed to the Warnable interface, and that interface did have a field named dataQualityWarnings.

The query should be adjusted to either:

• Resolution 1: Use the Labels type
• Resolution 2: use an inline fragment [↗] to match Warnable or Certifiable as required.

Resolution 1: Use the labels edge instead of the dataQualityWarnings edge

query myQuery {
  dataQualityWarnings {
    asset {
      labels {
        message
      }
    }
  }
}

Resolution 2: Use an inline fragment [↗] to limit the interfaces to Warnable

query myQuery {
  dataQualityWarnings {
    asset {
      ... on Warnable {
        dataQualityWarnings {
          message
        }
      }
    }
  }
}