{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Limitations","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","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":"limitations","__idx":0},"children":["Limitations"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"maximum-number-of-keys-in-key_columns","__idx":1},"children":["Maximum Number of Keys in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key_columns"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The maximum number of keys that can be specified in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key_columns:"]}," for each table within ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tables:"]}," is 32."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"tables:\n  - database: prod\n    table: pageviews\n    key_columns:\n      - {column: td_client_id, key: td_client_id}\n      # Up to 32 keys can be listed\n\n  - database: brand2\n    table: pageviews\n    as: brand2_pageviews\n    key_columns:\n      - {column: td_client_id, key: td_client_id}\n      - {column: td_global_id, key: td_global_id}\n      - {column: email, key: email}\n      # Up to 32 keys can be listed\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"maximum-number-of-tables-in-tables","__idx":2},"children":["Maximum Number of Tables in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tables"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The maximum number of tables that can be listed under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tables:"]}," is 255."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"maximum-occurrences-of-a-key-in-tables","__idx":3},"children":["Maximum Occurrences of a Key in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tables"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The maximum number of times a key can appear across all tables listed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tables:"]}," is 32. Exceeding this limit will result in an error."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"keys:\n  - name: td_client_id\n    invalid_texts: ['']\n\n  - name: td_global_id\n    valid_regexp: \"3rd_*\"\n    invalid_texts: ['']\n\n  - name: email\n    valid_regexp: \".*@.*\"\n    invalid_texts: ['']\n\n# Error occurs because td_client_id, td_global_id, and email appear 33 times\ntables:\n  - database: db1\n    table: pageviews\n    key_columns:\n      - {column: td_client_id, key: td_client_id}\n      - {column: td_global_id, key: td_global_id}\n      - {column: email, key: email}\n\n  - database: db2\n    table: pageviews\n    key_columns:\n      - {column: td_client_id, key: td_client_id}\n      - {column: td_global_id, key: td_global_id}\n      - {column: email, key: email}\n...\n  - database: db33\n    table: pageviews\n    key_columns:\n      - {column: td_client_id, key: td_client_id}\n      - {column: td_global_id, key: td_global_id}\n      - {column: email, key: email}\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"restrictions-on-do_not_merge_key-and-merge_by_keys","__idx":4},"children":["Restrictions on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["do_not_merge_key"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merge_by_keys"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["do_not_merge_key:"]},", the key specified in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["do_not_merge_key:"]}," must be listed as the first (highest-priority) element in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merge_by_keys:"]},". Failure to follow this rule will result in the following error:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"400 Bad Request: {\"canonical_ids[0].do_not_merge_key\": [\"must be the first element of merge_by_keys\"]}\n"},"children":[]}]},"headings":[{"value":"Limitations","id":"limitations","depth":1},{"value":"Maximum Number of Keys in key_columns","id":"maximum-number-of-keys-in-key_columns","depth":2},{"value":"Maximum Number of Tables in tables","id":"maximum-number-of-tables-in-tables","depth":2},{"value":"Maximum Occurrences of a Key in tables","id":"maximum-occurrences-of-a-key-in-tables","depth":2},{"value":"Restrictions on do_not_merge_key and merge_by_keys","id":"restrictions-on-do_not_merge_key-and-merge_by_keys","depth":2}],"frontmatter":{"seo":{"title":"Limitations"}},"lastModified":"2026-02-17T01:46:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/products/customer-data-platform/id-unification/p10_limitations","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}