{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Troubleshooting Composable Audience Studio for Databricks","description":"Resolve common issues with Databricks authentication, Parent Segment uploads, and CAS UI access.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","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":"databricks-authentication-fails","__idx":1},"children":["Databricks 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 PAT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify the PAT is still valid and has not expired. Regenerate if needed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service principal not in workspace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure the service principal has been added to the workspace."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incorrect hostname"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm the Databricks workspace hostname format (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dbc-e1c6a646-1e07.cloud.databricks.com"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incorrect HTTP path"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify the SQL warehouse or cluster HTTP path in Databricks workspace settings."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["IP access list blocking"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure Treasure Data server IPs are added to the Databricks allow list."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pat-creation-fails-for-service-principal","__idx":2},"children":["PAT Creation Fails for Service Principal"]},{"$$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":["\"User does not have permission to use tokens\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The initial PAT must be created by a workspace admin using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["databricks token-management create-obo-token"]},". Service principals cannot create their own first token."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth M2M profile used instead of admin profile"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use an admin profile (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--profile <admin-profile>"]},") when running the OBO command, not the service principal's OAuth profile."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parent-segment-upload-fails","__idx":3},"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 Databricks 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":["Missing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["catalog"]}," field"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Databricks requires the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["catalog"]}," field in master, attributes, and behaviors definitions. Ensure it is present in all entries."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Table/schema/catalog not found"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify all catalog, schema, and table names exist in Databricks 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":4},"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":["Empty Customers table"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify the Customers table has data: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELECT COUNT(*) FROM <catalog>.<schema>.customers;"]}]}]},{"$$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 principal has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELECT"]}," on all referenced tables in Unity Catalog."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cannot-access-cas-ui","__idx":5},"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":"Databricks Authentication Fails","id":"databricks-authentication-fails","depth":2},{"value":"PAT Creation Fails for Service Principal","id":"pat-creation-fails-for-service-principal","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 Databricks","description":"Resolve common issues with Databricks authentication, Parent Segment uploads, and CAS UI access."}},"lastModified":"2026-04-13T00:18:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/products/customer-data-platform/composable-cdp/databricks/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}