{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"About persistent_id","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":"about-persistent_id","__idx":0},"children":["About ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As mentioned in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/id-unification/p3_canonical_id_learning"},"children":["About ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," is not guaranteed to be immutable. In some cases, a different ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," may be assigned to a user who was previously identified as the same person."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To address this issue, a different mechanism has been introduced to maintain an persistency, robust value similar to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]},". This is called ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]},". This page introduces the characteristics of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," and explains how to configure it."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," is used instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]},", users do not need to set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merge_by_keys:"]}," to obtain an robust ID."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," is not supported by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ja/products/customer-data-platform/id-unification/p6_do_not_merge"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["do_not_merge_key"]}]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mechanism-for-persistent_id-to-retain-a-robust-value","__idx":1},"children":["Mechanism for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," to Retain a Robust Value"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The mechanism for generating values for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," is illustrated using the following examples:"]},{"$$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":"Day"},"children":["Day"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"td_client_id"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_client_id"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"td_global_id"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_global_id"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-01"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_002"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3rd_001"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-02"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3rd_001"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," can be configured as follows:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"canonical_ids:\n  - name: cid\n    merge_by_keys: [td_client_id, td_global_id]\n\npersistent_ids:\n  - name: pid\n    merge_by_keys: [td_client_id, td_global_id]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-canonical_id-is-generated","__idx":2},"children":["How ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," is Generated"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under this configuration, the smallest value in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_client_id"]}," (in this case, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aaa_001"]},") is selected as the leader, and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," is generated based on this value."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-persistent_id-is-generated","__idx":3},"children":["How ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," is Generated"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]},", the smallest value in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_client_id"]}," in terms of time is chosen as the leader. In this example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aaa_002"]}," is the leader, and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," is generated based on this value."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-1-daily-transition-of-key-values-selected-as-leader","__idx":4},"children":["Example 1: Daily Transition of Key Values Selected as Leader"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To understand how ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," is generated, let’s examine the transition of the leader as new data is added each day."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"day-1","__idx":5},"children":["Day 1"]},{"$$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":"Day"},"children":["Day"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"td_client_id"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_client_id"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"td_global_id"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_global_id"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-01"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_002"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3rd_001"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The leaders for each ID on Day 1 are as follows:"]},{"$$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":"Day"},"children":["Day"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( canonical_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( persistent_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-01"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_002"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_002"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"day-2","__idx":6},"children":["Day 2"]},{"$$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":"Day"},"children":["Day"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"td_client_id"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_client_id"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"td_global_id"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_global_id"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-01"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_002"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3rd_001"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-02"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3rd_001"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On Day 2, the leaders are as follows:"]},{"$$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":"Day"},"children":["Day"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( canonical_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( persistent_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-01"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_002"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_002"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-02"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_002"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The leader for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," changes from the previous day, resulting in a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," value. However, the leader for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," remains unchanged, so the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," value is retained."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This mechanism ensures that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," remains persistent by always selecting the smallest value based on time, ensuring the leader does not change regardless of new key values."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-2-behavior-when-two-individuals-are-linked","__idx":7},"children":["Example 2: Behavior When Two Individuals Are Linked"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When two individuals are linked, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," ensures that the value of the earlier key remains as the leader. Consider the following example:"]},{"$$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":"Day"},"children":["Day"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"site_aaa"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site_aaa"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"site_aaa"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site_aaa"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"site_bbb"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site_bbb"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"site_bbb"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site_bbb"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_client_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_global_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_client_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_global_id"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-01"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bbb_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3rd_001"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-02"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3rd_002"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-03"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3rd_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"day-2-1","__idx":8},"children":["Day 2"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"person-1","__idx":9},"children":["Person 1"]},{"$$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":"Day"},"children":["Day"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( canonical_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( persistent_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-02"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bbb_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bbb_001"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"person-2","__idx":10},"children":["Person 2"]},{"$$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":"Day"},"children":["Day"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( canonical_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( persistent_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-02"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_001"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"day-3","__idx":11},"children":["Day 3"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When Person 1 and Person 2 are linked on Day 3:"]},{"$$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":"Day"},"children":["Day"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( canonical_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Leader ( persistent_id )"},"children":["Leader (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2024-03-03"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["aaa_001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bbb_001"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this case, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," merges into the leader of Person 1, while ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," merges into the leader of Person 2."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cases-where-persistent_id-may-change","__idx":12},"children":["Cases Where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," May Change"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two scenarios where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," can change:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["When past records are added or deleted:"]}," Changes to past records may affect the leader selection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time"]}," is deprioritized in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merge_by_keys:"]},":"]}," The key priority can be explicitly set to override ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For instance:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"persistent_ids:\n  - name: pid\n    merge_by_keys: [td_client_id, time, td_global_id]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This configuration prioritizes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_client_id"]}," over ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time"]},", potentially leading to changes in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]}," value when higher-priority keys are introduced later."]}]},"headings":[{"value":"About persistent_id","id":"about-persistent_id","depth":1},{"value":"Mechanism for persistent_id to Retain a Robust Value","id":"mechanism-for-persistent_id-to-retain-a-robust-value","depth":2},{"value":"How canonical_id is Generated","id":"how-canonical_id-is-generated","depth":3},{"value":"How persistent_id is Generated","id":"how-persistent_id-is-generated","depth":3},{"value":"Example 1: Daily Transition of Key Values Selected as Leader","id":"example-1-daily-transition-of-key-values-selected-as-leader","depth":2},{"value":"Day 1","id":"day-1","depth":3},{"value":"Day 2","id":"day-2","depth":3},{"value":"Example 2: Behavior When Two Individuals Are Linked","id":"example-2-behavior-when-two-individuals-are-linked","depth":2},{"value":"Day 2","id":"day-2-1","depth":3},{"value":"Person 1","id":"person-1","depth":4},{"value":"Person 2","id":"person-2","depth":4},{"value":"Day 3","id":"day-3","depth":3},{"value":"Cases Where persistent_id May Change","id":"cases-where-persistent_id-may-change","depth":2}],"frontmatter":{"seo":{"title":"About persistent_id"}},"lastModified":"2026-02-17T01:46:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/products/customer-data-platform/id-unification/p8_persistent_id","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}