{"kind": "plan", "major": "18", "item": {"slug": "tid-range-scan", "name": "Tid Range Scan", "name_zh": "TidRangeScan", "category": "Scan", "summary": "Scans a relation over a range of tuple identifiers.", "aliases": ["T_TidRangeScan", "Tid Range Scan", "TidRangeScan"], "content_hash": "a0fbec00e321de32546acaa760891c2bcd32bbd4bdeef35bdc06ca231349d40c", "versions": {"14": {"facts": [{"label": "Core node tag", "value": "T_TidRangeScan"}, {"label": "Structured EXPLAIN Node Type", "value": "Tid Range Scan"}, {"label": "Inputs", "value": "A relation and tuple-identifier bounds"}, {"label": "Output", "value": "Selected table tuples"}, {"label": "Executor initializer", "value": "ExecInitTidRangeScan"}, {"label": "Memory mechanism", "value": "unclassified"}], "memory": {"evidence": [{"url": "https://ftp.postgresql.org/pub/source/v14.24/postgresql-14.24.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "2c5ba7e2ff8c5833c42d3ccbd371ea81589e8161ed103814665107ab04a143fb", "archive_sha256": "a7fa7ed3d558172355f51406097a7bd4f6b473be80f311ef7cda96bf383d8897"}], "mechanism": "unclassified", "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.", "source_notes": []}, "tables": [{"key": "explain-labels", "rows": [{"label": "Tid Range Scan", "identity": "Tid Range Scan"}], "title": "EXPLAIN labels in this source build", "columns": [{"key": "label", "label": "Text-format label"}, {"key": "identity", "label": "Structured node identity"}]}], "related": [{"url": "/wiki/sql/explain/?v=14", "label": "EXPLAIN"}, {"url": "/docs/14/using-explain.html", "label": "Using EXPLAIN"}, {"url": "/docs/14/parallel-plans.html", "label": "Parallel plans"}, {"url": "/wiki/guc/enable_tidscan/?v=14", "label": "enable_tidscan"}], "release": {"ref": "PostgreSQL 14.24 source archive", "label": "14.24", "major": "14", "channel": "stable", "revision": "a7fa7ed3d558172355f51406097a7bd4f6b473be80f311ef7cda96bf383d8897", "source_url": "https://ftp.postgresql.org/pub/source/v14.24/postgresql-14.24.tar.bz2", "source_snapshot_utc": ""}, "sources": [{"url": "https://ftp.postgresql.org/pub/source/v14.24/postgresql-14.24.tar.bz2", "line": 1249, "path": "src/backend/commands/explain.c", "label": "src/backend/commands/explain.c:1249", "sha256": "e091be4e2a083b8dea39ccd09beedede22c1716ef974da66c214a44f48be8c41", "archive_sha256": "a7fa7ed3d558172355f51406097a7bd4f6b473be80f311ef7cda96bf383d8897"}, {"url": "https://ftp.postgresql.org/pub/source/v14.24/postgresql-14.24.tar.bz2", "line": 244, "path": "src/backend/executor/execProcnode.c", "label": "src/backend/executor/execProcnode.c:244", "sha256": "72da1c5ad457f1d92a39ab73531701794df858419e3b89d6e6cb7079634e68fa", "archive_sha256": "a7fa7ed3d558172355f51406097a7bd4f6b473be80f311ef7cda96bf383d8897"}, {"url": "https://ftp.postgresql.org/pub/source/v14.24/postgresql-14.24.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "2c5ba7e2ff8c5833c42d3ccbd371ea81589e8161ed103814665107ab04a143fb", "archive_sha256": "a7fa7ed3d558172355f51406097a7bd4f6b473be80f311ef7cda96bf383d8897"}, {"url": "https://ftp.postgresql.org/pub/source/v14.24/postgresql-14.24.tar.bz2", "path": "src/include/nodes/plannodes.h", "label": "src/include/nodes/plannodes.h", "sha256": "302f51a16b570dba7ec4e7bc045f7df5800d21630280354d1a24025f3baec75d", "archive_sha256": "a7fa7ed3d558172355f51406097a7bd4f6b473be80f311ef7cda96bf383d8897"}], "node_tag": "T_TidRangeScan", "sections": [{"title": "EXPLAIN names and attributes", "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 Range 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": "Memory and temporary storage", "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": "Parallel execution and instrumentation", "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": "Executor implementation notes", "paragraphs": ["nodeTidrangescan.c Routines to support TID range scans of relations", "For the given 'expr', build and return an appropriate TidOpExpr taking into account the expr's operator and operand order.", "Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.", "Compute and set node's block and offset range to scan by evaluating the trss_tidexprs. Returns false if we detect the range cannot contain any tuples. Returns true if it's possible for the range to contain tuples.", "Set the upper and lower bounds to the absolute limits of the range of the ItemPointer type. Below we'll try to narrow this range on either side by looking at the TidOpExprs."]}, {"code": "case T_TidRangeScan:\n\t\t\tpname = sname = \"Tid Range Scan\";\n\t\t\tbreak;", "title": "EXPLAIN identity in core source"}], "strategies": [], "description": ["Scans a relation over a range of tuple identifiers."], "evidence_kind": "source and documentation", "explain_names": ["Tid Range Scan"], "partial_modes": [], "comparison_data": {"node_tag": "T_TidRangeScan", "strategies": [], "text_names": ["Tid Range Scan"], "initializer": "ExecInitTidRangeScan", "partial_modes": [], "memory_mechanism": "unclassified", "parallel_callbacks": []}, "comparison_hash": "fc2e690009eada98b87b1cebea56efd35a688fbd53c168572df67f03a1bde70e", "explain_prefixes": ["Parallel", "Async"], "runtime_verified": false, "source_inventory": {"explain": "src/backend/commands/explain.c", "executor": "src/backend/executor/execProcnode.c", "implementation": "src/backend/executor/nodeTidrangescan.c"}, "parallel_callbacks": []}, "15": {"facts": [{"label": "Core node tag", "value": "T_TidRangeScan"}, {"label": "Structured EXPLAIN Node Type", "value": "Tid Range Scan"}, {"label": "Inputs", "value": "A relation and tuple-identifier bounds"}, {"label": "Output", "value": "Selected table tuples"}, {"label": "Executor initializer", "value": "ExecInitTidRangeScan"}, {"label": "Memory mechanism", "value": "unclassified"}], "memory": {"evidence": [{"url": "https://ftp.postgresql.org/pub/source/v15.19/postgresql-15.19.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "2b5068feab07987678b326aff3a5ee61d8b02b37d2a9d6636e62a19a83dc2385", "archive_sha256": "e1a64a87a46b825b88c082e4518161a47aab53c45694964f8ba1df28f7859f89"}], "mechanism": "unclassified", "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.", "source_notes": []}, "tables": [{"key": "explain-labels", "rows": [{"label": "Tid Range Scan", "identity": "Tid Range Scan"}], "title": "EXPLAIN labels in this source build", "columns": [{"key": "label", "label": "Text-format label"}, {"key": "identity", "label": "Structured node identity"}]}], "related": [{"url": "/wiki/sql/explain/?v=15", "label": "EXPLAIN"}, {"url": "/docs/15/using-explain.html", "label": "Using EXPLAIN"}, {"url": "/docs/15/parallel-plans.html", "label": "Parallel plans"}, {"url": "/wiki/guc/enable_tidscan/?v=15", "label": "enable_tidscan"}], "release": {"ref": "PostgreSQL 15.19 source archive", "label": "15.19", "major": "15", "channel": "stable", "revision": "e1a64a87a46b825b88c082e4518161a47aab53c45694964f8ba1df28f7859f89", "source_url": "https://ftp.postgresql.org/pub/source/v15.19/postgresql-15.19.tar.bz2", "source_snapshot_utc": ""}, "sources": [{"url": "https://ftp.postgresql.org/pub/source/v15.19/postgresql-15.19.tar.bz2", "line": 1252, "path": "src/backend/commands/explain.c", "label": "src/backend/commands/explain.c:1252", "sha256": "bb3b442d0f1b098aa8707335250102f027a596cd94117308bd16d1d36b258f5c", "archive_sha256": "e1a64a87a46b825b88c082e4518161a47aab53c45694964f8ba1df28f7859f89"}, {"url": "https://ftp.postgresql.org/pub/source/v15.19/postgresql-15.19.tar.bz2", "line": 244, "path": "src/backend/executor/execProcnode.c", "label": "src/backend/executor/execProcnode.c:244", "sha256": "19836c50a272741a4eac653541e655437c2e00710a541e5348d6a277d0669d7c", "archive_sha256": "e1a64a87a46b825b88c082e4518161a47aab53c45694964f8ba1df28f7859f89"}, {"url": "https://ftp.postgresql.org/pub/source/v15.19/postgresql-15.19.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "2b5068feab07987678b326aff3a5ee61d8b02b37d2a9d6636e62a19a83dc2385", "archive_sha256": "e1a64a87a46b825b88c082e4518161a47aab53c45694964f8ba1df28f7859f89"}, {"url": "https://ftp.postgresql.org/pub/source/v15.19/postgresql-15.19.tar.bz2", "path": "src/include/nodes/plannodes.h", "label": "src/include/nodes/plannodes.h", "sha256": "fb4a4c8165495299131173680bc02a950d88e1ff610231fd97997bc0c9afc1d7", "archive_sha256": "e1a64a87a46b825b88c082e4518161a47aab53c45694964f8ba1df28f7859f89"}], "node_tag": "T_TidRangeScan", "sections": [{"title": "EXPLAIN names and attributes", "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 Range 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": "Memory and temporary storage", "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": "Parallel execution and instrumentation", "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": "Executor implementation notes", "paragraphs": ["nodeTidrangescan.c Routines to support TID range scans of relations", "For the given 'expr', build and return an appropriate TidOpExpr taking into account the expr's operator and operand order.", "Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.", "Compute and set node's block and offset range to scan by evaluating the trss_tidexprs. Returns false if we detect the range cannot contain any tuples. Returns true if it's possible for the range to contain tuples.", "Set the upper and lower bounds to the absolute limits of the range of the ItemPointer type. Below we'll try to narrow this range on either side by looking at the TidOpExprs."]}, {"code": "case T_TidRangeScan:\n\t\t\tpname = sname = \"Tid Range Scan\";\n\t\t\tbreak;", "title": "EXPLAIN identity in core source"}], "strategies": [], "description": ["Scans a relation over a range of tuple identifiers."], "evidence_kind": "source and documentation", "explain_names": ["Tid Range Scan"], "partial_modes": [], "comparison_data": {"node_tag": "T_TidRangeScan", "strategies": [], "text_names": ["Tid Range Scan"], "initializer": "ExecInitTidRangeScan", "partial_modes": [], "memory_mechanism": "unclassified", "parallel_callbacks": []}, "comparison_hash": "fc2e690009eada98b87b1cebea56efd35a688fbd53c168572df67f03a1bde70e", "explain_prefixes": ["Parallel", "Async"], "runtime_verified": false, "source_inventory": {"explain": "src/backend/commands/explain.c", "executor": "src/backend/executor/execProcnode.c", "implementation": "src/backend/executor/nodeTidrangescan.c"}, "parallel_callbacks": []}, "16": {"facts": [{"label": "Core node tag", "value": "T_TidRangeScan"}, {"label": "Structured EXPLAIN Node Type", "value": "Tid Range Scan"}, {"label": "Inputs", "value": "A relation and tuple-identifier bounds"}, {"label": "Output", "value": "Selected table tuples"}, {"label": "Executor initializer", "value": "ExecInitTidRangeScan"}, {"label": "Memory mechanism", "value": "unclassified"}], "memory": {"evidence": [{"url": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "e2ab5a1f5addbfc54a281de62b1fc826489c2fc85aae1953a81b993b0107b288", "archive_sha256": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed"}], "mechanism": "unclassified", "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.", "source_notes": []}, "tables": [{"key": "explain-labels", "rows": [{"label": "Tid Range Scan", "identity": "Tid Range Scan"}], "title": "EXPLAIN labels in this source build", "columns": [{"key": "label", "label": "Text-format label"}, {"key": "identity", "label": "Structured node identity"}]}], "related": [{"url": "/wiki/sql/explain/?v=16", "label": "EXPLAIN"}, {"url": "/docs/16/using-explain.html", "label": "Using EXPLAIN"}, {"url": "/docs/16/parallel-plans.html", "label": "Parallel plans"}, {"url": "/wiki/guc/enable_tidscan/?v=16", "label": "enable_tidscan"}], "release": {"ref": "PostgreSQL 16.15 source archive", "label": "16.15", "major": "16", "channel": "stable", "revision": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed", "source_url": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "source_snapshot_utc": ""}, "sources": [{"url": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "line": 1285, "path": "src/backend/commands/explain.c", "label": "src/backend/commands/explain.c:1285", "sha256": "8e017f0116dbea471339b40c37a667cc9f95039e7e0329c783e5e8ce194de7e1", "archive_sha256": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed"}, {"url": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "line": 244, "path": "src/backend/executor/execProcnode.c", "label": "src/backend/executor/execProcnode.c:244", "sha256": "e48c08e555f8cb4e4bb43df516c4b8906ce9bc374b2a745d98a1fc8c22cc5099", "archive_sha256": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed"}, {"url": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "e2ab5a1f5addbfc54a281de62b1fc826489c2fc85aae1953a81b993b0107b288", "archive_sha256": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed"}, {"url": "https://ftp.postgresql.org/pub/source/v16.15/postgresql-16.15.tar.bz2", "path": "src/include/nodes/plannodes.h", "label": "src/include/nodes/plannodes.h", "sha256": "97db47353db76326b874589a5ad0a04501cc74cd72e237e7bd956e7472c41f1f", "archive_sha256": "c1575341fa7bd40f5274ea465b34390f4dc64cdd0770af327005caaeb9f6b7ed"}], "node_tag": "T_TidRangeScan", "sections": [{"title": "EXPLAIN names and attributes", "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 Range 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": "Memory and temporary storage", "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": "Parallel execution and instrumentation", "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": "Executor implementation notes", "paragraphs": ["nodeTidrangescan.c Routines to support TID range scans of relations", "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.)", "For the given 'expr', build and return an appropriate TidOpExpr taking into account the expr's operator and operand order.", "Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.", "Compute and set node's block and offset range to scan by evaluating the trss_tidexprs. Returns false if we detect the range cannot contain any tuples. Returns true if it's possible for the range to contain tuples."]}, {"code": "case T_TidRangeScan:\n\t\t\tpname = sname = \"Tid Range Scan\";\n\t\t\tbreak;", "title": "EXPLAIN identity in core source"}], "strategies": [], "description": ["Scans a relation over a range of tuple identifiers."], "evidence_kind": "source and documentation", "explain_names": ["Tid Range Scan"], "partial_modes": [], "comparison_data": {"node_tag": "T_TidRangeScan", "strategies": [], "text_names": ["Tid Range Scan"], "initializer": "ExecInitTidRangeScan", "partial_modes": [], "memory_mechanism": "unclassified", "parallel_callbacks": []}, "comparison_hash": "fc2e690009eada98b87b1cebea56efd35a688fbd53c168572df67f03a1bde70e", "explain_prefixes": ["Parallel", "Async"], "runtime_verified": false, "source_inventory": {"explain": "src/backend/commands/explain.c", "executor": "src/backend/executor/execProcnode.c", "implementation": "src/backend/executor/nodeTidrangescan.c"}, "parallel_callbacks": []}, "17": {"facts": [{"label": "Core node tag", "value": "T_TidRangeScan"}, {"label": "Structured EXPLAIN Node Type", "value": "Tid Range Scan"}, {"label": "Inputs", "value": "A relation and tuple-identifier bounds"}, {"label": "Output", "value": "Selected table tuples"}, {"label": "Executor initializer", "value": "ExecInitTidRangeScan"}, {"label": "Memory mechanism", "value": "unclassified"}], "memory": {"evidence": [{"url": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "d90a113c9d5836add238f7174f1c17a9ef3a7bc4f9ffc4378744a038e972f1b9", "archive_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}], "mechanism": "unclassified", "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.", "source_notes": []}, "tables": [{"key": "explain-labels", "rows": [{"label": "Tid Range Scan", "identity": "Tid Range Scan"}], "title": "EXPLAIN labels in this source build", "columns": [{"key": "label", "label": "Text-format label"}, {"key": "identity", "label": "Structured node identity"}]}], "related": [{"url": "/wiki/sql/explain/?v=17", "label": "EXPLAIN"}, {"url": "/docs/17/using-explain.html", "label": "Using EXPLAIN"}, {"url": "/docs/17/parallel-plans.html", "label": "Parallel plans"}, {"url": "/wiki/guc/enable_tidscan/?v=17", "label": "enable_tidscan"}], "release": {"ref": "PostgreSQL 17.11 source archive", "label": "17.11", "major": "17", "channel": "stable", "revision": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979", "source_url": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "source_snapshot_utc": ""}, "sources": [{"url": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "line": 1474, "path": "src/backend/commands/explain.c", "label": "src/backend/commands/explain.c:1474", "sha256": "741251b1a3b6d269a52a673d42eb63b02e13a5872db7b359b137086ab21b63c8", "archive_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}, {"url": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "line": 244, "path": "src/backend/executor/execProcnode.c", "label": "src/backend/executor/execProcnode.c:244", "sha256": "a77576e158b94cb01fa8c5174ba133004eabdd727660323f8afc66c8d2e757b8", "archive_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}, {"url": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "d90a113c9d5836add238f7174f1c17a9ef3a7bc4f9ffc4378744a038e972f1b9", "archive_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}, {"url": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "path": "src/include/nodes/plannodes.h", "label": "src/include/nodes/plannodes.h", "sha256": "d390dd69e2d3f5085beb42b33e46ff0676a2959b916a12b82118a7e545f8e562", "archive_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}], "node_tag": "T_TidRangeScan", "sections": [{"title": "EXPLAIN names and attributes", "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 Range 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": "Memory and temporary storage", "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": "Parallel execution and instrumentation", "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": "Executor implementation notes", "paragraphs": ["nodeTidrangescan.c Routines to support TID range scans of relations", "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.)", "For the given 'expr', build and return an appropriate TidOpExpr taking into account the expr's operator and operand order.", "Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.", "Compute and set node's block and offset range to scan by evaluating the trss_tidexprs. Returns false if we detect the range cannot contain any tuples. Returns true if it's possible for the range to contain tuples."]}, {"code": "case T_TidRangeScan:\n\t\t\tpname = sname = \"Tid Range Scan\";\n\t\t\tbreak;", "title": "EXPLAIN identity in core source"}], "strategies": [], "description": ["Scans a relation over a range of tuple identifiers."], "evidence_kind": "source and documentation", "explain_names": ["Tid Range Scan"], "partial_modes": [], "comparison_data": {"node_tag": "T_TidRangeScan", "strategies": [], "text_names": ["Tid Range Scan"], "initializer": "ExecInitTidRangeScan", "partial_modes": [], "memory_mechanism": "unclassified", "parallel_callbacks": []}, "comparison_hash": "fc2e690009eada98b87b1cebea56efd35a688fbd53c168572df67f03a1bde70e", "explain_prefixes": ["Parallel", "Async"], "runtime_verified": false, "source_inventory": {"explain": "src/backend/commands/explain.c", "executor": "src/backend/executor/execProcnode.c", "implementation": "src/backend/executor/nodeTidrangescan.c"}, "parallel_callbacks": []}, "18": {"facts": [{"label": "Core node tag", "value": "T_TidRangeScan"}, {"label": "Structured EXPLAIN Node Type", "value": "Tid Range Scan"}, {"label": "Inputs", "value": "A relation and tuple-identifier bounds"}, {"label": "Output", "value": "Selected table tuples"}, {"label": "Executor initializer", "value": "ExecInitTidRangeScan"}, {"label": "Memory mechanism", "value": "unclassified"}], "memory": {"evidence": [{"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "2cc328fc19284accf5f67759b67cd54656ed615fdd7c8725eccda9e3bc74b4d7", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}], "mechanism": "unclassified", "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.", "source_notes": []}, "tables": [{"key": "explain-labels", "rows": [{"label": "Tid Range Scan", "identity": "Tid Range Scan"}], "title": "EXPLAIN labels in this source build", "columns": [{"key": "label", "label": "Text-format label"}, {"key": "identity", "label": "Structured node identity"}]}], "related": [{"url": "/wiki/sql/explain/?v=18", "label": "EXPLAIN"}, {"url": "/docs/18/using-explain.html", "label": "Using EXPLAIN"}, {"url": "/docs/18/parallel-plans.html", "label": "Parallel plans"}, {"url": "/wiki/guc/enable_tidscan/?v=18", "label": "enable_tidscan"}], "release": {"ref": "PostgreSQL 18.6 source archive", "label": "18.6", "major": "18", "channel": "stable", "revision": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f", "source_url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "source_snapshot_utc": ""}, "sources": [{"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "line": 1459, "path": "src/backend/commands/explain.c", "label": "src/backend/commands/explain.c:1459", "sha256": "34c86d6070224a0e981efef51f79101d6d505e5874f1684ace183034bab14bb4", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, {"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "line": 244, "path": "src/backend/executor/execProcnode.c", "label": "src/backend/executor/execProcnode.c:244", "sha256": "f8a06a3f539077249b20664b2812433db6d7bd12b2c0ca633525db43d06f112a", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, {"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "2cc328fc19284accf5f67759b67cd54656ed615fdd7c8725eccda9e3bc74b4d7", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, {"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "path": "src/include/nodes/plannodes.h", "label": "src/include/nodes/plannodes.h", "sha256": "52422b327a8049fbbb20d8b96008a0fc0a6fafa60f7eff3c695d5b2e83830120", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}], "node_tag": "T_TidRangeScan", "sections": [{"title": "EXPLAIN names and attributes", "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 Range 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": "Memory and temporary storage", "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": "Parallel execution and instrumentation", "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": "Executor implementation notes", "paragraphs": ["nodeTidrangescan.c Routines to support TID range scans of relations", "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.)", "For the given 'expr', build and return an appropriate TidOpExpr taking into account the expr's operator and operand order.", "Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.", "Compute and set node's block and offset range to scan by evaluating node->trss_tidexprs. Returns false if we detect the range cannot contain any tuples. Returns true if it's possible for the range to contain tuples. We don't bother validating that trss_mintid is less than or equal to trss_maxtid, as the scan_set_tidrange() table AM function will handle that."]}, {"code": "case T_TidRangeScan:\n\t\t\tpname = sname = \"Tid Range Scan\";\n\t\t\tbreak;", "title": "EXPLAIN identity in core source"}], "strategies": [], "description": ["Scans a relation over a range of tuple identifiers."], "evidence_kind": "source and documentation", "explain_names": ["Tid Range Scan"], "partial_modes": [], "comparison_data": {"node_tag": "T_TidRangeScan", "strategies": [], "text_names": ["Tid Range Scan"], "initializer": "ExecInitTidRangeScan", "partial_modes": [], "memory_mechanism": "unclassified", "parallel_callbacks": []}, "comparison_hash": "fc2e690009eada98b87b1cebea56efd35a688fbd53c168572df67f03a1bde70e", "explain_prefixes": ["Parallel", "Async"], "runtime_verified": false, "source_inventory": {"explain": "src/backend/commands/explain.c", "executor": "src/backend/executor/execProcnode.c", "implementation": "src/backend/executor/nodeTidrangescan.c"}, "parallel_callbacks": []}, "19": {"facts": [{"label": "Core node tag", "value": "T_TidRangeScan"}, {"label": "Structured EXPLAIN Node Type", "value": "Tid Range Scan"}, {"label": "Inputs", "value": "A relation and tuple-identifier bounds"}, {"label": "Output", "value": "Selected table tuples"}, {"label": "Executor initializer", "value": "ExecInitTidRangeScan"}, {"label": "Memory mechanism", "value": "unclassified"}], "memory": {"evidence": [{"url": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "6e99e6425b8f762049c0fcd26a8f44bfdff2badc2861ee44d6bb854629bfab73", "archive_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}], "mechanism": "unclassified", "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.", "source_notes": []}, "tables": [{"key": "explain-labels", "rows": [{"label": "Tid Range Scan", "identity": "Tid Range Scan"}], "title": "EXPLAIN labels in this source build", "columns": [{"key": "label", "label": "Text-format label"}, {"key": "identity", "label": "Structured node identity"}]}], "related": [{"url": "/wiki/sql/explain/?v=19", "label": "EXPLAIN"}, {"url": "/docs/19/using-explain.html", "label": "Using EXPLAIN"}, {"url": "/docs/19/parallel-plans.html", "label": "Parallel plans"}, {"url": "/wiki/guc/enable_tidscan/?v=19", "label": "enable_tidscan"}], "release": {"ref": "PostgreSQL 19beta4 source archive", "label": "19beta4", "major": "19", "channel": "preview", "revision": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86", "source_url": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "source_snapshot_utc": ""}, "sources": [{"url": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "line": 1471, "path": "src/backend/commands/explain.c", "label": "src/backend/commands/explain.c:1471", "sha256": "8b115b1c194a4b54ae630209a741e293b1df49a9052f10b2de9ca092a48998e3", "archive_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, {"url": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "line": 244, "path": "src/backend/executor/execProcnode.c", "label": "src/backend/executor/execProcnode.c:244", "sha256": "5e39b2037bed672da55104229ecc32da5abde44c26bcad01479edcfa044d09ed", "archive_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, {"url": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "6e99e6425b8f762049c0fcd26a8f44bfdff2badc2861ee44d6bb854629bfab73", "archive_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, {"url": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "path": "src/include/nodes/plannodes.h", "label": "src/include/nodes/plannodes.h", "sha256": "1c65d5d6b6c81c71531685843647869bcae630779d815a5036b06e070c6c06c7", "archive_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, {"url": "/docs/19/parallel-plans.html#PARALLEL-SCANS", "path": "parallel-plans.html", "label": "PostgreSQL 19beta4 \u00b7 parallel-plans", "sha256": "f99fee3456a48a5ce2c399d6b35ab93183c2c9012e8ed60c53c0c253f79c3756"}], "node_tag": "T_TidRangeScan", "sections": [{"title": "EXPLAIN names and attributes", "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 Range 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": "Memory and temporary storage", "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": "Parallel execution and instrumentation", "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: ExecTidRangeScanEstimate, ExecTidRangeScanInitializeDSM, ExecTidRangeScanInitializeWorker, ExecTidRangeScanInstrumentEstimate, ExecTidRangeScanReInitializeDSM, ExecTidRangeScanRetrieveInstrumentation."]}, {"title": "Same-version manual discussion", "paragraphs": ["In a parallel tid range scan , the range of blocks will be subdivided into smaller ranges which are shared among the cooperating processes. Each worker process will complete the scanning of its given range of blocks before requesting an additional range of blocks."]}, {"title": "Executor implementation notes", "paragraphs": ["nodeTidrangescan.c Routines to support TID range scans of relations", "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.)", "For the given 'expr', build and return an appropriate TidOpExpr taking into account the expr's operator and operand order.", "Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.", "Compute and set node's block and offset range to scan by evaluating node->trss_tidexprs. Returns false if we detect the range cannot contain any tuples. Returns true if it's possible for the range to contain tuples. We don't bother validating that trss_mintid is less than or equal to trss_maxtid, as the scan_set_tidrange() table AM function will handle that."]}, {"code": "case T_TidRangeScan:\n\t\t\tpname = sname = \"Tid Range Scan\";\n\t\t\tbreak;", "title": "EXPLAIN identity in core source"}], "strategies": [], "description": ["Scans a relation over a range of tuple identifiers."], "evidence_kind": "source and documentation", "explain_names": ["Tid Range Scan"], "partial_modes": [], "comparison_data": {"node_tag": "T_TidRangeScan", "strategies": [], "text_names": ["Tid Range Scan"], "initializer": "ExecInitTidRangeScan", "partial_modes": [], "memory_mechanism": "unclassified", "parallel_callbacks": ["ExecTidRangeScanEstimate", "ExecTidRangeScanInitializeDSM", "ExecTidRangeScanInitializeWorker", "ExecTidRangeScanInstrumentEstimate", "ExecTidRangeScanReInitializeDSM", "ExecTidRangeScanRetrieveInstrumentation"]}, "comparison_hash": "2b1ca31ef8003476fae107d50ea742351e6452b02ae0a9b45f03fc0090cdcb3c", "explain_prefixes": ["Parallel", "Async"], "runtime_verified": false, "source_inventory": {"explain": "src/backend/commands/explain.c", "executor": "src/backend/executor/execProcnode.c", "implementation": "src/backend/executor/nodeTidrangescan.c"}, "parallel_callbacks": ["ExecTidRangeScanEstimate", "ExecTidRangeScanInitializeDSM", "ExecTidRangeScanInitializeWorker", "ExecTidRangeScanInstrumentEstimate", "ExecTidRangeScanReInitializeDSM", "ExecTidRangeScanRetrieveInstrumentation"]}, "20": {"facts": [{"label": "Core node tag", "value": "T_TidRangeScan"}, {"label": "Structured EXPLAIN Node Type", "value": "Tid Range Scan"}, {"label": "Inputs", "value": "A relation and tuple-identifier bounds"}, {"label": "Output", "value": "Selected table tuples"}, {"label": "Executor initializer", "value": "ExecInitTidRangeScan"}, {"label": "Memory mechanism", "value": "unclassified"}], "memory": {"evidence": [{"url": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "6e99e6425b8f762049c0fcd26a8f44bfdff2badc2861ee44d6bb854629bfab73", "archive_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41"}], "mechanism": "unclassified", "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.", "source_notes": []}, "tables": [{"key": "explain-labels", "rows": [{"label": "Tid Range Scan", "identity": "Tid Range Scan"}], "title": "EXPLAIN labels in this source build", "columns": [{"key": "label", "label": "Text-format label"}, {"key": "identity", "label": "Structured node identity"}]}], "related": [{"url": "/wiki/sql/explain/?v=20", "label": "EXPLAIN"}, {"url": "/docs/devel/using-explain.html", "label": "Using EXPLAIN"}, {"url": "/docs/devel/parallel-plans.html", "label": "Parallel plans"}, {"url": "/wiki/guc/enable_tidscan/?v=20", "label": "enable_tidscan"}], "release": {"ref": "PostgreSQL 20devel source archive", "label": "20devel", "major": "20", "channel": "devel", "revision": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41", "source_url": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "source_snapshot_utc": "26-Sep-2026 20:22"}, "sources": [{"url": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "line": 1471, "path": "src/backend/commands/explain.c", "label": "src/backend/commands/explain.c:1471", "sha256": "13402758013520451539427b5993db06d463ca11c4e2d4cc5444e82367688077", "archive_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41"}, {"url": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "line": 244, "path": "src/backend/executor/execProcnode.c", "label": "src/backend/executor/execProcnode.c:244", "sha256": "5e39b2037bed672da55104229ecc32da5abde44c26bcad01479edcfa044d09ed", "archive_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41"}, {"url": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "6e99e6425b8f762049c0fcd26a8f44bfdff2badc2861ee44d6bb854629bfab73", "archive_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41"}, {"url": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "path": "src/include/nodes/plannodes.h", "label": "src/include/nodes/plannodes.h", "sha256": "7a94ed1652f0d74d50c39971d1cd3e8051dbc0d6058f31b6de71a433ca343521", "archive_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41"}, {"url": "/docs/devel/parallel-plans.html#PARALLEL-SCANS", "path": "parallel-plans.html", "label": "PostgreSQL 20devel \u00b7 parallel-plans", "sha256": "6451d4254d26d789b8697ba7207288ac26e75e56f9711c8a5a3f5480171a4724"}], "node_tag": "T_TidRangeScan", "sections": [{"title": "EXPLAIN names and attributes", "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 Range 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": "Memory and temporary storage", "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": "Parallel execution and instrumentation", "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: ExecTidRangeScanEstimate, ExecTidRangeScanInitializeDSM, ExecTidRangeScanInitializeWorker, ExecTidRangeScanInstrumentEstimate, ExecTidRangeScanReInitializeDSM, ExecTidRangeScanRetrieveInstrumentation."]}, {"title": "Same-version manual discussion", "paragraphs": ["In a parallel tid range scan , the range of blocks will be subdivided into smaller ranges which are shared among the cooperating processes. Each worker process will complete the scanning of its given range of blocks before requesting an additional range of blocks."]}, {"title": "Executor implementation notes", "paragraphs": ["nodeTidrangescan.c Routines to support TID range scans of relations", "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.)", "For the given 'expr', build and return an appropriate TidOpExpr taking into account the expr's operator and operand order.", "Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.", "Compute and set node's block and offset range to scan by evaluating node->trss_tidexprs. Returns false if we detect the range cannot contain any tuples. Returns true if it's possible for the range to contain tuples. We don't bother validating that trss_mintid is less than or equal to trss_maxtid, as the scan_set_tidrange() table AM function will handle that."]}, {"code": "case T_TidRangeScan:\n\t\t\tpname = sname = \"Tid Range Scan\";\n\t\t\tbreak;", "title": "EXPLAIN identity in core source"}], "strategies": [], "description": ["Scans a relation over a range of tuple identifiers."], "evidence_kind": "source and documentation", "explain_names": ["Tid Range Scan"], "partial_modes": [], "comparison_data": {"node_tag": "T_TidRangeScan", "strategies": [], "text_names": ["Tid Range Scan"], "initializer": "ExecInitTidRangeScan", "partial_modes": [], "memory_mechanism": "unclassified", "parallel_callbacks": ["ExecTidRangeScanEstimate", "ExecTidRangeScanInitializeDSM", "ExecTidRangeScanInitializeWorker", "ExecTidRangeScanInstrumentEstimate", "ExecTidRangeScanReInitializeDSM", "ExecTidRangeScanRetrieveInstrumentation"]}, "comparison_hash": "2b1ca31ef8003476fae107d50ea742351e6452b02ae0a9b45f03fc0090cdcb3c", "explain_prefixes": ["Parallel", "Async"], "runtime_verified": false, "source_inventory": {"explain": "src/backend/commands/explain.c", "executor": "src/backend/executor/execProcnode.c", "implementation": "src/backend/executor/nodeTidrangescan.c"}, "parallel_callbacks": ["ExecTidRangeScanEstimate", "ExecTidRangeScanInitializeDSM", "ExecTidRangeScanInitializeWorker", "ExecTidRangeScanInstrumentEstimate", "ExecTidRangeScanReInitializeDSM", "ExecTidRangeScanRetrieveInstrumentation"]}}}, "snapshot": {"facts": [{"label": "Core node tag", "value": "T_TidRangeScan"}, {"label": "Structured EXPLAIN Node Type", "value": "Tid Range Scan"}, {"label": "Inputs", "value": "A relation and tuple-identifier bounds"}, {"label": "Output", "value": "Selected table tuples"}, {"label": "Executor initializer", "value": "ExecInitTidRangeScan"}, {"label": "Memory mechanism", "value": "unclassified"}], "memory": {"evidence": [{"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "2cc328fc19284accf5f67759b67cd54656ed615fdd7c8725eccda9e3bc74b4d7", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}], "mechanism": "unclassified", "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.", "source_notes": []}, "tables": [{"key": "explain-labels", "rows": [{"label": "Tid Range Scan", "identity": "Tid Range Scan"}], "title": "EXPLAIN labels in this source build", "columns": [{"key": "label", "label": "Text-format label"}, {"key": "identity", "label": "Structured node identity"}]}], "related": [{"url": "/wiki/sql/explain/?v=18", "label": "EXPLAIN"}, {"url": "/docs/18/using-explain.html", "label": "Using EXPLAIN"}, {"url": "/docs/18/parallel-plans.html", "label": "Parallel plans"}, {"url": "/wiki/guc/enable_tidscan/?v=18", "label": "enable_tidscan"}], "release": {"ref": "PostgreSQL 18.6 source archive", "label": "18.6", "major": "18", "channel": "stable", "revision": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f", "source_url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "source_snapshot_utc": ""}, "sources": [{"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "line": 1459, "path": "src/backend/commands/explain.c", "label": "src/backend/commands/explain.c:1459", "sha256": "34c86d6070224a0e981efef51f79101d6d505e5874f1684ace183034bab14bb4", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, {"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "line": 244, "path": "src/backend/executor/execProcnode.c", "label": "src/backend/executor/execProcnode.c:244", "sha256": "f8a06a3f539077249b20664b2812433db6d7bd12b2c0ca633525db43d06f112a", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, {"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "path": "src/backend/executor/nodeTidrangescan.c", "label": "src/backend/executor/nodeTidrangescan.c", "sha256": "2cc328fc19284accf5f67759b67cd54656ed615fdd7c8725eccda9e3bc74b4d7", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, {"url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "path": "src/include/nodes/plannodes.h", "label": "src/include/nodes/plannodes.h", "sha256": "52422b327a8049fbbb20d8b96008a0fc0a6fafa60f7eff3c695d5b2e83830120", "archive_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}], "node_tag": "T_TidRangeScan", "sections": [{"title": "EXPLAIN names and attributes", "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 Range 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": "Memory and temporary storage", "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": "Parallel execution and instrumentation", "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": "Executor implementation notes", "paragraphs": ["nodeTidrangescan.c Routines to support TID range scans of relations", "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.)", "For the given 'expr', build and return an appropriate TidOpExpr taking into account the expr's operator and operand order.", "Extract the qual subexpressions that yield TIDs to search for, and compile them into ExprStates if they're ordinary expressions.", "Compute and set node's block and offset range to scan by evaluating node->trss_tidexprs. Returns false if we detect the range cannot contain any tuples. Returns true if it's possible for the range to contain tuples. We don't bother validating that trss_mintid is less than or equal to trss_maxtid, as the scan_set_tidrange() table AM function will handle that."]}, {"code": "case T_TidRangeScan:\n\t\t\tpname = sname = \"Tid Range Scan\";\n\t\t\tbreak;", "title": "EXPLAIN identity in core source"}], "strategies": [], "description": ["Scans a relation over a range of tuple identifiers."], "evidence_kind": "source and documentation", "explain_names": ["Tid Range Scan"], "partial_modes": [], "comparison_data": {"node_tag": "T_TidRangeScan", "strategies": [], "text_names": ["Tid Range Scan"], "initializer": "ExecInitTidRangeScan", "partial_modes": [], "memory_mechanism": "unclassified", "parallel_callbacks": []}, "comparison_hash": "fc2e690009eada98b87b1cebea56efd35a688fbd53c168572df67f03a1bde70e", "explain_prefixes": ["Parallel", "Async"], "runtime_verified": false, "source_inventory": {"explain": "src/backend/commands/explain.c", "executor": "src/backend/executor/execProcnode.c", "implementation": "src/backend/executor/nodeTidrangescan.c"}, "parallel_callbacks": []}, "comparison": {"left": "13", "right": "14", "status": "added", "diff": "--- PostgreSQL 13\n+++ PostgreSQL 14\n@@ -1 +1,11 @@\n-Not recorded in this version\n+{\n+  \"initializer\": \"ExecInitTidRangeScan\",\n+  \"memory_mechanism\": \"unclassified\",\n+  \"node_tag\": \"T_TidRangeScan\",\n+  \"parallel_callbacks\": [],\n+  \"partial_modes\": [],\n+  \"strategies\": [],\n+  \"text_names\": [\n+    \"Tid Range Scan\"\n+  ]\n+}"}}