This is legacy documentation, and may not be complete. To see the latest documentation, if you are a marketer, refer to theMarketerssite. If you are a measurement partner, refer to theMeasurement Partnerssite.
Stay organized with collectionsSave and categorize content based on your preferences.
This page describes error messages you might encounter when querying data with Ads Data Hub,
and provides troubleshooting guidance.
Error messages can be found in the following locations:
While editing a query in the Ads Data Hub UI, error messages will appear in the validation
box above the query text. You can expand the error text by clicking onShow
validation.
After running a query that fails to complete, the Details field specific to the job will
contain an error message in the Error field. A list of your recent jobs can be found by
clicking onJobsin the Ads Data Hub UI.
You can retrieve error messages using the Ads Data Hub API, using theoperationsresource.
This table does not include all possible error messages. If you don't see the relevant error
here, or the suggested steps don't resolve the issue,contact
support.
Error message
Description
Troubleshooting
Resources exceeded during query execution:
The query couldn't be executed in the allotted memory.
This error is returned when your query requires too much
memory to execute.
Break up your query into multiple, smaller queries. Then, combine the outputs in
BigQuery. Alternatively, try using temporary tables to split the query up.
Ensure that the larger table is on the left side of anyJOIN.
This error is returned for various reasons. Common causes
of this error include:
A temporary issue or a timeout
Try running your query again.
When usingOFFSET()orORDINAL(), if the index is out of
range
RemoveOFFSET()orORDINAL(), or rewrite, usingSAFE_OFFSET()orSAFE_ORDINAL()instead. (ref.)
When there is a data overflow caused by
re-aggregations.
Avoid re-aggregation in query.
Avoid joining unaggregated to aggregated and then aggregating once more.
When the result has an array which contains aNULLelement
Review BigQueryrulesconcerningNULLelements in arrays.
If none of the these scenarios apply to
your query, reach out toAds Data Hub Supportto diagnose the
error.
Not found: Dataset<myproject:mydataset>was not found in location<regioncode>.
This error is returned when you attempt to output query
results to a BigQuery dataset that is not in the sameregionas your Ads Data Hub
instance.
Re-execute the job, pointing to a dataset that is in the same region as your Ads Data
Hub instance.
Copyorrecreatethe data in a dataset that is in the same region as your Ads Data Hub
instance.
For Ads Data Hub instances in the US or EU, specify themulti-region locationUSorEU; specifying a specific
region, such asus-east1oreurope-west1will cause jobs to
fail.
Ads Data Hub Support cannot modify or
change the region assigned to your Ads Data Hub instance.
Table cannot be accessed in BigQuery.
This error returns during results preview, if you don't
have access to the output table in BigQuery.
Have someone in your organization with the proper credentials in BigQuery grant you
permission to view the table.
Re-execute the query, specifying an output table for which you have permission to
view in BigQuery.
Your query didn't pass Ads Data Hub privacy
checks. Make sure your query meets aggregation requirements and difference checks.
Error code: 0400
This error returns when
query results are insufficiently aggregated or they are too similar to previous results.
Ensure that each result row meets the minimum required user count (50 users in most
cases; 10 users when only clicks and conversions are accessed).
If none of the these scenarios apply to
your query, reach out toAds Data Hub Supportto diagnose the
error.
The query contains<number>user sets, which exceeds the 100000 limit
This error is returned when the query results would
contain
more than the limit of 100,000 user sets. A user set is the most basic unit of protection
in Ads Data Hub. A query gets one user set each time it retrieves data from a user-level
Ads Data Hub table.
Reduce the complexity of the query.
Reduce the number ofJOINs in the query, particularly for user-level Ads
Data Hub tables.
Try querying over a shorter date range.
Break up the query into multiple, smaller queries.
Reminder: Queries that use 1PD tables require that
you update your consent settings.
This error is returned when a query references first-party
data (1PD) tables, if you have not acknowledged that you have obtained user consent.
Temporarily disable DRS on your Google Cloud project to complete UPDM setup. Once
setup is complete, you can re-enable DRS. If you cannot disable DRS due to organizational
policies,reach out to our support teamfor assistance.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-28 UTC."],[[["\u003cp\u003eThis page provides troubleshooting guidance for error messages encountered when querying data with Ads Data Hub.\u003c/p\u003e\n"],["\u003cp\u003eError messages can appear in the Ads Data Hub UI, job details, and through the Ads Data Hub API.\u003c/p\u003e\n"],["\u003cp\u003eCommon error types include resource exceeding, BigQuery errors, data access issues, and privacy violations.\u003c/p\u003e\n"],["\u003cp\u003eSolutions for common errors are offered, including query optimization, data location adjustments, and user consent management.\u003c/p\u003e\n"],["\u003cp\u003eIf you encounter an error not listed or if suggested steps fail to resolve the issue, contact Ads Data Hub Support.\u003c/p\u003e\n"]]],["Ads Data Hub query errors can appear in the UI's validation box, the job's \"Error\" field, or via the API. Common issues include exceeding memory limits, requiring re-execution, or data output region mismatch. Troubleshoot by adjusting query complexity, using smaller data ranges, or rewriting using safer functions. Privacy checks may trigger errors; ensure sufficient data aggregation and user consent when applicable. Errors can also involve data from different services, or having more than 100000 user sets.\n"],null,[]]