{"Entry":{"collection":"plan","key":"tid-scan","name":"Tid Scan","aliases":["T_TidScan","Tid Scan","TidScan"],"metadata":{"aliases":["T_TidScan","Tid Scan","TidScan"],"category":"Scan","content_hash":"f050641cc364a76dcc1d707717aceaba554f8f2d5534006eb3c8d75f02477c7c","imported_at":"2026-09-30T00:40:44.270476+08:00","name":"Tid Scan","name_zh":"TidScan","slug":"tid-scan","summary":"Fetches table tuples using tuple identifiers."}},"Definition":{"Collection":"plan","Key":"tid-scan","SourceDatabase":"center","Version":"18","SourceTable":"plan_node","SourceKey":"tid-scan","SourceRevision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","Facts":{"comparison_data":{"initializer":"ExecInitTidScan","memory_mechanism":"unclassified","node_tag":"T_TidScan","parallel_callbacks":[],"partial_modes":[],"strategies":[],"text_names":["Tid Scan"]},"comparison_hash":"27c48787ee6973592cca83b0723557b9fe9f8bdc43681359f976103257be5ddf","description":["Fetches table tuples using tuple identifiers."],"evidence_kind":"source and documentation","explain_names":["Tid Scan"],"explain_prefixes":["Parallel","Async"],"facts":[{"label":"Core node tag","value":"T_TidScan"},{"label":"Structured EXPLAIN Node Type","value":"Tid Scan"},{"label":"Inputs","value":"A relation and tuple identifiers"},{"label":"Output","value":"Selected table tuples"},{"label":"Executor initializer","value":"ExecInitTidScan"},{"label":"Memory mechanism","value":"unclassified"}],"memory":{"description":"This extraction does not assign a universal memory limit or spill policy to this node. Inspect the same-build implementation and its expressions or provider.","evidence":[{"archive_sha256":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","label":"src/backend/executor/nodeTidscan.c","path":"src/backend/executor/nodeTidscan.c","sha256":"1cbb79fe5ad3964149cac33cac91f5929f881feae4a415674e45c3e6d1b9451f","url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"}],"mechanism":"unclassified","source_notes":[]},"node_tag":"T_TidScan","parallel_callbacks":[],"partial_modes":[],"related":[{"label":"EXPLAIN","url":"/wiki/sql/explain/?v=18"},{"label":"Using EXPLAIN","url":"/docs/18/using-explain.html"},{"label":"Parallel plans","url":"/docs/18/parallel-plans.html"},{"label":"enable_tidscan","url":"/wiki/guc/enable_tidscan/?v=18"}],"release":{"channel":"stable","label":"18.6","major":"18","ref":"PostgreSQL 18.6 source archive","revision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","source_snapshot_utc":"","source_url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"},"runtime_verified":false,"sections":[{"paragraphs":["Structured formats use the Node Type above. Text-format spellings can also include operation, strategy, join type, scan direction or aggregation-stage attributes.","Text names recorded by this source: Tid Scan.","Parallel-aware and parallel-safe are different plan properties. A node running inside a parallel worker is not necessarily a parallel-aware node."],"title":"EXPLAIN names and attributes"},{"paragraphs":["This extraction does not assign a universal memory limit or spill policy to this node. Inspect the same-build implementation and its expressions or provider."],"title":"Memory and temporary storage"},{"paragraphs":["The source callbacks below can coordinate execution or collect worker instrumentation. Their presence is not a blanket claim that this node supports a shared parallel scan or shared state.","Callbacks in this build: none extracted from this node implementation."],"title":"Parallel execution and instrumentation"},{"paragraphs":["nodeTidscan.c Routines to support direct tid scans of relations","ExecTidScan scans a relation using tids ExecInitTidScan creates and initializes state info. ExecReScanTidScan rescans the tid relation. ExecEndTidScan releases all storage.","It's sufficient to check varattno to identify the CTID variable, as any Var in the relation scan qual must be for our table. (Even if it's a parameterized scan referencing some other table's CTID, the other table's Var would have become a Param by the time it gets here.)","Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.","CURRENT OF is a special case that we can't compile usefully; just drop it into the TidExpr list as-is."],"title":"Executor implementation notes"},{"code":"case T_TidScan:\n\t\t\tpname = sname = \"Tid Scan\";\n\t\t\tbreak;","title":"EXPLAIN identity in core source"}],"source_inventory":{"executor":"src/backend/executor/execProcnode.c","explain":"src/backend/commands/explain.c","implementation":"src/backend/executor/nodeTidscan.c"},"sources":[{"archive_sha256":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","label":"src/backend/commands/explain.c:1456","line":1456,"path":"src/backend/commands/explain.c","sha256":"34c86d6070224a0e981efef51f79101d6d505e5874f1684ace183034bab14bb4","url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"},{"archive_sha256":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","label":"src/backend/executor/execProcnode.c:239","line":239,"path":"src/backend/executor/execProcnode.c","sha256":"f8a06a3f539077249b20664b2812433db6d7bd12b2c0ca633525db43d06f112a","url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"},{"archive_sha256":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","label":"src/backend/executor/nodeTidscan.c","path":"src/backend/executor/nodeTidscan.c","sha256":"1cbb79fe5ad3964149cac33cac91f5929f881feae4a415674e45c3e6d1b9451f","url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"},{"archive_sha256":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","label":"src/include/nodes/plannodes.h","path":"src/include/nodes/plannodes.h","sha256":"52422b327a8049fbbb20d8b96008a0fc0a6fafa60f7eff3c695d5b2e83830120","url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"}],"strategies":[],"tables":[{"columns":[{"key":"label","label":"Text-format label"},{"key":"identity","label":"Structured node identity"}],"key":"explain-labels","rows":[{"identity":"Tid Scan","label":"Tid Scan"}],"title":"EXPLAIN labels in this source build"}]},"ManualEvidence":{"release":{"channel":"stable","label":"18.6","major":"18","ref":"PostgreSQL 18.6 source archive","revision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","source_snapshot_utc":"","source_url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"},"sources":[{"archive_sha256":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","label":"src/backend/commands/explain.c:1456","line":1456,"path":"src/backend/commands/explain.c","sha256":"34c86d6070224a0e981efef51f79101d6d505e5874f1684ace183034bab14bb4","url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"},{"archive_sha256":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","label":"src/backend/executor/execProcnode.c:239","line":239,"path":"src/backend/executor/execProcnode.c","sha256":"f8a06a3f539077249b20664b2812433db6d7bd12b2c0ca633525db43d06f112a","url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"},{"archive_sha256":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","label":"src/backend/executor/nodeTidscan.c","path":"src/backend/executor/nodeTidscan.c","sha256":"1cbb79fe5ad3964149cac33cac91f5929f881feae4a415674e45c3e6d1b9451f","url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"},{"archive_sha256":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","label":"src/include/nodes/plannodes.h","path":"src/include/nodes/plannodes.h","sha256":"52422b327a8049fbbb20d8b96008a0fc0a6fafa60f7eff3c695d5b2e83830120","url":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2"}]},"MeasuredEvidence":{"runtime_verified":false}},"Text":{"Collection":"plan","Key":"tid-scan","SourceDatabase":"center","Version":"18","Locale":"en","Title":"Tid Scan","Summary":"Fetches table tuples using tuple identifiers.","BodyHTML":"\u003cp\u003eFetches table tuples using tuple identifiers.\u003c/p\u003e","SourceRevision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","ContentHash":"e22d7d7c8d09090911fa56998dc6cf6bb80734ebf0522d7688866bb9ebb7dc77","Payload":{"description":["Fetches table tuples using tuple identifiers."],"related":[{"label":"EXPLAIN","url":"/wiki/sql/explain/?v=18"},{"label":"Using EXPLAIN","url":"/docs/18/using-explain.html"},{"label":"Parallel plans","url":"/docs/18/parallel-plans.html"},{"label":"enable_tidscan","url":"/wiki/guc/enable_tidscan/?v=18"}],"sections":[{"paragraphs":["Structured formats use the Node Type above. Text-format spellings can also include operation, strategy, join type, scan direction or aggregation-stage attributes.","Text names recorded by this source: Tid Scan.","Parallel-aware and parallel-safe are different plan properties. A node running inside a parallel worker is not necessarily a parallel-aware node."],"title":"EXPLAIN names and attributes"},{"paragraphs":["This extraction does not assign a universal memory limit or spill policy to this node. Inspect the same-build implementation and its expressions or provider."],"title":"Memory and temporary storage"},{"paragraphs":["The source callbacks below can coordinate execution or collect worker instrumentation. Their presence is not a blanket claim that this node supports a shared parallel scan or shared state.","Callbacks in this build: none extracted from this node implementation."],"title":"Parallel execution and instrumentation"},{"paragraphs":["nodeTidscan.c Routines to support direct tid scans of relations","ExecTidScan scans a relation using tids ExecInitTidScan creates and initializes state info. ExecReScanTidScan rescans the tid relation. ExecEndTidScan releases all storage.","It's sufficient to check varattno to identify the CTID variable, as any Var in the relation scan qual must be for our table. (Even if it's a parameterized scan referencing some other table's CTID, the other table's Var would have become a Param by the time it gets here.)","Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.","CURRENT OF is a special case that we can't compile usefully; just drop it into the TidExpr list as-is."],"title":"Executor implementation notes"},{"code":"case T_TidScan:\n\t\t\tpname = sname = \"Tid Scan\";\n\t\t\tbreak;","title":"EXPLAIN identity in core source"}],"tables":[{"columns":[{"key":"label","label":"Text-format label"},{"key":"identity","label":"Structured node identity"}],"key":"explain-labels","rows":[{"identity":"Tid Scan","label":"Tid Scan"}],"title":"EXPLAIN labels in this source build"}]}},"RequestedLocale":"zh-Hans","Fallback":true,"Versions":["10","11","12","13","14","15","16","17","18","19","20"],"Locales":["en"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}