{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Troubleshooting Composable Audience Studio for BigQuery","description":"Resolve common issues with BigQuery authentication, Parent Segment uploads, and CAS UI access.","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]},"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"troubleshooting","__idx":0},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bigquery-authentication-fails","__idx":1},"children":["BigQuery Authentication Fails"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Possible Cause"},"children":["Possible Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resolution"},"children":["Resolution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid JSON key"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify the JSON key file contents are valid. Re-download from the GCP Console if needed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service account missing IAM roles"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure the service account has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["roles/bigquery.jobUser"]}," at project level and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["roles/bigquery.dataEditor"]}," at dataset level."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BigQuery API not enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify that the BigQuery API is enabled in your GCP project: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["APIs & Services"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled APIs"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["BigQuery API"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth credentials used instead of JSON key"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only JSON keyfile authentication is supported. OAuth user credentials are not supported for CDW connections used in CAS."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VPC Service Controls blocking access"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If your GCP project uses VPC Service Controls, ensure Treasure AI server IPs are added to the allowed list."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parent-segment-upload-fails","__idx":2},"children":["Parent Segment Upload Fails"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Possible Cause"},"children":["Possible Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resolution"},"children":["Resolution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid JSON"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate your JSON with a linter (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jq . parent_segment_config.json"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wrong ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connectionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm the ID matches your saved BigQuery authentication in Integration Hub. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connectionId"]}," can be found in the URL of the authentication detail page."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dataset or table not found"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify all dataset and table names exist in BigQuery and match exactly (case-sensitive)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing columns"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["keyColumn"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tableKey"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["masterKey"]},", and all ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["column"]}," values exist in the referenced tables."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"segment-counts-show-zero","__idx":3},"children":["Segment Counts Show Zero"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Possible Cause"},"children":["Possible Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resolution"},"children":["Resolution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Empty Customers table"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify the Customers table has data:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"SELECT COUNT(*) FROM `<project>.<dataset>.customers`;\n","lang":"sql"},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Key mismatch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm that unified profile identifier values in Behaviors tables match those in the Customers table."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Permission issues"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure the service account has the required IAM roles on all referenced datasets and tables."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cannot-access-cas-ui","__idx":4},"children":["Cannot Access CAS UI"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Possible Cause"},"children":["Possible Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resolution"},"children":["Resolution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Feature not enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact Customer Success to verify your account has Composable Audience Studio enabled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Browser cache"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clear browser cache and reload the page."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account permissions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact Customer Success to verify your account has CAS permissions."]}]}]}]}]}]},"headings":[{"value":"Troubleshooting","id":"troubleshooting","depth":1},{"value":"BigQuery Authentication Fails","id":"bigquery-authentication-fails","depth":2},{"value":"Parent Segment Upload Fails","id":"parent-segment-upload-fails","depth":2},{"value":"Segment Counts Show Zero","id":"segment-counts-show-zero","depth":2},{"value":"Cannot Access CAS UI","id":"cannot-access-cas-ui","depth":2}],"frontmatter":{"seo":{"title":"Troubleshooting Composable Audience Studio for BigQuery","description":"Resolve common issues with BigQuery authentication, Parent Segment uploads, and CAS UI access."}},"lastModified":"2026-08-14T22:18:35.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/composable-cdp/audience-studio/bigquery/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}