diff options
Diffstat (limited to 'docs/sqlglot/optimizer')
| -rw-r--r-- | docs/sqlglot/optimizer/canonicalize.html | 257 | ||||
| -rw-r--r-- | docs/sqlglot/optimizer/optimizer.html | 2 | ||||
| -rw-r--r-- | docs/sqlglot/optimizer/pushdown_projections.html | 329 | ||||
| -rw-r--r-- | docs/sqlglot/optimizer/qualify_columns.html | 1227 | ||||
| -rw-r--r-- | docs/sqlglot/optimizer/qualify_tables.html | 132 | ||||
| -rw-r--r-- | docs/sqlglot/optimizer/scope.html | 2601 |
6 files changed, 2322 insertions, 2226 deletions
diff --git a/docs/sqlglot/optimizer/canonicalize.html b/docs/sqlglot/optimizer/canonicalize.html index 2baa3ef..386dfbd 100644 --- a/docs/sqlglot/optimizer/canonicalize.html +++ b/docs/sqlglot/optimizer/canonicalize.html @@ -42,6 +42,9 @@ <li> <a class="function" href="#remove_redundant_casts">remove_redundant_casts</a> </li> + <li> + <a class="function" href="#ensure_bool_predicates">ensure_bool_predicates</a> + </li> </ul> @@ -65,76 +68,98 @@ <label class="view-source-button" for="mod-canonicalize-view-source"><span>View Source</span></label> - <div class="pdoc-code codehilite"><pre><span></span><span id="L-1"><a href="#L-1"><span class="linenos"> 1</span></a><span class="kn">import</span> <span class="nn">itertools</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="L-1"><a href="#L-1"><span class="linenos"> 1</span></a><span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">annotations</span> </span><span id="L-2"><a href="#L-2"><span class="linenos"> 2</span></a> -</span><span id="L-3"><a href="#L-3"><span class="linenos"> 3</span></a><span class="kn">from</span> <span class="nn">sqlglot</span> <span class="kn">import</span> <span class="n">exp</span> +</span><span id="L-3"><a href="#L-3"><span class="linenos"> 3</span></a><span class="kn">import</span> <span class="nn">itertools</span> </span><span id="L-4"><a href="#L-4"><span class="linenos"> 4</span></a> -</span><span id="L-5"><a href="#L-5"><span class="linenos"> 5</span></a> -</span><span id="L-6"><a href="#L-6"><span class="linenos"> 6</span></a><span class="k">def</span> <span class="nf">canonicalize</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> -</span><span id="L-7"><a href="#L-7"><span class="linenos"> 7</span></a><span class="w"> </span><span class="sd">"""Converts a sql expression into a standard form.</span> +</span><span id="L-5"><a href="#L-5"><span class="linenos"> 5</span></a><span class="kn">from</span> <span class="nn">sqlglot</span> <span class="kn">import</span> <span class="n">exp</span> +</span><span id="L-6"><a href="#L-6"><span class="linenos"> 6</span></a><span class="kn">from</span> <span class="nn">sqlglot.helper</span> <span class="kn">import</span> <span class="n">should_identify</span> +</span><span id="L-7"><a href="#L-7"><span class="linenos"> 7</span></a> </span><span id="L-8"><a href="#L-8"><span class="linenos"> 8</span></a> -</span><span id="L-9"><a href="#L-9"><span class="linenos"> 9</span></a><span class="sd"> This method relies on annotate_types because many of the</span> -</span><span id="L-10"><a href="#L-10"><span class="linenos">10</span></a><span class="sd"> conversions rely on type inference.</span> +</span><span id="L-9"><a href="#L-9"><span class="linenos"> 9</span></a><span class="k">def</span> <span class="nf">canonicalize</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">,</span> <span class="n">identify</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">"safe"</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="L-10"><a href="#L-10"><span class="linenos">10</span></a><span class="w"> </span><span class="sd">"""Converts a sql expression into a standard form.</span> </span><span id="L-11"><a href="#L-11"><span class="linenos">11</span></a> -</span><span id="L-12"><a href="#L-12"><span class="linenos">12</span></a><span class="sd"> Args:</span> -</span><span id="L-13"><a href="#L-13"><span class="linenos">13</span></a><span class="sd"> expression: The expression to canonicalize.</span> -</span><span id="L-14"><a href="#L-14"><span class="linenos">14</span></a><span class="sd"> """</span> -</span><span id="L-15"><a href="#L-15"><span class="linenos">15</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">replace_children</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">canonicalize</span><span class="p">)</span> -</span><span id="L-16"><a href="#L-16"><span class="linenos">16</span></a> -</span><span id="L-17"><a href="#L-17"><span class="linenos">17</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">add_text_to_concat</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> -</span><span id="L-18"><a href="#L-18"><span class="linenos">18</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">coerce_type</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> -</span><span id="L-19"><a href="#L-19"><span class="linenos">19</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">remove_redundant_casts</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="L-12"><a href="#L-12"><span class="linenos">12</span></a><span class="sd"> This method relies on annotate_types because many of the</span> +</span><span id="L-13"><a href="#L-13"><span class="linenos">13</span></a><span class="sd"> conversions rely on type inference.</span> +</span><span id="L-14"><a href="#L-14"><span class="linenos">14</span></a> +</span><span id="L-15"><a href="#L-15"><span class="linenos">15</span></a><span class="sd"> Args:</span> +</span><span id="L-16"><a href="#L-16"><span class="linenos">16</span></a><span class="sd"> expression: The expression to canonicalize.</span> +</span><span id="L-17"><a href="#L-17"><span class="linenos">17</span></a><span class="sd"> identify: Whether or not to force identify identifier.</span> +</span><span id="L-18"><a href="#L-18"><span class="linenos">18</span></a><span class="sd"> """</span> +</span><span id="L-19"><a href="#L-19"><span class="linenos">19</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">replace_children</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">canonicalize</span><span class="p">,</span> <span class="n">identify</span><span class="o">=</span><span class="n">identify</span><span class="p">)</span> </span><span id="L-20"><a href="#L-20"><span class="linenos">20</span></a> -</span><span id="L-21"><a href="#L-21"><span class="linenos">21</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">):</span> -</span><span id="L-22"><a href="#L-22"><span class="linenos">22</span></a> <span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"quoted"</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span> -</span><span id="L-23"><a href="#L-23"><span class="linenos">23</span></a> -</span><span id="L-24"><a href="#L-24"><span class="linenos">24</span></a> <span class="k">return</span> <span class="n">expression</span> +</span><span id="L-21"><a href="#L-21"><span class="linenos">21</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">add_text_to_concat</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="L-22"><a href="#L-22"><span class="linenos">22</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">coerce_type</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="L-23"><a href="#L-23"><span class="linenos">23</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">remove_redundant_casts</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="L-24"><a href="#L-24"><span class="linenos">24</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">ensure_bool_predicates</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> </span><span id="L-25"><a href="#L-25"><span class="linenos">25</span></a> -</span><span id="L-26"><a href="#L-26"><span class="linenos">26</span></a> -</span><span id="L-27"><a href="#L-27"><span class="linenos">27</span></a><span class="k">def</span> <span class="nf">add_text_to_concat</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> -</span><span id="L-28"><a href="#L-28"><span class="linenos">28</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Add</span><span class="p">)</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">type</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="ow">in</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">TEXT_TYPES</span><span class="p">:</span> -</span><span id="L-29"><a href="#L-29"><span class="linenos">29</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">Concat</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">expression</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="p">)</span> -</span><span id="L-30"><a href="#L-30"><span class="linenos">30</span></a> <span class="k">return</span> <span class="n">node</span> +</span><span id="L-26"><a href="#L-26"><span class="linenos">26</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">):</span> +</span><span id="L-27"><a href="#L-27"><span class="linenos">27</span></a> <span class="k">if</span> <span class="n">should_identify</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">identify</span><span class="p">):</span> +</span><span id="L-28"><a href="#L-28"><span class="linenos">28</span></a> <span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"quoted"</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span> +</span><span id="L-29"><a href="#L-29"><span class="linenos">29</span></a> +</span><span id="L-30"><a href="#L-30"><span class="linenos">30</span></a> <span class="k">return</span> <span class="n">expression</span> </span><span id="L-31"><a href="#L-31"><span class="linenos">31</span></a> </span><span id="L-32"><a href="#L-32"><span class="linenos">32</span></a> -</span><span id="L-33"><a href="#L-33"><span class="linenos">33</span></a><span class="k">def</span> <span class="nf">coerce_type</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> -</span><span id="L-34"><a href="#L-34"><span class="linenos">34</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Binary</span><span class="p">):</span> -</span><span id="L-35"><a href="#L-35"><span class="linenos">35</span></a> <span class="n">_coerce_date</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">left</span><span class="p">,</span> <span class="n">node</span><span class="o">.</span><span class="n">right</span><span class="p">)</span> -</span><span id="L-36"><a href="#L-36"><span class="linenos">36</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Between</span><span class="p">):</span> -</span><span id="L-37"><a href="#L-37"><span class="linenos">37</span></a> <span class="n">_coerce_date</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="s2">"low"</span><span class="p">])</span> -</span><span id="L-38"><a href="#L-38"><span class="linenos">38</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Extract</span><span class="p">):</span> -</span><span id="L-39"><a href="#L-39"><span class="linenos">39</span></a> <span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">TEMPORAL_TYPES</span><span class="p">:</span> -</span><span id="L-40"><a href="#L-40"><span class="linenos">40</span></a> <span class="n">_replace_cast</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="s2">"datetime"</span><span class="p">)</span> -</span><span id="L-41"><a href="#L-41"><span class="linenos">41</span></a> <span class="k">return</span> <span class="n">node</span> -</span><span id="L-42"><a href="#L-42"><span class="linenos">42</span></a> -</span><span id="L-43"><a href="#L-43"><span class="linenos">43</span></a> -</span><span id="L-44"><a href="#L-44"><span class="linenos">44</span></a><span class="k">def</span> <span class="nf">remove_redundant_casts</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> -</span><span id="L-45"><a href="#L-45"><span class="linenos">45</span></a> <span class="k">if</span> <span class="p">(</span> -</span><span id="L-46"><a href="#L-46"><span class="linenos">46</span></a> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Cast</span><span class="p">)</span> -</span><span id="L-47"><a href="#L-47"><span class="linenos">47</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">to</span><span class="o">.</span><span class="n">type</span> -</span><span id="L-48"><a href="#L-48"><span class="linenos">48</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">type</span> -</span><span id="L-49"><a href="#L-49"><span class="linenos">49</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">to</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="o">==</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> -</span><span id="L-50"><a href="#L-50"><span class="linenos">50</span></a> <span class="p">):</span> -</span><span id="L-51"><a href="#L-51"><span class="linenos">51</span></a> <span class="k">return</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span> -</span><span id="L-52"><a href="#L-52"><span class="linenos">52</span></a> <span class="k">return</span> <span class="n">expression</span> -</span><span id="L-53"><a href="#L-53"><span class="linenos">53</span></a> -</span><span id="L-54"><a href="#L-54"><span class="linenos">54</span></a> -</span><span id="L-55"><a href="#L-55"><span class="linenos">55</span></a><span class="k">def</span> <span class="nf">_coerce_date</span><span class="p">(</span><span class="n">a</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">,</span> <span class="n">b</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-56"><a href="#L-56"><span class="linenos">56</span></a> <span class="k">for</span> <span class="n">a</span><span class="p">,</span> <span class="n">b</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">permutations</span><span class="p">([</span><span class="n">a</span><span class="p">,</span> <span class="n">b</span><span class="p">]):</span> -</span><span id="L-57"><a href="#L-57"><span class="linenos">57</span></a> <span class="k">if</span> <span class="p">(</span> -</span><span id="L-58"><a href="#L-58"><span class="linenos">58</span></a> <span class="n">a</span><span class="o">.</span><span class="n">type</span> -</span><span id="L-59"><a href="#L-59"><span class="linenos">59</span></a> <span class="ow">and</span> <span class="n">a</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="o">==</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">Type</span><span class="o">.</span><span class="n">DATE</span> -</span><span id="L-60"><a href="#L-60"><span class="linenos">60</span></a> <span class="ow">and</span> <span class="n">b</span><span class="o">.</span><span class="n">type</span> -</span><span id="L-61"><a href="#L-61"><span class="linenos">61</span></a> <span class="ow">and</span> <span class="n">b</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="o">!=</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">Type</span><span class="o">.</span><span class="n">DATE</span> -</span><span id="L-62"><a href="#L-62"><span class="linenos">62</span></a> <span class="p">):</span> -</span><span id="L-63"><a href="#L-63"><span class="linenos">63</span></a> <span class="n">_replace_cast</span><span class="p">(</span><span class="n">b</span><span class="p">,</span> <span class="s2">"date"</span><span class="p">)</span> -</span><span id="L-64"><a href="#L-64"><span class="linenos">64</span></a> +</span><span id="L-33"><a href="#L-33"><span class="linenos">33</span></a><span class="k">def</span> <span class="nf">add_text_to_concat</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="L-34"><a href="#L-34"><span class="linenos">34</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Add</span><span class="p">)</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">type</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="ow">in</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">TEXT_TYPES</span><span class="p">:</span> +</span><span id="L-35"><a href="#L-35"><span class="linenos">35</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">Concat</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">expression</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="p">)</span> +</span><span id="L-36"><a href="#L-36"><span class="linenos">36</span></a> <span class="k">return</span> <span class="n">node</span> +</span><span id="L-37"><a href="#L-37"><span class="linenos">37</span></a> +</span><span id="L-38"><a href="#L-38"><span class="linenos">38</span></a> +</span><span id="L-39"><a href="#L-39"><span class="linenos">39</span></a><span class="k">def</span> <span class="nf">coerce_type</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="L-40"><a href="#L-40"><span class="linenos">40</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Binary</span><span class="p">):</span> +</span><span id="L-41"><a href="#L-41"><span class="linenos">41</span></a> <span class="n">_coerce_date</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">left</span><span class="p">,</span> <span class="n">node</span><span class="o">.</span><span class="n">right</span><span class="p">)</span> +</span><span id="L-42"><a href="#L-42"><span class="linenos">42</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Between</span><span class="p">):</span> +</span><span id="L-43"><a href="#L-43"><span class="linenos">43</span></a> <span class="n">_coerce_date</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="s2">"low"</span><span class="p">])</span> +</span><span id="L-44"><a href="#L-44"><span class="linenos">44</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Extract</span><span class="p">):</span> +</span><span id="L-45"><a href="#L-45"><span class="linenos">45</span></a> <span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">TEMPORAL_TYPES</span><span class="p">:</span> +</span><span id="L-46"><a href="#L-46"><span class="linenos">46</span></a> <span class="n">_replace_cast</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="s2">"datetime"</span><span class="p">)</span> +</span><span id="L-47"><a href="#L-47"><span class="linenos">47</span></a> <span class="k">return</span> <span class="n">node</span> +</span><span id="L-48"><a href="#L-48"><span class="linenos">48</span></a> +</span><span id="L-49"><a href="#L-49"><span class="linenos">49</span></a> +</span><span id="L-50"><a href="#L-50"><span class="linenos">50</span></a><span class="k">def</span> <span class="nf">remove_redundant_casts</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="L-51"><a href="#L-51"><span class="linenos">51</span></a> <span class="k">if</span> <span class="p">(</span> +</span><span id="L-52"><a href="#L-52"><span class="linenos">52</span></a> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Cast</span><span class="p">)</span> +</span><span id="L-53"><a href="#L-53"><span class="linenos">53</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">to</span><span class="o">.</span><span class="n">type</span> +</span><span id="L-54"><a href="#L-54"><span class="linenos">54</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">type</span> +</span><span id="L-55"><a href="#L-55"><span class="linenos">55</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">to</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="o">==</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> +</span><span id="L-56"><a href="#L-56"><span class="linenos">56</span></a> <span class="p">):</span> +</span><span id="L-57"><a href="#L-57"><span class="linenos">57</span></a> <span class="k">return</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span> +</span><span id="L-58"><a href="#L-58"><span class="linenos">58</span></a> <span class="k">return</span> <span class="n">expression</span> +</span><span id="L-59"><a href="#L-59"><span class="linenos">59</span></a> +</span><span id="L-60"><a href="#L-60"><span class="linenos">60</span></a> +</span><span id="L-61"><a href="#L-61"><span class="linenos">61</span></a><span class="k">def</span> <span class="nf">ensure_bool_predicates</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="L-62"><a href="#L-62"><span class="linenos">62</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Connector</span><span class="p">):</span> +</span><span id="L-63"><a href="#L-63"><span class="linenos">63</span></a> <span class="n">_replace_int_predicate</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">left</span><span class="p">)</span> +</span><span id="L-64"><a href="#L-64"><span class="linenos">64</span></a> <span class="n">_replace_int_predicate</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">right</span><span class="p">)</span> </span><span id="L-65"><a href="#L-65"><span class="linenos">65</span></a> -</span><span id="L-66"><a href="#L-66"><span class="linenos">66</span></a><span class="k">def</span> <span class="nf">_replace_cast</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">,</span> <span class="n">to</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-67"><a href="#L-67"><span class="linenos">67</span></a> <span class="n">data_type</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">to</span><span class="p">)</span> -</span><span id="L-68"><a href="#L-68"><span class="linenos">68</span></a> <span class="n">cast</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">Cast</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> <span class="n">to</span><span class="o">=</span><span class="n">data_type</span><span class="p">)</span> -</span><span id="L-69"><a href="#L-69"><span class="linenos">69</span></a> <span class="n">cast</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="n">data_type</span> -</span><span id="L-70"><a href="#L-70"><span class="linenos">70</span></a> <span class="n">node</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">cast</span><span class="p">)</span> +</span><span id="L-66"><a href="#L-66"><span class="linenos">66</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Where</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Having</span><span class="p">)):</span> +</span><span id="L-67"><a href="#L-67"><span class="linenos">67</span></a> <span class="n">_replace_int_predicate</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="p">)</span> +</span><span id="L-68"><a href="#L-68"><span class="linenos">68</span></a> +</span><span id="L-69"><a href="#L-69"><span class="linenos">69</span></a> <span class="k">return</span> <span class="n">expression</span> +</span><span id="L-70"><a href="#L-70"><span class="linenos">70</span></a> +</span><span id="L-71"><a href="#L-71"><span class="linenos">71</span></a> +</span><span id="L-72"><a href="#L-72"><span class="linenos">72</span></a><span class="k">def</span> <span class="nf">_coerce_date</span><span class="p">(</span><span class="n">a</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">,</span> <span class="n">b</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-73"><a href="#L-73"><span class="linenos">73</span></a> <span class="k">for</span> <span class="n">a</span><span class="p">,</span> <span class="n">b</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">permutations</span><span class="p">([</span><span class="n">a</span><span class="p">,</span> <span class="n">b</span><span class="p">]):</span> +</span><span id="L-74"><a href="#L-74"><span class="linenos">74</span></a> <span class="k">if</span> <span class="p">(</span> +</span><span id="L-75"><a href="#L-75"><span class="linenos">75</span></a> <span class="n">a</span><span class="o">.</span><span class="n">type</span> +</span><span id="L-76"><a href="#L-76"><span class="linenos">76</span></a> <span class="ow">and</span> <span class="n">a</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="o">==</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">Type</span><span class="o">.</span><span class="n">DATE</span> +</span><span id="L-77"><a href="#L-77"><span class="linenos">77</span></a> <span class="ow">and</span> <span class="n">b</span><span class="o">.</span><span class="n">type</span> +</span><span id="L-78"><a href="#L-78"><span class="linenos">78</span></a> <span class="ow">and</span> <span class="n">b</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="o">!=</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">Type</span><span class="o">.</span><span class="n">DATE</span> +</span><span id="L-79"><a href="#L-79"><span class="linenos">79</span></a> <span class="p">):</span> +</span><span id="L-80"><a href="#L-80"><span class="linenos">80</span></a> <span class="n">_replace_cast</span><span class="p">(</span><span class="n">b</span><span class="p">,</span> <span class="s2">"date"</span><span class="p">)</span> +</span><span id="L-81"><a href="#L-81"><span class="linenos">81</span></a> +</span><span id="L-82"><a href="#L-82"><span class="linenos">82</span></a> +</span><span id="L-83"><a href="#L-83"><span class="linenos">83</span></a><span class="k">def</span> <span class="nf">_replace_cast</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">,</span> <span class="n">to</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-84"><a href="#L-84"><span class="linenos">84</span></a> <span class="n">data_type</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">to</span><span class="p">)</span> +</span><span id="L-85"><a href="#L-85"><span class="linenos">85</span></a> <span class="n">cast</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">Cast</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> <span class="n">to</span><span class="o">=</span><span class="n">data_type</span><span class="p">)</span> +</span><span id="L-86"><a href="#L-86"><span class="linenos">86</span></a> <span class="n">cast</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="n">data_type</span> +</span><span id="L-87"><a href="#L-87"><span class="linenos">87</span></a> <span class="n">node</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">cast</span><span class="p">)</span> +</span><span id="L-88"><a href="#L-88"><span class="linenos">88</span></a> +</span><span id="L-89"><a href="#L-89"><span class="linenos">89</span></a> +</span><span id="L-90"><a href="#L-90"><span class="linenos">90</span></a><span class="k">def</span> <span class="nf">_replace_int_predicate</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-91"><a href="#L-91"><span class="linenos">91</span></a> <span class="k">if</span> <span class="n">expression</span><span class="o">.</span><span class="n">type</span> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="ow">in</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">INTEGER_TYPES</span><span class="p">:</span> +</span><span id="L-92"><a href="#L-92"><span class="linenos">92</span></a> <span class="n">expression</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">NEQ</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">expression</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> <span class="n">expression</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">Literal</span><span class="o">.</span><span class="n">number</span><span class="p">(</span><span class="mi">0</span><span class="p">)))</span> </span></pre></div> @@ -144,31 +169,34 @@ <div class="attr function"> <span class="def">def</span> - <span class="name">canonicalize</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="n">expression</span><span class="p">:</span> <span class="n"><a href="../expressions.html#Expression">sqlglot.expressions.Expression</a></span></span><span class="return-annotation">) -> <span class="n"><a href="../expressions.html#Expression">sqlglot.expressions.Expression</a></span>:</span></span> + <span class="name">canonicalize</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="n">expression</span><span class="p">:</span> <span class="n"><a href="../expressions.html#Expression">sqlglot.expressions.Expression</a></span>,</span><span class="param"> <span class="n">identify</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s1">'safe'</span></span><span class="return-annotation">) -> <span class="n"><a href="../expressions.html#Expression">sqlglot.expressions.Expression</a></span>:</span></span> <label class="view-source-button" for="canonicalize-view-source"><span>View Source</span></label> </div> <a class="headerlink" href="#canonicalize"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="canonicalize-7"><a href="#canonicalize-7"><span class="linenos"> 7</span></a><span class="k">def</span> <span class="nf">canonicalize</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> -</span><span id="canonicalize-8"><a href="#canonicalize-8"><span class="linenos"> 8</span></a><span class="w"> </span><span class="sd">"""Converts a sql expression into a standard form.</span> -</span><span id="canonicalize-9"><a href="#canonicalize-9"><span class="linenos"> 9</span></a> -</span><span id="canonicalize-10"><a href="#canonicalize-10"><span class="linenos">10</span></a><span class="sd"> This method relies on annotate_types because many of the</span> -</span><span id="canonicalize-11"><a href="#canonicalize-11"><span class="linenos">11</span></a><span class="sd"> conversions rely on type inference.</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="canonicalize-10"><a href="#canonicalize-10"><span class="linenos">10</span></a><span class="k">def</span> <span class="nf">canonicalize</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">,</span> <span class="n">identify</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">"safe"</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="canonicalize-11"><a href="#canonicalize-11"><span class="linenos">11</span></a><span class="w"> </span><span class="sd">"""Converts a sql expression into a standard form.</span> </span><span id="canonicalize-12"><a href="#canonicalize-12"><span class="linenos">12</span></a> -</span><span id="canonicalize-13"><a href="#canonicalize-13"><span class="linenos">13</span></a><span class="sd"> Args:</span> -</span><span id="canonicalize-14"><a href="#canonicalize-14"><span class="linenos">14</span></a><span class="sd"> expression: The expression to canonicalize.</span> -</span><span id="canonicalize-15"><a href="#canonicalize-15"><span class="linenos">15</span></a><span class="sd"> """</span> -</span><span id="canonicalize-16"><a href="#canonicalize-16"><span class="linenos">16</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">replace_children</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">canonicalize</span><span class="p">)</span> -</span><span id="canonicalize-17"><a href="#canonicalize-17"><span class="linenos">17</span></a> -</span><span id="canonicalize-18"><a href="#canonicalize-18"><span class="linenos">18</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">add_text_to_concat</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> -</span><span id="canonicalize-19"><a href="#canonicalize-19"><span class="linenos">19</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">coerce_type</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> -</span><span id="canonicalize-20"><a href="#canonicalize-20"><span class="linenos">20</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">remove_redundant_casts</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="canonicalize-13"><a href="#canonicalize-13"><span class="linenos">13</span></a><span class="sd"> This method relies on annotate_types because many of the</span> +</span><span id="canonicalize-14"><a href="#canonicalize-14"><span class="linenos">14</span></a><span class="sd"> conversions rely on type inference.</span> +</span><span id="canonicalize-15"><a href="#canonicalize-15"><span class="linenos">15</span></a> +</span><span id="canonicalize-16"><a href="#canonicalize-16"><span class="linenos">16</span></a><span class="sd"> Args:</span> +</span><span id="canonicalize-17"><a href="#canonicalize-17"><span class="linenos">17</span></a><span class="sd"> expression: The expression to canonicalize.</span> +</span><span id="canonicalize-18"><a href="#canonicalize-18"><span class="linenos">18</span></a><span class="sd"> identify: Whether or not to force identify identifier.</span> +</span><span id="canonicalize-19"><a href="#canonicalize-19"><span class="linenos">19</span></a><span class="sd"> """</span> +</span><span id="canonicalize-20"><a href="#canonicalize-20"><span class="linenos">20</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">replace_children</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">canonicalize</span><span class="p">,</span> <span class="n">identify</span><span class="o">=</span><span class="n">identify</span><span class="p">)</span> </span><span id="canonicalize-21"><a href="#canonicalize-21"><span class="linenos">21</span></a> -</span><span id="canonicalize-22"><a href="#canonicalize-22"><span class="linenos">22</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">):</span> -</span><span id="canonicalize-23"><a href="#canonicalize-23"><span class="linenos">23</span></a> <span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"quoted"</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span> -</span><span id="canonicalize-24"><a href="#canonicalize-24"><span class="linenos">24</span></a> -</span><span id="canonicalize-25"><a href="#canonicalize-25"><span class="linenos">25</span></a> <span class="k">return</span> <span class="n">expression</span> +</span><span id="canonicalize-22"><a href="#canonicalize-22"><span class="linenos">22</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">add_text_to_concat</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="canonicalize-23"><a href="#canonicalize-23"><span class="linenos">23</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">coerce_type</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="canonicalize-24"><a href="#canonicalize-24"><span class="linenos">24</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">remove_redundant_casts</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="canonicalize-25"><a href="#canonicalize-25"><span class="linenos">25</span></a> <span class="n">expression</span> <span class="o">=</span> <span class="n">ensure_bool_predicates</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="canonicalize-26"><a href="#canonicalize-26"><span class="linenos">26</span></a> +</span><span id="canonicalize-27"><a href="#canonicalize-27"><span class="linenos">27</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">):</span> +</span><span id="canonicalize-28"><a href="#canonicalize-28"><span class="linenos">28</span></a> <span class="k">if</span> <span class="n">should_identify</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">identify</span><span class="p">):</span> +</span><span id="canonicalize-29"><a href="#canonicalize-29"><span class="linenos">29</span></a> <span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"quoted"</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span> +</span><span id="canonicalize-30"><a href="#canonicalize-30"><span class="linenos">30</span></a> +</span><span id="canonicalize-31"><a href="#canonicalize-31"><span class="linenos">31</span></a> <span class="k">return</span> <span class="n">expression</span> </span></pre></div> @@ -181,6 +209,7 @@ conversions rely on type inference.</p> <ul> <li><strong>expression:</strong> The expression to canonicalize.</li> +<li><strong>identify:</strong> Whether or not to force identify identifier.</li> </ul> </div> @@ -197,10 +226,10 @@ conversions rely on type inference.</p> </div> <a class="headerlink" href="#add_text_to_concat"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="add_text_to_concat-28"><a href="#add_text_to_concat-28"><span class="linenos">28</span></a><span class="k">def</span> <span class="nf">add_text_to_concat</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> -</span><span id="add_text_to_concat-29"><a href="#add_text_to_concat-29"><span class="linenos">29</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Add</span><span class="p">)</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">type</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="ow">in</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">TEXT_TYPES</span><span class="p">:</span> -</span><span id="add_text_to_concat-30"><a href="#add_text_to_concat-30"><span class="linenos">30</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">Concat</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">expression</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="p">)</span> -</span><span id="add_text_to_concat-31"><a href="#add_text_to_concat-31"><span class="linenos">31</span></a> <span class="k">return</span> <span class="n">node</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="add_text_to_concat-34"><a href="#add_text_to_concat-34"><span class="linenos">34</span></a><span class="k">def</span> <span class="nf">add_text_to_concat</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="add_text_to_concat-35"><a href="#add_text_to_concat-35"><span class="linenos">35</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Add</span><span class="p">)</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">type</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="ow">in</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">TEXT_TYPES</span><span class="p">:</span> +</span><span id="add_text_to_concat-36"><a href="#add_text_to_concat-36"><span class="linenos">36</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">Concat</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">expression</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="p">)</span> +</span><span id="add_text_to_concat-37"><a href="#add_text_to_concat-37"><span class="linenos">37</span></a> <span class="k">return</span> <span class="n">node</span> </span></pre></div> @@ -218,15 +247,15 @@ conversions rely on type inference.</p> </div> <a class="headerlink" href="#coerce_type"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="coerce_type-34"><a href="#coerce_type-34"><span class="linenos">34</span></a><span class="k">def</span> <span class="nf">coerce_type</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> -</span><span id="coerce_type-35"><a href="#coerce_type-35"><span class="linenos">35</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Binary</span><span class="p">):</span> -</span><span id="coerce_type-36"><a href="#coerce_type-36"><span class="linenos">36</span></a> <span class="n">_coerce_date</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">left</span><span class="p">,</span> <span class="n">node</span><span class="o">.</span><span class="n">right</span><span class="p">)</span> -</span><span id="coerce_type-37"><a href="#coerce_type-37"><span class="linenos">37</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Between</span><span class="p">):</span> -</span><span id="coerce_type-38"><a href="#coerce_type-38"><span class="linenos">38</span></a> <span class="n">_coerce_date</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="s2">"low"</span><span class="p">])</span> -</span><span id="coerce_type-39"><a href="#coerce_type-39"><span class="linenos">39</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Extract</span><span class="p">):</span> -</span><span id="coerce_type-40"><a href="#coerce_type-40"><span class="linenos">40</span></a> <span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">TEMPORAL_TYPES</span><span class="p">:</span> -</span><span id="coerce_type-41"><a href="#coerce_type-41"><span class="linenos">41</span></a> <span class="n">_replace_cast</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="s2">"datetime"</span><span class="p">)</span> -</span><span id="coerce_type-42"><a href="#coerce_type-42"><span class="linenos">42</span></a> <span class="k">return</span> <span class="n">node</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="coerce_type-40"><a href="#coerce_type-40"><span class="linenos">40</span></a><span class="k">def</span> <span class="nf">coerce_type</span><span class="p">(</span><span class="n">node</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="coerce_type-41"><a href="#coerce_type-41"><span class="linenos">41</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Binary</span><span class="p">):</span> +</span><span id="coerce_type-42"><a href="#coerce_type-42"><span class="linenos">42</span></a> <span class="n">_coerce_date</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">left</span><span class="p">,</span> <span class="n">node</span><span class="o">.</span><span class="n">right</span><span class="p">)</span> +</span><span id="coerce_type-43"><a href="#coerce_type-43"><span class="linenos">43</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Between</span><span class="p">):</span> +</span><span id="coerce_type-44"><a href="#coerce_type-44"><span class="linenos">44</span></a> <span class="n">_coerce_date</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="s2">"low"</span><span class="p">])</span> +</span><span id="coerce_type-45"><a href="#coerce_type-45"><span class="linenos">45</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Extract</span><span class="p">):</span> +</span><span id="coerce_type-46"><a href="#coerce_type-46"><span class="linenos">46</span></a> <span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">exp</span><span class="o">.</span><span class="n">DataType</span><span class="o">.</span><span class="n">TEMPORAL_TYPES</span><span class="p">:</span> +</span><span id="coerce_type-47"><a href="#coerce_type-47"><span class="linenos">47</span></a> <span class="n">_replace_cast</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="s2">"datetime"</span><span class="p">)</span> +</span><span id="coerce_type-48"><a href="#coerce_type-48"><span class="linenos">48</span></a> <span class="k">return</span> <span class="n">node</span> </span></pre></div> @@ -244,15 +273,41 @@ conversions rely on type inference.</p> </div> <a class="headerlink" href="#remove_redundant_casts"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="remove_redundant_casts-45"><a href="#remove_redundant_casts-45"><span class="linenos">45</span></a><span class="k">def</span> <span class="nf">remove_redundant_casts</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> -</span><span id="remove_redundant_casts-46"><a href="#remove_redundant_casts-46"><span class="linenos">46</span></a> <span class="k">if</span> <span class="p">(</span> -</span><span id="remove_redundant_casts-47"><a href="#remove_redundant_casts-47"><span class="linenos">47</span></a> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Cast</span><span class="p">)</span> -</span><span id="remove_redundant_casts-48"><a href="#remove_redundant_casts-48"><span class="linenos">48</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">to</span><span class="o">.</span><span class="n">type</span> -</span><span id="remove_redundant_casts-49"><a href="#remove_redundant_casts-49"><span class="linenos">49</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">type</span> -</span><span id="remove_redundant_casts-50"><a href="#remove_redundant_casts-50"><span class="linenos">50</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">to</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="o">==</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> -</span><span id="remove_redundant_casts-51"><a href="#remove_redundant_casts-51"><span class="linenos">51</span></a> <span class="p">):</span> -</span><span id="remove_redundant_casts-52"><a href="#remove_redundant_casts-52"><span class="linenos">52</span></a> <span class="k">return</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span> -</span><span id="remove_redundant_casts-53"><a href="#remove_redundant_casts-53"><span class="linenos">53</span></a> <span class="k">return</span> <span class="n">expression</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="remove_redundant_casts-51"><a href="#remove_redundant_casts-51"><span class="linenos">51</span></a><span class="k">def</span> <span class="nf">remove_redundant_casts</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="remove_redundant_casts-52"><a href="#remove_redundant_casts-52"><span class="linenos">52</span></a> <span class="k">if</span> <span class="p">(</span> +</span><span id="remove_redundant_casts-53"><a href="#remove_redundant_casts-53"><span class="linenos">53</span></a> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Cast</span><span class="p">)</span> +</span><span id="remove_redundant_casts-54"><a href="#remove_redundant_casts-54"><span class="linenos">54</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">to</span><span class="o">.</span><span class="n">type</span> +</span><span id="remove_redundant_casts-55"><a href="#remove_redundant_casts-55"><span class="linenos">55</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">type</span> +</span><span id="remove_redundant_casts-56"><a href="#remove_redundant_casts-56"><span class="linenos">56</span></a> <span class="ow">and</span> <span class="n">expression</span><span class="o">.</span><span class="n">to</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> <span class="o">==</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">type</span><span class="o">.</span><span class="n">this</span> +</span><span id="remove_redundant_casts-57"><a href="#remove_redundant_casts-57"><span class="linenos">57</span></a> <span class="p">):</span> +</span><span id="remove_redundant_casts-58"><a href="#remove_redundant_casts-58"><span class="linenos">58</span></a> <span class="k">return</span> <span class="n">expression</span><span class="o">.</span><span class="n">this</span> +</span><span id="remove_redundant_casts-59"><a href="#remove_redundant_casts-59"><span class="linenos">59</span></a> <span class="k">return</span> <span class="n">expression</span> +</span></pre></div> + + + + + </section> + <section id="ensure_bool_predicates"> + <input id="ensure_bool_predicates-view-source" class="view-source-toggle-state" type="checkbox" aria-hidden="true" tabindex="-1"> +<div class="attr function"> + + <span class="def">def</span> + <span class="name">ensure_bool_predicates</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="n">expression</span><span class="p">:</span> <span class="n"><a href="../expressions.html#Expression">sqlglot.expressions.Expression</a></span></span><span class="return-annotation">) -> <span class="n"><a href="../expressions.html#Expression">sqlglot.expressions.Expression</a></span>:</span></span> + + <label class="view-source-button" for="ensure_bool_predicates-view-source"><span>View Source</span></label> + + </div> + <a class="headerlink" href="#ensure_bool_predicates"></a> + <div class="pdoc-code codehilite"><pre><span></span><span id="ensure_bool_predicates-62"><a href="#ensure_bool_predicates-62"><span class="linenos">62</span></a><span class="k">def</span> <span class="nf">ensure_bool_predicates</span><span class="p">(</span><span class="n">expression</span><span class="p">:</span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">)</span> <span class="o">-></span> <span class="n">exp</span><span class="o">.</span><span class="n">Expression</span><span class="p">:</span> +</span><span id="ensure_bool_predicates-63"><a href="#ensure_bool_predicates-63"><span class="linenos">63</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Connector</span><span class="p">):</span> +</span><span id="ensure_bool_predicates-64"><a href="#ensure_bool_predicates-64"><span class="linenos">64</span></a> <span class="n">_replace_int_predicate</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">left</span><span class="p">)</span> +</span><span id="ensure_bool_predicates-65"><a href="#ensure_bool_predicates-65"><span class="linenos">65</span></a> <span class="n">_replace_int_predicate</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">right</span><span class="p">)</span> +</span><span id="ensure_bool_predicates-66"><a href="#ensure_bool_predicates-66"><span class="linenos">66</span></a> +</span><span id="ensure_bool_predicates-67"><a href="#ensure_bool_predicates-67"><span class="linenos">67</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Where</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Having</span><span class="p">)):</span> +</span><span id="ensure_bool_predicates-68"><a href="#ensure_bool_predicates-68"><span class="linenos">68</span></a> <span class="n">_replace_int_predicate</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="p">)</span> +</span><span id="ensure_bool_predicates-69"><a href="#ensure_bool_predicates-69"><span class="linenos">69</span></a> +</span><span id="ensure_bool_predicates-70"><a href="#ensure_bool_predicates-70"><span class="linenos">70</span></a> <span class="k">return</span> <span class="n">expression</span> </span></pre></div> diff --git a/docs/sqlglot/optimizer/optimizer.html b/docs/sqlglot/optimizer/optimizer.html index efbece9..e6bbae7 100644 --- a/docs/sqlglot/optimizer/optimizer.html +++ b/docs/sqlglot/optimizer/optimizer.html @@ -156,7 +156,7 @@ <div class="attr function"> <span class="def">def</span> - <span class="name">optimize</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="n">expression</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="n"><a href="../expressions.html#Expression">sqlglot.expressions.Expression</a></span>,</span><span class="param"> <span class="n">schema</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n"><a href="../schema.html#Schema">sqlglot.schema.Schema</a></span><span class="p">,</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">db</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">catalog</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">dialect</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n"><a href="../dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">,</span> <span class="n">Type</span><span class="p">[</span><span class="n"><a href="../dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">],</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">rules</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="o"><</span><span class="n">function</span> <span class="n">lower_identities</span> <span class="n">at</span> <span class="mh">0x7f5daa39e830</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">qualify_tables</span> <span class="n">at</span> <span class="mh">0x7f5daa3a0ee0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">isolate_table_selects</span> <span class="n">at</span> <span class="mh">0x7f5daa39e7a0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">qualify_columns</span> <span class="n">at</span> <span class="mh">0x7f5daa39fd90</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">expand_laterals</span> <span class="n">at</span> <span class="mh">0x7f5daa39e560</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">pushdown_projections</span> <span class="n">at</span> <span class="mh">0x7f5daa3a08b0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">validate_qualify_columns</span> <span class="n">at</span> <span class="mh">0x7f5daa39fe20</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">normalize</span> <span class="n">at</span> <span class="mh">0x7f5daa39c550</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">unnest_subqueries</span> <span class="n">at</span> <span class="mh">0x7f5daa3a1000</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">expand_multi_table_selects</span> <span class="n">at</span> <span class="mh">0x7f5daa39e710</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">pushdown_predicates</span> <span class="n">at</span> <span class="mh">0x7f5daa39f910</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">optimize_joins</span> <span class="n">at</span> <span class="mh">0x7f5daa39f640</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">eliminate_subqueries</span> <span class="n">at</span> <span class="mh">0x7f5daa39e170</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">merge_subqueries</span> <span class="n">at</span> <span class="mh">0x7f5daa39eb00</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">eliminate_joins</span> <span class="n">at</span> <span class="mh">0x7f5daa39c3a0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">eliminate_ctes</span> <span class="n">at</span> <span class="mh">0x7f5daa39c280</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">annotate_types</span> <span class="n">at</span> <span class="mh">0x7f5daa324e50</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">canonicalize</span> <span class="n">at</span> <span class="mh">0x7f5daa3b7e20</span><span class="o">></span><span class="p">)</span>,</span><span class="param"> <span class="o">**</span><span class="n">kwargs</span></span><span class="return-annotation">):</span></span> + <span class="name">optimize</span><span class="signature pdoc-code multiline">(<span class="param"> <span class="n">expression</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="n"><a href="../expressions.html#Expression">sqlglot.expressions.Expression</a></span>,</span><span class="param"> <span class="n">schema</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n"><a href="../schema.html#Schema">sqlglot.schema.Schema</a></span><span class="p">,</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">db</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">catalog</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">dialect</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n"><a href="../dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">,</span> <span class="n">Type</span><span class="p">[</span><span class="n"><a href="../dialects/dialect.html#Dialect">sqlglot.dialects.dialect.Dialect</a></span><span class="p">],</span> <span class="n">NoneType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>,</span><span class="param"> <span class="n">rules</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="o"><</span><span class="n">function</span> <span class="n">lower_identities</span> <span class="n">at</span> <span class="mh">0x7fb8b87bc1f0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">qualify_tables</span> <span class="n">at</span> <span class="mh">0x7fb8b87be8c0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">isolate_table_selects</span> <span class="n">at</span> <span class="mh">0x7fb8b87bc160</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">qualify_columns</span> <span class="n">at</span> <span class="mh">0x7fb8b87bd7e0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">expand_laterals</span> <span class="n">at</span> <span class="mh">0x7fb8b87afeb0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">pushdown_projections</span> <span class="n">at</span> <span class="mh">0x7fb8b87be290</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">validate_qualify_columns</span> <span class="n">at</span> <span class="mh">0x7fb8b87bd870</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">normalize</span> <span class="n">at</span> <span class="mh">0x7fb8b87adea0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">unnest_subqueries</span> <span class="n">at</span> <span class="mh">0x7fb8b87be9e0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">expand_multi_table_selects</span> <span class="n">at</span> <span class="mh">0x7fb8b87bc0d0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">pushdown_predicates</span> <span class="n">at</span> <span class="mh">0x7fb8b87bd2d0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">optimize_joins</span> <span class="n">at</span> <span class="mh">0x7fb8b87bd000</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">eliminate_subqueries</span> <span class="n">at</span> <span class="mh">0x7fb8b87afac0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">merge_subqueries</span> <span class="n">at</span> <span class="mh">0x7fb8b87bc4c0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">eliminate_joins</span> <span class="n">at</span> <span class="mh">0x7fb8b87adcf0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">eliminate_ctes</span> <span class="n">at</span> <span class="mh">0x7fb8b87adbd0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">annotate_types</span> <span class="n">at</span> <span class="mh">0x7fb8b87465f0</span><span class="o">></span><span class="p">,</span> <span class="o"><</span><span class="n">function</span> <span class="n">canonicalize</span> <span class="n">at</span> <span class="mh">0x7fb8b87ad6c0</span><span class="o">></span><span class="p">)</span>,</span><span class="param"> <span class="o">**</span><span class="n">kwargs</span></span><span class="return-annotation">):</span></span> <label class="view-source-button" for="optimize-view-source"><span>View Source</span></label> diff --git a/docs/sqlglot/optimizer/pushdown_projections.html b/docs/sqlglot/optimizer/pushdown_projections.html index 54d7932..f0de386 100644 --- a/docs/sqlglot/optimizer/pushdown_projections.html +++ b/docs/sqlglot/optimizer/pushdown_projections.html @@ -62,99 +62,99 @@ <div class="pdoc-code codehilite"><pre><span></span><span id="L-1"><a href="#L-1"><span class="linenos"> 1</span></a><span class="kn">from</span> <span class="nn">collections</span> <span class="kn">import</span> <span class="n">defaultdict</span> </span><span id="L-2"><a href="#L-2"><span class="linenos"> 2</span></a> </span><span id="L-3"><a href="#L-3"><span class="linenos"> 3</span></a><span class="kn">from</span> <span class="nn">sqlglot</span> <span class="kn">import</span> <span class="n">alias</span><span class="p">,</span> <span class="n">exp</span> -</span><span id="L-4"><a href="#L-4"><span class="linenos"> 4</span></a><span class="kn">from</span> <span class="nn">sqlglot.helper</span> <span class="kn">import</span> <span class="n">flatten</span> -</span><span id="L-5"><a href="#L-5"><span class="linenos"> 5</span></a><span class="kn">from</span> <span class="nn">sqlglot.optimizer.qualify_columns</span> <span class="kn">import</span> <span class="n">Resolver</span> -</span><span id="L-6"><a href="#L-6"><span class="linenos"> 6</span></a><span class="kn">from</span> <span class="nn">sqlglot.optimizer.scope</span> <span class="kn">import</span> <span class="n">Scope</span><span class="p">,</span> <span class="n">traverse_scope</span> -</span><span id="L-7"><a href="#L-7"><span class="linenos"> 7</span></a><span class="kn">from</span> <span class="nn">sqlglot.schema</span> <span class="kn">import</span> <span class="n">ensure_schema</span> -</span><span id="L-8"><a href="#L-8"><span class="linenos"> 8</span></a> -</span><span id="L-9"><a href="#L-9"><span class="linenos"> 9</span></a><span class="c1"># Sentinel value that means an outer query selecting ALL columns</span> -</span><span id="L-10"><a href="#L-10"><span class="linenos"> 10</span></a><span class="n">SELECT_ALL</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span> -</span><span id="L-11"><a href="#L-11"><span class="linenos"> 11</span></a> -</span><span id="L-12"><a href="#L-12"><span class="linenos"> 12</span></a><span class="c1"># Selection to use if selection list is empty</span> -</span><span id="L-13"><a href="#L-13"><span class="linenos"> 13</span></a><span class="n">DEFAULT_SELECTION</span> <span class="o">=</span> <span class="k">lambda</span><span class="p">:</span> <span class="n">alias</span><span class="p">(</span><span class="s2">"1"</span><span class="p">,</span> <span class="s2">"_"</span><span class="p">)</span> +</span><span id="L-4"><a href="#L-4"><span class="linenos"> 4</span></a><span class="kn">from</span> <span class="nn">sqlglot.optimizer.qualify_columns</span> <span class="kn">import</span> <span class="n">Resolver</span> +</span><span id="L-5"><a href="#L-5"><span class="linenos"> 5</span></a><span class="kn">from</span> <span class="nn">sqlglot.optimizer.scope</span> <span class="kn">import</span> <span class="n">Scope</span><span class="p">,</span> <span class="n">traverse_scope</span> +</span><span id="L-6"><a href="#L-6"><span class="linenos"> 6</span></a><span class="kn">from</span> <span class="nn">sqlglot.schema</span> <span class="kn">import</span> <span class="n">ensure_schema</span> +</span><span id="L-7"><a href="#L-7"><span class="linenos"> 7</span></a> +</span><span id="L-8"><a href="#L-8"><span class="linenos"> 8</span></a><span class="c1"># Sentinel value that means an outer query selecting ALL columns</span> +</span><span id="L-9"><a href="#L-9"><span class="linenos"> 9</span></a><span class="n">SELECT_ALL</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span> +</span><span id="L-10"><a href="#L-10"><span class="linenos"> 10</span></a> +</span><span id="L-11"><a href="#L-11"><span class="linenos"> 11</span></a><span class="c1"># Selection to use if selection list is empty</span> +</span><span id="L-12"><a href="#L-12"><span class="linenos"> 12</span></a><span class="n">DEFAULT_SELECTION</span> <span class="o">=</span> <span class="k">lambda</span><span class="p">:</span> <span class="n">alias</span><span class="p">(</span><span class="s2">"1"</span><span class="p">,</span> <span class="s2">"_"</span><span class="p">)</span> +</span><span id="L-13"><a href="#L-13"><span class="linenos"> 13</span></a> </span><span id="L-14"><a href="#L-14"><span class="linenos"> 14</span></a> -</span><span id="L-15"><a href="#L-15"><span class="linenos"> 15</span></a> -</span><span id="L-16"><a href="#L-16"><span class="linenos"> 16</span></a><span class="k">def</span> <span class="nf">pushdown_projections</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">remove_unused_selections</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="L-17"><a href="#L-17"><span class="linenos"> 17</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-18"><a href="#L-18"><span class="linenos"> 18</span></a><span class="sd"> Rewrite sqlglot AST to remove unused columns projections.</span> -</span><span id="L-19"><a href="#L-19"><span class="linenos"> 19</span></a> -</span><span id="L-20"><a href="#L-20"><span class="linenos"> 20</span></a><span class="sd"> Example:</span> -</span><span id="L-21"><a href="#L-21"><span class="linenos"> 21</span></a><span class="sd"> >>> import sqlglot</span> -</span><span id="L-22"><a href="#L-22"><span class="linenos"> 22</span></a><span class="sd"> >>> sql = "SELECT y.a AS a FROM (SELECT x.a AS a, x.b AS b FROM x) AS y"</span> -</span><span id="L-23"><a href="#L-23"><span class="linenos"> 23</span></a><span class="sd"> >>> expression = sqlglot.parse_one(sql)</span> -</span><span id="L-24"><a href="#L-24"><span class="linenos"> 24</span></a><span class="sd"> >>> pushdown_projections(expression).sql()</span> -</span><span id="L-25"><a href="#L-25"><span class="linenos"> 25</span></a><span class="sd"> 'SELECT y.a AS a FROM (SELECT x.a AS a FROM x) AS y'</span> -</span><span id="L-26"><a href="#L-26"><span class="linenos"> 26</span></a> -</span><span id="L-27"><a href="#L-27"><span class="linenos"> 27</span></a><span class="sd"> Args:</span> -</span><span id="L-28"><a href="#L-28"><span class="linenos"> 28</span></a><span class="sd"> expression (sqlglot.Expression): expression to optimize</span> -</span><span id="L-29"><a href="#L-29"><span class="linenos"> 29</span></a><span class="sd"> remove_unused_selections (bool): remove selects that are unused</span> -</span><span id="L-30"><a href="#L-30"><span class="linenos"> 30</span></a><span class="sd"> Returns:</span> -</span><span id="L-31"><a href="#L-31"><span class="linenos"> 31</span></a><span class="sd"> sqlglot.Expression: optimized expression</span> -</span><span id="L-32"><a href="#L-32"><span class="linenos"> 32</span></a><span class="sd"> """</span> -</span><span id="L-33"><a href="#L-33"><span class="linenos"> 33</span></a> <span class="c1"># Map of Scope to all columns being selected by outer queries.</span> -</span><span id="L-34"><a href="#L-34"><span class="linenos"> 34</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="n">ensure_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> -</span><span id="L-35"><a href="#L-35"><span class="linenos"> 35</span></a> <span class="n">referenced_columns</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">set</span><span class="p">)</span> -</span><span id="L-36"><a href="#L-36"><span class="linenos"> 36</span></a> -</span><span id="L-37"><a href="#L-37"><span class="linenos"> 37</span></a> <span class="c1"># We build the scope tree (which is traversed in DFS postorder), then iterate</span> -</span><span id="L-38"><a href="#L-38"><span class="linenos"> 38</span></a> <span class="c1"># over the result in reverse order. This should ensure that the set of selected</span> -</span><span id="L-39"><a href="#L-39"><span class="linenos"> 39</span></a> <span class="c1"># columns for a particular scope are completely build by the time we get to it.</span> -</span><span id="L-40"><a href="#L-40"><span class="linenos"> 40</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)):</span> -</span><span id="L-41"><a href="#L-41"><span class="linenos"> 41</span></a> <span class="n">parent_selections</span> <span class="o">=</span> <span class="n">referenced_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="p">{</span><span class="n">SELECT_ALL</span><span class="p">})</span> -</span><span id="L-42"><a href="#L-42"><span class="linenos"> 42</span></a> -</span><span id="L-43"><a href="#L-43"><span class="linenos"> 43</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"distinct"</span><span class="p">):</span> -</span><span id="L-44"><a href="#L-44"><span class="linenos"> 44</span></a> <span class="c1"># We can't remove columns SELECT DISTINCT nor UNION DISTINCT</span> -</span><span id="L-45"><a href="#L-45"><span class="linenos"> 45</span></a> <span class="n">parent_selections</span> <span class="o">=</span> <span class="p">{</span><span class="n">SELECT_ALL</span><span class="p">}</span> -</span><span id="L-46"><a href="#L-46"><span class="linenos"> 46</span></a> -</span><span id="L-47"><a href="#L-47"><span class="linenos"> 47</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> -</span><span id="L-48"><a href="#L-48"><span class="linenos"> 48</span></a> <span class="n">left</span><span class="p">,</span> <span class="n">right</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">union_scopes</span> -</span><span id="L-49"><a href="#L-49"><span class="linenos"> 49</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">left</span><span class="p">]</span> <span class="o">=</span> <span class="n">parent_selections</span> -</span><span id="L-50"><a href="#L-50"><span class="linenos"> 50</span></a> -</span><span id="L-51"><a href="#L-51"><span class="linenos"> 51</span></a> <span class="k">if</span> <span class="nb">any</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">is_star</span> <span class="k">for</span> <span class="n">select</span> <span class="ow">in</span> <span class="n">right</span><span class="o">.</span><span class="n">selects</span><span class="p">):</span> -</span><span id="L-52"><a href="#L-52"><span class="linenos"> 52</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">right</span><span class="p">]</span> <span class="o">=</span> <span class="n">parent_selections</span> -</span><span id="L-53"><a href="#L-53"><span class="linenos"> 53</span></a> <span class="k">elif</span> <span class="ow">not</span> <span class="nb">any</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">is_star</span> <span class="k">for</span> <span class="n">select</span> <span class="ow">in</span> <span class="n">left</span><span class="o">.</span><span class="n">selects</span><span class="p">):</span> -</span><span id="L-54"><a href="#L-54"><span class="linenos"> 54</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">right</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span> -</span><span id="L-55"><a href="#L-55"><span class="linenos"> 55</span></a> <span class="n">right</span><span class="o">.</span><span class="n">selects</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">alias_or_name</span> -</span><span id="L-56"><a href="#L-56"><span class="linenos"> 56</span></a> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">select</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">left</span><span class="o">.</span><span class="n">selects</span><span class="p">)</span> -</span><span id="L-57"><a href="#L-57"><span class="linenos"> 57</span></a> <span class="k">if</span> <span class="n">SELECT_ALL</span> <span class="ow">in</span> <span class="n">parent_selections</span> <span class="ow">or</span> <span class="n">select</span><span class="o">.</span><span class="n">alias_or_name</span> <span class="ow">in</span> <span class="n">parent_selections</span> -</span><span id="L-58"><a href="#L-58"><span class="linenos"> 58</span></a> <span class="p">]</span> -</span><span id="L-59"><a href="#L-59"><span class="linenos"> 59</span></a> -</span><span id="L-60"><a href="#L-60"><span class="linenos"> 60</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> -</span><span id="L-61"><a href="#L-61"><span class="linenos"> 61</span></a> <span class="k">if</span> <span class="n">remove_unused_selections</span><span class="p">:</span> -</span><span id="L-62"><a href="#L-62"><span class="linenos"> 62</span></a> <span class="n">_remove_unused_selections</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">parent_selections</span><span class="p">,</span> <span class="n">schema</span><span class="p">)</span> -</span><span id="L-63"><a href="#L-63"><span class="linenos"> 63</span></a> -</span><span id="L-64"><a href="#L-64"><span class="linenos"> 64</span></a> <span class="c1"># Group columns by source name</span> -</span><span id="L-65"><a href="#L-65"><span class="linenos"> 65</span></a> <span class="n">selects</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">set</span><span class="p">)</span> -</span><span id="L-66"><a href="#L-66"><span class="linenos"> 66</span></a> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">columns</span><span class="p">:</span> -</span><span id="L-67"><a href="#L-67"><span class="linenos"> 67</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">col</span><span class="o">.</span><span class="n">table</span> -</span><span id="L-68"><a href="#L-68"><span class="linenos"> 68</span></a> <span class="n">col_name</span> <span class="o">=</span> <span class="n">col</span><span class="o">.</span><span class="n">name</span> -</span><span id="L-69"><a href="#L-69"><span class="linenos"> 69</span></a> <span class="n">selects</span><span class="p">[</span><span class="n">table_name</span><span class="p">]</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">col_name</span><span class="p">)</span> -</span><span id="L-70"><a href="#L-70"><span class="linenos"> 70</span></a> -</span><span id="L-71"><a href="#L-71"><span class="linenos"> 71</span></a> <span class="c1"># Push the selected columns down to the next scope</span> -</span><span id="L-72"><a href="#L-72"><span class="linenos"> 72</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="p">(</span><span class="n">_</span><span class="p">,</span> <span class="n">source</span><span class="p">)</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> -</span><span id="L-73"><a href="#L-73"><span class="linenos"> 73</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">):</span> -</span><span id="L-74"><a href="#L-74"><span class="linenos"> 74</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">selects</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="ow">or</span> <span class="nb">set</span><span class="p">()</span> -</span><span id="L-75"><a href="#L-75"><span class="linenos"> 75</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">source</span><span class="p">]</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> -</span><span id="L-76"><a href="#L-76"><span class="linenos"> 76</span></a> -</span><span id="L-77"><a href="#L-77"><span class="linenos"> 77</span></a> <span class="k">return</span> <span class="n">expression</span> +</span><span id="L-15"><a href="#L-15"><span class="linenos"> 15</span></a><span class="k">def</span> <span class="nf">pushdown_projections</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">remove_unused_selections</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="L-16"><a href="#L-16"><span class="linenos"> 16</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-17"><a href="#L-17"><span class="linenos"> 17</span></a><span class="sd"> Rewrite sqlglot AST to remove unused columns projections.</span> +</span><span id="L-18"><a href="#L-18"><span class="linenos"> 18</span></a> +</span><span id="L-19"><a href="#L-19"><span class="linenos"> 19</span></a><span class="sd"> Example:</span> +</span><span id="L-20"><a href="#L-20"><span class="linenos"> 20</span></a><span class="sd"> >>> import sqlglot</span> +</span><span id="L-21"><a href="#L-21"><span class="linenos"> 21</span></a><span class="sd"> >>> sql = "SELECT y.a AS a FROM (SELECT x.a AS a, x.b AS b FROM x) AS y"</span> +</span><span id="L-22"><a href="#L-22"><span class="linenos"> 22</span></a><span class="sd"> >>> expression = sqlglot.parse_one(sql)</span> +</span><span id="L-23"><a href="#L-23"><span class="linenos"> 23</span></a><span class="sd"> >>> pushdown_projections(expression).sql()</span> +</span><span id="L-24"><a href="#L-24"><span class="linenos"> 24</span></a><span class="sd"> 'SELECT y.a AS a FROM (SELECT x.a AS a FROM x) AS y'</span> +</span><span id="L-25"><a href="#L-25"><span class="linenos"> 25</span></a> +</span><span id="L-26"><a href="#L-26"><span class="linenos"> 26</span></a><span class="sd"> Args:</span> +</span><span id="L-27"><a href="#L-27"><span class="linenos"> 27</span></a><span class="sd"> expression (sqlglot.Expression): expression to optimize</span> +</span><span id="L-28"><a href="#L-28"><span class="linenos"> 28</span></a><span class="sd"> remove_unused_selections (bool): remove selects that are unused</span> +</span><span id="L-29"><a href="#L-29"><span class="linenos"> 29</span></a><span class="sd"> Returns:</span> +</span><span id="L-30"><a href="#L-30"><span class="linenos"> 30</span></a><span class="sd"> sqlglot.Expression: optimized expression</span> +</span><span id="L-31"><a href="#L-31"><span class="linenos"> 31</span></a><span class="sd"> """</span> +</span><span id="L-32"><a href="#L-32"><span class="linenos"> 32</span></a> <span class="c1"># Map of Scope to all columns being selected by outer queries.</span> +</span><span id="L-33"><a href="#L-33"><span class="linenos"> 33</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="n">ensure_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> +</span><span id="L-34"><a href="#L-34"><span class="linenos"> 34</span></a> <span class="n">referenced_columns</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">set</span><span class="p">)</span> +</span><span id="L-35"><a href="#L-35"><span class="linenos"> 35</span></a> +</span><span id="L-36"><a href="#L-36"><span class="linenos"> 36</span></a> <span class="c1"># We build the scope tree (which is traversed in DFS postorder), then iterate</span> +</span><span id="L-37"><a href="#L-37"><span class="linenos"> 37</span></a> <span class="c1"># over the result in reverse order. This should ensure that the set of selected</span> +</span><span id="L-38"><a href="#L-38"><span class="linenos"> 38</span></a> <span class="c1"># columns for a particular scope are completely build by the time we get to it.</span> +</span><span id="L-39"><a href="#L-39"><span class="linenos"> 39</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)):</span> +</span><span id="L-40"><a href="#L-40"><span class="linenos"> 40</span></a> <span class="n">parent_selections</span> <span class="o">=</span> <span class="n">referenced_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="p">{</span><span class="n">SELECT_ALL</span><span class="p">})</span> +</span><span id="L-41"><a href="#L-41"><span class="linenos"> 41</span></a> +</span><span id="L-42"><a href="#L-42"><span class="linenos"> 42</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"distinct"</span><span class="p">):</span> +</span><span id="L-43"><a href="#L-43"><span class="linenos"> 43</span></a> <span class="c1"># We can't remove columns SELECT DISTINCT nor UNION DISTINCT</span> +</span><span id="L-44"><a href="#L-44"><span class="linenos"> 44</span></a> <span class="n">parent_selections</span> <span class="o">=</span> <span class="p">{</span><span class="n">SELECT_ALL</span><span class="p">}</span> +</span><span id="L-45"><a href="#L-45"><span class="linenos"> 45</span></a> +</span><span id="L-46"><a href="#L-46"><span class="linenos"> 46</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> +</span><span id="L-47"><a href="#L-47"><span class="linenos"> 47</span></a> <span class="n">left</span><span class="p">,</span> <span class="n">right</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">union_scopes</span> +</span><span id="L-48"><a href="#L-48"><span class="linenos"> 48</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">left</span><span class="p">]</span> <span class="o">=</span> <span class="n">parent_selections</span> +</span><span id="L-49"><a href="#L-49"><span class="linenos"> 49</span></a> +</span><span id="L-50"><a href="#L-50"><span class="linenos"> 50</span></a> <span class="k">if</span> <span class="nb">any</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">is_star</span> <span class="k">for</span> <span class="n">select</span> <span class="ow">in</span> <span class="n">right</span><span class="o">.</span><span class="n">selects</span><span class="p">):</span> +</span><span id="L-51"><a href="#L-51"><span class="linenos"> 51</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">right</span><span class="p">]</span> <span class="o">=</span> <span class="n">parent_selections</span> +</span><span id="L-52"><a href="#L-52"><span class="linenos"> 52</span></a> <span class="k">elif</span> <span class="ow">not</span> <span class="nb">any</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">is_star</span> <span class="k">for</span> <span class="n">select</span> <span class="ow">in</span> <span class="n">left</span><span class="o">.</span><span class="n">selects</span><span class="p">):</span> +</span><span id="L-53"><a href="#L-53"><span class="linenos"> 53</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">right</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span> +</span><span id="L-54"><a href="#L-54"><span class="linenos"> 54</span></a> <span class="n">right</span><span class="o">.</span><span class="n">selects</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">alias_or_name</span> +</span><span id="L-55"><a href="#L-55"><span class="linenos"> 55</span></a> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">select</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">left</span><span class="o">.</span><span class="n">selects</span><span class="p">)</span> +</span><span id="L-56"><a href="#L-56"><span class="linenos"> 56</span></a> <span class="k">if</span> <span class="n">SELECT_ALL</span> <span class="ow">in</span> <span class="n">parent_selections</span> <span class="ow">or</span> <span class="n">select</span><span class="o">.</span><span class="n">alias_or_name</span> <span class="ow">in</span> <span class="n">parent_selections</span> +</span><span id="L-57"><a href="#L-57"><span class="linenos"> 57</span></a> <span class="p">]</span> +</span><span id="L-58"><a href="#L-58"><span class="linenos"> 58</span></a> +</span><span id="L-59"><a href="#L-59"><span class="linenos"> 59</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> +</span><span id="L-60"><a href="#L-60"><span class="linenos"> 60</span></a> <span class="k">if</span> <span class="n">remove_unused_selections</span><span class="p">:</span> +</span><span id="L-61"><a href="#L-61"><span class="linenos"> 61</span></a> <span class="n">_remove_unused_selections</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">parent_selections</span><span class="p">,</span> <span class="n">schema</span><span class="p">)</span> +</span><span id="L-62"><a href="#L-62"><span class="linenos"> 62</span></a> +</span><span id="L-63"><a href="#L-63"><span class="linenos"> 63</span></a> <span class="c1"># Group columns by source name</span> +</span><span id="L-64"><a href="#L-64"><span class="linenos"> 64</span></a> <span class="n">selects</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">set</span><span class="p">)</span> +</span><span id="L-65"><a href="#L-65"><span class="linenos"> 65</span></a> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">columns</span><span class="p">:</span> +</span><span id="L-66"><a href="#L-66"><span class="linenos"> 66</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">col</span><span class="o">.</span><span class="n">table</span> +</span><span id="L-67"><a href="#L-67"><span class="linenos"> 67</span></a> <span class="n">col_name</span> <span class="o">=</span> <span class="n">col</span><span class="o">.</span><span class="n">name</span> +</span><span id="L-68"><a href="#L-68"><span class="linenos"> 68</span></a> <span class="n">selects</span><span class="p">[</span><span class="n">table_name</span><span class="p">]</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">col_name</span><span class="p">)</span> +</span><span id="L-69"><a href="#L-69"><span class="linenos"> 69</span></a> +</span><span id="L-70"><a href="#L-70"><span class="linenos"> 70</span></a> <span class="c1"># Push the selected columns down to the next scope</span> +</span><span id="L-71"><a href="#L-71"><span class="linenos"> 71</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="p">(</span><span class="n">_</span><span class="p">,</span> <span class="n">source</span><span class="p">)</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> +</span><span id="L-72"><a href="#L-72"><span class="linenos"> 72</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">):</span> +</span><span id="L-73"><a href="#L-73"><span class="linenos"> 73</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">selects</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="ow">or</span> <span class="nb">set</span><span class="p">()</span> +</span><span id="L-74"><a href="#L-74"><span class="linenos"> 74</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">source</span><span class="p">]</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> +</span><span id="L-75"><a href="#L-75"><span class="linenos"> 75</span></a> +</span><span id="L-76"><a href="#L-76"><span class="linenos"> 76</span></a> <span class="k">return</span> <span class="n">expression</span> +</span><span id="L-77"><a href="#L-77"><span class="linenos"> 77</span></a> </span><span id="L-78"><a href="#L-78"><span class="linenos"> 78</span></a> -</span><span id="L-79"><a href="#L-79"><span class="linenos"> 79</span></a> -</span><span id="L-80"><a href="#L-80"><span class="linenos"> 80</span></a><span class="k">def</span> <span class="nf">_remove_unused_selections</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">parent_selections</span><span class="p">,</span> <span class="n">schema</span><span class="p">):</span> -</span><span id="L-81"><a href="#L-81"><span class="linenos"> 81</span></a> <span class="n">order</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"order"</span><span class="p">)</span> -</span><span id="L-82"><a href="#L-82"><span class="linenos"> 82</span></a> -</span><span id="L-83"><a href="#L-83"><span class="linenos"> 83</span></a> <span class="k">if</span> <span class="n">order</span><span class="p">:</span> -</span><span id="L-84"><a href="#L-84"><span class="linenos"> 84</span></a> <span class="c1"># Assume columns without a qualified table are references to output columns</span> -</span><span id="L-85"><a href="#L-85"><span class="linenos"> 85</span></a> <span class="n">order_refs</span> <span class="o">=</span> <span class="p">{</span><span class="n">c</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="n">order</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">)</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span><span class="p">}</span> -</span><span id="L-86"><a href="#L-86"><span class="linenos"> 86</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-87"><a href="#L-87"><span class="linenos"> 87</span></a> <span class="n">order_refs</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span> -</span><span id="L-88"><a href="#L-88"><span class="linenos"> 88</span></a> -</span><span id="L-89"><a href="#L-89"><span class="linenos"> 89</span></a> <span class="n">new_selections</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">list</span><span class="p">)</span> -</span><span id="L-90"><a href="#L-90"><span class="linenos"> 90</span></a> <span class="n">removed</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="L-91"><a href="#L-91"><span class="linenos"> 91</span></a> <span class="n">star</span> <span class="o">=</span> <span class="kc">False</span> +</span><span id="L-79"><a href="#L-79"><span class="linenos"> 79</span></a><span class="k">def</span> <span class="nf">_remove_unused_selections</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">parent_selections</span><span class="p">,</span> <span class="n">schema</span><span class="p">):</span> +</span><span id="L-80"><a href="#L-80"><span class="linenos"> 80</span></a> <span class="n">order</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"order"</span><span class="p">)</span> +</span><span id="L-81"><a href="#L-81"><span class="linenos"> 81</span></a> +</span><span id="L-82"><a href="#L-82"><span class="linenos"> 82</span></a> <span class="k">if</span> <span class="n">order</span><span class="p">:</span> +</span><span id="L-83"><a href="#L-83"><span class="linenos"> 83</span></a> <span class="c1"># Assume columns without a qualified table are references to output columns</span> +</span><span id="L-84"><a href="#L-84"><span class="linenos"> 84</span></a> <span class="n">order_refs</span> <span class="o">=</span> <span class="p">{</span><span class="n">c</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="n">order</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">)</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span><span class="p">}</span> +</span><span id="L-85"><a href="#L-85"><span class="linenos"> 85</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-86"><a href="#L-86"><span class="linenos"> 86</span></a> <span class="n">order_refs</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span> +</span><span id="L-87"><a href="#L-87"><span class="linenos"> 87</span></a> +</span><span id="L-88"><a href="#L-88"><span class="linenos"> 88</span></a> <span class="n">new_selections</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-89"><a href="#L-89"><span class="linenos"> 89</span></a> <span class="n">removed</span> <span class="o">=</span> <span class="kc">False</span> +</span><span id="L-90"><a href="#L-90"><span class="linenos"> 90</span></a> <span class="n">star</span> <span class="o">=</span> <span class="kc">False</span> +</span><span id="L-91"><a href="#L-91"><span class="linenos"> 91</span></a> </span><span id="L-92"><a href="#L-92"><span class="linenos"> 92</span></a> <span class="k">for</span> <span class="n">selection</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selects</span><span class="p">:</span> </span><span id="L-93"><a href="#L-93"><span class="linenos"> 93</span></a> <span class="n">name</span> <span class="o">=</span> <span class="n">selection</span><span class="o">.</span><span class="n">alias_or_name</span> </span><span id="L-94"><a href="#L-94"><span class="linenos"> 94</span></a> </span><span id="L-95"><a href="#L-95"><span class="linenos"> 95</span></a> <span class="k">if</span> <span class="n">SELECT_ALL</span> <span class="ow">in</span> <span class="n">parent_selections</span> <span class="ow">or</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">parent_selections</span> <span class="ow">or</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">order_refs</span><span class="p">:</span> -</span><span id="L-96"><a href="#L-96"><span class="linenos"> 96</span></a> <span class="n">new_selections</span><span class="p">[</span><span class="n">name</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">selection</span><span class="p">)</span> +</span><span id="L-96"><a href="#L-96"><span class="linenos"> 96</span></a> <span class="n">new_selections</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">selection</span><span class="p">)</span> </span><span id="L-97"><a href="#L-97"><span class="linenos"> 97</span></a> <span class="k">else</span><span class="p">:</span> </span><span id="L-98"><a href="#L-98"><span class="linenos"> 98</span></a> <span class="k">if</span> <span class="n">selection</span><span class="o">.</span><span class="n">is_star</span><span class="p">:</span> </span><span id="L-99"><a href="#L-99"><span class="linenos"> 99</span></a> <span class="n">star</span> <span class="o">=</span> <span class="kc">True</span> @@ -162,21 +162,20 @@ </span><span id="L-101"><a href="#L-101"><span class="linenos">101</span></a> </span><span id="L-102"><a href="#L-102"><span class="linenos">102</span></a> <span class="k">if</span> <span class="n">star</span><span class="p">:</span> </span><span id="L-103"><a href="#L-103"><span class="linenos">103</span></a> <span class="n">resolver</span> <span class="o">=</span> <span class="n">Resolver</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">schema</span><span class="p">)</span> -</span><span id="L-104"><a href="#L-104"><span class="linenos">104</span></a> -</span><span id="L-105"><a href="#L-105"><span class="linenos">105</span></a> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">parent_selections</span><span class="p">):</span> -</span><span id="L-106"><a href="#L-106"><span class="linenos">106</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">new_selections</span><span class="p">:</span> -</span><span id="L-107"><a href="#L-107"><span class="linenos">107</span></a> <span class="n">new_selections</span><span class="p">[</span><span class="n">name</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span> -</span><span id="L-108"><a href="#L-108"><span class="linenos">108</span></a> <span class="n">alias</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">table</span><span class="o">=</span><span class="n">resolver</span><span class="o">.</span><span class="n">get_table</span><span class="p">(</span><span class="n">name</span><span class="p">)),</span> <span class="n">name</span><span class="p">)</span> -</span><span id="L-109"><a href="#L-109"><span class="linenos">109</span></a> <span class="p">)</span> -</span><span id="L-110"><a href="#L-110"><span class="linenos">110</span></a> -</span><span id="L-111"><a href="#L-111"><span class="linenos">111</span></a> <span class="c1"># If there are no remaining selections, just select a single constant</span> -</span><span id="L-112"><a href="#L-112"><span class="linenos">112</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">new_selections</span><span class="p">:</span> -</span><span id="L-113"><a href="#L-113"><span class="linenos">113</span></a> <span class="n">new_selections</span><span class="p">[</span><span class="s2">""</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">DEFAULT_SELECTION</span><span class="p">())</span> -</span><span id="L-114"><a href="#L-114"><span class="linenos">114</span></a> -</span><span id="L-115"><a href="#L-115"><span class="linenos">115</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">flatten</span><span class="p">(</span><span class="n">new_selections</span><span class="o">.</span><span class="n">values</span><span class="p">()),</span> <span class="n">append</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> -</span><span id="L-116"><a href="#L-116"><span class="linenos">116</span></a> -</span><span id="L-117"><a href="#L-117"><span class="linenos">117</span></a> <span class="k">if</span> <span class="n">removed</span><span class="p">:</span> -</span><span id="L-118"><a href="#L-118"><span class="linenos">118</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> +</span><span id="L-104"><a href="#L-104"><span class="linenos">104</span></a> <span class="n">names</span> <span class="o">=</span> <span class="p">{</span><span class="n">s</span><span class="o">.</span><span class="n">alias_or_name</span> <span class="k">for</span> <span class="n">s</span> <span class="ow">in</span> <span class="n">new_selections</span><span class="p">}</span> +</span><span id="L-105"><a href="#L-105"><span class="linenos">105</span></a> +</span><span id="L-106"><a href="#L-106"><span class="linenos">106</span></a> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">parent_selections</span><span class="p">):</span> +</span><span id="L-107"><a href="#L-107"><span class="linenos">107</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">names</span><span class="p">:</span> +</span><span id="L-108"><a href="#L-108"><span class="linenos">108</span></a> <span class="n">new_selections</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">alias</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">table</span><span class="o">=</span><span class="n">resolver</span><span class="o">.</span><span class="n">get_table</span><span class="p">(</span><span class="n">name</span><span class="p">)),</span> <span class="n">name</span><span class="p">))</span> +</span><span id="L-109"><a href="#L-109"><span class="linenos">109</span></a> +</span><span id="L-110"><a href="#L-110"><span class="linenos">110</span></a> <span class="c1"># If there are no remaining selections, just select a single constant</span> +</span><span id="L-111"><a href="#L-111"><span class="linenos">111</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">new_selections</span><span class="p">:</span> +</span><span id="L-112"><a href="#L-112"><span class="linenos">112</span></a> <span class="n">new_selections</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">DEFAULT_SELECTION</span><span class="p">())</span> +</span><span id="L-113"><a href="#L-113"><span class="linenos">113</span></a> +</span><span id="L-114"><a href="#L-114"><span class="linenos">114</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">new_selections</span><span class="p">,</span> <span class="n">append</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> +</span><span id="L-115"><a href="#L-115"><span class="linenos">115</span></a> +</span><span id="L-116"><a href="#L-116"><span class="linenos">116</span></a> <span class="k">if</span> <span class="n">removed</span><span class="p">:</span> +</span><span id="L-117"><a href="#L-117"><span class="linenos">117</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> </span></pre></div> @@ -192,7 +191,7 @@ </div> <a class="headerlink" href="#DEFAULT_SELECTION"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="DEFAULT_SELECTION-14"><a href="#DEFAULT_SELECTION-14"><span class="linenos">14</span></a><span class="n">DEFAULT_SELECTION</span> <span class="o">=</span> <span class="k">lambda</span><span class="p">:</span> <span class="n">alias</span><span class="p">(</span><span class="s2">"1"</span><span class="p">,</span> <span class="s2">"_"</span><span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="DEFAULT_SELECTION-13"><a href="#DEFAULT_SELECTION-13"><span class="linenos">13</span></a><span class="n">DEFAULT_SELECTION</span> <span class="o">=</span> <span class="k">lambda</span><span class="p">:</span> <span class="n">alias</span><span class="p">(</span><span class="s2">"1"</span><span class="p">,</span> <span class="s2">"_"</span><span class="p">)</span> </span></pre></div> @@ -210,68 +209,68 @@ </div> <a class="headerlink" href="#pushdown_projections"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="pushdown_projections-17"><a href="#pushdown_projections-17"><span class="linenos">17</span></a><span class="k">def</span> <span class="nf">pushdown_projections</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">remove_unused_selections</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="pushdown_projections-18"><a href="#pushdown_projections-18"><span class="linenos">18</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="pushdown_projections-19"><a href="#pushdown_projections-19"><span class="linenos">19</span></a><span class="sd"> Rewrite sqlglot AST to remove unused columns projections.</span> -</span><span id="pushdown_projections-20"><a href="#pushdown_projections-20"><span class="linenos">20</span></a> -</span><span id="pushdown_projections-21"><a href="#pushdown_projections-21"><span class="linenos">21</span></a><span class="sd"> Example:</span> -</span><span id="pushdown_projections-22"><a href="#pushdown_projections-22"><span class="linenos">22</span></a><span class="sd"> >>> import sqlglot</span> -</span><span id="pushdown_projections-23"><a href="#pushdown_projections-23"><span class="linenos">23</span></a><span class="sd"> >>> sql = "SELECT y.a AS a FROM (SELECT x.a AS a, x.b AS b FROM x) AS y"</span> -</span><span id="pushdown_projections-24"><a href="#pushdown_projections-24"><span class="linenos">24</span></a><span class="sd"> >>> expression = sqlglot.parse_one(sql)</span> -</span><span id="pushdown_projections-25"><a href="#pushdown_projections-25"><span class="linenos">25</span></a><span class="sd"> >>> pushdown_projections(expression).sql()</span> -</span><span id="pushdown_projections-26"><a href="#pushdown_projections-26"><span class="linenos">26</span></a><span class="sd"> 'SELECT y.a AS a FROM (SELECT x.a AS a FROM x) AS y'</span> -</span><span id="pushdown_projections-27"><a href="#pushdown_projections-27"><span class="linenos">27</span></a> -</span><span id="pushdown_projections-28"><a href="#pushdown_projections-28"><span class="linenos">28</span></a><span class="sd"> Args:</span> -</span><span id="pushdown_projections-29"><a href="#pushdown_projections-29"><span class="linenos">29</span></a><span class="sd"> expression (sqlglot.Expression): expression to optimize</span> -</span><span id="pushdown_projections-30"><a href="#pushdown_projections-30"><span class="linenos">30</span></a><span class="sd"> remove_unused_selections (bool): remove selects that are unused</span> -</span><span id="pushdown_projections-31"><a href="#pushdown_projections-31"><span class="linenos">31</span></a><span class="sd"> Returns:</span> -</span><span id="pushdown_projections-32"><a href="#pushdown_projections-32"><span class="linenos">32</span></a><span class="sd"> sqlglot.Expression: optimized expression</span> -</span><span id="pushdown_projections-33"><a href="#pushdown_projections-33"><span class="linenos">33</span></a><span class="sd"> """</span> -</span><span id="pushdown_projections-34"><a href="#pushdown_projections-34"><span class="linenos">34</span></a> <span class="c1"># Map of Scope to all columns being selected by outer queries.</span> -</span><span id="pushdown_projections-35"><a href="#pushdown_projections-35"><span class="linenos">35</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="n">ensure_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> -</span><span id="pushdown_projections-36"><a href="#pushdown_projections-36"><span class="linenos">36</span></a> <span class="n">referenced_columns</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">set</span><span class="p">)</span> -</span><span id="pushdown_projections-37"><a href="#pushdown_projections-37"><span class="linenos">37</span></a> -</span><span id="pushdown_projections-38"><a href="#pushdown_projections-38"><span class="linenos">38</span></a> <span class="c1"># We build the scope tree (which is traversed in DFS postorder), then iterate</span> -</span><span id="pushdown_projections-39"><a href="#pushdown_projections-39"><span class="linenos">39</span></a> <span class="c1"># over the result in reverse order. This should ensure that the set of selected</span> -</span><span id="pushdown_projections-40"><a href="#pushdown_projections-40"><span class="linenos">40</span></a> <span class="c1"># columns for a particular scope are completely build by the time we get to it.</span> -</span><span id="pushdown_projections-41"><a href="#pushdown_projections-41"><span class="linenos">41</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)):</span> -</span><span id="pushdown_projections-42"><a href="#pushdown_projections-42"><span class="linenos">42</span></a> <span class="n">parent_selections</span> <span class="o">=</span> <span class="n">referenced_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="p">{</span><span class="n">SELECT_ALL</span><span class="p">})</span> -</span><span id="pushdown_projections-43"><a href="#pushdown_projections-43"><span class="linenos">43</span></a> -</span><span id="pushdown_projections-44"><a href="#pushdown_projections-44"><span class="linenos">44</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"distinct"</span><span class="p">):</span> -</span><span id="pushdown_projections-45"><a href="#pushdown_projections-45"><span class="linenos">45</span></a> <span class="c1"># We can't remove columns SELECT DISTINCT nor UNION DISTINCT</span> -</span><span id="pushdown_projections-46"><a href="#pushdown_projections-46"><span class="linenos">46</span></a> <span class="n">parent_selections</span> <span class="o">=</span> <span class="p">{</span><span class="n">SELECT_ALL</span><span class="p">}</span> -</span><span id="pushdown_projections-47"><a href="#pushdown_projections-47"><span class="linenos">47</span></a> -</span><span id="pushdown_projections-48"><a href="#pushdown_projections-48"><span class="linenos">48</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> -</span><span id="pushdown_projections-49"><a href="#pushdown_projections-49"><span class="linenos">49</span></a> <span class="n">left</span><span class="p">,</span> <span class="n">right</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">union_scopes</span> -</span><span id="pushdown_projections-50"><a href="#pushdown_projections-50"><span class="linenos">50</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">left</span><span class="p">]</span> <span class="o">=</span> <span class="n">parent_selections</span> -</span><span id="pushdown_projections-51"><a href="#pushdown_projections-51"><span class="linenos">51</span></a> -</span><span id="pushdown_projections-52"><a href="#pushdown_projections-52"><span class="linenos">52</span></a> <span class="k">if</span> <span class="nb">any</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">is_star</span> <span class="k">for</span> <span class="n">select</span> <span class="ow">in</span> <span class="n">right</span><span class="o">.</span><span class="n">selects</span><span class="p">):</span> -</span><span id="pushdown_projections-53"><a href="#pushdown_projections-53"><span class="linenos">53</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">right</span><span class="p">]</span> <span class="o">=</span> <span class="n">parent_selections</span> -</span><span id="pushdown_projections-54"><a href="#pushdown_projections-54"><span class="linenos">54</span></a> <span class="k">elif</span> <span class="ow">not</span> <span class="nb">any</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">is_star</span> <span class="k">for</span> <span class="n">select</span> <span class="ow">in</span> <span class="n">left</span><span class="o">.</span><span class="n">selects</span><span class="p">):</span> -</span><span id="pushdown_projections-55"><a href="#pushdown_projections-55"><span class="linenos">55</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">right</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span> -</span><span id="pushdown_projections-56"><a href="#pushdown_projections-56"><span class="linenos">56</span></a> <span class="n">right</span><span class="o">.</span><span class="n">selects</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">alias_or_name</span> -</span><span id="pushdown_projections-57"><a href="#pushdown_projections-57"><span class="linenos">57</span></a> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">select</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">left</span><span class="o">.</span><span class="n">selects</span><span class="p">)</span> -</span><span id="pushdown_projections-58"><a href="#pushdown_projections-58"><span class="linenos">58</span></a> <span class="k">if</span> <span class="n">SELECT_ALL</span> <span class="ow">in</span> <span class="n">parent_selections</span> <span class="ow">or</span> <span class="n">select</span><span class="o">.</span><span class="n">alias_or_name</span> <span class="ow">in</span> <span class="n">parent_selections</span> -</span><span id="pushdown_projections-59"><a href="#pushdown_projections-59"><span class="linenos">59</span></a> <span class="p">]</span> -</span><span id="pushdown_projections-60"><a href="#pushdown_projections-60"><span class="linenos">60</span></a> -</span><span id="pushdown_projections-61"><a href="#pushdown_projections-61"><span class="linenos">61</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> -</span><span id="pushdown_projections-62"><a href="#pushdown_projections-62"><span class="linenos">62</span></a> <span class="k">if</span> <span class="n">remove_unused_selections</span><span class="p">:</span> -</span><span id="pushdown_projections-63"><a href="#pushdown_projections-63"><span class="linenos">63</span></a> <span class="n">_remove_unused_selections</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">parent_selections</span><span class="p">,</span> <span class="n">schema</span><span class="p">)</span> -</span><span id="pushdown_projections-64"><a href="#pushdown_projections-64"><span class="linenos">64</span></a> -</span><span id="pushdown_projections-65"><a href="#pushdown_projections-65"><span class="linenos">65</span></a> <span class="c1"># Group columns by source name</span> -</span><span id="pushdown_projections-66"><a href="#pushdown_projections-66"><span class="linenos">66</span></a> <span class="n">selects</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">set</span><span class="p">)</span> -</span><span id="pushdown_projections-67"><a href="#pushdown_projections-67"><span class="linenos">67</span></a> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">columns</span><span class="p">:</span> -</span><span id="pushdown_projections-68"><a href="#pushdown_projections-68"><span class="linenos">68</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">col</span><span class="o">.</span><span class="n">table</span> -</span><span id="pushdown_projections-69"><a href="#pushdown_projections-69"><span class="linenos">69</span></a> <span class="n">col_name</span> <span class="o">=</span> <span class="n">col</span><span class="o">.</span><span class="n">name</span> -</span><span id="pushdown_projections-70"><a href="#pushdown_projections-70"><span class="linenos">70</span></a> <span class="n">selects</span><span class="p">[</span><span class="n">table_name</span><span class="p">]</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">col_name</span><span class="p">)</span> -</span><span id="pushdown_projections-71"><a href="#pushdown_projections-71"><span class="linenos">71</span></a> -</span><span id="pushdown_projections-72"><a href="#pushdown_projections-72"><span class="linenos">72</span></a> <span class="c1"># Push the selected columns down to the next scope</span> -</span><span id="pushdown_projections-73"><a href="#pushdown_projections-73"><span class="linenos">73</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="p">(</span><span class="n">_</span><span class="p">,</span> <span class="n">source</span><span class="p">)</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> -</span><span id="pushdown_projections-74"><a href="#pushdown_projections-74"><span class="linenos">74</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">):</span> -</span><span id="pushdown_projections-75"><a href="#pushdown_projections-75"><span class="linenos">75</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">selects</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="ow">or</span> <span class="nb">set</span><span class="p">()</span> -</span><span id="pushdown_projections-76"><a href="#pushdown_projections-76"><span class="linenos">76</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">source</span><span class="p">]</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> -</span><span id="pushdown_projections-77"><a href="#pushdown_projections-77"><span class="linenos">77</span></a> -</span><span id="pushdown_projections-78"><a href="#pushdown_projections-78"><span class="linenos">78</span></a> <span class="k">return</span> <span class="n">expression</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="pushdown_projections-16"><a href="#pushdown_projections-16"><span class="linenos">16</span></a><span class="k">def</span> <span class="nf">pushdown_projections</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">remove_unused_selections</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="pushdown_projections-17"><a href="#pushdown_projections-17"><span class="linenos">17</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="pushdown_projections-18"><a href="#pushdown_projections-18"><span class="linenos">18</span></a><span class="sd"> Rewrite sqlglot AST to remove unused columns projections.</span> +</span><span id="pushdown_projections-19"><a href="#pushdown_projections-19"><span class="linenos">19</span></a> +</span><span id="pushdown_projections-20"><a href="#pushdown_projections-20"><span class="linenos">20</span></a><span class="sd"> Example:</span> +</span><span id="pushdown_projections-21"><a href="#pushdown_projections-21"><span class="linenos">21</span></a><span class="sd"> >>> import sqlglot</span> +</span><span id="pushdown_projections-22"><a href="#pushdown_projections-22"><span class="linenos">22</span></a><span class="sd"> >>> sql = "SELECT y.a AS a FROM (SELECT x.a AS a, x.b AS b FROM x) AS y"</span> +</span><span id="pushdown_projections-23"><a href="#pushdown_projections-23"><span class="linenos">23</span></a><span class="sd"> >>> expression = sqlglot.parse_one(sql)</span> +</span><span id="pushdown_projections-24"><a href="#pushdown_projections-24"><span class="linenos">24</span></a><span class="sd"> >>> pushdown_projections(expression).sql()</span> +</span><span id="pushdown_projections-25"><a href="#pushdown_projections-25"><span class="linenos">25</span></a><span class="sd"> 'SELECT y.a AS a FROM (SELECT x.a AS a FROM x) AS y'</span> +</span><span id="pushdown_projections-26"><a href="#pushdown_projections-26"><span class="linenos">26</span></a> +</span><span id="pushdown_projections-27"><a href="#pushdown_projections-27"><span class="linenos">27</span></a><span class="sd"> Args:</span> +</span><span id="pushdown_projections-28"><a href="#pushdown_projections-28"><span class="linenos">28</span></a><span class="sd"> expression (sqlglot.Expression): expression to optimize</span> +</span><span id="pushdown_projections-29"><a href="#pushdown_projections-29"><span class="linenos">29</span></a><span class="sd"> remove_unused_selections (bool): remove selects that are unused</span> +</span><span id="pushdown_projections-30"><a href="#pushdown_projections-30"><span class="linenos">30</span></a><span class="sd"> Returns:</span> +</span><span id="pushdown_projections-31"><a href="#pushdown_projections-31"><span class="linenos">31</span></a><span class="sd"> sqlglot.Expression: optimized expression</span> +</span><span id="pushdown_projections-32"><a href="#pushdown_projections-32"><span class="linenos">32</span></a><span class="sd"> """</span> +</span><span id="pushdown_projections-33"><a href="#pushdown_projections-33"><span class="linenos">33</span></a> <span class="c1"># Map of Scope to all columns being selected by outer queries.</span> +</span><span id="pushdown_projections-34"><a href="#pushdown_projections-34"><span class="linenos">34</span></a> <span class="n">schema</span> <span class="o">=</span> <span class="n">ensure_schema</span><span class="p">(</span><span class="n">schema</span><span class="p">)</span> +</span><span id="pushdown_projections-35"><a href="#pushdown_projections-35"><span class="linenos">35</span></a> <span class="n">referenced_columns</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">set</span><span class="p">)</span> +</span><span id="pushdown_projections-36"><a href="#pushdown_projections-36"><span class="linenos">36</span></a> +</span><span id="pushdown_projections-37"><a href="#pushdown_projections-37"><span class="linenos">37</span></a> <span class="c1"># We build the scope tree (which is traversed in DFS postorder), then iterate</span> +</span><span id="pushdown_projections-38"><a href="#pushdown_projections-38"><span class="linenos">38</span></a> <span class="c1"># over the result in reverse order. This should ensure that the set of selected</span> +</span><span id="pushdown_projections-39"><a href="#pushdown_projections-39"><span class="linenos">39</span></a> <span class="c1"># columns for a particular scope are completely build by the time we get to it.</span> +</span><span id="pushdown_projections-40"><a href="#pushdown_projections-40"><span class="linenos">40</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)):</span> +</span><span id="pushdown_projections-41"><a href="#pushdown_projections-41"><span class="linenos">41</span></a> <span class="n">parent_selections</span> <span class="o">=</span> <span class="n">referenced_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="p">{</span><span class="n">SELECT_ALL</span><span class="p">})</span> +</span><span id="pushdown_projections-42"><a href="#pushdown_projections-42"><span class="linenos">42</span></a> +</span><span id="pushdown_projections-43"><a href="#pushdown_projections-43"><span class="linenos">43</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"distinct"</span><span class="p">):</span> +</span><span id="pushdown_projections-44"><a href="#pushdown_projections-44"><span class="linenos">44</span></a> <span class="c1"># We can't remove columns SELECT DISTINCT nor UNION DISTINCT</span> +</span><span id="pushdown_projections-45"><a href="#pushdown_projections-45"><span class="linenos">45</span></a> <span class="n">parent_selections</span> <span class="o">=</span> <span class="p">{</span><span class="n">SELECT_ALL</span><span class="p">}</span> +</span><span id="pushdown_projections-46"><a href="#pushdown_projections-46"><span class="linenos">46</span></a> +</span><span id="pushdown_projections-47"><a href="#pushdown_projections-47"><span class="linenos">47</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> +</span><span id="pushdown_projections-48"><a href="#pushdown_projections-48"><span class="linenos">48</span></a> <span class="n">left</span><span class="p">,</span> <span class="n">right</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">union_scopes</span> +</span><span id="pushdown_projections-49"><a href="#pushdown_projections-49"><span class="linenos">49</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">left</span><span class="p">]</span> <span class="o">=</span> <span class="n">parent_selections</span> +</span><span id="pushdown_projections-50"><a href="#pushdown_projections-50"><span class="linenos">50</span></a> +</span><span id="pushdown_projections-51"><a href="#pushdown_projections-51"><span class="linenos">51</span></a> <span class="k">if</span> <span class="nb">any</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">is_star</span> <span class="k">for</span> <span class="n">select</span> <span class="ow">in</span> <span class="n">right</span><span class="o">.</span><span class="n">selects</span><span class="p">):</span> +</span><span id="pushdown_projections-52"><a href="#pushdown_projections-52"><span class="linenos">52</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">right</span><span class="p">]</span> <span class="o">=</span> <span class="n">parent_selections</span> +</span><span id="pushdown_projections-53"><a href="#pushdown_projections-53"><span class="linenos">53</span></a> <span class="k">elif</span> <span class="ow">not</span> <span class="nb">any</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">is_star</span> <span class="k">for</span> <span class="n">select</span> <span class="ow">in</span> <span class="n">left</span><span class="o">.</span><span class="n">selects</span><span class="p">):</span> +</span><span id="pushdown_projections-54"><a href="#pushdown_projections-54"><span class="linenos">54</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">right</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span> +</span><span id="pushdown_projections-55"><a href="#pushdown_projections-55"><span class="linenos">55</span></a> <span class="n">right</span><span class="o">.</span><span class="n">selects</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">alias_or_name</span> +</span><span id="pushdown_projections-56"><a href="#pushdown_projections-56"><span class="linenos">56</span></a> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">select</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">left</span><span class="o">.</span><span class="n">selects</span><span class="p">)</span> +</span><span id="pushdown_projections-57"><a href="#pushdown_projections-57"><span class="linenos">57</span></a> <span class="k">if</span> <span class="n">SELECT_ALL</span> <span class="ow">in</span> <span class="n">parent_selections</span> <span class="ow">or</span> <span class="n">select</span><span class="o">.</span><span class="n">alias_or_name</span> <span class="ow">in</span> <span class="n">parent_selections</span> +</span><span id="pushdown_projections-58"><a href="#pushdown_projections-58"><span class="linenos">58</span></a> <span class="p">]</span> +</span><span id="pushdown_projections-59"><a href="#pushdown_projections-59"><span class="linenos">59</span></a> +</span><span id="pushdown_projections-60"><a href="#pushdown_projections-60"><span class="linenos">60</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> +</span><span id="pushdown_projections-61"><a href="#pushdown_projections-61"><span class="linenos">61</span></a> <span class="k">if</span> <span class="n">remove_unused_selections</span><span class="p">:</span> +</span><span id="pushdown_projections-62"><a href="#pushdown_projections-62"><span class="linenos">62</span></a> <span class="n">_remove_unused_selections</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">parent_selections</span><span class="p">,</span> <span class="n">schema</span><span class="p">)</span> +</span><span id="pushdown_projections-63"><a href="#pushdown_projections-63"><span class="linenos">63</span></a> +</span><span id="pushdown_projections-64"><a href="#pushdown_projections-64"><span class="linenos">64</span></a> <span class="c1"># Group columns by source name</span> +</span><span id="pushdown_projections-65"><a href="#pushdown_projections-65"><span class="linenos">65</span></a> <span class="n">selects</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">set</span><span class="p">)</span> +</span><span id="pushdown_projections-66"><a href="#pushdown_projections-66"><span class="linenos">66</span></a> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">columns</span><span class="p">:</span> +</span><span id="pushdown_projections-67"><a href="#pushdown_projections-67"><span class="linenos">67</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">col</span><span class="o">.</span><span class="n">table</span> +</span><span id="pushdown_projections-68"><a href="#pushdown_projections-68"><span class="linenos">68</span></a> <span class="n">col_name</span> <span class="o">=</span> <span class="n">col</span><span class="o">.</span><span class="n">name</span> +</span><span id="pushdown_projections-69"><a href="#pushdown_projections-69"><span class="linenos">69</span></a> <span class="n">selects</span><span class="p">[</span><span class="n">table_name</span><span class="p">]</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">col_name</span><span class="p">)</span> +</span><span id="pushdown_projections-70"><a href="#pushdown_projections-70"><span class="linenos">70</span></a> +</span><span id="pushdown_projections-71"><a href="#pushdown_projections-71"><span class="linenos">71</span></a> <span class="c1"># Push the selected columns down to the next scope</span> +</span><span id="pushdown_projections-72"><a href="#pushdown_projections-72"><span class="linenos">72</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="p">(</span><span class="n">_</span><span class="p">,</span> <span class="n">source</span><span class="p">)</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> +</span><span id="pushdown_projections-73"><a href="#pushdown_projections-73"><span class="linenos">73</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">):</span> +</span><span id="pushdown_projections-74"><a href="#pushdown_projections-74"><span class="linenos">74</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">selects</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="ow">or</span> <span class="nb">set</span><span class="p">()</span> +</span><span id="pushdown_projections-75"><a href="#pushdown_projections-75"><span class="linenos">75</span></a> <span class="n">referenced_columns</span><span class="p">[</span><span class="n">source</span><span class="p">]</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> +</span><span id="pushdown_projections-76"><a href="#pushdown_projections-76"><span class="linenos">76</span></a> +</span><span id="pushdown_projections-77"><a href="#pushdown_projections-77"><span class="linenos">77</span></a> <span class="k">return</span> <span class="n">expression</span> </span></pre></div> diff --git a/docs/sqlglot/optimizer/qualify_columns.html b/docs/sqlglot/optimizer/qualify_columns.html index 7f7fadd..8de0b29 100644 --- a/docs/sqlglot/optimizer/qualify_columns.html +++ b/docs/sqlglot/optimizer/qualify_columns.html @@ -116,425 +116,455 @@ </span><span id="L-37"><a href="#L-37"><span class="linenos"> 37</span></a> <span class="n">_qualify_outputs</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> </span><span id="L-38"><a href="#L-38"><span class="linenos"> 38</span></a> <span class="n">_expand_group_by</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">)</span> </span><span id="L-39"><a href="#L-39"><span class="linenos"> 39</span></a> <span class="n">_expand_order_by</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> -</span><span id="L-40"><a href="#L-40"><span class="linenos"> 40</span></a> <span class="k">return</span> <span class="n">expression</span> -</span><span id="L-41"><a href="#L-41"><span class="linenos"> 41</span></a> +</span><span id="L-40"><a href="#L-40"><span class="linenos"> 40</span></a> +</span><span id="L-41"><a href="#L-41"><span class="linenos"> 41</span></a> <span class="k">return</span> <span class="n">expression</span> </span><span id="L-42"><a href="#L-42"><span class="linenos"> 42</span></a> -</span><span id="L-43"><a href="#L-43"><span class="linenos"> 43</span></a><span class="k">def</span> <span class="nf">validate_qualify_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> -</span><span id="L-44"><a href="#L-44"><span class="linenos"> 44</span></a><span class="w"> </span><span class="sd">"""Raise an `OptimizeError` if any columns aren't qualified"""</span> -</span><span id="L-45"><a href="#L-45"><span class="linenos"> 45</span></a> <span class="n">unqualified_columns</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-46"><a href="#L-46"><span class="linenos"> 46</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> -</span><span id="L-47"><a href="#L-47"><span class="linenos"> 47</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> -</span><span id="L-48"><a href="#L-48"><span class="linenos"> 48</span></a> <span class="n">unqualified_columns</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">unqualified_columns</span><span class="p">)</span> -</span><span id="L-49"><a href="#L-49"><span class="linenos"> 49</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">scope</span><span class="o">.</span><span class="n">is_correlated_subquery</span><span class="p">:</span> -</span><span id="L-50"><a href="#L-50"><span class="linenos"> 50</span></a> <span class="n">column</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> -</span><span id="L-51"><a href="#L-51"><span class="linenos"> 51</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: '</span><span class="si">{</span><span class="n">column</span><span class="o">.</span><span class="n">table</span><span class="si">}</span><span class="s2">' for column '</span><span class="si">{</span><span class="n">column</span><span class="si">}</span><span class="s2">'"</span><span class="p">)</span> -</span><span id="L-52"><a href="#L-52"><span class="linenos"> 52</span></a> -</span><span id="L-53"><a href="#L-53"><span class="linenos"> 53</span></a> <span class="k">if</span> <span class="n">unqualified_columns</span><span class="p">:</span> -</span><span id="L-54"><a href="#L-54"><span class="linenos"> 54</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous columns: </span><span class="si">{</span><span class="n">unqualified_columns</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-55"><a href="#L-55"><span class="linenos"> 55</span></a> <span class="k">return</span> <span class="n">expression</span> -</span><span id="L-56"><a href="#L-56"><span class="linenos"> 56</span></a> +</span><span id="L-43"><a href="#L-43"><span class="linenos"> 43</span></a> +</span><span id="L-44"><a href="#L-44"><span class="linenos"> 44</span></a><span class="k">def</span> <span class="nf">validate_qualify_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> +</span><span id="L-45"><a href="#L-45"><span class="linenos"> 45</span></a><span class="w"> </span><span class="sd">"""Raise an `OptimizeError` if any columns aren't qualified"""</span> +</span><span id="L-46"><a href="#L-46"><span class="linenos"> 46</span></a> <span class="n">unqualified_columns</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-47"><a href="#L-47"><span class="linenos"> 47</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> +</span><span id="L-48"><a href="#L-48"><span class="linenos"> 48</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> +</span><span id="L-49"><a href="#L-49"><span class="linenos"> 49</span></a> <span class="n">unqualified_columns</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">unqualified_columns</span><span class="p">)</span> +</span><span id="L-50"><a href="#L-50"><span class="linenos"> 50</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">scope</span><span class="o">.</span><span class="n">is_correlated_subquery</span><span class="p">:</span> +</span><span id="L-51"><a href="#L-51"><span class="linenos"> 51</span></a> <span class="n">column</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> +</span><span id="L-52"><a href="#L-52"><span class="linenos"> 52</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: '</span><span class="si">{</span><span class="n">column</span><span class="o">.</span><span class="n">table</span><span class="si">}</span><span class="s2">' for column '</span><span class="si">{</span><span class="n">column</span><span class="si">}</span><span class="s2">'"</span><span class="p">)</span> +</span><span id="L-53"><a href="#L-53"><span class="linenos"> 53</span></a> +</span><span id="L-54"><a href="#L-54"><span class="linenos"> 54</span></a> <span class="k">if</span> <span class="n">unqualified_columns</span><span class="p">:</span> +</span><span id="L-55"><a href="#L-55"><span class="linenos"> 55</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous columns: </span><span class="si">{</span><span class="n">unqualified_columns</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-56"><a href="#L-56"><span class="linenos"> 56</span></a> <span class="k">return</span> <span class="n">expression</span> </span><span id="L-57"><a href="#L-57"><span class="linenos"> 57</span></a> -</span><span id="L-58"><a href="#L-58"><span class="linenos"> 58</span></a><span class="k">def</span> <span class="nf">_pop_table_column_aliases</span><span class="p">(</span><span class="n">derived_tables</span><span class="p">):</span> -</span><span id="L-59"><a href="#L-59"><span class="linenos"> 59</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-60"><a href="#L-60"><span class="linenos"> 60</span></a><span class="sd"> Remove table column aliases.</span> -</span><span id="L-61"><a href="#L-61"><span class="linenos"> 61</span></a> -</span><span id="L-62"><a href="#L-62"><span class="linenos"> 62</span></a><span class="sd"> (e.g. SELECT ... FROM (SELECT ...) AS foo(col1, col2)</span> -</span><span id="L-63"><a href="#L-63"><span class="linenos"> 63</span></a><span class="sd"> """</span> -</span><span id="L-64"><a href="#L-64"><span class="linenos"> 64</span></a> <span class="k">for</span> <span class="n">derived_table</span> <span class="ow">in</span> <span class="n">derived_tables</span><span class="p">:</span> -</span><span id="L-65"><a href="#L-65"><span class="linenos"> 65</span></a> <span class="n">table_alias</span> <span class="o">=</span> <span class="n">derived_table</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> -</span><span id="L-66"><a href="#L-66"><span class="linenos"> 66</span></a> <span class="k">if</span> <span class="n">table_alias</span><span class="p">:</span> -</span><span id="L-67"><a href="#L-67"><span class="linenos"> 67</span></a> <span class="n">table_alias</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">"columns"</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> -</span><span id="L-68"><a href="#L-68"><span class="linenos"> 68</span></a> +</span><span id="L-58"><a href="#L-58"><span class="linenos"> 58</span></a> +</span><span id="L-59"><a href="#L-59"><span class="linenos"> 59</span></a><span class="k">def</span> <span class="nf">_pop_table_column_aliases</span><span class="p">(</span><span class="n">derived_tables</span><span class="p">):</span> +</span><span id="L-60"><a href="#L-60"><span class="linenos"> 60</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-61"><a href="#L-61"><span class="linenos"> 61</span></a><span class="sd"> Remove table column aliases.</span> +</span><span id="L-62"><a href="#L-62"><span class="linenos"> 62</span></a> +</span><span id="L-63"><a href="#L-63"><span class="linenos"> 63</span></a><span class="sd"> (e.g. SELECT ... FROM (SELECT ...) AS foo(col1, col2)</span> +</span><span id="L-64"><a href="#L-64"><span class="linenos"> 64</span></a><span class="sd"> """</span> +</span><span id="L-65"><a href="#L-65"><span class="linenos"> 65</span></a> <span class="k">for</span> <span class="n">derived_table</span> <span class="ow">in</span> <span class="n">derived_tables</span><span class="p">:</span> +</span><span id="L-66"><a href="#L-66"><span class="linenos"> 66</span></a> <span class="n">table_alias</span> <span class="o">=</span> <span class="n">derived_table</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> +</span><span id="L-67"><a href="#L-67"><span class="linenos"> 67</span></a> <span class="k">if</span> <span class="n">table_alias</span><span class="p">:</span> +</span><span id="L-68"><a href="#L-68"><span class="linenos"> 68</span></a> <span class="n">table_alias</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">"columns"</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> </span><span id="L-69"><a href="#L-69"><span class="linenos"> 69</span></a> -</span><span id="L-70"><a href="#L-70"><span class="linenos"> 70</span></a><span class="k">def</span> <span class="nf">_expand_using</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">):</span> -</span><span id="L-71"><a href="#L-71"><span class="linenos"> 71</span></a> <span class="n">joins</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">))</span> -</span><span id="L-72"><a href="#L-72"><span class="linenos"> 72</span></a> <span class="n">names</span> <span class="o">=</span> <span class="p">{</span><span class="n">join</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">alias</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins</span><span class="p">}</span> -</span><span id="L-73"><a href="#L-73"><span class="linenos"> 73</span></a> <span class="n">ordered</span> <span class="o">=</span> <span class="p">[</span><span class="n">key</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span> <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">names</span><span class="p">]</span> -</span><span id="L-74"><a href="#L-74"><span class="linenos"> 74</span></a> -</span><span id="L-75"><a href="#L-75"><span class="linenos"> 75</span></a> <span class="c1"># Mapping of automatically joined column names to source names</span> -</span><span id="L-76"><a href="#L-76"><span class="linenos"> 76</span></a> <span class="n">column_tables</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="L-77"><a href="#L-77"><span class="linenos"> 77</span></a> -</span><span id="L-78"><a href="#L-78"><span class="linenos"> 78</span></a> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins</span><span class="p">:</span> -</span><span id="L-79"><a href="#L-79"><span class="linenos"> 79</span></a> <span class="n">using</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"using"</span><span class="p">)</span> -</span><span id="L-80"><a href="#L-80"><span class="linenos"> 80</span></a> -</span><span id="L-81"><a href="#L-81"><span class="linenos"> 81</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">using</span><span class="p">:</span> -</span><span id="L-82"><a href="#L-82"><span class="linenos"> 82</span></a> <span class="k">continue</span> -</span><span id="L-83"><a href="#L-83"><span class="linenos"> 83</span></a> -</span><span id="L-84"><a href="#L-84"><span class="linenos"> 84</span></a> <span class="n">join_table</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">alias_or_name</span> -</span><span id="L-85"><a href="#L-85"><span class="linenos"> 85</span></a> -</span><span id="L-86"><a href="#L-86"><span class="linenos"> 86</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="L-87"><a href="#L-87"><span class="linenos"> 87</span></a> -</span><span id="L-88"><a href="#L-88"><span class="linenos"> 88</span></a> <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">:</span> -</span><span id="L-89"><a href="#L-89"><span class="linenos"> 89</span></a> <span class="k">if</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">ordered</span><span class="p">:</span> -</span><span id="L-90"><a href="#L-90"><span class="linenos"> 90</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">k</span><span class="p">):</span> -</span><span id="L-91"><a href="#L-91"><span class="linenos"> 91</span></a> <span class="k">if</span> <span class="n">column</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> -</span><span id="L-92"><a href="#L-92"><span class="linenos"> 92</span></a> <span class="n">columns</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">k</span> -</span><span id="L-93"><a href="#L-93"><span class="linenos"> 93</span></a> -</span><span id="L-94"><a href="#L-94"><span class="linenos"> 94</span></a> <span class="n">ordered</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">join_table</span><span class="p">)</span> -</span><span id="L-95"><a href="#L-95"><span class="linenos"> 95</span></a> <span class="n">join_columns</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">join_table</span><span class="p">)</span> -</span><span id="L-96"><a href="#L-96"><span class="linenos"> 96</span></a> <span class="n">conditions</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-97"><a href="#L-97"><span class="linenos"> 97</span></a> -</span><span id="L-98"><a href="#L-98"><span class="linenos"> 98</span></a> <span class="k">for</span> <span class="n">identifier</span> <span class="ow">in</span> <span class="n">using</span><span class="p">:</span> -</span><span id="L-99"><a href="#L-99"><span class="linenos"> 99</span></a> <span class="n">identifier</span> <span class="o">=</span> <span class="n">identifier</span><span class="o">.</span><span class="n">name</span> -</span><span id="L-100"><a href="#L-100"><span class="linenos">100</span></a> <span class="n">table</span> <span class="o">=</span> <span class="n">columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">identifier</span><span class="p">)</span> -</span><span id="L-101"><a href="#L-101"><span class="linenos">101</span></a> -</span><span id="L-102"><a href="#L-102"><span class="linenos">102</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table</span> <span class="ow">or</span> <span class="n">identifier</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">join_columns</span><span class="p">:</span> -</span><span id="L-103"><a href="#L-103"><span class="linenos">103</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Cannot automatically join: </span><span class="si">{</span><span class="n">identifier</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-104"><a href="#L-104"><span class="linenos">104</span></a> -</span><span id="L-105"><a href="#L-105"><span class="linenos">105</span></a> <span class="n">conditions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span> -</span><span id="L-106"><a href="#L-106"><span class="linenos">106</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">condition</span><span class="p">(</span> -</span><span id="L-107"><a href="#L-107"><span class="linenos">107</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">EQ</span><span class="p">(</span> -</span><span id="L-108"><a href="#L-108"><span class="linenos">108</span></a> <span class="n">this</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">identifier</span><span class="p">,</span> <span class="n">table</span><span class="o">=</span><span class="n">table</span><span class="p">),</span> -</span><span id="L-109"><a href="#L-109"><span class="linenos">109</span></a> <span class="n">expression</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">identifier</span><span class="p">,</span> <span class="n">table</span><span class="o">=</span><span class="n">join_table</span><span class="p">),</span> -</span><span id="L-110"><a href="#L-110"><span class="linenos">110</span></a> <span class="p">)</span> -</span><span id="L-111"><a href="#L-111"><span class="linenos">111</span></a> <span class="p">)</span> -</span><span id="L-112"><a href="#L-112"><span class="linenos">112</span></a> <span class="p">)</span> -</span><span id="L-113"><a href="#L-113"><span class="linenos">113</span></a> -</span><span id="L-114"><a href="#L-114"><span class="linenos">114</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="n">column_tables</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">identifier</span><span class="p">,</span> <span class="p">[])</span> -</span><span id="L-115"><a href="#L-115"><span class="linenos">115</span></a> <span class="k">if</span> <span class="n">table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> -</span><span id="L-116"><a href="#L-116"><span class="linenos">116</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">table</span><span class="p">)</span> -</span><span id="L-117"><a href="#L-117"><span class="linenos">117</span></a> <span class="k">if</span> <span class="n">join_table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> -</span><span id="L-118"><a href="#L-118"><span class="linenos">118</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">join_table</span><span class="p">)</span> -</span><span id="L-119"><a href="#L-119"><span class="linenos">119</span></a> -</span><span id="L-120"><a href="#L-120"><span class="linenos">120</span></a> <span class="n">join</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">"using"</span><span class="p">)</span> -</span><span id="L-121"><a href="#L-121"><span class="linenos">121</span></a> <span class="n">join</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"on"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">and_</span><span class="p">(</span><span class="o">*</span><span class="n">conditions</span><span class="p">))</span> -</span><span id="L-122"><a href="#L-122"><span class="linenos">122</span></a> -</span><span id="L-123"><a href="#L-123"><span class="linenos">123</span></a> <span class="k">if</span> <span class="n">column_tables</span><span class="p">:</span> -</span><span id="L-124"><a href="#L-124"><span class="linenos">124</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">columns</span><span class="p">:</span> -</span><span id="L-125"><a href="#L-125"><span class="linenos">125</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="n">column_tables</span><span class="p">:</span> -</span><span id="L-126"><a href="#L-126"><span class="linenos">126</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="n">column_tables</span><span class="p">[</span><span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> -</span><span id="L-127"><a href="#L-127"><span class="linenos">127</span></a> <span class="n">coalesce</span> <span class="o">=</span> <span class="p">[</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">table</span><span class="o">=</span><span class="n">table</span><span class="p">)</span> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">]</span> -</span><span id="L-128"><a href="#L-128"><span class="linenos">128</span></a> <span class="n">replacement</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">Coalesce</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">coalesce</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">expressions</span><span class="o">=</span><span class="n">coalesce</span><span class="p">[</span><span class="mi">1</span><span class="p">:])</span> -</span><span id="L-129"><a href="#L-129"><span class="linenos">129</span></a> -</span><span id="L-130"><a href="#L-130"><span class="linenos">130</span></a> <span class="c1"># Ensure selects keep their output name</span> -</span><span id="L-131"><a href="#L-131"><span class="linenos">131</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> -</span><span id="L-132"><a href="#L-132"><span class="linenos">132</span></a> <span class="n">replacement</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">alias_</span><span class="p">(</span><span class="n">replacement</span><span class="p">,</span> <span class="n">alias</span><span class="o">=</span><span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> -</span><span id="L-133"><a href="#L-133"><span class="linenos">133</span></a> -</span><span id="L-134"><a href="#L-134"><span class="linenos">134</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="n">replacement</span><span class="p">)</span> -</span><span id="L-135"><a href="#L-135"><span class="linenos">135</span></a> +</span><span id="L-70"><a href="#L-70"><span class="linenos"> 70</span></a> +</span><span id="L-71"><a href="#L-71"><span class="linenos"> 71</span></a><span class="k">def</span> <span class="nf">_expand_using</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">):</span> +</span><span id="L-72"><a href="#L-72"><span class="linenos"> 72</span></a> <span class="n">joins</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">))</span> +</span><span id="L-73"><a href="#L-73"><span class="linenos"> 73</span></a> <span class="n">names</span> <span class="o">=</span> <span class="p">{</span><span class="n">join</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">alias</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins</span><span class="p">}</span> +</span><span id="L-74"><a href="#L-74"><span class="linenos"> 74</span></a> <span class="n">ordered</span> <span class="o">=</span> <span class="p">[</span><span class="n">key</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span> <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">names</span><span class="p">]</span> +</span><span id="L-75"><a href="#L-75"><span class="linenos"> 75</span></a> +</span><span id="L-76"><a href="#L-76"><span class="linenos"> 76</span></a> <span class="c1"># Mapping of automatically joined column names to source names</span> +</span><span id="L-77"><a href="#L-77"><span class="linenos"> 77</span></a> <span class="n">column_tables</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-78"><a href="#L-78"><span class="linenos"> 78</span></a> +</span><span id="L-79"><a href="#L-79"><span class="linenos"> 79</span></a> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins</span><span class="p">:</span> +</span><span id="L-80"><a href="#L-80"><span class="linenos"> 80</span></a> <span class="n">using</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"using"</span><span class="p">)</span> +</span><span id="L-81"><a href="#L-81"><span class="linenos"> 81</span></a> +</span><span id="L-82"><a href="#L-82"><span class="linenos"> 82</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">using</span><span class="p">:</span> +</span><span id="L-83"><a href="#L-83"><span class="linenos"> 83</span></a> <span class="k">continue</span> +</span><span id="L-84"><a href="#L-84"><span class="linenos"> 84</span></a> +</span><span id="L-85"><a href="#L-85"><span class="linenos"> 85</span></a> <span class="n">join_table</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">alias_or_name</span> +</span><span id="L-86"><a href="#L-86"><span class="linenos"> 86</span></a> +</span><span id="L-87"><a href="#L-87"><span class="linenos"> 87</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-88"><a href="#L-88"><span class="linenos"> 88</span></a> +</span><span id="L-89"><a href="#L-89"><span class="linenos"> 89</span></a> <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">:</span> +</span><span id="L-90"><a href="#L-90"><span class="linenos"> 90</span></a> <span class="k">if</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">ordered</span><span class="p">:</span> +</span><span id="L-91"><a href="#L-91"><span class="linenos"> 91</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">k</span><span class="p">):</span> +</span><span id="L-92"><a href="#L-92"><span class="linenos"> 92</span></a> <span class="k">if</span> <span class="n">column</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> +</span><span id="L-93"><a href="#L-93"><span class="linenos"> 93</span></a> <span class="n">columns</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">k</span> +</span><span id="L-94"><a href="#L-94"><span class="linenos"> 94</span></a> +</span><span id="L-95"><a href="#L-95"><span class="linenos"> 95</span></a> <span class="n">ordered</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">join_table</span><span class="p">)</span> +</span><span id="L-96"><a href="#L-96"><span class="linenos"> 96</span></a> <span class="n">join_columns</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">join_table</span><span class="p">)</span> +</span><span id="L-97"><a href="#L-97"><span class="linenos"> 97</span></a> <span class="n">conditions</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-98"><a href="#L-98"><span class="linenos"> 98</span></a> +</span><span id="L-99"><a href="#L-99"><span class="linenos"> 99</span></a> <span class="k">for</span> <span class="n">identifier</span> <span class="ow">in</span> <span class="n">using</span><span class="p">:</span> +</span><span id="L-100"><a href="#L-100"><span class="linenos">100</span></a> <span class="n">identifier</span> <span class="o">=</span> <span class="n">identifier</span><span class="o">.</span><span class="n">name</span> +</span><span id="L-101"><a href="#L-101"><span class="linenos">101</span></a> <span class="n">table</span> <span class="o">=</span> <span class="n">columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">identifier</span><span class="p">)</span> +</span><span id="L-102"><a href="#L-102"><span class="linenos">102</span></a> +</span><span id="L-103"><a href="#L-103"><span class="linenos">103</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table</span> <span class="ow">or</span> <span class="n">identifier</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">join_columns</span><span class="p">:</span> +</span><span id="L-104"><a href="#L-104"><span class="linenos">104</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Cannot automatically join: </span><span class="si">{</span><span class="n">identifier</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-105"><a href="#L-105"><span class="linenos">105</span></a> +</span><span id="L-106"><a href="#L-106"><span class="linenos">106</span></a> <span class="n">conditions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span> +</span><span id="L-107"><a href="#L-107"><span class="linenos">107</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">condition</span><span class="p">(</span> +</span><span id="L-108"><a href="#L-108"><span class="linenos">108</span></a> <span class="n">exp</span><span class="o">.</span><span class="n">EQ</span><span class="p">(</span> +</span><span id="L-109"><a href="#L-109"><span class="linenos">109</span></a> <span class="n">this</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">identifier</span><span class="p">,</span> <span class="n">table</span><span class="o">=</span><span class="n">table</span><span class="p">),</span> +</span><span id="L-110"><a href="#L-110"><span class="linenos">110</span></a> <span class="n">expression</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">identifier</span><span class="p">,</span> <span class="n">table</span><span class="o">=</span><span class="n">join_table</span><span class="p">),</span> +</span><span id="L-111"><a href="#L-111"><span class="linenos">111</span></a> <span class="p">)</span> +</span><span id="L-112"><a href="#L-112"><span class="linenos">112</span></a> <span class="p">)</span> +</span><span id="L-113"><a href="#L-113"><span class="linenos">113</span></a> <span class="p">)</span> +</span><span id="L-114"><a href="#L-114"><span class="linenos">114</span></a> +</span><span id="L-115"><a href="#L-115"><span class="linenos">115</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="n">column_tables</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">identifier</span><span class="p">,</span> <span class="p">[])</span> +</span><span id="L-116"><a href="#L-116"><span class="linenos">116</span></a> <span class="k">if</span> <span class="n">table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> +</span><span id="L-117"><a href="#L-117"><span class="linenos">117</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">table</span><span class="p">)</span> +</span><span id="L-118"><a href="#L-118"><span class="linenos">118</span></a> <span class="k">if</span> <span class="n">join_table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> +</span><span id="L-119"><a href="#L-119"><span class="linenos">119</span></a> <span class="n">tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">join_table</span><span class="p">)</span> +</span><span id="L-120"><a href="#L-120"><span class="linenos">120</span></a> +</span><span id="L-121"><a href="#L-121"><span class="linenos">121</span></a> <span class="n">join</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">"using"</span><span class="p">)</span> +</span><span id="L-122"><a href="#L-122"><span class="linenos">122</span></a> <span class="n">join</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"on"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">and_</span><span class="p">(</span><span class="o">*</span><span class="n">conditions</span><span class="p">))</span> +</span><span id="L-123"><a href="#L-123"><span class="linenos">123</span></a> +</span><span id="L-124"><a href="#L-124"><span class="linenos">124</span></a> <span class="k">if</span> <span class="n">column_tables</span><span class="p">:</span> +</span><span id="L-125"><a href="#L-125"><span class="linenos">125</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">columns</span><span class="p">:</span> +</span><span id="L-126"><a href="#L-126"><span class="linenos">126</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="n">column_tables</span><span class="p">:</span> +</span><span id="L-127"><a href="#L-127"><span class="linenos">127</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="n">column_tables</span><span class="p">[</span><span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> +</span><span id="L-128"><a href="#L-128"><span class="linenos">128</span></a> <span class="n">coalesce</span> <span class="o">=</span> <span class="p">[</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">table</span><span class="o">=</span><span class="n">table</span><span class="p">)</span> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">]</span> +</span><span id="L-129"><a href="#L-129"><span class="linenos">129</span></a> <span class="n">replacement</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">Coalesce</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">coalesce</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">expressions</span><span class="o">=</span><span class="n">coalesce</span><span class="p">[</span><span class="mi">1</span><span class="p">:])</span> +</span><span id="L-130"><a href="#L-130"><span class="linenos">130</span></a> +</span><span id="L-131"><a href="#L-131"><span class="linenos">131</span></a> <span class="c1"># Ensure selects keep their output name</span> +</span><span id="L-132"><a href="#L-132"><span class="linenos">132</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> +</span><span id="L-133"><a href="#L-133"><span class="linenos">133</span></a> <span class="n">replacement</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">alias_</span><span class="p">(</span><span class="n">replacement</span><span class="p">,</span> <span class="n">alias</span><span class="o">=</span><span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> +</span><span id="L-134"><a href="#L-134"><span class="linenos">134</span></a> +</span><span id="L-135"><a href="#L-135"><span class="linenos">135</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="n">replacement</span><span class="p">)</span> </span><span id="L-136"><a href="#L-136"><span class="linenos">136</span></a> -</span><span id="L-137"><a href="#L-137"><span class="linenos">137</span></a><span class="k">def</span> <span class="nf">_expand_group_by</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">):</span> -</span><span id="L-138"><a href="#L-138"><span class="linenos">138</span></a> <span class="n">group</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"group"</span><span class="p">)</span> -</span><span id="L-139"><a href="#L-139"><span class="linenos">139</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">group</span><span class="p">:</span> -</span><span id="L-140"><a href="#L-140"><span class="linenos">140</span></a> <span class="k">return</span> -</span><span id="L-141"><a href="#L-141"><span class="linenos">141</span></a> -</span><span id="L-142"><a href="#L-142"><span class="linenos">142</span></a> <span class="c1"># Replace references to select aliases</span> -</span><span id="L-143"><a href="#L-143"><span class="linenos">143</span></a> <span class="k">def</span> <span class="nf">transform</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="o">*</span><span class="n">_</span><span class="p">):</span> -</span><span id="L-144"><a href="#L-144"><span class="linenos">144</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">node</span><span class="o">.</span><span class="n">table</span><span class="p">:</span> -</span><span id="L-145"><a href="#L-145"><span class="linenos">145</span></a> <span class="n">table</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_table</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> -</span><span id="L-146"><a href="#L-146"><span class="linenos">146</span></a> -</span><span id="L-147"><a href="#L-147"><span class="linenos">147</span></a> <span class="c1"># Source columns get priority over select aliases</span> -</span><span id="L-148"><a href="#L-148"><span class="linenos">148</span></a> <span class="k">if</span> <span class="n">table</span><span class="p">:</span> -</span><span id="L-149"><a href="#L-149"><span class="linenos">149</span></a> <span class="n">node</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"table"</span><span class="p">,</span> <span class="n">table</span><span class="p">)</span> -</span><span id="L-150"><a href="#L-150"><span class="linenos">150</span></a> <span class="k">return</span> <span class="n">node</span> -</span><span id="L-151"><a href="#L-151"><span class="linenos">151</span></a> -</span><span id="L-152"><a href="#L-152"><span class="linenos">152</span></a> <span class="n">selects</span> <span class="o">=</span> <span class="p">{</span><span class="n">s</span><span class="o">.</span><span class="n">alias_or_name</span><span class="p">:</span> <span class="n">s</span> <span class="k">for</span> <span class="n">s</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selects</span><span class="p">}</span> -</span><span id="L-153"><a href="#L-153"><span class="linenos">153</span></a> -</span><span id="L-154"><a href="#L-154"><span class="linenos">154</span></a> <span class="n">select</span> <span class="o">=</span> <span class="n">selects</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> -</span><span id="L-155"><a href="#L-155"><span class="linenos">155</span></a> <span class="k">if</span> <span class="n">select</span><span class="p">:</span> -</span><span id="L-156"><a href="#L-156"><span class="linenos">156</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="L-157"><a href="#L-157"><span class="linenos">157</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">select</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Alias</span><span class="p">):</span> -</span><span id="L-158"><a href="#L-158"><span class="linenos">158</span></a> <span class="n">select</span> <span class="o">=</span> <span class="n">select</span><span class="o">.</span><span class="n">this</span> -</span><span id="L-159"><a href="#L-159"><span class="linenos">159</span></a> <span class="k">return</span> <span class="n">select</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span> -</span><span id="L-160"><a href="#L-160"><span class="linenos">160</span></a> -</span><span id="L-161"><a href="#L-161"><span class="linenos">161</span></a> <span class="k">return</span> <span class="n">node</span> -</span><span id="L-162"><a href="#L-162"><span class="linenos">162</span></a> -</span><span id="L-163"><a href="#L-163"><span class="linenos">163</span></a> <span class="n">group</span><span class="o">.</span><span class="n">transform</span><span class="p">(</span><span class="n">transform</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> -</span><span id="L-164"><a href="#L-164"><span class="linenos">164</span></a> <span class="n">group</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"expressions"</span><span class="p">,</span> <span class="n">_expand_positional_references</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">group</span><span class="o">.</span><span class="n">expressions</span><span class="p">))</span> -</span><span id="L-165"><a href="#L-165"><span class="linenos">165</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"group"</span><span class="p">,</span> <span class="n">group</span><span class="p">)</span> -</span><span id="L-166"><a href="#L-166"><span class="linenos">166</span></a> +</span><span id="L-137"><a href="#L-137"><span class="linenos">137</span></a> +</span><span id="L-138"><a href="#L-138"><span class="linenos">138</span></a><span class="k">def</span> <span class="nf">_expand_group_by</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">):</span> +</span><span id="L-139"><a href="#L-139"><span class="linenos">139</span></a> <span class="n">group</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"group"</span><span class="p">)</span> +</span><span id="L-140"><a href="#L-140"><span class="linenos">140</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">group</span><span class="p">:</span> +</span><span id="L-141"><a href="#L-141"><span class="linenos">141</span></a> <span class="k">return</span> +</span><span id="L-142"><a href="#L-142"><span class="linenos">142</span></a> +</span><span id="L-143"><a href="#L-143"><span class="linenos">143</span></a> <span class="c1"># Replace references to select aliases</span> +</span><span id="L-144"><a href="#L-144"><span class="linenos">144</span></a> <span class="k">def</span> <span class="nf">transform</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="o">*</span><span class="n">_</span><span class="p">):</span> +</span><span id="L-145"><a href="#L-145"><span class="linenos">145</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">node</span><span class="o">.</span><span class="n">table</span><span class="p">:</span> +</span><span id="L-146"><a href="#L-146"><span class="linenos">146</span></a> <span class="n">table</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_table</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> +</span><span id="L-147"><a href="#L-147"><span class="linenos">147</span></a> +</span><span id="L-148"><a href="#L-148"><span class="linenos">148</span></a> <span class="c1"># Source columns get priority over select aliases</span> +</span><span id="L-149"><a href="#L-149"><span class="linenos">149</span></a> <span class="k">if</span> <span class="n">table</span><span class="p">:</span> +</span><span id="L-150"><a href="#L-150"><span class="linenos">150</span></a> <span class="n">node</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"table"</span><span class="p">,</span> <span class="n">table</span><span class="p">)</span> +</span><span id="L-151"><a href="#L-151"><span class="linenos">151</span></a> <span class="k">return</span> <span class="n">node</span> +</span><span id="L-152"><a href="#L-152"><span class="linenos">152</span></a> +</span><span id="L-153"><a href="#L-153"><span class="linenos">153</span></a> <span class="n">selects</span> <span class="o">=</span> <span class="p">{</span><span class="n">s</span><span class="o">.</span><span class="n">alias_or_name</span><span class="p">:</span> <span class="n">s</span> <span class="k">for</span> <span class="n">s</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selects</span><span class="p">}</span> +</span><span id="L-154"><a href="#L-154"><span class="linenos">154</span></a> +</span><span id="L-155"><a href="#L-155"><span class="linenos">155</span></a> <span class="n">select</span> <span class="o">=</span> <span class="n">selects</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> +</span><span id="L-156"><a href="#L-156"><span class="linenos">156</span></a> <span class="k">if</span> <span class="n">select</span><span class="p">:</span> +</span><span id="L-157"><a href="#L-157"><span class="linenos">157</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> +</span><span id="L-158"><a href="#L-158"><span class="linenos">158</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">select</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Alias</span><span class="p">):</span> +</span><span id="L-159"><a href="#L-159"><span class="linenos">159</span></a> <span class="n">select</span> <span class="o">=</span> <span class="n">select</span><span class="o">.</span><span class="n">this</span> +</span><span id="L-160"><a href="#L-160"><span class="linenos">160</span></a> <span class="k">return</span> <span class="n">select</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span> +</span><span id="L-161"><a href="#L-161"><span class="linenos">161</span></a> +</span><span id="L-162"><a href="#L-162"><span class="linenos">162</span></a> <span class="k">return</span> <span class="n">node</span> +</span><span id="L-163"><a href="#L-163"><span class="linenos">163</span></a> +</span><span id="L-164"><a href="#L-164"><span class="linenos">164</span></a> <span class="n">group</span><span class="o">.</span><span class="n">transform</span><span class="p">(</span><span class="n">transform</span><span class="p">,</span> <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span> +</span><span id="L-165"><a href="#L-165"><span class="linenos">165</span></a> <span class="n">group</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"expressions"</span><span class="p">,</span> <span class="n">_expand_positional_references</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">group</span><span class="o">.</span><span class="n">expressions</span><span class="p">))</span> +</span><span id="L-166"><a href="#L-166"><span class="linenos">166</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"group"</span><span class="p">,</span> <span class="n">group</span><span class="p">)</span> </span><span id="L-167"><a href="#L-167"><span class="linenos">167</span></a> -</span><span id="L-168"><a href="#L-168"><span class="linenos">168</span></a><span class="k">def</span> <span class="nf">_expand_order_by</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> -</span><span id="L-169"><a href="#L-169"><span class="linenos">169</span></a> <span class="n">order</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"order"</span><span class="p">)</span> -</span><span id="L-170"><a href="#L-170"><span class="linenos">170</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">order</span><span class="p">:</span> -</span><span id="L-171"><a href="#L-171"><span class="linenos">171</span></a> <span class="k">return</span> -</span><span id="L-172"><a href="#L-172"><span class="linenos">172</span></a> -</span><span id="L-173"><a href="#L-173"><span class="linenos">173</span></a> <span class="n">ordereds</span> <span class="o">=</span> <span class="n">order</span><span class="o">.</span><span class="n">expressions</span> -</span><span id="L-174"><a href="#L-174"><span class="linenos">174</span></a> <span class="k">for</span> <span class="n">ordered</span><span class="p">,</span> <span class="n">new_expression</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span> -</span><span id="L-175"><a href="#L-175"><span class="linenos">175</span></a> <span class="n">ordereds</span><span class="p">,</span> -</span><span id="L-176"><a href="#L-176"><span class="linenos">176</span></a> <span class="n">_expand_positional_references</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="p">(</span><span class="n">o</span><span class="o">.</span><span class="n">this</span> <span class="k">for</span> <span class="n">o</span> <span class="ow">in</span> <span class="n">ordereds</span><span class="p">)),</span> -</span><span id="L-177"><a href="#L-177"><span class="linenos">177</span></a> <span class="p">):</span> -</span><span id="L-178"><a href="#L-178"><span class="linenos">178</span></a> <span class="n">ordered</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"this"</span><span class="p">,</span> <span class="n">new_expression</span><span class="p">)</span> -</span><span id="L-179"><a href="#L-179"><span class="linenos">179</span></a> +</span><span id="L-168"><a href="#L-168"><span class="linenos">168</span></a> +</span><span id="L-169"><a href="#L-169"><span class="linenos">169</span></a><span class="k">def</span> <span class="nf">_expand_order_by</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> +</span><span id="L-170"><a href="#L-170"><span class="linenos">170</span></a> <span class="n">order</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"order"</span><span class="p">)</span> +</span><span id="L-171"><a href="#L-171"><span class="linenos">171</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">order</span><span class="p">:</span> +</span><span id="L-172"><a href="#L-172"><span class="linenos">172</span></a> <span class="k">return</span> +</span><span id="L-173"><a href="#L-173"><span class="linenos">173</span></a> +</span><span id="L-174"><a href="#L-174"><span class="linenos">174</span></a> <span class="n">ordereds</span> <span class="o">=</span> <span class="n">order</span><span class="o">.</span><span class="n">expressions</span> +</span><span id="L-175"><a href="#L-175"><span class="linenos">175</span></a> <span class="k">for</span> <span class="n">ordered</span><span class="p">,</span> <span class="n">new_expression</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span> +</span><span id="L-176"><a href="#L-176"><span class="linenos">176</span></a> <span class="n">ordereds</span><span class="p">,</span> +</span><span id="L-177"><a href="#L-177"><span class="linenos">177</span></a> <span class="n">_expand_positional_references</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="p">(</span><span class="n">o</span><span class="o">.</span><span class="n">this</span> <span class="k">for</span> <span class="n">o</span> <span class="ow">in</span> <span class="n">ordereds</span><span class="p">)),</span> +</span><span id="L-178"><a href="#L-178"><span class="linenos">178</span></a> <span class="p">):</span> +</span><span id="L-179"><a href="#L-179"><span class="linenos">179</span></a> <span class="n">ordered</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"this"</span><span class="p">,</span> <span class="n">new_expression</span><span class="p">)</span> </span><span id="L-180"><a href="#L-180"><span class="linenos">180</span></a> -</span><span id="L-181"><a href="#L-181"><span class="linenos">181</span></a><span class="k">def</span> <span class="nf">_expand_positional_references</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">expressions</span><span class="p">):</span> -</span><span id="L-182"><a href="#L-182"><span class="linenos">182</span></a> <span class="n">new_nodes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-183"><a href="#L-183"><span class="linenos">183</span></a> <span class="k">for</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">expressions</span><span class="p">:</span> -</span><span id="L-184"><a href="#L-184"><span class="linenos">184</span></a> <span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">is_int</span><span class="p">:</span> -</span><span id="L-185"><a href="#L-185"><span class="linenos">185</span></a> <span class="k">try</span><span class="p">:</span> -</span><span id="L-186"><a href="#L-186"><span class="linenos">186</span></a> <span class="n">select</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">selects</span><span class="p">[</span><span class="nb">int</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">]</span> -</span><span id="L-187"><a href="#L-187"><span class="linenos">187</span></a> <span class="k">except</span> <span class="ne">IndexError</span><span class="p">:</span> -</span><span id="L-188"><a href="#L-188"><span class="linenos">188</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown output column: </span><span class="si">{</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-189"><a href="#L-189"><span class="linenos">189</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">select</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Alias</span><span class="p">):</span> -</span><span id="L-190"><a href="#L-190"><span class="linenos">190</span></a> <span class="n">select</span> <span class="o">=</span> <span class="n">select</span><span class="o">.</span><span class="n">this</span> -</span><span id="L-191"><a href="#L-191"><span class="linenos">191</span></a> <span class="n">new_nodes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">copy</span><span class="p">())</span> -</span><span id="L-192"><a href="#L-192"><span class="linenos">192</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="L-193"><a href="#L-193"><span class="linenos">193</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-194"><a href="#L-194"><span class="linenos">194</span></a> <span class="n">new_nodes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="L-195"><a href="#L-195"><span class="linenos">195</span></a> -</span><span id="L-196"><a href="#L-196"><span class="linenos">196</span></a> <span class="k">return</span> <span class="n">new_nodes</span> -</span><span id="L-197"><a href="#L-197"><span class="linenos">197</span></a> +</span><span id="L-181"><a href="#L-181"><span class="linenos">181</span></a> +</span><span id="L-182"><a href="#L-182"><span class="linenos">182</span></a><span class="k">def</span> <span class="nf">_expand_positional_references</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">expressions</span><span class="p">):</span> +</span><span id="L-183"><a href="#L-183"><span class="linenos">183</span></a> <span class="n">new_nodes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-184"><a href="#L-184"><span class="linenos">184</span></a> <span class="k">for</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">expressions</span><span class="p">:</span> +</span><span id="L-185"><a href="#L-185"><span class="linenos">185</span></a> <span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">is_int</span><span class="p">:</span> +</span><span id="L-186"><a href="#L-186"><span class="linenos">186</span></a> <span class="k">try</span><span class="p">:</span> +</span><span id="L-187"><a href="#L-187"><span class="linenos">187</span></a> <span class="n">select</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">selects</span><span class="p">[</span><span class="nb">int</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">]</span> +</span><span id="L-188"><a href="#L-188"><span class="linenos">188</span></a> <span class="k">except</span> <span class="ne">IndexError</span><span class="p">:</span> +</span><span id="L-189"><a href="#L-189"><span class="linenos">189</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown output column: </span><span class="si">{</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-190"><a href="#L-190"><span class="linenos">190</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">select</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Alias</span><span class="p">):</span> +</span><span id="L-191"><a href="#L-191"><span class="linenos">191</span></a> <span class="n">select</span> <span class="o">=</span> <span class="n">select</span><span class="o">.</span><span class="n">this</span> +</span><span id="L-192"><a href="#L-192"><span class="linenos">192</span></a> <span class="n">new_nodes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">select</span><span class="o">.</span><span class="n">copy</span><span class="p">())</span> +</span><span id="L-193"><a href="#L-193"><span class="linenos">193</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> +</span><span id="L-194"><a href="#L-194"><span class="linenos">194</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-195"><a href="#L-195"><span class="linenos">195</span></a> <span class="n">new_nodes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="L-196"><a href="#L-196"><span class="linenos">196</span></a> +</span><span id="L-197"><a href="#L-197"><span class="linenos">197</span></a> <span class="k">return</span> <span class="n">new_nodes</span> </span><span id="L-198"><a href="#L-198"><span class="linenos">198</span></a> -</span><span id="L-199"><a href="#L-199"><span class="linenos">199</span></a><span class="k">def</span> <span class="nf">_qualify_columns</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">):</span> -</span><span id="L-200"><a href="#L-200"><span class="linenos">200</span></a><span class="w"> </span><span class="sd">"""Disambiguate columns, ensuring each column specifies a source"""</span> -</span><span id="L-201"><a href="#L-201"><span class="linenos">201</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">columns</span><span class="p">:</span> -</span><span id="L-202"><a href="#L-202"><span class="linenos">202</span></a> <span class="n">column_table</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> -</span><span id="L-203"><a href="#L-203"><span class="linenos">203</span></a> <span class="n">column_name</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> -</span><span id="L-204"><a href="#L-204"><span class="linenos">204</span></a> -</span><span id="L-205"><a href="#L-205"><span class="linenos">205</span></a> <span class="k">if</span> <span class="n">column_table</span> <span class="ow">and</span> <span class="n">column_table</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> -</span><span id="L-206"><a href="#L-206"><span class="linenos">206</span></a> <span class="n">source_columns</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">column_table</span><span class="p">)</span> -</span><span id="L-207"><a href="#L-207"><span class="linenos">207</span></a> <span class="k">if</span> <span class="n">source_columns</span> <span class="ow">and</span> <span class="n">column_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">source_columns</span> <span class="ow">and</span> <span class="s2">"*"</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">source_columns</span><span class="p">:</span> -</span><span id="L-208"><a href="#L-208"><span class="linenos">208</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown column: </span><span class="si">{</span><span class="n">column_name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-209"><a href="#L-209"><span class="linenos">209</span></a> -</span><span id="L-210"><a href="#L-210"><span class="linenos">210</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">column_table</span><span class="p">:</span> -</span><span id="L-211"><a href="#L-211"><span class="linenos">211</span></a> <span class="n">column_table</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_table</span><span class="p">(</span><span class="n">column_name</span><span class="p">)</span> -</span><span id="L-212"><a href="#L-212"><span class="linenos">212</span></a> -</span><span id="L-213"><a href="#L-213"><span class="linenos">213</span></a> <span class="c1"># column_table can be a '' because bigquery unnest has no table alias</span> -</span><span id="L-214"><a href="#L-214"><span class="linenos">214</span></a> <span class="k">if</span> <span class="n">column_table</span><span class="p">:</span> -</span><span id="L-215"><a href="#L-215"><span class="linenos">215</span></a> <span class="n">column</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"table"</span><span class="p">,</span> <span class="n">column_table</span><span class="p">)</span> -</span><span id="L-216"><a href="#L-216"><span class="linenos">216</span></a> -</span><span id="L-217"><a href="#L-217"><span class="linenos">217</span></a> <span class="n">columns_missing_from_scope</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-218"><a href="#L-218"><span class="linenos">218</span></a> <span class="c1"># Determine whether each reference in the order by clause is to a column or an alias.</span> -</span><span id="L-219"><a href="#L-219"><span class="linenos">219</span></a> <span class="k">for</span> <span class="n">ordered</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Ordered</span><span class="p">):</span> -</span><span id="L-220"><a href="#L-220"><span class="linenos">220</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">ordered</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">):</span> -</span><span id="L-221"><a href="#L-221"><span class="linenos">221</span></a> <span class="k">if</span> <span class="p">(</span> -</span><span id="L-222"><a href="#L-222"><span class="linenos">222</span></a> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> -</span><span id="L-223"><a href="#L-223"><span class="linenos">223</span></a> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">parent</span> <span class="ow">is</span> <span class="ow">not</span> <span class="n">ordered</span> -</span><span id="L-224"><a href="#L-224"><span class="linenos">224</span></a> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="n">resolver</span><span class="o">.</span><span class="n">all_columns</span> -</span><span id="L-225"><a href="#L-225"><span class="linenos">225</span></a> <span class="p">):</span> -</span><span id="L-226"><a href="#L-226"><span class="linenos">226</span></a> <span class="n">columns_missing_from_scope</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> -</span><span id="L-227"><a href="#L-227"><span class="linenos">227</span></a> -</span><span id="L-228"><a href="#L-228"><span class="linenos">228</span></a> <span class="c1"># Determine whether each reference in the having clause is to a column or an alias.</span> -</span><span id="L-229"><a href="#L-229"><span class="linenos">229</span></a> <span class="k">for</span> <span class="n">having</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Having</span><span class="p">):</span> -</span><span id="L-230"><a href="#L-230"><span class="linenos">230</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">having</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">):</span> -</span><span id="L-231"><a href="#L-231"><span class="linenos">231</span></a> <span class="k">if</span> <span class="p">(</span> -</span><span id="L-232"><a href="#L-232"><span class="linenos">232</span></a> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> -</span><span id="L-233"><a href="#L-233"><span class="linenos">233</span></a> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">find_ancestor</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">AggFunc</span><span class="p">)</span> -</span><span id="L-234"><a href="#L-234"><span class="linenos">234</span></a> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="n">resolver</span><span class="o">.</span><span class="n">all_columns</span> -</span><span id="L-235"><a href="#L-235"><span class="linenos">235</span></a> <span class="p">):</span> -</span><span id="L-236"><a href="#L-236"><span class="linenos">236</span></a> <span class="n">columns_missing_from_scope</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> -</span><span id="L-237"><a href="#L-237"><span class="linenos">237</span></a> -</span><span id="L-238"><a href="#L-238"><span class="linenos">238</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns_missing_from_scope</span><span class="p">:</span> -</span><span id="L-239"><a href="#L-239"><span class="linenos">239</span></a> <span class="n">column_table</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_table</span><span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> +</span><span id="L-199"><a href="#L-199"><span class="linenos">199</span></a> +</span><span id="L-200"><a href="#L-200"><span class="linenos">200</span></a><span class="k">def</span> <span class="nf">_qualify_columns</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">):</span> +</span><span id="L-201"><a href="#L-201"><span class="linenos">201</span></a><span class="w"> </span><span class="sd">"""Disambiguate columns, ensuring each column specifies a source"""</span> +</span><span id="L-202"><a href="#L-202"><span class="linenos">202</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">columns</span><span class="p">:</span> +</span><span id="L-203"><a href="#L-203"><span class="linenos">203</span></a> <span class="n">column_table</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> +</span><span id="L-204"><a href="#L-204"><span class="linenos">204</span></a> <span class="n">column_name</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> +</span><span id="L-205"><a href="#L-205"><span class="linenos">205</span></a> +</span><span id="L-206"><a href="#L-206"><span class="linenos">206</span></a> <span class="k">if</span> <span class="n">column_table</span> <span class="ow">and</span> <span class="n">column_table</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="L-207"><a href="#L-207"><span class="linenos">207</span></a> <span class="n">source_columns</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">column_table</span><span class="p">)</span> +</span><span id="L-208"><a href="#L-208"><span class="linenos">208</span></a> <span class="k">if</span> <span class="n">source_columns</span> <span class="ow">and</span> <span class="n">column_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">source_columns</span> <span class="ow">and</span> <span class="s2">"*"</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">source_columns</span><span class="p">:</span> +</span><span id="L-209"><a href="#L-209"><span class="linenos">209</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown column: </span><span class="si">{</span><span class="n">column_name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-210"><a href="#L-210"><span class="linenos">210</span></a> +</span><span id="L-211"><a href="#L-211"><span class="linenos">211</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">column_table</span><span class="p">:</span> +</span><span id="L-212"><a href="#L-212"><span class="linenos">212</span></a> <span class="n">column_table</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_table</span><span class="p">(</span><span class="n">column_name</span><span class="p">)</span> +</span><span id="L-213"><a href="#L-213"><span class="linenos">213</span></a> +</span><span id="L-214"><a href="#L-214"><span class="linenos">214</span></a> <span class="c1"># column_table can be a '' because bigquery unnest has no table alias</span> +</span><span id="L-215"><a href="#L-215"><span class="linenos">215</span></a> <span class="k">if</span> <span class="n">column_table</span><span class="p">:</span> +</span><span id="L-216"><a href="#L-216"><span class="linenos">216</span></a> <span class="n">column</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"table"</span><span class="p">,</span> <span class="n">column_table</span><span class="p">)</span> +</span><span id="L-217"><a href="#L-217"><span class="linenos">217</span></a> <span class="k">elif</span> <span class="n">column_table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="L-218"><a href="#L-218"><span class="linenos">218</span></a> <span class="c1"># structs are used like tables (e.g. "struct"."field"), so they need to be qualified</span> +</span><span id="L-219"><a href="#L-219"><span class="linenos">219</span></a> <span class="c1"># separately and represented as dot(dot(...(<table>.<column>, field1), field2, ...))</span> +</span><span id="L-220"><a href="#L-220"><span class="linenos">220</span></a> +</span><span id="L-221"><a href="#L-221"><span class="linenos">221</span></a> <span class="n">struct_root</span><span class="p">,</span> <span class="o">*</span><span class="n">struct_fields</span> <span class="o">=</span> <span class="p">[</span> +</span><span id="L-222"><a href="#L-222"><span class="linenos">222</span></a> <span class="n">val</span> <span class="k">for</span> <span class="n">val</span> <span class="ow">in</span> <span class="nb">reversed</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">values</span><span class="p">()))</span> <span class="k">if</span> <span class="n">val</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> +</span><span id="L-223"><a href="#L-223"><span class="linenos">223</span></a> <span class="p">]</span> +</span><span id="L-224"><a href="#L-224"><span class="linenos">224</span></a> +</span><span id="L-225"><a href="#L-225"><span class="linenos">225</span></a> <span class="k">if</span> <span class="n">struct_root</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="L-226"><a href="#L-226"><span class="linenos">226</span></a> <span class="c1"># struct is already qualified, but we still need to change the AST representation</span> +</span><span id="L-227"><a href="#L-227"><span class="linenos">227</span></a> <span class="n">struct_table</span> <span class="o">=</span> <span class="n">struct_root</span> +</span><span id="L-228"><a href="#L-228"><span class="linenos">228</span></a> <span class="n">struct_root</span><span class="p">,</span> <span class="o">*</span><span class="n">struct_fields</span> <span class="o">=</span> <span class="n">struct_fields</span> +</span><span id="L-229"><a href="#L-229"><span class="linenos">229</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-230"><a href="#L-230"><span class="linenos">230</span></a> <span class="n">struct_table</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_table</span><span class="p">(</span><span class="n">struct_root</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> +</span><span id="L-231"><a href="#L-231"><span class="linenos">231</span></a> +</span><span id="L-232"><a href="#L-232"><span class="linenos">232</span></a> <span class="k">if</span> <span class="n">struct_table</span><span class="p">:</span> +</span><span id="L-233"><a href="#L-233"><span class="linenos">233</span></a> <span class="k">while</span> <span class="n">column</span><span class="o">.</span><span class="n">parent</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Dot</span><span class="p">):</span> +</span><span id="L-234"><a href="#L-234"><span class="linenos">234</span></a> <span class="n">column</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">parent</span> +</span><span id="L-235"><a href="#L-235"><span class="linenos">235</span></a> <span class="n">struct_fields</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">expression</span><span class="p">)</span> +</span><span id="L-236"><a href="#L-236"><span class="linenos">236</span></a> +</span><span id="L-237"><a href="#L-237"><span class="linenos">237</span></a> <span class="n">new_column</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">struct_root</span><span class="p">,</span> <span class="n">table</span><span class="o">=</span><span class="n">struct_table</span><span class="p">)</span> +</span><span id="L-238"><a href="#L-238"><span class="linenos">238</span></a> <span class="k">for</span> <span class="n">field</span> <span class="ow">in</span> <span class="n">struct_fields</span><span class="p">:</span> +</span><span id="L-239"><a href="#L-239"><span class="linenos">239</span></a> <span class="n">new_column</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">Dot</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">new_column</span><span class="p">,</span> <span class="n">expression</span><span class="o">=</span><span class="n">field</span><span class="p">)</span> </span><span id="L-240"><a href="#L-240"><span class="linenos">240</span></a> -</span><span id="L-241"><a href="#L-241"><span class="linenos">241</span></a> <span class="k">if</span> <span class="n">column_table</span><span class="p">:</span> -</span><span id="L-242"><a href="#L-242"><span class="linenos">242</span></a> <span class="n">column</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"table"</span><span class="p">,</span> <span class="n">column_table</span><span class="p">)</span> -</span><span id="L-243"><a href="#L-243"><span class="linenos">243</span></a> -</span><span id="L-244"><a href="#L-244"><span class="linenos">244</span></a> -</span><span id="L-245"><a href="#L-245"><span class="linenos">245</span></a><span class="k">def</span> <span class="nf">_expand_stars</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">):</span> -</span><span id="L-246"><a href="#L-246"><span class="linenos">246</span></a><span class="w"> </span><span class="sd">"""Expand stars to lists of column selections"""</span> -</span><span id="L-247"><a href="#L-247"><span class="linenos">247</span></a> -</span><span id="L-248"><a href="#L-248"><span class="linenos">248</span></a> <span class="n">new_selections</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-249"><a href="#L-249"><span class="linenos">249</span></a> <span class="n">except_columns</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="L-250"><a href="#L-250"><span class="linenos">250</span></a> <span class="n">replace_columns</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="L-251"><a href="#L-251"><span class="linenos">251</span></a> -</span><span id="L-252"><a href="#L-252"><span class="linenos">252</span></a> <span class="k">for</span> <span class="n">expression</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selects</span><span class="p">:</span> -</span><span id="L-253"><a href="#L-253"><span class="linenos">253</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Star</span><span class="p">):</span> -</span><span id="L-254"><a href="#L-254"><span class="linenos">254</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">)</span> -</span><span id="L-255"><a href="#L-255"><span class="linenos">255</span></a> <span class="n">_add_except_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">except_columns</span><span class="p">)</span> -</span><span id="L-256"><a href="#L-256"><span class="linenos">256</span></a> <span class="n">_add_replace_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">replace_columns</span><span class="p">)</span> -</span><span id="L-257"><a href="#L-257"><span class="linenos">257</span></a> <span class="k">elif</span> <span class="n">expression</span><span class="o">.</span><span class="n">is_star</span><span class="p">:</span> -</span><span id="L-258"><a href="#L-258"><span class="linenos">258</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="p">[</span><span class="n">expression</span><span class="o">.</span><span class="n">table</span><span class="p">]</span> -</span><span id="L-259"><a href="#L-259"><span class="linenos">259</span></a> <span class="n">_add_except_columns</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">except_columns</span><span class="p">)</span> -</span><span id="L-260"><a href="#L-260"><span class="linenos">260</span></a> <span class="n">_add_replace_columns</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">replace_columns</span><span class="p">)</span> -</span><span id="L-261"><a href="#L-261"><span class="linenos">261</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-262"><a href="#L-262"><span class="linenos">262</span></a> <span class="n">new_selections</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> -</span><span id="L-263"><a href="#L-263"><span class="linenos">263</span></a> <span class="k">continue</span> -</span><span id="L-264"><a href="#L-264"><span class="linenos">264</span></a> -</span><span id="L-265"><a href="#L-265"><span class="linenos">265</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> -</span><span id="L-266"><a href="#L-266"><span class="linenos">266</span></a> <span class="k">if</span> <span class="n">table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> -</span><span id="L-267"><a href="#L-267"><span class="linenos">267</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: </span><span class="si">{</span><span class="n">table</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-268"><a href="#L-268"><span class="linenos">268</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">only_visible</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> +</span><span id="L-241"><a href="#L-241"><span class="linenos">241</span></a> <span class="n">column</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">new_column</span><span class="p">)</span> +</span><span id="L-242"><a href="#L-242"><span class="linenos">242</span></a> +</span><span id="L-243"><a href="#L-243"><span class="linenos">243</span></a> <span class="n">columns_missing_from_scope</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-244"><a href="#L-244"><span class="linenos">244</span></a> <span class="c1"># Determine whether each reference in the order by clause is to a column or an alias.</span> +</span><span id="L-245"><a href="#L-245"><span class="linenos">245</span></a> <span class="k">for</span> <span class="n">ordered</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Ordered</span><span class="p">):</span> +</span><span id="L-246"><a href="#L-246"><span class="linenos">246</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">ordered</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">):</span> +</span><span id="L-247"><a href="#L-247"><span class="linenos">247</span></a> <span class="k">if</span> <span class="p">(</span> +</span><span id="L-248"><a href="#L-248"><span class="linenos">248</span></a> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> +</span><span id="L-249"><a href="#L-249"><span class="linenos">249</span></a> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">parent</span> <span class="ow">is</span> <span class="ow">not</span> <span class="n">ordered</span> +</span><span id="L-250"><a href="#L-250"><span class="linenos">250</span></a> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="n">resolver</span><span class="o">.</span><span class="n">all_columns</span> +</span><span id="L-251"><a href="#L-251"><span class="linenos">251</span></a> <span class="p">):</span> +</span><span id="L-252"><a href="#L-252"><span class="linenos">252</span></a> <span class="n">columns_missing_from_scope</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> +</span><span id="L-253"><a href="#L-253"><span class="linenos">253</span></a> +</span><span id="L-254"><a href="#L-254"><span class="linenos">254</span></a> <span class="c1"># Determine whether each reference in the having clause is to a column or an alias.</span> +</span><span id="L-255"><a href="#L-255"><span class="linenos">255</span></a> <span class="k">for</span> <span class="n">having</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Having</span><span class="p">):</span> +</span><span id="L-256"><a href="#L-256"><span class="linenos">256</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">having</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">):</span> +</span><span id="L-257"><a href="#L-257"><span class="linenos">257</span></a> <span class="k">if</span> <span class="p">(</span> +</span><span id="L-258"><a href="#L-258"><span class="linenos">258</span></a> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> +</span><span id="L-259"><a href="#L-259"><span class="linenos">259</span></a> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">find_ancestor</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">AggFunc</span><span class="p">)</span> +</span><span id="L-260"><a href="#L-260"><span class="linenos">260</span></a> <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="n">resolver</span><span class="o">.</span><span class="n">all_columns</span> +</span><span id="L-261"><a href="#L-261"><span class="linenos">261</span></a> <span class="p">):</span> +</span><span id="L-262"><a href="#L-262"><span class="linenos">262</span></a> <span class="n">columns_missing_from_scope</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> +</span><span id="L-263"><a href="#L-263"><span class="linenos">263</span></a> +</span><span id="L-264"><a href="#L-264"><span class="linenos">264</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns_missing_from_scope</span><span class="p">:</span> +</span><span id="L-265"><a href="#L-265"><span class="linenos">265</span></a> <span class="n">column_table</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_table</span><span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> +</span><span id="L-266"><a href="#L-266"><span class="linenos">266</span></a> +</span><span id="L-267"><a href="#L-267"><span class="linenos">267</span></a> <span class="k">if</span> <span class="n">column_table</span><span class="p">:</span> +</span><span id="L-268"><a href="#L-268"><span class="linenos">268</span></a> <span class="n">column</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"table"</span><span class="p">,</span> <span class="n">column_table</span><span class="p">)</span> </span><span id="L-269"><a href="#L-269"><span class="linenos">269</span></a> -</span><span id="L-270"><a href="#L-270"><span class="linenos">270</span></a> <span class="k">if</span> <span class="n">columns</span> <span class="ow">and</span> <span class="s2">"*"</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> -</span><span id="L-271"><a href="#L-271"><span class="linenos">271</span></a> <span class="n">table_id</span> <span class="o">=</span> <span class="nb">id</span><span class="p">(</span><span class="n">table</span><span class="p">)</span> -</span><span id="L-272"><a href="#L-272"><span class="linenos">272</span></a> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> -</span><span id="L-273"><a href="#L-273"><span class="linenos">273</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">except_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_id</span><span class="p">,</span> <span class="nb">set</span><span class="p">()):</span> -</span><span id="L-274"><a href="#L-274"><span class="linenos">274</span></a> <span class="n">alias_</span> <span class="o">=</span> <span class="n">replace_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_id</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span> -</span><span id="L-275"><a href="#L-275"><span class="linenos">275</span></a> <span class="n">column</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">table</span><span class="p">)</span> -</span><span id="L-276"><a href="#L-276"><span class="linenos">276</span></a> <span class="n">new_selections</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">alias</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="n">alias_</span><span class="p">)</span> <span class="k">if</span> <span class="n">alias_</span> <span class="o">!=</span> <span class="n">name</span> <span class="k">else</span> <span class="n">column</span><span class="p">)</span> -</span><span id="L-277"><a href="#L-277"><span class="linenos">277</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-278"><a href="#L-278"><span class="linenos">278</span></a> <span class="k">return</span> -</span><span id="L-279"><a href="#L-279"><span class="linenos">279</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"expressions"</span><span class="p">,</span> <span class="n">new_selections</span><span class="p">)</span> -</span><span id="L-280"><a href="#L-280"><span class="linenos">280</span></a> -</span><span id="L-281"><a href="#L-281"><span class="linenos">281</span></a> -</span><span id="L-282"><a href="#L-282"><span class="linenos">282</span></a><span class="k">def</span> <span class="nf">_add_except_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">except_columns</span><span class="p">):</span> -</span><span id="L-283"><a href="#L-283"><span class="linenos">283</span></a> <span class="n">except_</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"except"</span><span class="p">)</span> -</span><span id="L-284"><a href="#L-284"><span class="linenos">284</span></a> -</span><span id="L-285"><a href="#L-285"><span class="linenos">285</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">except_</span><span class="p">:</span> -</span><span id="L-286"><a href="#L-286"><span class="linenos">286</span></a> <span class="k">return</span> -</span><span id="L-287"><a href="#L-287"><span class="linenos">287</span></a> -</span><span id="L-288"><a href="#L-288"><span class="linenos">288</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">e</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">e</span> <span class="ow">in</span> <span class="n">except_</span><span class="p">}</span> -</span><span id="L-289"><a href="#L-289"><span class="linenos">289</span></a> -</span><span id="L-290"><a href="#L-290"><span class="linenos">290</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> -</span><span id="L-291"><a href="#L-291"><span class="linenos">291</span></a> <span class="n">except_columns</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">table</span><span class="p">)]</span> <span class="o">=</span> <span class="n">columns</span> -</span><span id="L-292"><a href="#L-292"><span class="linenos">292</span></a> -</span><span id="L-293"><a href="#L-293"><span class="linenos">293</span></a> -</span><span id="L-294"><a href="#L-294"><span class="linenos">294</span></a><span class="k">def</span> <span class="nf">_add_replace_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">replace_columns</span><span class="p">):</span> -</span><span id="L-295"><a href="#L-295"><span class="linenos">295</span></a> <span class="n">replace</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"replace"</span><span class="p">)</span> -</span><span id="L-296"><a href="#L-296"><span class="linenos">296</span></a> -</span><span id="L-297"><a href="#L-297"><span class="linenos">297</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">replace</span><span class="p">:</span> -</span><span id="L-298"><a href="#L-298"><span class="linenos">298</span></a> <span class="k">return</span> -</span><span id="L-299"><a href="#L-299"><span class="linenos">299</span></a> -</span><span id="L-300"><a href="#L-300"><span class="linenos">300</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">e</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="n">e</span><span class="o">.</span><span class="n">alias</span> <span class="k">for</span> <span class="n">e</span> <span class="ow">in</span> <span class="n">replace</span><span class="p">}</span> -</span><span id="L-301"><a href="#L-301"><span class="linenos">301</span></a> -</span><span id="L-302"><a href="#L-302"><span class="linenos">302</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> -</span><span id="L-303"><a href="#L-303"><span class="linenos">303</span></a> <span class="n">replace_columns</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">table</span><span class="p">)]</span> <span class="o">=</span> <span class="n">columns</span> -</span><span id="L-304"><a href="#L-304"><span class="linenos">304</span></a> -</span><span id="L-305"><a href="#L-305"><span class="linenos">305</span></a> -</span><span id="L-306"><a href="#L-306"><span class="linenos">306</span></a><span class="k">def</span> <span class="nf">_qualify_outputs</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> -</span><span id="L-307"><a href="#L-307"><span class="linenos">307</span></a><span class="w"> </span><span class="sd">"""Ensure all output columns are aliased"""</span> -</span><span id="L-308"><a href="#L-308"><span class="linenos">308</span></a> <span class="n">new_selections</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-309"><a href="#L-309"><span class="linenos">309</span></a> -</span><span id="L-310"><a href="#L-310"><span class="linenos">310</span></a> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="p">(</span><span class="n">selection</span><span class="p">,</span> <span class="n">aliased_column</span><span class="p">)</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span> -</span><span id="L-311"><a href="#L-311"><span class="linenos">311</span></a> <span class="n">itertools</span><span class="o">.</span><span class="n">zip_longest</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">selects</span><span class="p">,</span> <span class="n">scope</span><span class="o">.</span><span class="n">outer_column_list</span><span class="p">)</span> -</span><span id="L-312"><a href="#L-312"><span class="linenos">312</span></a> <span class="p">):</span> -</span><span id="L-313"><a href="#L-313"><span class="linenos">313</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">selection</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">):</span> -</span><span id="L-314"><a href="#L-314"><span class="linenos">314</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">selection</span><span class="o">.</span><span class="n">output_name</span><span class="p">:</span> -</span><span id="L-315"><a href="#L-315"><span class="linenos">315</span></a> <span class="n">selection</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">TableAlias</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="sa">f</span><span class="s2">"_col_</span><span class="si">{</span><span class="n">i</span><span class="si">}</span><span class="s2">"</span><span class="p">)))</span> -</span><span id="L-316"><a href="#L-316"><span class="linenos">316</span></a> <span class="k">elif</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">selection</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Alias</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">selection</span><span class="o">.</span><span class="n">is_star</span><span class="p">:</span> -</span><span id="L-317"><a href="#L-317"><span class="linenos">317</span></a> <span class="n">alias_</span> <span class="o">=</span> <span class="n">alias</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="s2">""</span><span class="p">),</span> <span class="n">alias</span><span class="o">=</span><span class="n">selection</span><span class="o">.</span><span class="n">output_name</span> <span class="ow">or</span> <span class="sa">f</span><span class="s2">"_col_</span><span class="si">{</span><span class="n">i</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-318"><a href="#L-318"><span class="linenos">318</span></a> <span class="n">alias_</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"this"</span><span class="p">,</span> <span class="n">selection</span><span class="p">)</span> -</span><span id="L-319"><a href="#L-319"><span class="linenos">319</span></a> <span class="n">selection</span> <span class="o">=</span> <span class="n">alias_</span> -</span><span id="L-320"><a href="#L-320"><span class="linenos">320</span></a> -</span><span id="L-321"><a href="#L-321"><span class="linenos">321</span></a> <span class="k">if</span> <span class="n">aliased_column</span><span class="p">:</span> -</span><span id="L-322"><a href="#L-322"><span class="linenos">322</span></a> <span class="n">selection</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">aliased_column</span><span class="p">))</span> -</span><span id="L-323"><a href="#L-323"><span class="linenos">323</span></a> -</span><span id="L-324"><a href="#L-324"><span class="linenos">324</span></a> <span class="n">new_selections</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">selection</span><span class="p">)</span> +</span><span id="L-270"><a href="#L-270"><span class="linenos">270</span></a> +</span><span id="L-271"><a href="#L-271"><span class="linenos">271</span></a><span class="k">def</span> <span class="nf">_expand_stars</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">):</span> +</span><span id="L-272"><a href="#L-272"><span class="linenos">272</span></a><span class="w"> </span><span class="sd">"""Expand stars to lists of column selections"""</span> +</span><span id="L-273"><a href="#L-273"><span class="linenos">273</span></a> +</span><span id="L-274"><a href="#L-274"><span class="linenos">274</span></a> <span class="n">new_selections</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-275"><a href="#L-275"><span class="linenos">275</span></a> <span class="n">except_columns</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-276"><a href="#L-276"><span class="linenos">276</span></a> <span class="n">replace_columns</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-277"><a href="#L-277"><span class="linenos">277</span></a> +</span><span id="L-278"><a href="#L-278"><span class="linenos">278</span></a> <span class="k">for</span> <span class="n">expression</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selects</span><span class="p">:</span> +</span><span id="L-279"><a href="#L-279"><span class="linenos">279</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Star</span><span class="p">):</span> +</span><span id="L-280"><a href="#L-280"><span class="linenos">280</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">)</span> +</span><span id="L-281"><a href="#L-281"><span class="linenos">281</span></a> <span class="n">_add_except_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">except_columns</span><span class="p">)</span> +</span><span id="L-282"><a href="#L-282"><span class="linenos">282</span></a> <span class="n">_add_replace_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">replace_columns</span><span class="p">)</span> +</span><span id="L-283"><a href="#L-283"><span class="linenos">283</span></a> <span class="k">elif</span> <span class="n">expression</span><span class="o">.</span><span class="n">is_star</span><span class="p">:</span> +</span><span id="L-284"><a href="#L-284"><span class="linenos">284</span></a> <span class="n">tables</span> <span class="o">=</span> <span class="p">[</span><span class="n">expression</span><span class="o">.</span><span class="n">table</span><span class="p">]</span> +</span><span id="L-285"><a href="#L-285"><span class="linenos">285</span></a> <span class="n">_add_except_columns</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">except_columns</span><span class="p">)</span> +</span><span id="L-286"><a href="#L-286"><span class="linenos">286</span></a> <span class="n">_add_replace_columns</span><span class="p">(</span><span class="n">expression</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">replace_columns</span><span class="p">)</span> +</span><span id="L-287"><a href="#L-287"><span class="linenos">287</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-288"><a href="#L-288"><span class="linenos">288</span></a> <span class="n">new_selections</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">expression</span><span class="p">)</span> +</span><span id="L-289"><a href="#L-289"><span class="linenos">289</span></a> <span class="k">continue</span> +</span><span id="L-290"><a href="#L-290"><span class="linenos">290</span></a> +</span><span id="L-291"><a href="#L-291"><span class="linenos">291</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> +</span><span id="L-292"><a href="#L-292"><span class="linenos">292</span></a> <span class="k">if</span> <span class="n">table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="L-293"><a href="#L-293"><span class="linenos">293</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: </span><span class="si">{</span><span class="n">table</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-294"><a href="#L-294"><span class="linenos">294</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="n">resolver</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">only_visible</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> +</span><span id="L-295"><a href="#L-295"><span class="linenos">295</span></a> +</span><span id="L-296"><a href="#L-296"><span class="linenos">296</span></a> <span class="k">if</span> <span class="n">columns</span> <span class="ow">and</span> <span class="s2">"*"</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> +</span><span id="L-297"><a href="#L-297"><span class="linenos">297</span></a> <span class="n">table_id</span> <span class="o">=</span> <span class="nb">id</span><span class="p">(</span><span class="n">table</span><span class="p">)</span> +</span><span id="L-298"><a href="#L-298"><span class="linenos">298</span></a> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> +</span><span id="L-299"><a href="#L-299"><span class="linenos">299</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">except_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_id</span><span class="p">,</span> <span class="nb">set</span><span class="p">()):</span> +</span><span id="L-300"><a href="#L-300"><span class="linenos">300</span></a> <span class="n">alias_</span> <span class="o">=</span> <span class="n">replace_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_id</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span> +</span><span id="L-301"><a href="#L-301"><span class="linenos">301</span></a> <span class="n">column</span> <span class="o">=</span> <span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">table</span><span class="p">)</span> +</span><span id="L-302"><a href="#L-302"><span class="linenos">302</span></a> <span class="n">new_selections</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">alias</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="n">alias_</span><span class="p">)</span> <span class="k">if</span> <span class="n">alias_</span> <span class="o">!=</span> <span class="n">name</span> <span class="k">else</span> <span class="n">column</span><span class="p">)</span> +</span><span id="L-303"><a href="#L-303"><span class="linenos">303</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-304"><a href="#L-304"><span class="linenos">304</span></a> <span class="k">return</span> +</span><span id="L-305"><a href="#L-305"><span class="linenos">305</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"expressions"</span><span class="p">,</span> <span class="n">new_selections</span><span class="p">)</span> +</span><span id="L-306"><a href="#L-306"><span class="linenos">306</span></a> +</span><span id="L-307"><a href="#L-307"><span class="linenos">307</span></a> +</span><span id="L-308"><a href="#L-308"><span class="linenos">308</span></a><span class="k">def</span> <span class="nf">_add_except_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">except_columns</span><span class="p">):</span> +</span><span id="L-309"><a href="#L-309"><span class="linenos">309</span></a> <span class="n">except_</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"except"</span><span class="p">)</span> +</span><span id="L-310"><a href="#L-310"><span class="linenos">310</span></a> +</span><span id="L-311"><a href="#L-311"><span class="linenos">311</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">except_</span><span class="p">:</span> +</span><span id="L-312"><a href="#L-312"><span class="linenos">312</span></a> <span class="k">return</span> +</span><span id="L-313"><a href="#L-313"><span class="linenos">313</span></a> +</span><span id="L-314"><a href="#L-314"><span class="linenos">314</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">e</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">e</span> <span class="ow">in</span> <span class="n">except_</span><span class="p">}</span> +</span><span id="L-315"><a href="#L-315"><span class="linenos">315</span></a> +</span><span id="L-316"><a href="#L-316"><span class="linenos">316</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> +</span><span id="L-317"><a href="#L-317"><span class="linenos">317</span></a> <span class="n">except_columns</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">table</span><span class="p">)]</span> <span class="o">=</span> <span class="n">columns</span> +</span><span id="L-318"><a href="#L-318"><span class="linenos">318</span></a> +</span><span id="L-319"><a href="#L-319"><span class="linenos">319</span></a> +</span><span id="L-320"><a href="#L-320"><span class="linenos">320</span></a><span class="k">def</span> <span class="nf">_add_replace_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">tables</span><span class="p">,</span> <span class="n">replace_columns</span><span class="p">):</span> +</span><span id="L-321"><a href="#L-321"><span class="linenos">321</span></a> <span class="n">replace</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"replace"</span><span class="p">)</span> +</span><span id="L-322"><a href="#L-322"><span class="linenos">322</span></a> +</span><span id="L-323"><a href="#L-323"><span class="linenos">323</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">replace</span><span class="p">:</span> +</span><span id="L-324"><a href="#L-324"><span class="linenos">324</span></a> <span class="k">return</span> </span><span id="L-325"><a href="#L-325"><span class="linenos">325</span></a> -</span><span id="L-326"><a href="#L-326"><span class="linenos">326</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"expressions"</span><span class="p">,</span> <span class="n">new_selections</span><span class="p">)</span> +</span><span id="L-326"><a href="#L-326"><span class="linenos">326</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">e</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="n">e</span><span class="o">.</span><span class="n">alias</span> <span class="k">for</span> <span class="n">e</span> <span class="ow">in</span> <span class="n">replace</span><span class="p">}</span> </span><span id="L-327"><a href="#L-327"><span class="linenos">327</span></a> -</span><span id="L-328"><a href="#L-328"><span class="linenos">328</span></a> -</span><span id="L-329"><a href="#L-329"><span class="linenos">329</span></a><span class="k">class</span> <span class="nc">Resolver</span><span class="p">:</span> -</span><span id="L-330"><a href="#L-330"><span class="linenos">330</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-331"><a href="#L-331"><span class="linenos">331</span></a><span class="sd"> Helper for resolving columns.</span> -</span><span id="L-332"><a href="#L-332"><span class="linenos">332</span></a> -</span><span id="L-333"><a href="#L-333"><span class="linenos">333</span></a><span class="sd"> This is a class so we can lazily load some things and easily share them across functions.</span> -</span><span id="L-334"><a href="#L-334"><span class="linenos">334</span></a><span class="sd"> """</span> +</span><span id="L-328"><a href="#L-328"><span class="linenos">328</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="n">tables</span><span class="p">:</span> +</span><span id="L-329"><a href="#L-329"><span class="linenos">329</span></a> <span class="n">replace_columns</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">table</span><span class="p">)]</span> <span class="o">=</span> <span class="n">columns</span> +</span><span id="L-330"><a href="#L-330"><span class="linenos">330</span></a> +</span><span id="L-331"><a href="#L-331"><span class="linenos">331</span></a> +</span><span id="L-332"><a href="#L-332"><span class="linenos">332</span></a><span class="k">def</span> <span class="nf">_qualify_outputs</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> +</span><span id="L-333"><a href="#L-333"><span class="linenos">333</span></a><span class="w"> </span><span class="sd">"""Ensure all output columns are aliased"""</span> +</span><span id="L-334"><a href="#L-334"><span class="linenos">334</span></a> <span class="n">new_selections</span> <span class="o">=</span> <span class="p">[]</span> </span><span id="L-335"><a href="#L-335"><span class="linenos">335</span></a> -</span><span id="L-336"><a href="#L-336"><span class="linenos">336</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">schema</span><span class="p">):</span> -</span><span id="L-337"><a href="#L-337"><span class="linenos">337</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span> <span class="o">=</span> <span class="n">scope</span> -</span><span id="L-338"><a href="#L-338"><span class="linenos">338</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span> <span class="o">=</span> <span class="n">schema</span> -</span><span id="L-339"><a href="#L-339"><span class="linenos">339</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-340"><a href="#L-340"><span class="linenos">340</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-341"><a href="#L-341"><span class="linenos">341</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-342"><a href="#L-342"><span class="linenos">342</span></a> -</span><span id="L-343"><a href="#L-343"><span class="linenos">343</span></a> <span class="k">def</span> <span class="nf">get_table</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">column_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">]:</span> -</span><span id="L-344"><a href="#L-344"><span class="linenos">344</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-345"><a href="#L-345"><span class="linenos">345</span></a><span class="sd"> Get the table for a column name.</span> +</span><span id="L-336"><a href="#L-336"><span class="linenos">336</span></a> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="p">(</span><span class="n">selection</span><span class="p">,</span> <span class="n">aliased_column</span><span class="p">)</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span> +</span><span id="L-337"><a href="#L-337"><span class="linenos">337</span></a> <span class="n">itertools</span><span class="o">.</span><span class="n">zip_longest</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">selects</span><span class="p">,</span> <span class="n">scope</span><span class="o">.</span><span class="n">outer_column_list</span><span class="p">)</span> +</span><span id="L-338"><a href="#L-338"><span class="linenos">338</span></a> <span class="p">):</span> +</span><span id="L-339"><a href="#L-339"><span class="linenos">339</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">selection</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">):</span> +</span><span id="L-340"><a href="#L-340"><span class="linenos">340</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">selection</span><span class="o">.</span><span class="n">output_name</span><span class="p">:</span> +</span><span id="L-341"><a href="#L-341"><span class="linenos">341</span></a> <span class="n">selection</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">TableAlias</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="sa">f</span><span class="s2">"_col_</span><span class="si">{</span><span class="n">i</span><span class="si">}</span><span class="s2">"</span><span class="p">)))</span> +</span><span id="L-342"><a href="#L-342"><span class="linenos">342</span></a> <span class="k">elif</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">selection</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Alias</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">selection</span><span class="o">.</span><span class="n">is_star</span><span class="p">:</span> +</span><span id="L-343"><a href="#L-343"><span class="linenos">343</span></a> <span class="n">alias_</span> <span class="o">=</span> <span class="n">alias</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">column</span><span class="p">(</span><span class="s2">""</span><span class="p">),</span> <span class="n">alias</span><span class="o">=</span><span class="n">selection</span><span class="o">.</span><span class="n">output_name</span> <span class="ow">or</span> <span class="sa">f</span><span class="s2">"_col_</span><span class="si">{</span><span class="n">i</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-344"><a href="#L-344"><span class="linenos">344</span></a> <span class="n">alias_</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"this"</span><span class="p">,</span> <span class="n">selection</span><span class="p">)</span> +</span><span id="L-345"><a href="#L-345"><span class="linenos">345</span></a> <span class="n">selection</span> <span class="o">=</span> <span class="n">alias_</span> </span><span id="L-346"><a href="#L-346"><span class="linenos">346</span></a> -</span><span id="L-347"><a href="#L-347"><span class="linenos">347</span></a><span class="sd"> Args:</span> -</span><span id="L-348"><a href="#L-348"><span class="linenos">348</span></a><span class="sd"> column_name: The column name to find the table for.</span> -</span><span id="L-349"><a href="#L-349"><span class="linenos">349</span></a><span class="sd"> Returns:</span> -</span><span id="L-350"><a href="#L-350"><span class="linenos">350</span></a><span class="sd"> The table name if it can be found/inferred.</span> -</span><span id="L-351"><a href="#L-351"><span class="linenos">351</span></a><span class="sd"> """</span> -</span><span id="L-352"><a href="#L-352"><span class="linenos">352</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-353"><a href="#L-353"><span class="linenos">353</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_unambiguous_columns</span><span class="p">(</span> -</span><span id="L-354"><a href="#L-354"><span class="linenos">354</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span> -</span><span id="L-355"><a href="#L-355"><span class="linenos">355</span></a> <span class="p">)</span> -</span><span id="L-356"><a href="#L-356"><span class="linenos">356</span></a> -</span><span id="L-357"><a href="#L-357"><span class="linenos">357</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column_name</span><span class="p">)</span> +</span><span id="L-347"><a href="#L-347"><span class="linenos">347</span></a> <span class="k">if</span> <span class="n">aliased_column</span><span class="p">:</span> +</span><span id="L-348"><a href="#L-348"><span class="linenos">348</span></a> <span class="n">selection</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">aliased_column</span><span class="p">))</span> +</span><span id="L-349"><a href="#L-349"><span class="linenos">349</span></a> +</span><span id="L-350"><a href="#L-350"><span class="linenos">350</span></a> <span class="n">new_selections</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">selection</span><span class="p">)</span> +</span><span id="L-351"><a href="#L-351"><span class="linenos">351</span></a> +</span><span id="L-352"><a href="#L-352"><span class="linenos">352</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"expressions"</span><span class="p">,</span> <span class="n">new_selections</span><span class="p">)</span> +</span><span id="L-353"><a href="#L-353"><span class="linenos">353</span></a> +</span><span id="L-354"><a href="#L-354"><span class="linenos">354</span></a> +</span><span id="L-355"><a href="#L-355"><span class="linenos">355</span></a><span class="k">class</span> <span class="nc">Resolver</span><span class="p">:</span> +</span><span id="L-356"><a href="#L-356"><span class="linenos">356</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-357"><a href="#L-357"><span class="linenos">357</span></a><span class="sd"> Helper for resolving columns.</span> </span><span id="L-358"><a href="#L-358"><span class="linenos">358</span></a> -</span><span id="L-359"><a href="#L-359"><span class="linenos">359</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_name</span><span class="p">:</span> -</span><span id="L-360"><a href="#L-360"><span class="linenos">360</span></a> <span class="n">sources_without_schema</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span> -</span><span id="L-361"><a href="#L-361"><span class="linenos">361</span></a> <span class="n">source</span> -</span><span id="L-362"><a href="#L-362"><span class="linenos">362</span></a> <span class="k">for</span> <span class="n">source</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> -</span><span id="L-363"><a href="#L-363"><span class="linenos">363</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">columns</span> <span class="ow">or</span> <span class="s2">"*"</span> <span class="ow">in</span> <span class="n">columns</span> -</span><span id="L-364"><a href="#L-364"><span class="linenos">364</span></a> <span class="p">)</span> -</span><span id="L-365"><a href="#L-365"><span class="linenos">365</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sources_without_schema</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="L-366"><a href="#L-366"><span class="linenos">366</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">sources_without_schema</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> -</span><span id="L-367"><a href="#L-367"><span class="linenos">367</span></a> -</span><span id="L-368"><a href="#L-368"><span class="linenos">368</span></a> <span class="k">if</span> <span class="n">table_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">:</span> -</span><span id="L-369"><a href="#L-369"><span class="linenos">369</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> -</span><span id="L-370"><a href="#L-370"><span class="linenos">370</span></a> -</span><span id="L-371"><a href="#L-371"><span class="linenos">371</span></a> <span class="n">node</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> +</span><span id="L-359"><a href="#L-359"><span class="linenos">359</span></a><span class="sd"> This is a class so we can lazily load some things and easily share them across functions.</span> +</span><span id="L-360"><a href="#L-360"><span class="linenos">360</span></a><span class="sd"> """</span> +</span><span id="L-361"><a href="#L-361"><span class="linenos">361</span></a> +</span><span id="L-362"><a href="#L-362"><span class="linenos">362</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">schema</span><span class="p">):</span> +</span><span id="L-363"><a href="#L-363"><span class="linenos">363</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span> <span class="o">=</span> <span class="n">scope</span> +</span><span id="L-364"><a href="#L-364"><span class="linenos">364</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span> <span class="o">=</span> <span class="n">schema</span> +</span><span id="L-365"><a href="#L-365"><span class="linenos">365</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-366"><a href="#L-366"><span class="linenos">366</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-367"><a href="#L-367"><span class="linenos">367</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-368"><a href="#L-368"><span class="linenos">368</span></a> +</span><span id="L-369"><a href="#L-369"><span class="linenos">369</span></a> <span class="k">def</span> <span class="nf">get_table</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">column_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">]:</span> +</span><span id="L-370"><a href="#L-370"><span class="linenos">370</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-371"><a href="#L-371"><span class="linenos">371</span></a><span class="sd"> Get the table for a column name.</span> </span><span id="L-372"><a href="#L-372"><span class="linenos">372</span></a> -</span><span id="L-373"><a href="#L-373"><span class="linenos">373</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> -</span><span id="L-374"><a href="#L-374"><span class="linenos">374</span></a> <span class="k">while</span> <span class="n">node</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">alias</span> <span class="o">!=</span> <span class="n">table_name</span><span class="p">:</span> -</span><span id="L-375"><a href="#L-375"><span class="linenos">375</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">parent</span> -</span><span id="L-376"><a href="#L-376"><span class="linenos">376</span></a> <span class="n">node_alias</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> -</span><span id="L-377"><a href="#L-377"><span class="linenos">377</span></a> <span class="k">if</span> <span class="n">node_alias</span><span class="p">:</span> -</span><span id="L-378"><a href="#L-378"><span class="linenos">378</span></a> <span class="k">return</span> <span class="n">node_alias</span><span class="o">.</span><span class="n">this</span> -</span><span id="L-379"><a href="#L-379"><span class="linenos">379</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> -</span><span id="L-380"><a href="#L-380"><span class="linenos">380</span></a> -</span><span id="L-381"><a href="#L-381"><span class="linenos">381</span></a> <span class="nd">@property</span> -</span><span id="L-382"><a href="#L-382"><span class="linenos">382</span></a> <span class="k">def</span> <span class="nf">all_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-383"><a href="#L-383"><span class="linenos">383</span></a><span class="w"> </span><span class="sd">"""All available columns of all sources in this scope"""</span> -</span><span id="L-384"><a href="#L-384"><span class="linenos">384</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-385"><a href="#L-385"><span class="linenos">385</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="p">{</span> -</span><span id="L-386"><a href="#L-386"><span class="linenos">386</span></a> <span class="n">column</span> <span class="k">for</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">values</span><span class="p">()</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span> -</span><span id="L-387"><a href="#L-387"><span class="linenos">387</span></a> <span class="p">}</span> -</span><span id="L-388"><a href="#L-388"><span class="linenos">388</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> -</span><span id="L-389"><a href="#L-389"><span class="linenos">389</span></a> -</span><span id="L-390"><a href="#L-390"><span class="linenos">390</span></a> <span class="k">def</span> <span class="nf">get_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">only_visible</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> -</span><span id="L-391"><a href="#L-391"><span class="linenos">391</span></a><span class="w"> </span><span class="sd">"""Resolve the source columns for a given source `name`"""</span> -</span><span id="L-392"><a href="#L-392"><span class="linenos">392</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> -</span><span id="L-393"><a href="#L-393"><span class="linenos">393</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-394"><a href="#L-394"><span class="linenos">394</span></a> -</span><span id="L-395"><a href="#L-395"><span class="linenos">395</span></a> <span class="n">source</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> +</span><span id="L-373"><a href="#L-373"><span class="linenos">373</span></a><span class="sd"> Args:</span> +</span><span id="L-374"><a href="#L-374"><span class="linenos">374</span></a><span class="sd"> column_name: The column name to find the table for.</span> +</span><span id="L-375"><a href="#L-375"><span class="linenos">375</span></a><span class="sd"> Returns:</span> +</span><span id="L-376"><a href="#L-376"><span class="linenos">376</span></a><span class="sd"> The table name if it can be found/inferred.</span> +</span><span id="L-377"><a href="#L-377"><span class="linenos">377</span></a><span class="sd"> """</span> +</span><span id="L-378"><a href="#L-378"><span class="linenos">378</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-379"><a href="#L-379"><span class="linenos">379</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_unambiguous_columns</span><span class="p">(</span> +</span><span id="L-380"><a href="#L-380"><span class="linenos">380</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span> +</span><span id="L-381"><a href="#L-381"><span class="linenos">381</span></a> <span class="p">)</span> +</span><span id="L-382"><a href="#L-382"><span class="linenos">382</span></a> +</span><span id="L-383"><a href="#L-383"><span class="linenos">383</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column_name</span><span class="p">)</span> +</span><span id="L-384"><a href="#L-384"><span class="linenos">384</span></a> +</span><span id="L-385"><a href="#L-385"><span class="linenos">385</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_name</span><span class="p">:</span> +</span><span id="L-386"><a href="#L-386"><span class="linenos">386</span></a> <span class="n">sources_without_schema</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span> +</span><span id="L-387"><a href="#L-387"><span class="linenos">387</span></a> <span class="n">source</span> +</span><span id="L-388"><a href="#L-388"><span class="linenos">388</span></a> <span class="k">for</span> <span class="n">source</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> +</span><span id="L-389"><a href="#L-389"><span class="linenos">389</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">columns</span> <span class="ow">or</span> <span class="s2">"*"</span> <span class="ow">in</span> <span class="n">columns</span> +</span><span id="L-390"><a href="#L-390"><span class="linenos">390</span></a> <span class="p">)</span> +</span><span id="L-391"><a href="#L-391"><span class="linenos">391</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sources_without_schema</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="L-392"><a href="#L-392"><span class="linenos">392</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">sources_without_schema</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> +</span><span id="L-393"><a href="#L-393"><span class="linenos">393</span></a> +</span><span id="L-394"><a href="#L-394"><span class="linenos">394</span></a> <span class="k">if</span> <span class="n">table_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">:</span> +</span><span id="L-395"><a href="#L-395"><span class="linenos">395</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> </span><span id="L-396"><a href="#L-396"><span class="linenos">396</span></a> -</span><span id="L-397"><a href="#L-397"><span class="linenos">397</span></a> <span class="c1"># If referencing a table, return the columns from the schema</span> -</span><span id="L-398"><a href="#L-398"><span class="linenos">398</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> -</span><span id="L-399"><a href="#L-399"><span class="linenos">399</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span><span class="o">.</span><span class="n">column_names</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">only_visible</span><span class="p">)</span> -</span><span id="L-400"><a href="#L-400"><span class="linenos">400</span></a> -</span><span id="L-401"><a href="#L-401"><span class="linenos">401</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Values</span><span class="p">):</span> -</span><span id="L-402"><a href="#L-402"><span class="linenos">402</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">alias_column_names</span> -</span><span id="L-403"><a href="#L-403"><span class="linenos">403</span></a> -</span><span id="L-404"><a href="#L-404"><span class="linenos">404</span></a> <span class="c1"># Otherwise, if referencing another scope, return that scope's named selects</span> -</span><span id="L-405"><a href="#L-405"><span class="linenos">405</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span> +</span><span id="L-397"><a href="#L-397"><span class="linenos">397</span></a> <span class="n">node</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> +</span><span id="L-398"><a href="#L-398"><span class="linenos">398</span></a> +</span><span id="L-399"><a href="#L-399"><span class="linenos">399</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> +</span><span id="L-400"><a href="#L-400"><span class="linenos">400</span></a> <span class="k">while</span> <span class="n">node</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">alias</span> <span class="o">!=</span> <span class="n">table_name</span><span class="p">:</span> +</span><span id="L-401"><a href="#L-401"><span class="linenos">401</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">parent</span> +</span><span id="L-402"><a href="#L-402"><span class="linenos">402</span></a> +</span><span id="L-403"><a href="#L-403"><span class="linenos">403</span></a> <span class="n">node_alias</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> +</span><span id="L-404"><a href="#L-404"><span class="linenos">404</span></a> <span class="k">if</span> <span class="n">node_alias</span><span class="p">:</span> +</span><span id="L-405"><a href="#L-405"><span class="linenos">405</span></a> <span class="k">return</span> <span class="n">node_alias</span><span class="o">.</span><span class="n">this</span> </span><span id="L-406"><a href="#L-406"><span class="linenos">406</span></a> -</span><span id="L-407"><a href="#L-407"><span class="linenos">407</span></a> <span class="k">def</span> <span class="nf">_get_all_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-408"><a href="#L-408"><span class="linenos">408</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-409"><a href="#L-409"><span class="linenos">409</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="p">{</span> -</span><span id="L-410"><a href="#L-410"><span class="linenos">410</span></a> <span class="n">k</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">k</span><span class="p">)</span> -</span><span id="L-411"><a href="#L-411"><span class="linenos">411</span></a> <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> -</span><span id="L-412"><a href="#L-412"><span class="linenos">412</span></a> <span class="p">}</span> -</span><span id="L-413"><a href="#L-413"><span class="linenos">413</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> -</span><span id="L-414"><a href="#L-414"><span class="linenos">414</span></a> -</span><span id="L-415"><a href="#L-415"><span class="linenos">415</span></a> <span class="k">def</span> <span class="nf">_get_unambiguous_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_columns</span><span class="p">):</span> -</span><span id="L-416"><a href="#L-416"><span class="linenos">416</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-417"><a href="#L-417"><span class="linenos">417</span></a><span class="sd"> Find all the unambiguous columns in sources.</span> -</span><span id="L-418"><a href="#L-418"><span class="linenos">418</span></a> -</span><span id="L-419"><a href="#L-419"><span class="linenos">419</span></a><span class="sd"> Args:</span> -</span><span id="L-420"><a href="#L-420"><span class="linenos">420</span></a><span class="sd"> source_columns (dict): Mapping of names to source columns</span> -</span><span id="L-421"><a href="#L-421"><span class="linenos">421</span></a><span class="sd"> Returns:</span> -</span><span id="L-422"><a href="#L-422"><span class="linenos">422</span></a><span class="sd"> dict: Mapping of column name to source name</span> -</span><span id="L-423"><a href="#L-423"><span class="linenos">423</span></a><span class="sd"> """</span> -</span><span id="L-424"><a href="#L-424"><span class="linenos">424</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source_columns</span><span class="p">:</span> -</span><span id="L-425"><a href="#L-425"><span class="linenos">425</span></a> <span class="k">return</span> <span class="p">{}</span> +</span><span id="L-407"><a href="#L-407"><span class="linenos">407</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span> +</span><span id="L-408"><a href="#L-408"><span class="linenos">408</span></a> <span class="n">table_name</span><span class="p">,</span> <span class="n">quoted</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">quoted</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="k">else</span> <span class="kc">None</span> +</span><span id="L-409"><a href="#L-409"><span class="linenos">409</span></a> <span class="p">)</span> +</span><span id="L-410"><a href="#L-410"><span class="linenos">410</span></a> +</span><span id="L-411"><a href="#L-411"><span class="linenos">411</span></a> <span class="nd">@property</span> +</span><span id="L-412"><a href="#L-412"><span class="linenos">412</span></a> <span class="k">def</span> <span class="nf">all_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-413"><a href="#L-413"><span class="linenos">413</span></a><span class="w"> </span><span class="sd">"""All available columns of all sources in this scope"""</span> +</span><span id="L-414"><a href="#L-414"><span class="linenos">414</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-415"><a href="#L-415"><span class="linenos">415</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="p">{</span> +</span><span id="L-416"><a href="#L-416"><span class="linenos">416</span></a> <span class="n">column</span> <span class="k">for</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">values</span><span class="p">()</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span> +</span><span id="L-417"><a href="#L-417"><span class="linenos">417</span></a> <span class="p">}</span> +</span><span id="L-418"><a href="#L-418"><span class="linenos">418</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> +</span><span id="L-419"><a href="#L-419"><span class="linenos">419</span></a> +</span><span id="L-420"><a href="#L-420"><span class="linenos">420</span></a> <span class="k">def</span> <span class="nf">get_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">only_visible</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> +</span><span id="L-421"><a href="#L-421"><span class="linenos">421</span></a><span class="w"> </span><span class="sd">"""Resolve the source columns for a given source `name`"""</span> +</span><span id="L-422"><a href="#L-422"><span class="linenos">422</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="L-423"><a href="#L-423"><span class="linenos">423</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-424"><a href="#L-424"><span class="linenos">424</span></a> +</span><span id="L-425"><a href="#L-425"><span class="linenos">425</span></a> <span class="n">source</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> </span><span id="L-426"><a href="#L-426"><span class="linenos">426</span></a> -</span><span id="L-427"><a href="#L-427"><span class="linenos">427</span></a> <span class="n">source_columns</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">source_columns</span><span class="o">.</span><span class="n">items</span><span class="p">())</span> -</span><span id="L-428"><a href="#L-428"><span class="linenos">428</span></a> -</span><span id="L-429"><a href="#L-429"><span class="linenos">429</span></a> <span class="n">first_table</span><span class="p">,</span> <span class="n">first_columns</span> <span class="o">=</span> <span class="n">source_columns</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> -</span><span id="L-430"><a href="#L-430"><span class="linenos">430</span></a> <span class="n">unambiguous_columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">col</span><span class="p">:</span> <span class="n">first_table</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_unique_columns</span><span class="p">(</span><span class="n">first_columns</span><span class="p">)}</span> -</span><span id="L-431"><a href="#L-431"><span class="linenos">431</span></a> <span class="n">all_columns</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">unambiguous_columns</span><span class="p">)</span> -</span><span id="L-432"><a href="#L-432"><span class="linenos">432</span></a> -</span><span id="L-433"><a href="#L-433"><span class="linenos">433</span></a> <span class="k">for</span> <span class="n">table</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="n">source_columns</span><span class="p">[</span><span class="mi">1</span><span class="p">:]:</span> -</span><span id="L-434"><a href="#L-434"><span class="linenos">434</span></a> <span class="n">unique</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_unique_columns</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> -</span><span id="L-435"><a href="#L-435"><span class="linenos">435</span></a> <span class="n">ambiguous</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">all_columns</span><span class="p">)</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="n">unique</span><span class="p">)</span> -</span><span id="L-436"><a href="#L-436"><span class="linenos">436</span></a> <span class="n">all_columns</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> -</span><span id="L-437"><a href="#L-437"><span class="linenos">437</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">ambiguous</span><span class="p">:</span> -</span><span id="L-438"><a href="#L-438"><span class="linenos">438</span></a> <span class="n">unambiguous_columns</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> -</span><span id="L-439"><a href="#L-439"><span class="linenos">439</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">unique</span><span class="o">.</span><span class="n">difference</span><span class="p">(</span><span class="n">ambiguous</span><span class="p">):</span> -</span><span id="L-440"><a href="#L-440"><span class="linenos">440</span></a> <span class="n">unambiguous_columns</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">table</span> -</span><span id="L-441"><a href="#L-441"><span class="linenos">441</span></a> -</span><span id="L-442"><a href="#L-442"><span class="linenos">442</span></a> <span class="k">return</span> <span class="n">unambiguous_columns</span> -</span><span id="L-443"><a href="#L-443"><span class="linenos">443</span></a> -</span><span id="L-444"><a href="#L-444"><span class="linenos">444</span></a> <span class="nd">@staticmethod</span> -</span><span id="L-445"><a href="#L-445"><span class="linenos">445</span></a> <span class="k">def</span> <span class="nf">_find_unique_columns</span><span class="p">(</span><span class="n">columns</span><span class="p">):</span> +</span><span id="L-427"><a href="#L-427"><span class="linenos">427</span></a> <span class="c1"># If referencing a table, return the columns from the schema</span> +</span><span id="L-428"><a href="#L-428"><span class="linenos">428</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> +</span><span id="L-429"><a href="#L-429"><span class="linenos">429</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span><span class="o">.</span><span class="n">column_names</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">only_visible</span><span class="p">)</span> +</span><span id="L-430"><a href="#L-430"><span class="linenos">430</span></a> +</span><span id="L-431"><a href="#L-431"><span class="linenos">431</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Values</span><span class="p">):</span> +</span><span id="L-432"><a href="#L-432"><span class="linenos">432</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">alias_column_names</span> +</span><span id="L-433"><a href="#L-433"><span class="linenos">433</span></a> +</span><span id="L-434"><a href="#L-434"><span class="linenos">434</span></a> <span class="c1"># Otherwise, if referencing another scope, return that scope's named selects</span> +</span><span id="L-435"><a href="#L-435"><span class="linenos">435</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span> +</span><span id="L-436"><a href="#L-436"><span class="linenos">436</span></a> +</span><span id="L-437"><a href="#L-437"><span class="linenos">437</span></a> <span class="k">def</span> <span class="nf">_get_all_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-438"><a href="#L-438"><span class="linenos">438</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-439"><a href="#L-439"><span class="linenos">439</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="p">{</span> +</span><span id="L-440"><a href="#L-440"><span class="linenos">440</span></a> <span class="n">k</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">k</span><span class="p">)</span> +</span><span id="L-441"><a href="#L-441"><span class="linenos">441</span></a> <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> +</span><span id="L-442"><a href="#L-442"><span class="linenos">442</span></a> <span class="p">}</span> +</span><span id="L-443"><a href="#L-443"><span class="linenos">443</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> +</span><span id="L-444"><a href="#L-444"><span class="linenos">444</span></a> +</span><span id="L-445"><a href="#L-445"><span class="linenos">445</span></a> <span class="k">def</span> <span class="nf">_get_unambiguous_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_columns</span><span class="p">):</span> </span><span id="L-446"><a href="#L-446"><span class="linenos">446</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-447"><a href="#L-447"><span class="linenos">447</span></a><span class="sd"> Find the unique columns in a list of columns.</span> +</span><span id="L-447"><a href="#L-447"><span class="linenos">447</span></a><span class="sd"> Find all the unambiguous columns in sources.</span> </span><span id="L-448"><a href="#L-448"><span class="linenos">448</span></a> -</span><span id="L-449"><a href="#L-449"><span class="linenos">449</span></a><span class="sd"> Example:</span> -</span><span id="L-450"><a href="#L-450"><span class="linenos">450</span></a><span class="sd"> >>> sorted(Resolver._find_unique_columns(["a", "b", "b", "c"]))</span> -</span><span id="L-451"><a href="#L-451"><span class="linenos">451</span></a><span class="sd"> ['a', 'c']</span> -</span><span id="L-452"><a href="#L-452"><span class="linenos">452</span></a> -</span><span id="L-453"><a href="#L-453"><span class="linenos">453</span></a><span class="sd"> This is necessary because duplicate column names are ambiguous.</span> -</span><span id="L-454"><a href="#L-454"><span class="linenos">454</span></a><span class="sd"> """</span> -</span><span id="L-455"><a href="#L-455"><span class="linenos">455</span></a> <span class="n">counts</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="L-456"><a href="#L-456"><span class="linenos">456</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> -</span><span id="L-457"><a href="#L-457"><span class="linenos">457</span></a> <span class="n">counts</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">counts</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span> -</span><span id="L-458"><a href="#L-458"><span class="linenos">458</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span><span class="p">,</span> <span class="n">count</span> <span class="ow">in</span> <span class="n">counts</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> <span class="k">if</span> <span class="n">count</span> <span class="o">==</span> <span class="mi">1</span><span class="p">}</span> +</span><span id="L-449"><a href="#L-449"><span class="linenos">449</span></a><span class="sd"> Args:</span> +</span><span id="L-450"><a href="#L-450"><span class="linenos">450</span></a><span class="sd"> source_columns (dict): Mapping of names to source columns</span> +</span><span id="L-451"><a href="#L-451"><span class="linenos">451</span></a><span class="sd"> Returns:</span> +</span><span id="L-452"><a href="#L-452"><span class="linenos">452</span></a><span class="sd"> dict: Mapping of column name to source name</span> +</span><span id="L-453"><a href="#L-453"><span class="linenos">453</span></a><span class="sd"> """</span> +</span><span id="L-454"><a href="#L-454"><span class="linenos">454</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source_columns</span><span class="p">:</span> +</span><span id="L-455"><a href="#L-455"><span class="linenos">455</span></a> <span class="k">return</span> <span class="p">{}</span> +</span><span id="L-456"><a href="#L-456"><span class="linenos">456</span></a> +</span><span id="L-457"><a href="#L-457"><span class="linenos">457</span></a> <span class="n">source_columns</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">source_columns</span><span class="o">.</span><span class="n">items</span><span class="p">())</span> +</span><span id="L-458"><a href="#L-458"><span class="linenos">458</span></a> +</span><span id="L-459"><a href="#L-459"><span class="linenos">459</span></a> <span class="n">first_table</span><span class="p">,</span> <span class="n">first_columns</span> <span class="o">=</span> <span class="n">source_columns</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> +</span><span id="L-460"><a href="#L-460"><span class="linenos">460</span></a> <span class="n">unambiguous_columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">col</span><span class="p">:</span> <span class="n">first_table</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_unique_columns</span><span class="p">(</span><span class="n">first_columns</span><span class="p">)}</span> +</span><span id="L-461"><a href="#L-461"><span class="linenos">461</span></a> <span class="n">all_columns</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">unambiguous_columns</span><span class="p">)</span> +</span><span id="L-462"><a href="#L-462"><span class="linenos">462</span></a> +</span><span id="L-463"><a href="#L-463"><span class="linenos">463</span></a> <span class="k">for</span> <span class="n">table</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="n">source_columns</span><span class="p">[</span><span class="mi">1</span><span class="p">:]:</span> +</span><span id="L-464"><a href="#L-464"><span class="linenos">464</span></a> <span class="n">unique</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_unique_columns</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> +</span><span id="L-465"><a href="#L-465"><span class="linenos">465</span></a> <span class="n">ambiguous</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">all_columns</span><span class="p">)</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="n">unique</span><span class="p">)</span> +</span><span id="L-466"><a href="#L-466"><span class="linenos">466</span></a> <span class="n">all_columns</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> +</span><span id="L-467"><a href="#L-467"><span class="linenos">467</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">ambiguous</span><span class="p">:</span> +</span><span id="L-468"><a href="#L-468"><span class="linenos">468</span></a> <span class="n">unambiguous_columns</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> +</span><span id="L-469"><a href="#L-469"><span class="linenos">469</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">unique</span><span class="o">.</span><span class="n">difference</span><span class="p">(</span><span class="n">ambiguous</span><span class="p">):</span> +</span><span id="L-470"><a href="#L-470"><span class="linenos">470</span></a> <span class="n">unambiguous_columns</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">table</span> +</span><span id="L-471"><a href="#L-471"><span class="linenos">471</span></a> +</span><span id="L-472"><a href="#L-472"><span class="linenos">472</span></a> <span class="k">return</span> <span class="n">unambiguous_columns</span> +</span><span id="L-473"><a href="#L-473"><span class="linenos">473</span></a> +</span><span id="L-474"><a href="#L-474"><span class="linenos">474</span></a> <span class="nd">@staticmethod</span> +</span><span id="L-475"><a href="#L-475"><span class="linenos">475</span></a> <span class="k">def</span> <span class="nf">_find_unique_columns</span><span class="p">(</span><span class="n">columns</span><span class="p">):</span> +</span><span id="L-476"><a href="#L-476"><span class="linenos">476</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-477"><a href="#L-477"><span class="linenos">477</span></a><span class="sd"> Find the unique columns in a list of columns.</span> +</span><span id="L-478"><a href="#L-478"><span class="linenos">478</span></a> +</span><span id="L-479"><a href="#L-479"><span class="linenos">479</span></a><span class="sd"> Example:</span> +</span><span id="L-480"><a href="#L-480"><span class="linenos">480</span></a><span class="sd"> >>> sorted(Resolver._find_unique_columns(["a", "b", "b", "c"]))</span> +</span><span id="L-481"><a href="#L-481"><span class="linenos">481</span></a><span class="sd"> ['a', 'c']</span> +</span><span id="L-482"><a href="#L-482"><span class="linenos">482</span></a> +</span><span id="L-483"><a href="#L-483"><span class="linenos">483</span></a><span class="sd"> This is necessary because duplicate column names are ambiguous.</span> +</span><span id="L-484"><a href="#L-484"><span class="linenos">484</span></a><span class="sd"> """</span> +</span><span id="L-485"><a href="#L-485"><span class="linenos">485</span></a> <span class="n">counts</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-486"><a href="#L-486"><span class="linenos">486</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> +</span><span id="L-487"><a href="#L-487"><span class="linenos">487</span></a> <span class="n">counts</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">counts</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span> +</span><span id="L-488"><a href="#L-488"><span class="linenos">488</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span><span class="p">,</span> <span class="n">count</span> <span class="ow">in</span> <span class="n">counts</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> <span class="k">if</span> <span class="n">count</span> <span class="o">==</span> <span class="mi">1</span><span class="p">}</span> </span></pre></div> @@ -580,7 +610,8 @@ </span><span id="qualify_columns-38"><a href="#qualify_columns-38"><span class="linenos">38</span></a> <span class="n">_qualify_outputs</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> </span><span id="qualify_columns-39"><a href="#qualify_columns-39"><span class="linenos">39</span></a> <span class="n">_expand_group_by</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">resolver</span><span class="p">)</span> </span><span id="qualify_columns-40"><a href="#qualify_columns-40"><span class="linenos">40</span></a> <span class="n">_expand_order_by</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> -</span><span id="qualify_columns-41"><a href="#qualify_columns-41"><span class="linenos">41</span></a> <span class="k">return</span> <span class="n">expression</span> +</span><span id="qualify_columns-41"><a href="#qualify_columns-41"><span class="linenos">41</span></a> +</span><span id="qualify_columns-42"><a href="#qualify_columns-42"><span class="linenos">42</span></a> <span class="k">return</span> <span class="n">expression</span> </span></pre></div> @@ -626,19 +657,19 @@ </div> <a class="headerlink" href="#validate_qualify_columns"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="validate_qualify_columns-44"><a href="#validate_qualify_columns-44"><span class="linenos">44</span></a><span class="k">def</span> <span class="nf">validate_qualify_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> -</span><span id="validate_qualify_columns-45"><a href="#validate_qualify_columns-45"><span class="linenos">45</span></a><span class="w"> </span><span class="sd">"""Raise an `OptimizeError` if any columns aren't qualified"""</span> -</span><span id="validate_qualify_columns-46"><a href="#validate_qualify_columns-46"><span class="linenos">46</span></a> <span class="n">unqualified_columns</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="validate_qualify_columns-47"><a href="#validate_qualify_columns-47"><span class="linenos">47</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> -</span><span id="validate_qualify_columns-48"><a href="#validate_qualify_columns-48"><span class="linenos">48</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> -</span><span id="validate_qualify_columns-49"><a href="#validate_qualify_columns-49"><span class="linenos">49</span></a> <span class="n">unqualified_columns</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">unqualified_columns</span><span class="p">)</span> -</span><span id="validate_qualify_columns-50"><a href="#validate_qualify_columns-50"><span class="linenos">50</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">scope</span><span class="o">.</span><span class="n">is_correlated_subquery</span><span class="p">:</span> -</span><span id="validate_qualify_columns-51"><a href="#validate_qualify_columns-51"><span class="linenos">51</span></a> <span class="n">column</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> -</span><span id="validate_qualify_columns-52"><a href="#validate_qualify_columns-52"><span class="linenos">52</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: '</span><span class="si">{</span><span class="n">column</span><span class="o">.</span><span class="n">table</span><span class="si">}</span><span class="s2">' for column '</span><span class="si">{</span><span class="n">column</span><span class="si">}</span><span class="s2">'"</span><span class="p">)</span> -</span><span id="validate_qualify_columns-53"><a href="#validate_qualify_columns-53"><span class="linenos">53</span></a> -</span><span id="validate_qualify_columns-54"><a href="#validate_qualify_columns-54"><span class="linenos">54</span></a> <span class="k">if</span> <span class="n">unqualified_columns</span><span class="p">:</span> -</span><span id="validate_qualify_columns-55"><a href="#validate_qualify_columns-55"><span class="linenos">55</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous columns: </span><span class="si">{</span><span class="n">unqualified_columns</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="validate_qualify_columns-56"><a href="#validate_qualify_columns-56"><span class="linenos">56</span></a> <span class="k">return</span> <span class="n">expression</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="validate_qualify_columns-45"><a href="#validate_qualify_columns-45"><span class="linenos">45</span></a><span class="k">def</span> <span class="nf">validate_qualify_columns</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> +</span><span id="validate_qualify_columns-46"><a href="#validate_qualify_columns-46"><span class="linenos">46</span></a><span class="w"> </span><span class="sd">"""Raise an `OptimizeError` if any columns aren't qualified"""</span> +</span><span id="validate_qualify_columns-47"><a href="#validate_qualify_columns-47"><span class="linenos">47</span></a> <span class="n">unqualified_columns</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="validate_qualify_columns-48"><a href="#validate_qualify_columns-48"><span class="linenos">48</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> +</span><span id="validate_qualify_columns-49"><a href="#validate_qualify_columns-49"><span class="linenos">49</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> +</span><span id="validate_qualify_columns-50"><a href="#validate_qualify_columns-50"><span class="linenos">50</span></a> <span class="n">unqualified_columns</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">unqualified_columns</span><span class="p">)</span> +</span><span id="validate_qualify_columns-51"><a href="#validate_qualify_columns-51"><span class="linenos">51</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">scope</span><span class="o">.</span><span class="n">is_correlated_subquery</span><span class="p">:</span> +</span><span id="validate_qualify_columns-52"><a href="#validate_qualify_columns-52"><span class="linenos">52</span></a> <span class="n">column</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> +</span><span id="validate_qualify_columns-53"><a href="#validate_qualify_columns-53"><span class="linenos">53</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: '</span><span class="si">{</span><span class="n">column</span><span class="o">.</span><span class="n">table</span><span class="si">}</span><span class="s2">' for column '</span><span class="si">{</span><span class="n">column</span><span class="si">}</span><span class="s2">'"</span><span class="p">)</span> +</span><span id="validate_qualify_columns-54"><a href="#validate_qualify_columns-54"><span class="linenos">54</span></a> +</span><span id="validate_qualify_columns-55"><a href="#validate_qualify_columns-55"><span class="linenos">55</span></a> <span class="k">if</span> <span class="n">unqualified_columns</span><span class="p">:</span> +</span><span id="validate_qualify_columns-56"><a href="#validate_qualify_columns-56"><span class="linenos">56</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Ambiguous columns: </span><span class="si">{</span><span class="n">unqualified_columns</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="validate_qualify_columns-57"><a href="#validate_qualify_columns-57"><span class="linenos">57</span></a> <span class="k">return</span> <span class="n">expression</span> </span></pre></div> @@ -658,136 +689,140 @@ </div> <a class="headerlink" href="#Resolver"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Resolver-330"><a href="#Resolver-330"><span class="linenos">330</span></a><span class="k">class</span> <span class="nc">Resolver</span><span class="p">:</span> -</span><span id="Resolver-331"><a href="#Resolver-331"><span class="linenos">331</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Resolver-332"><a href="#Resolver-332"><span class="linenos">332</span></a><span class="sd"> Helper for resolving columns.</span> -</span><span id="Resolver-333"><a href="#Resolver-333"><span class="linenos">333</span></a> -</span><span id="Resolver-334"><a href="#Resolver-334"><span class="linenos">334</span></a><span class="sd"> This is a class so we can lazily load some things and easily share them across functions.</span> -</span><span id="Resolver-335"><a href="#Resolver-335"><span class="linenos">335</span></a><span class="sd"> """</span> -</span><span id="Resolver-336"><a href="#Resolver-336"><span class="linenos">336</span></a> -</span><span id="Resolver-337"><a href="#Resolver-337"><span class="linenos">337</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">schema</span><span class="p">):</span> -</span><span id="Resolver-338"><a href="#Resolver-338"><span class="linenos">338</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span> <span class="o">=</span> <span class="n">scope</span> -</span><span id="Resolver-339"><a href="#Resolver-339"><span class="linenos">339</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span> <span class="o">=</span> <span class="n">schema</span> -</span><span id="Resolver-340"><a href="#Resolver-340"><span class="linenos">340</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Resolver-341"><a href="#Resolver-341"><span class="linenos">341</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Resolver-342"><a href="#Resolver-342"><span class="linenos">342</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Resolver-343"><a href="#Resolver-343"><span class="linenos">343</span></a> -</span><span id="Resolver-344"><a href="#Resolver-344"><span class="linenos">344</span></a> <span class="k">def</span> <span class="nf">get_table</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">column_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">]:</span> -</span><span id="Resolver-345"><a href="#Resolver-345"><span class="linenos">345</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Resolver-346"><a href="#Resolver-346"><span class="linenos">346</span></a><span class="sd"> Get the table for a column name.</span> -</span><span id="Resolver-347"><a href="#Resolver-347"><span class="linenos">347</span></a> -</span><span id="Resolver-348"><a href="#Resolver-348"><span class="linenos">348</span></a><span class="sd"> Args:</span> -</span><span id="Resolver-349"><a href="#Resolver-349"><span class="linenos">349</span></a><span class="sd"> column_name: The column name to find the table for.</span> -</span><span id="Resolver-350"><a href="#Resolver-350"><span class="linenos">350</span></a><span class="sd"> Returns:</span> -</span><span id="Resolver-351"><a href="#Resolver-351"><span class="linenos">351</span></a><span class="sd"> The table name if it can be found/inferred.</span> -</span><span id="Resolver-352"><a href="#Resolver-352"><span class="linenos">352</span></a><span class="sd"> """</span> -</span><span id="Resolver-353"><a href="#Resolver-353"><span class="linenos">353</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Resolver-354"><a href="#Resolver-354"><span class="linenos">354</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_unambiguous_columns</span><span class="p">(</span> -</span><span id="Resolver-355"><a href="#Resolver-355"><span class="linenos">355</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span> -</span><span id="Resolver-356"><a href="#Resolver-356"><span class="linenos">356</span></a> <span class="p">)</span> -</span><span id="Resolver-357"><a href="#Resolver-357"><span class="linenos">357</span></a> -</span><span id="Resolver-358"><a href="#Resolver-358"><span class="linenos">358</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column_name</span><span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Resolver-356"><a href="#Resolver-356"><span class="linenos">356</span></a><span class="k">class</span> <span class="nc">Resolver</span><span class="p">:</span> +</span><span id="Resolver-357"><a href="#Resolver-357"><span class="linenos">357</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Resolver-358"><a href="#Resolver-358"><span class="linenos">358</span></a><span class="sd"> Helper for resolving columns.</span> </span><span id="Resolver-359"><a href="#Resolver-359"><span class="linenos">359</span></a> -</span><span id="Resolver-360"><a href="#Resolver-360"><span class="linenos">360</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_name</span><span class="p">:</span> -</span><span id="Resolver-361"><a href="#Resolver-361"><span class="linenos">361</span></a> <span class="n">sources_without_schema</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span> -</span><span id="Resolver-362"><a href="#Resolver-362"><span class="linenos">362</span></a> <span class="n">source</span> -</span><span id="Resolver-363"><a href="#Resolver-363"><span class="linenos">363</span></a> <span class="k">for</span> <span class="n">source</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> -</span><span id="Resolver-364"><a href="#Resolver-364"><span class="linenos">364</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">columns</span> <span class="ow">or</span> <span class="s2">"*"</span> <span class="ow">in</span> <span class="n">columns</span> -</span><span id="Resolver-365"><a href="#Resolver-365"><span class="linenos">365</span></a> <span class="p">)</span> -</span><span id="Resolver-366"><a href="#Resolver-366"><span class="linenos">366</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sources_without_schema</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="Resolver-367"><a href="#Resolver-367"><span class="linenos">367</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">sources_without_schema</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> -</span><span id="Resolver-368"><a href="#Resolver-368"><span class="linenos">368</span></a> -</span><span id="Resolver-369"><a href="#Resolver-369"><span class="linenos">369</span></a> <span class="k">if</span> <span class="n">table_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">:</span> -</span><span id="Resolver-370"><a href="#Resolver-370"><span class="linenos">370</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> -</span><span id="Resolver-371"><a href="#Resolver-371"><span class="linenos">371</span></a> -</span><span id="Resolver-372"><a href="#Resolver-372"><span class="linenos">372</span></a> <span class="n">node</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> +</span><span id="Resolver-360"><a href="#Resolver-360"><span class="linenos">360</span></a><span class="sd"> This is a class so we can lazily load some things and easily share them across functions.</span> +</span><span id="Resolver-361"><a href="#Resolver-361"><span class="linenos">361</span></a><span class="sd"> """</span> +</span><span id="Resolver-362"><a href="#Resolver-362"><span class="linenos">362</span></a> +</span><span id="Resolver-363"><a href="#Resolver-363"><span class="linenos">363</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">schema</span><span class="p">):</span> +</span><span id="Resolver-364"><a href="#Resolver-364"><span class="linenos">364</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span> <span class="o">=</span> <span class="n">scope</span> +</span><span id="Resolver-365"><a href="#Resolver-365"><span class="linenos">365</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span> <span class="o">=</span> <span class="n">schema</span> +</span><span id="Resolver-366"><a href="#Resolver-366"><span class="linenos">366</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Resolver-367"><a href="#Resolver-367"><span class="linenos">367</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Resolver-368"><a href="#Resolver-368"><span class="linenos">368</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Resolver-369"><a href="#Resolver-369"><span class="linenos">369</span></a> +</span><span id="Resolver-370"><a href="#Resolver-370"><span class="linenos">370</span></a> <span class="k">def</span> <span class="nf">get_table</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">column_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">]:</span> +</span><span id="Resolver-371"><a href="#Resolver-371"><span class="linenos">371</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Resolver-372"><a href="#Resolver-372"><span class="linenos">372</span></a><span class="sd"> Get the table for a column name.</span> </span><span id="Resolver-373"><a href="#Resolver-373"><span class="linenos">373</span></a> -</span><span id="Resolver-374"><a href="#Resolver-374"><span class="linenos">374</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> -</span><span id="Resolver-375"><a href="#Resolver-375"><span class="linenos">375</span></a> <span class="k">while</span> <span class="n">node</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">alias</span> <span class="o">!=</span> <span class="n">table_name</span><span class="p">:</span> -</span><span id="Resolver-376"><a href="#Resolver-376"><span class="linenos">376</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">parent</span> -</span><span id="Resolver-377"><a href="#Resolver-377"><span class="linenos">377</span></a> <span class="n">node_alias</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> -</span><span id="Resolver-378"><a href="#Resolver-378"><span class="linenos">378</span></a> <span class="k">if</span> <span class="n">node_alias</span><span class="p">:</span> -</span><span id="Resolver-379"><a href="#Resolver-379"><span class="linenos">379</span></a> <span class="k">return</span> <span class="n">node_alias</span><span class="o">.</span><span class="n">this</span> -</span><span id="Resolver-380"><a href="#Resolver-380"><span class="linenos">380</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> -</span><span id="Resolver-381"><a href="#Resolver-381"><span class="linenos">381</span></a> -</span><span id="Resolver-382"><a href="#Resolver-382"><span class="linenos">382</span></a> <span class="nd">@property</span> -</span><span id="Resolver-383"><a href="#Resolver-383"><span class="linenos">383</span></a> <span class="k">def</span> <span class="nf">all_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Resolver-384"><a href="#Resolver-384"><span class="linenos">384</span></a><span class="w"> </span><span class="sd">"""All available columns of all sources in this scope"""</span> -</span><span id="Resolver-385"><a href="#Resolver-385"><span class="linenos">385</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Resolver-386"><a href="#Resolver-386"><span class="linenos">386</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="p">{</span> -</span><span id="Resolver-387"><a href="#Resolver-387"><span class="linenos">387</span></a> <span class="n">column</span> <span class="k">for</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">values</span><span class="p">()</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span> -</span><span id="Resolver-388"><a href="#Resolver-388"><span class="linenos">388</span></a> <span class="p">}</span> -</span><span id="Resolver-389"><a href="#Resolver-389"><span class="linenos">389</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> -</span><span id="Resolver-390"><a href="#Resolver-390"><span class="linenos">390</span></a> -</span><span id="Resolver-391"><a href="#Resolver-391"><span class="linenos">391</span></a> <span class="k">def</span> <span class="nf">get_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">only_visible</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> -</span><span id="Resolver-392"><a href="#Resolver-392"><span class="linenos">392</span></a><span class="w"> </span><span class="sd">"""Resolve the source columns for a given source `name`"""</span> -</span><span id="Resolver-393"><a href="#Resolver-393"><span class="linenos">393</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> -</span><span id="Resolver-394"><a href="#Resolver-394"><span class="linenos">394</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="Resolver-395"><a href="#Resolver-395"><span class="linenos">395</span></a> -</span><span id="Resolver-396"><a href="#Resolver-396"><span class="linenos">396</span></a> <span class="n">source</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> +</span><span id="Resolver-374"><a href="#Resolver-374"><span class="linenos">374</span></a><span class="sd"> Args:</span> +</span><span id="Resolver-375"><a href="#Resolver-375"><span class="linenos">375</span></a><span class="sd"> column_name: The column name to find the table for.</span> +</span><span id="Resolver-376"><a href="#Resolver-376"><span class="linenos">376</span></a><span class="sd"> Returns:</span> +</span><span id="Resolver-377"><a href="#Resolver-377"><span class="linenos">377</span></a><span class="sd"> The table name if it can be found/inferred.</span> +</span><span id="Resolver-378"><a href="#Resolver-378"><span class="linenos">378</span></a><span class="sd"> """</span> +</span><span id="Resolver-379"><a href="#Resolver-379"><span class="linenos">379</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Resolver-380"><a href="#Resolver-380"><span class="linenos">380</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_unambiguous_columns</span><span class="p">(</span> +</span><span id="Resolver-381"><a href="#Resolver-381"><span class="linenos">381</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span> +</span><span id="Resolver-382"><a href="#Resolver-382"><span class="linenos">382</span></a> <span class="p">)</span> +</span><span id="Resolver-383"><a href="#Resolver-383"><span class="linenos">383</span></a> +</span><span id="Resolver-384"><a href="#Resolver-384"><span class="linenos">384</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column_name</span><span class="p">)</span> +</span><span id="Resolver-385"><a href="#Resolver-385"><span class="linenos">385</span></a> +</span><span id="Resolver-386"><a href="#Resolver-386"><span class="linenos">386</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_name</span><span class="p">:</span> +</span><span id="Resolver-387"><a href="#Resolver-387"><span class="linenos">387</span></a> <span class="n">sources_without_schema</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span> +</span><span id="Resolver-388"><a href="#Resolver-388"><span class="linenos">388</span></a> <span class="n">source</span> +</span><span id="Resolver-389"><a href="#Resolver-389"><span class="linenos">389</span></a> <span class="k">for</span> <span class="n">source</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> +</span><span id="Resolver-390"><a href="#Resolver-390"><span class="linenos">390</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">columns</span> <span class="ow">or</span> <span class="s2">"*"</span> <span class="ow">in</span> <span class="n">columns</span> +</span><span id="Resolver-391"><a href="#Resolver-391"><span class="linenos">391</span></a> <span class="p">)</span> +</span><span id="Resolver-392"><a href="#Resolver-392"><span class="linenos">392</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sources_without_schema</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="Resolver-393"><a href="#Resolver-393"><span class="linenos">393</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">sources_without_schema</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> +</span><span id="Resolver-394"><a href="#Resolver-394"><span class="linenos">394</span></a> +</span><span id="Resolver-395"><a href="#Resolver-395"><span class="linenos">395</span></a> <span class="k">if</span> <span class="n">table_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">:</span> +</span><span id="Resolver-396"><a href="#Resolver-396"><span class="linenos">396</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> </span><span id="Resolver-397"><a href="#Resolver-397"><span class="linenos">397</span></a> -</span><span id="Resolver-398"><a href="#Resolver-398"><span class="linenos">398</span></a> <span class="c1"># If referencing a table, return the columns from the schema</span> -</span><span id="Resolver-399"><a href="#Resolver-399"><span class="linenos">399</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> -</span><span id="Resolver-400"><a href="#Resolver-400"><span class="linenos">400</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span><span class="o">.</span><span class="n">column_names</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">only_visible</span><span class="p">)</span> -</span><span id="Resolver-401"><a href="#Resolver-401"><span class="linenos">401</span></a> -</span><span id="Resolver-402"><a href="#Resolver-402"><span class="linenos">402</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Values</span><span class="p">):</span> -</span><span id="Resolver-403"><a href="#Resolver-403"><span class="linenos">403</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">alias_column_names</span> -</span><span id="Resolver-404"><a href="#Resolver-404"><span class="linenos">404</span></a> -</span><span id="Resolver-405"><a href="#Resolver-405"><span class="linenos">405</span></a> <span class="c1"># Otherwise, if referencing another scope, return that scope's named selects</span> -</span><span id="Resolver-406"><a href="#Resolver-406"><span class="linenos">406</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span> +</span><span id="Resolver-398"><a href="#Resolver-398"><span class="linenos">398</span></a> <span class="n">node</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> +</span><span id="Resolver-399"><a href="#Resolver-399"><span class="linenos">399</span></a> +</span><span id="Resolver-400"><a href="#Resolver-400"><span class="linenos">400</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> +</span><span id="Resolver-401"><a href="#Resolver-401"><span class="linenos">401</span></a> <span class="k">while</span> <span class="n">node</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">alias</span> <span class="o">!=</span> <span class="n">table_name</span><span class="p">:</span> +</span><span id="Resolver-402"><a href="#Resolver-402"><span class="linenos">402</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">parent</span> +</span><span id="Resolver-403"><a href="#Resolver-403"><span class="linenos">403</span></a> +</span><span id="Resolver-404"><a href="#Resolver-404"><span class="linenos">404</span></a> <span class="n">node_alias</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> +</span><span id="Resolver-405"><a href="#Resolver-405"><span class="linenos">405</span></a> <span class="k">if</span> <span class="n">node_alias</span><span class="p">:</span> +</span><span id="Resolver-406"><a href="#Resolver-406"><span class="linenos">406</span></a> <span class="k">return</span> <span class="n">node_alias</span><span class="o">.</span><span class="n">this</span> </span><span id="Resolver-407"><a href="#Resolver-407"><span class="linenos">407</span></a> -</span><span id="Resolver-408"><a href="#Resolver-408"><span class="linenos">408</span></a> <span class="k">def</span> <span class="nf">_get_all_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Resolver-409"><a href="#Resolver-409"><span class="linenos">409</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Resolver-410"><a href="#Resolver-410"><span class="linenos">410</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="p">{</span> -</span><span id="Resolver-411"><a href="#Resolver-411"><span class="linenos">411</span></a> <span class="n">k</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">k</span><span class="p">)</span> -</span><span id="Resolver-412"><a href="#Resolver-412"><span class="linenos">412</span></a> <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> -</span><span id="Resolver-413"><a href="#Resolver-413"><span class="linenos">413</span></a> <span class="p">}</span> -</span><span id="Resolver-414"><a href="#Resolver-414"><span class="linenos">414</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> -</span><span id="Resolver-415"><a href="#Resolver-415"><span class="linenos">415</span></a> -</span><span id="Resolver-416"><a href="#Resolver-416"><span class="linenos">416</span></a> <span class="k">def</span> <span class="nf">_get_unambiguous_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_columns</span><span class="p">):</span> -</span><span id="Resolver-417"><a href="#Resolver-417"><span class="linenos">417</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Resolver-418"><a href="#Resolver-418"><span class="linenos">418</span></a><span class="sd"> Find all the unambiguous columns in sources.</span> -</span><span id="Resolver-419"><a href="#Resolver-419"><span class="linenos">419</span></a> -</span><span id="Resolver-420"><a href="#Resolver-420"><span class="linenos">420</span></a><span class="sd"> Args:</span> -</span><span id="Resolver-421"><a href="#Resolver-421"><span class="linenos">421</span></a><span class="sd"> source_columns (dict): Mapping of names to source columns</span> -</span><span id="Resolver-422"><a href="#Resolver-422"><span class="linenos">422</span></a><span class="sd"> Returns:</span> -</span><span id="Resolver-423"><a href="#Resolver-423"><span class="linenos">423</span></a><span class="sd"> dict: Mapping of column name to source name</span> -</span><span id="Resolver-424"><a href="#Resolver-424"><span class="linenos">424</span></a><span class="sd"> """</span> -</span><span id="Resolver-425"><a href="#Resolver-425"><span class="linenos">425</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source_columns</span><span class="p">:</span> -</span><span id="Resolver-426"><a href="#Resolver-426"><span class="linenos">426</span></a> <span class="k">return</span> <span class="p">{}</span> +</span><span id="Resolver-408"><a href="#Resolver-408"><span class="linenos">408</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span> +</span><span id="Resolver-409"><a href="#Resolver-409"><span class="linenos">409</span></a> <span class="n">table_name</span><span class="p">,</span> <span class="n">quoted</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">quoted</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="k">else</span> <span class="kc">None</span> +</span><span id="Resolver-410"><a href="#Resolver-410"><span class="linenos">410</span></a> <span class="p">)</span> +</span><span id="Resolver-411"><a href="#Resolver-411"><span class="linenos">411</span></a> +</span><span id="Resolver-412"><a href="#Resolver-412"><span class="linenos">412</span></a> <span class="nd">@property</span> +</span><span id="Resolver-413"><a href="#Resolver-413"><span class="linenos">413</span></a> <span class="k">def</span> <span class="nf">all_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Resolver-414"><a href="#Resolver-414"><span class="linenos">414</span></a><span class="w"> </span><span class="sd">"""All available columns of all sources in this scope"""</span> +</span><span id="Resolver-415"><a href="#Resolver-415"><span class="linenos">415</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Resolver-416"><a href="#Resolver-416"><span class="linenos">416</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="p">{</span> +</span><span id="Resolver-417"><a href="#Resolver-417"><span class="linenos">417</span></a> <span class="n">column</span> <span class="k">for</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">values</span><span class="p">()</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span> +</span><span id="Resolver-418"><a href="#Resolver-418"><span class="linenos">418</span></a> <span class="p">}</span> +</span><span id="Resolver-419"><a href="#Resolver-419"><span class="linenos">419</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> +</span><span id="Resolver-420"><a href="#Resolver-420"><span class="linenos">420</span></a> +</span><span id="Resolver-421"><a href="#Resolver-421"><span class="linenos">421</span></a> <span class="k">def</span> <span class="nf">get_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">only_visible</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> +</span><span id="Resolver-422"><a href="#Resolver-422"><span class="linenos">422</span></a><span class="w"> </span><span class="sd">"""Resolve the source columns for a given source `name`"""</span> +</span><span id="Resolver-423"><a href="#Resolver-423"><span class="linenos">423</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="Resolver-424"><a href="#Resolver-424"><span class="linenos">424</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="Resolver-425"><a href="#Resolver-425"><span class="linenos">425</span></a> +</span><span id="Resolver-426"><a href="#Resolver-426"><span class="linenos">426</span></a> <span class="n">source</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> </span><span id="Resolver-427"><a href="#Resolver-427"><span class="linenos">427</span></a> -</span><span id="Resolver-428"><a href="#Resolver-428"><span class="linenos">428</span></a> <span class="n">source_columns</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">source_columns</span><span class="o">.</span><span class="n">items</span><span class="p">())</span> -</span><span id="Resolver-429"><a href="#Resolver-429"><span class="linenos">429</span></a> -</span><span id="Resolver-430"><a href="#Resolver-430"><span class="linenos">430</span></a> <span class="n">first_table</span><span class="p">,</span> <span class="n">first_columns</span> <span class="o">=</span> <span class="n">source_columns</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> -</span><span id="Resolver-431"><a href="#Resolver-431"><span class="linenos">431</span></a> <span class="n">unambiguous_columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">col</span><span class="p">:</span> <span class="n">first_table</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_unique_columns</span><span class="p">(</span><span class="n">first_columns</span><span class="p">)}</span> -</span><span id="Resolver-432"><a href="#Resolver-432"><span class="linenos">432</span></a> <span class="n">all_columns</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">unambiguous_columns</span><span class="p">)</span> -</span><span id="Resolver-433"><a href="#Resolver-433"><span class="linenos">433</span></a> -</span><span id="Resolver-434"><a href="#Resolver-434"><span class="linenos">434</span></a> <span class="k">for</span> <span class="n">table</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="n">source_columns</span><span class="p">[</span><span class="mi">1</span><span class="p">:]:</span> -</span><span id="Resolver-435"><a href="#Resolver-435"><span class="linenos">435</span></a> <span class="n">unique</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_unique_columns</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> -</span><span id="Resolver-436"><a href="#Resolver-436"><span class="linenos">436</span></a> <span class="n">ambiguous</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">all_columns</span><span class="p">)</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="n">unique</span><span class="p">)</span> -</span><span id="Resolver-437"><a href="#Resolver-437"><span class="linenos">437</span></a> <span class="n">all_columns</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> -</span><span id="Resolver-438"><a href="#Resolver-438"><span class="linenos">438</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">ambiguous</span><span class="p">:</span> -</span><span id="Resolver-439"><a href="#Resolver-439"><span class="linenos">439</span></a> <span class="n">unambiguous_columns</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> -</span><span id="Resolver-440"><a href="#Resolver-440"><span class="linenos">440</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">unique</span><span class="o">.</span><span class="n">difference</span><span class="p">(</span><span class="n">ambiguous</span><span class="p">):</span> -</span><span id="Resolver-441"><a href="#Resolver-441"><span class="linenos">441</span></a> <span class="n">unambiguous_columns</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">table</span> -</span><span id="Resolver-442"><a href="#Resolver-442"><span class="linenos">442</span></a> -</span><span id="Resolver-443"><a href="#Resolver-443"><span class="linenos">443</span></a> <span class="k">return</span> <span class="n">unambiguous_columns</span> -</span><span id="Resolver-444"><a href="#Resolver-444"><span class="linenos">444</span></a> -</span><span id="Resolver-445"><a href="#Resolver-445"><span class="linenos">445</span></a> <span class="nd">@staticmethod</span> -</span><span id="Resolver-446"><a href="#Resolver-446"><span class="linenos">446</span></a> <span class="k">def</span> <span class="nf">_find_unique_columns</span><span class="p">(</span><span class="n">columns</span><span class="p">):</span> +</span><span id="Resolver-428"><a href="#Resolver-428"><span class="linenos">428</span></a> <span class="c1"># If referencing a table, return the columns from the schema</span> +</span><span id="Resolver-429"><a href="#Resolver-429"><span class="linenos">429</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> +</span><span id="Resolver-430"><a href="#Resolver-430"><span class="linenos">430</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span><span class="o">.</span><span class="n">column_names</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">only_visible</span><span class="p">)</span> +</span><span id="Resolver-431"><a href="#Resolver-431"><span class="linenos">431</span></a> +</span><span id="Resolver-432"><a href="#Resolver-432"><span class="linenos">432</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Values</span><span class="p">):</span> +</span><span id="Resolver-433"><a href="#Resolver-433"><span class="linenos">433</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">alias_column_names</span> +</span><span id="Resolver-434"><a href="#Resolver-434"><span class="linenos">434</span></a> +</span><span id="Resolver-435"><a href="#Resolver-435"><span class="linenos">435</span></a> <span class="c1"># Otherwise, if referencing another scope, return that scope's named selects</span> +</span><span id="Resolver-436"><a href="#Resolver-436"><span class="linenos">436</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span> +</span><span id="Resolver-437"><a href="#Resolver-437"><span class="linenos">437</span></a> +</span><span id="Resolver-438"><a href="#Resolver-438"><span class="linenos">438</span></a> <span class="k">def</span> <span class="nf">_get_all_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Resolver-439"><a href="#Resolver-439"><span class="linenos">439</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Resolver-440"><a href="#Resolver-440"><span class="linenos">440</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="p">{</span> +</span><span id="Resolver-441"><a href="#Resolver-441"><span class="linenos">441</span></a> <span class="n">k</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_source_columns</span><span class="p">(</span><span class="n">k</span><span class="p">)</span> +</span><span id="Resolver-442"><a href="#Resolver-442"><span class="linenos">442</span></a> <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> +</span><span id="Resolver-443"><a href="#Resolver-443"><span class="linenos">443</span></a> <span class="p">}</span> +</span><span id="Resolver-444"><a href="#Resolver-444"><span class="linenos">444</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> +</span><span id="Resolver-445"><a href="#Resolver-445"><span class="linenos">445</span></a> +</span><span id="Resolver-446"><a href="#Resolver-446"><span class="linenos">446</span></a> <span class="k">def</span> <span class="nf">_get_unambiguous_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_columns</span><span class="p">):</span> </span><span id="Resolver-447"><a href="#Resolver-447"><span class="linenos">447</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Resolver-448"><a href="#Resolver-448"><span class="linenos">448</span></a><span class="sd"> Find the unique columns in a list of columns.</span> +</span><span id="Resolver-448"><a href="#Resolver-448"><span class="linenos">448</span></a><span class="sd"> Find all the unambiguous columns in sources.</span> </span><span id="Resolver-449"><a href="#Resolver-449"><span class="linenos">449</span></a> -</span><span id="Resolver-450"><a href="#Resolver-450"><span class="linenos">450</span></a><span class="sd"> Example:</span> -</span><span id="Resolver-451"><a href="#Resolver-451"><span class="linenos">451</span></a><span class="sd"> >>> sorted(Resolver._find_unique_columns(["a", "b", "b", "c"]))</span> -</span><span id="Resolver-452"><a href="#Resolver-452"><span class="linenos">452</span></a><span class="sd"> ['a', 'c']</span> -</span><span id="Resolver-453"><a href="#Resolver-453"><span class="linenos">453</span></a> -</span><span id="Resolver-454"><a href="#Resolver-454"><span class="linenos">454</span></a><span class="sd"> This is necessary because duplicate column names are ambiguous.</span> -</span><span id="Resolver-455"><a href="#Resolver-455"><span class="linenos">455</span></a><span class="sd"> """</span> -</span><span id="Resolver-456"><a href="#Resolver-456"><span class="linenos">456</span></a> <span class="n">counts</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="Resolver-457"><a href="#Resolver-457"><span class="linenos">457</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> -</span><span id="Resolver-458"><a href="#Resolver-458"><span class="linenos">458</span></a> <span class="n">counts</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">counts</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span> -</span><span id="Resolver-459"><a href="#Resolver-459"><span class="linenos">459</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span><span class="p">,</span> <span class="n">count</span> <span class="ow">in</span> <span class="n">counts</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> <span class="k">if</span> <span class="n">count</span> <span class="o">==</span> <span class="mi">1</span><span class="p">}</span> +</span><span id="Resolver-450"><a href="#Resolver-450"><span class="linenos">450</span></a><span class="sd"> Args:</span> +</span><span id="Resolver-451"><a href="#Resolver-451"><span class="linenos">451</span></a><span class="sd"> source_columns (dict): Mapping of names to source columns</span> +</span><span id="Resolver-452"><a href="#Resolver-452"><span class="linenos">452</span></a><span class="sd"> Returns:</span> +</span><span id="Resolver-453"><a href="#Resolver-453"><span class="linenos">453</span></a><span class="sd"> dict: Mapping of column name to source name</span> +</span><span id="Resolver-454"><a href="#Resolver-454"><span class="linenos">454</span></a><span class="sd"> """</span> +</span><span id="Resolver-455"><a href="#Resolver-455"><span class="linenos">455</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source_columns</span><span class="p">:</span> +</span><span id="Resolver-456"><a href="#Resolver-456"><span class="linenos">456</span></a> <span class="k">return</span> <span class="p">{}</span> +</span><span id="Resolver-457"><a href="#Resolver-457"><span class="linenos">457</span></a> +</span><span id="Resolver-458"><a href="#Resolver-458"><span class="linenos">458</span></a> <span class="n">source_columns</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">source_columns</span><span class="o">.</span><span class="n">items</span><span class="p">())</span> +</span><span id="Resolver-459"><a href="#Resolver-459"><span class="linenos">459</span></a> +</span><span id="Resolver-460"><a href="#Resolver-460"><span class="linenos">460</span></a> <span class="n">first_table</span><span class="p">,</span> <span class="n">first_columns</span> <span class="o">=</span> <span class="n">source_columns</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> +</span><span id="Resolver-461"><a href="#Resolver-461"><span class="linenos">461</span></a> <span class="n">unambiguous_columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">col</span><span class="p">:</span> <span class="n">first_table</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_unique_columns</span><span class="p">(</span><span class="n">first_columns</span><span class="p">)}</span> +</span><span id="Resolver-462"><a href="#Resolver-462"><span class="linenos">462</span></a> <span class="n">all_columns</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">unambiguous_columns</span><span class="p">)</span> +</span><span id="Resolver-463"><a href="#Resolver-463"><span class="linenos">463</span></a> +</span><span id="Resolver-464"><a href="#Resolver-464"><span class="linenos">464</span></a> <span class="k">for</span> <span class="n">table</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="n">source_columns</span><span class="p">[</span><span class="mi">1</span><span class="p">:]:</span> +</span><span id="Resolver-465"><a href="#Resolver-465"><span class="linenos">465</span></a> <span class="n">unique</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_find_unique_columns</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> +</span><span id="Resolver-466"><a href="#Resolver-466"><span class="linenos">466</span></a> <span class="n">ambiguous</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">all_columns</span><span class="p">)</span><span class="o">.</span><span class="n">intersection</span><span class="p">(</span><span class="n">unique</span><span class="p">)</span> +</span><span id="Resolver-467"><a href="#Resolver-467"><span class="linenos">467</span></a> <span class="n">all_columns</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">columns</span><span class="p">)</span> +</span><span id="Resolver-468"><a href="#Resolver-468"><span class="linenos">468</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">ambiguous</span><span class="p">:</span> +</span><span id="Resolver-469"><a href="#Resolver-469"><span class="linenos">469</span></a> <span class="n">unambiguous_columns</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> +</span><span id="Resolver-470"><a href="#Resolver-470"><span class="linenos">470</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">unique</span><span class="o">.</span><span class="n">difference</span><span class="p">(</span><span class="n">ambiguous</span><span class="p">):</span> +</span><span id="Resolver-471"><a href="#Resolver-471"><span class="linenos">471</span></a> <span class="n">unambiguous_columns</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">table</span> +</span><span id="Resolver-472"><a href="#Resolver-472"><span class="linenos">472</span></a> +</span><span id="Resolver-473"><a href="#Resolver-473"><span class="linenos">473</span></a> <span class="k">return</span> <span class="n">unambiguous_columns</span> +</span><span id="Resolver-474"><a href="#Resolver-474"><span class="linenos">474</span></a> +</span><span id="Resolver-475"><a href="#Resolver-475"><span class="linenos">475</span></a> <span class="nd">@staticmethod</span> +</span><span id="Resolver-476"><a href="#Resolver-476"><span class="linenos">476</span></a> <span class="k">def</span> <span class="nf">_find_unique_columns</span><span class="p">(</span><span class="n">columns</span><span class="p">):</span> +</span><span id="Resolver-477"><a href="#Resolver-477"><span class="linenos">477</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Resolver-478"><a href="#Resolver-478"><span class="linenos">478</span></a><span class="sd"> Find the unique columns in a list of columns.</span> +</span><span id="Resolver-479"><a href="#Resolver-479"><span class="linenos">479</span></a> +</span><span id="Resolver-480"><a href="#Resolver-480"><span class="linenos">480</span></a><span class="sd"> Example:</span> +</span><span id="Resolver-481"><a href="#Resolver-481"><span class="linenos">481</span></a><span class="sd"> >>> sorted(Resolver._find_unique_columns(["a", "b", "b", "c"]))</span> +</span><span id="Resolver-482"><a href="#Resolver-482"><span class="linenos">482</span></a><span class="sd"> ['a', 'c']</span> +</span><span id="Resolver-483"><a href="#Resolver-483"><span class="linenos">483</span></a> +</span><span id="Resolver-484"><a href="#Resolver-484"><span class="linenos">484</span></a><span class="sd"> This is necessary because duplicate column names are ambiguous.</span> +</span><span id="Resolver-485"><a href="#Resolver-485"><span class="linenos">485</span></a><span class="sd"> """</span> +</span><span id="Resolver-486"><a href="#Resolver-486"><span class="linenos">486</span></a> <span class="n">counts</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="Resolver-487"><a href="#Resolver-487"><span class="linenos">487</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span><span class="p">:</span> +</span><span id="Resolver-488"><a href="#Resolver-488"><span class="linenos">488</span></a> <span class="n">counts</span><span class="p">[</span><span class="n">column</span><span class="p">]</span> <span class="o">=</span> <span class="n">counts</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span> <span class="o">+</span> <span class="mi">1</span> +</span><span id="Resolver-489"><a href="#Resolver-489"><span class="linenos">489</span></a> <span class="k">return</span> <span class="p">{</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span><span class="p">,</span> <span class="n">count</span> <span class="ow">in</span> <span class="n">counts</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> <span class="k">if</span> <span class="n">count</span> <span class="o">==</span> <span class="mi">1</span><span class="p">}</span> </span></pre></div> @@ -807,12 +842,12 @@ </div> <a class="headerlink" href="#Resolver.__init__"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Resolver.__init__-337"><a href="#Resolver.__init__-337"><span class="linenos">337</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">schema</span><span class="p">):</span> -</span><span id="Resolver.__init__-338"><a href="#Resolver.__init__-338"><span class="linenos">338</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span> <span class="o">=</span> <span class="n">scope</span> -</span><span id="Resolver.__init__-339"><a href="#Resolver.__init__-339"><span class="linenos">339</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span> <span class="o">=</span> <span class="n">schema</span> -</span><span id="Resolver.__init__-340"><a href="#Resolver.__init__-340"><span class="linenos">340</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Resolver.__init__-341"><a href="#Resolver.__init__-341"><span class="linenos">341</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Resolver.__init__-342"><a href="#Resolver.__init__-342"><span class="linenos">342</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="kc">None</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Resolver.__init__-363"><a href="#Resolver.__init__-363"><span class="linenos">363</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">schema</span><span class="p">):</span> +</span><span id="Resolver.__init__-364"><a href="#Resolver.__init__-364"><span class="linenos">364</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span> <span class="o">=</span> <span class="n">scope</span> +</span><span id="Resolver.__init__-365"><a href="#Resolver.__init__-365"><span class="linenos">365</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span> <span class="o">=</span> <span class="n">schema</span> +</span><span id="Resolver.__init__-366"><a href="#Resolver.__init__-366"><span class="linenos">366</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_source_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Resolver.__init__-367"><a href="#Resolver.__init__-367"><span class="linenos">367</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Resolver.__init__-368"><a href="#Resolver.__init__-368"><span class="linenos">368</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_all_columns</span> <span class="o">=</span> <span class="kc">None</span> </span></pre></div> @@ -830,43 +865,47 @@ </div> <a class="headerlink" href="#Resolver.get_table"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Resolver.get_table-344"><a href="#Resolver.get_table-344"><span class="linenos">344</span></a> <span class="k">def</span> <span class="nf">get_table</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">column_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">]:</span> -</span><span id="Resolver.get_table-345"><a href="#Resolver.get_table-345"><span class="linenos">345</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Resolver.get_table-346"><a href="#Resolver.get_table-346"><span class="linenos">346</span></a><span class="sd"> Get the table for a column name.</span> -</span><span id="Resolver.get_table-347"><a href="#Resolver.get_table-347"><span class="linenos">347</span></a> -</span><span id="Resolver.get_table-348"><a href="#Resolver.get_table-348"><span class="linenos">348</span></a><span class="sd"> Args:</span> -</span><span id="Resolver.get_table-349"><a href="#Resolver.get_table-349"><span class="linenos">349</span></a><span class="sd"> column_name: The column name to find the table for.</span> -</span><span id="Resolver.get_table-350"><a href="#Resolver.get_table-350"><span class="linenos">350</span></a><span class="sd"> Returns:</span> -</span><span id="Resolver.get_table-351"><a href="#Resolver.get_table-351"><span class="linenos">351</span></a><span class="sd"> The table name if it can be found/inferred.</span> -</span><span id="Resolver.get_table-352"><a href="#Resolver.get_table-352"><span class="linenos">352</span></a><span class="sd"> """</span> -</span><span id="Resolver.get_table-353"><a href="#Resolver.get_table-353"><span class="linenos">353</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Resolver.get_table-354"><a href="#Resolver.get_table-354"><span class="linenos">354</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_unambiguous_columns</span><span class="p">(</span> -</span><span id="Resolver.get_table-355"><a href="#Resolver.get_table-355"><span class="linenos">355</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span> -</span><span id="Resolver.get_table-356"><a href="#Resolver.get_table-356"><span class="linenos">356</span></a> <span class="p">)</span> -</span><span id="Resolver.get_table-357"><a href="#Resolver.get_table-357"><span class="linenos">357</span></a> -</span><span id="Resolver.get_table-358"><a href="#Resolver.get_table-358"><span class="linenos">358</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column_name</span><span class="p">)</span> -</span><span id="Resolver.get_table-359"><a href="#Resolver.get_table-359"><span class="linenos">359</span></a> -</span><span id="Resolver.get_table-360"><a href="#Resolver.get_table-360"><span class="linenos">360</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_name</span><span class="p">:</span> -</span><span id="Resolver.get_table-361"><a href="#Resolver.get_table-361"><span class="linenos">361</span></a> <span class="n">sources_without_schema</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span> -</span><span id="Resolver.get_table-362"><a href="#Resolver.get_table-362"><span class="linenos">362</span></a> <span class="n">source</span> -</span><span id="Resolver.get_table-363"><a href="#Resolver.get_table-363"><span class="linenos">363</span></a> <span class="k">for</span> <span class="n">source</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> -</span><span id="Resolver.get_table-364"><a href="#Resolver.get_table-364"><span class="linenos">364</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">columns</span> <span class="ow">or</span> <span class="s2">"*"</span> <span class="ow">in</span> <span class="n">columns</span> -</span><span id="Resolver.get_table-365"><a href="#Resolver.get_table-365"><span class="linenos">365</span></a> <span class="p">)</span> -</span><span id="Resolver.get_table-366"><a href="#Resolver.get_table-366"><span class="linenos">366</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sources_without_schema</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> -</span><span id="Resolver.get_table-367"><a href="#Resolver.get_table-367"><span class="linenos">367</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">sources_without_schema</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> -</span><span id="Resolver.get_table-368"><a href="#Resolver.get_table-368"><span class="linenos">368</span></a> -</span><span id="Resolver.get_table-369"><a href="#Resolver.get_table-369"><span class="linenos">369</span></a> <span class="k">if</span> <span class="n">table_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">:</span> -</span><span id="Resolver.get_table-370"><a href="#Resolver.get_table-370"><span class="linenos">370</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> -</span><span id="Resolver.get_table-371"><a href="#Resolver.get_table-371"><span class="linenos">371</span></a> -</span><span id="Resolver.get_table-372"><a href="#Resolver.get_table-372"><span class="linenos">372</span></a> <span class="n">node</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Resolver.get_table-370"><a href="#Resolver.get_table-370"><span class="linenos">370</span></a> <span class="k">def</span> <span class="nf">get_table</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">column_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="n">t</span><span class="o">.</span><span class="n">Optional</span><span class="p">[</span><span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">]:</span> +</span><span id="Resolver.get_table-371"><a href="#Resolver.get_table-371"><span class="linenos">371</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Resolver.get_table-372"><a href="#Resolver.get_table-372"><span class="linenos">372</span></a><span class="sd"> Get the table for a column name.</span> </span><span id="Resolver.get_table-373"><a href="#Resolver.get_table-373"><span class="linenos">373</span></a> -</span><span id="Resolver.get_table-374"><a href="#Resolver.get_table-374"><span class="linenos">374</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> -</span><span id="Resolver.get_table-375"><a href="#Resolver.get_table-375"><span class="linenos">375</span></a> <span class="k">while</span> <span class="n">node</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">alias</span> <span class="o">!=</span> <span class="n">table_name</span><span class="p">:</span> -</span><span id="Resolver.get_table-376"><a href="#Resolver.get_table-376"><span class="linenos">376</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">parent</span> -</span><span id="Resolver.get_table-377"><a href="#Resolver.get_table-377"><span class="linenos">377</span></a> <span class="n">node_alias</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> -</span><span id="Resolver.get_table-378"><a href="#Resolver.get_table-378"><span class="linenos">378</span></a> <span class="k">if</span> <span class="n">node_alias</span><span class="p">:</span> -</span><span id="Resolver.get_table-379"><a href="#Resolver.get_table-379"><span class="linenos">379</span></a> <span class="k">return</span> <span class="n">node_alias</span><span class="o">.</span><span class="n">this</span> -</span><span id="Resolver.get_table-380"><a href="#Resolver.get_table-380"><span class="linenos">380</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> +</span><span id="Resolver.get_table-374"><a href="#Resolver.get_table-374"><span class="linenos">374</span></a><span class="sd"> Args:</span> +</span><span id="Resolver.get_table-375"><a href="#Resolver.get_table-375"><span class="linenos">375</span></a><span class="sd"> column_name: The column name to find the table for.</span> +</span><span id="Resolver.get_table-376"><a href="#Resolver.get_table-376"><span class="linenos">376</span></a><span class="sd"> Returns:</span> +</span><span id="Resolver.get_table-377"><a href="#Resolver.get_table-377"><span class="linenos">377</span></a><span class="sd"> The table name if it can be found/inferred.</span> +</span><span id="Resolver.get_table-378"><a href="#Resolver.get_table-378"><span class="linenos">378</span></a><span class="sd"> """</span> +</span><span id="Resolver.get_table-379"><a href="#Resolver.get_table-379"><span class="linenos">379</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Resolver.get_table-380"><a href="#Resolver.get_table-380"><span class="linenos">380</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_unambiguous_columns</span><span class="p">(</span> +</span><span id="Resolver.get_table-381"><a href="#Resolver.get_table-381"><span class="linenos">381</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span> +</span><span id="Resolver.get_table-382"><a href="#Resolver.get_table-382"><span class="linenos">382</span></a> <span class="p">)</span> +</span><span id="Resolver.get_table-383"><a href="#Resolver.get_table-383"><span class="linenos">383</span></a> +</span><span id="Resolver.get_table-384"><a href="#Resolver.get_table-384"><span class="linenos">384</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_unambiguous_columns</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">column_name</span><span class="p">)</span> +</span><span id="Resolver.get_table-385"><a href="#Resolver.get_table-385"><span class="linenos">385</span></a> +</span><span id="Resolver.get_table-386"><a href="#Resolver.get_table-386"><span class="linenos">386</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_name</span><span class="p">:</span> +</span><span id="Resolver.get_table-387"><a href="#Resolver.get_table-387"><span class="linenos">387</span></a> <span class="n">sources_without_schema</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span> +</span><span id="Resolver.get_table-388"><a href="#Resolver.get_table-388"><span class="linenos">388</span></a> <span class="n">source</span> +</span><span id="Resolver.get_table-389"><a href="#Resolver.get_table-389"><span class="linenos">389</span></a> <span class="k">for</span> <span class="n">source</span><span class="p">,</span> <span class="n">columns</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_source_columns</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> +</span><span id="Resolver.get_table-390"><a href="#Resolver.get_table-390"><span class="linenos">390</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">columns</span> <span class="ow">or</span> <span class="s2">"*"</span> <span class="ow">in</span> <span class="n">columns</span> +</span><span id="Resolver.get_table-391"><a href="#Resolver.get_table-391"><span class="linenos">391</span></a> <span class="p">)</span> +</span><span id="Resolver.get_table-392"><a href="#Resolver.get_table-392"><span class="linenos">392</span></a> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sources_without_schema</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span> +</span><span id="Resolver.get_table-393"><a href="#Resolver.get_table-393"><span class="linenos">393</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">sources_without_schema</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> +</span><span id="Resolver.get_table-394"><a href="#Resolver.get_table-394"><span class="linenos">394</span></a> +</span><span id="Resolver.get_table-395"><a href="#Resolver.get_table-395"><span class="linenos">395</span></a> <span class="k">if</span> <span class="n">table_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="p">:</span> +</span><span id="Resolver.get_table-396"><a href="#Resolver.get_table-396"><span class="linenos">396</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> +</span><span id="Resolver.get_table-397"><a href="#Resolver.get_table-397"><span class="linenos">397</span></a> +</span><span id="Resolver.get_table-398"><a href="#Resolver.get_table-398"><span class="linenos">398</span></a> <span class="n">node</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">table_name</span><span class="p">)</span> +</span><span id="Resolver.get_table-399"><a href="#Resolver.get_table-399"><span class="linenos">399</span></a> +</span><span id="Resolver.get_table-400"><a href="#Resolver.get_table-400"><span class="linenos">400</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> +</span><span id="Resolver.get_table-401"><a href="#Resolver.get_table-401"><span class="linenos">401</span></a> <span class="k">while</span> <span class="n">node</span> <span class="ow">and</span> <span class="n">node</span><span class="o">.</span><span class="n">alias</span> <span class="o">!=</span> <span class="n">table_name</span><span class="p">:</span> +</span><span id="Resolver.get_table-402"><a href="#Resolver.get_table-402"><span class="linenos">402</span></a> <span class="n">node</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">parent</span> +</span><span id="Resolver.get_table-403"><a href="#Resolver.get_table-403"><span class="linenos">403</span></a> +</span><span id="Resolver.get_table-404"><a href="#Resolver.get_table-404"><span class="linenos">404</span></a> <span class="n">node_alias</span> <span class="o">=</span> <span class="n">node</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> +</span><span id="Resolver.get_table-405"><a href="#Resolver.get_table-405"><span class="linenos">405</span></a> <span class="k">if</span> <span class="n">node_alias</span><span class="p">:</span> +</span><span id="Resolver.get_table-406"><a href="#Resolver.get_table-406"><span class="linenos">406</span></a> <span class="k">return</span> <span class="n">node_alias</span><span class="o">.</span><span class="n">this</span> +</span><span id="Resolver.get_table-407"><a href="#Resolver.get_table-407"><span class="linenos">407</span></a> +</span><span id="Resolver.get_table-408"><a href="#Resolver.get_table-408"><span class="linenos">408</span></a> <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span> +</span><span id="Resolver.get_table-409"><a href="#Resolver.get_table-409"><span class="linenos">409</span></a> <span class="n">table_name</span><span class="p">,</span> <span class="n">quoted</span><span class="o">=</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="o">.</span><span class="n">quoted</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="k">else</span> <span class="kc">None</span> +</span><span id="Resolver.get_table-410"><a href="#Resolver.get_table-410"><span class="linenos">410</span></a> <span class="p">)</span> </span></pre></div> @@ -911,22 +950,22 @@ </div> <a class="headerlink" href="#Resolver.get_source_columns"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Resolver.get_source_columns-391"><a href="#Resolver.get_source_columns-391"><span class="linenos">391</span></a> <span class="k">def</span> <span class="nf">get_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">only_visible</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> -</span><span id="Resolver.get_source_columns-392"><a href="#Resolver.get_source_columns-392"><span class="linenos">392</span></a><span class="w"> </span><span class="sd">"""Resolve the source columns for a given source `name`"""</span> -</span><span id="Resolver.get_source_columns-393"><a href="#Resolver.get_source_columns-393"><span class="linenos">393</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> -</span><span id="Resolver.get_source_columns-394"><a href="#Resolver.get_source_columns-394"><span class="linenos">394</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="Resolver.get_source_columns-395"><a href="#Resolver.get_source_columns-395"><span class="linenos">395</span></a> -</span><span id="Resolver.get_source_columns-396"><a href="#Resolver.get_source_columns-396"><span class="linenos">396</span></a> <span class="n">source</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> -</span><span id="Resolver.get_source_columns-397"><a href="#Resolver.get_source_columns-397"><span class="linenos">397</span></a> -</span><span id="Resolver.get_source_columns-398"><a href="#Resolver.get_source_columns-398"><span class="linenos">398</span></a> <span class="c1"># If referencing a table, return the columns from the schema</span> -</span><span id="Resolver.get_source_columns-399"><a href="#Resolver.get_source_columns-399"><span class="linenos">399</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> -</span><span id="Resolver.get_source_columns-400"><a href="#Resolver.get_source_columns-400"><span class="linenos">400</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span><span class="o">.</span><span class="n">column_names</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">only_visible</span><span class="p">)</span> -</span><span id="Resolver.get_source_columns-401"><a href="#Resolver.get_source_columns-401"><span class="linenos">401</span></a> -</span><span id="Resolver.get_source_columns-402"><a href="#Resolver.get_source_columns-402"><span class="linenos">402</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Values</span><span class="p">):</span> -</span><span id="Resolver.get_source_columns-403"><a href="#Resolver.get_source_columns-403"><span class="linenos">403</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">alias_column_names</span> -</span><span id="Resolver.get_source_columns-404"><a href="#Resolver.get_source_columns-404"><span class="linenos">404</span></a> -</span><span id="Resolver.get_source_columns-405"><a href="#Resolver.get_source_columns-405"><span class="linenos">405</span></a> <span class="c1"># Otherwise, if referencing another scope, return that scope's named selects</span> -</span><span id="Resolver.get_source_columns-406"><a href="#Resolver.get_source_columns-406"><span class="linenos">406</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Resolver.get_source_columns-421"><a href="#Resolver.get_source_columns-421"><span class="linenos">421</span></a> <span class="k">def</span> <span class="nf">get_source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">only_visible</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> +</span><span id="Resolver.get_source_columns-422"><a href="#Resolver.get_source_columns-422"><span class="linenos">422</span></a><span class="w"> </span><span class="sd">"""Resolve the source columns for a given source `name`"""</span> +</span><span id="Resolver.get_source_columns-423"><a href="#Resolver.get_source_columns-423"><span class="linenos">423</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="Resolver.get_source_columns-424"><a href="#Resolver.get_source_columns-424"><span class="linenos">424</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unknown table: </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="Resolver.get_source_columns-425"><a href="#Resolver.get_source_columns-425"><span class="linenos">425</span></a> +</span><span id="Resolver.get_source_columns-426"><a href="#Resolver.get_source_columns-426"><span class="linenos">426</span></a> <span class="n">source</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> +</span><span id="Resolver.get_source_columns-427"><a href="#Resolver.get_source_columns-427"><span class="linenos">427</span></a> +</span><span id="Resolver.get_source_columns-428"><a href="#Resolver.get_source_columns-428"><span class="linenos">428</span></a> <span class="c1"># If referencing a table, return the columns from the schema</span> +</span><span id="Resolver.get_source_columns-429"><a href="#Resolver.get_source_columns-429"><span class="linenos">429</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> +</span><span id="Resolver.get_source_columns-430"><a href="#Resolver.get_source_columns-430"><span class="linenos">430</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">schema</span><span class="o">.</span><span class="n">column_names</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">only_visible</span><span class="p">)</span> +</span><span id="Resolver.get_source_columns-431"><a href="#Resolver.get_source_columns-431"><span class="linenos">431</span></a> +</span><span id="Resolver.get_source_columns-432"><a href="#Resolver.get_source_columns-432"><span class="linenos">432</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Values</span><span class="p">):</span> +</span><span id="Resolver.get_source_columns-433"><a href="#Resolver.get_source_columns-433"><span class="linenos">433</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">alias_column_names</span> +</span><span id="Resolver.get_source_columns-434"><a href="#Resolver.get_source_columns-434"><span class="linenos">434</span></a> +</span><span id="Resolver.get_source_columns-435"><a href="#Resolver.get_source_columns-435"><span class="linenos">435</span></a> <span class="c1"># Otherwise, if referencing another scope, return that scope's named selects</span> +</span><span id="Resolver.get_source_columns-436"><a href="#Resolver.get_source_columns-436"><span class="linenos">436</span></a> <span class="k">return</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span> </span></pre></div> diff --git a/docs/sqlglot/optimizer/qualify_tables.html b/docs/sqlglot/optimizer/qualify_tables.html index 87d9739..f0bbf01 100644 --- a/docs/sqlglot/optimizer/qualify_tables.html +++ b/docs/sqlglot/optimizer/qualify_tables.html @@ -92,41 +92,39 @@ </span><span id="L-34"><a href="#L-34"><span class="linenos">34</span></a> <span class="n">derived_table</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">TableAlias</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">alias_</span><span class="p">)))</span> </span><span id="L-35"><a href="#L-35"><span class="linenos">35</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">rename_source</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">alias_</span><span class="p">)</span> </span><span id="L-36"><a href="#L-36"><span class="linenos">36</span></a> -</span><span id="L-37"><a href="#L-37"><span class="linenos">37</span></a> <span class="k">for</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">values</span><span class="p">():</span> +</span><span id="L-37"><a href="#L-37"><span class="linenos">37</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> </span><span id="L-38"><a href="#L-38"><span class="linenos">38</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> -</span><span id="L-39"><a href="#L-39"><span class="linenos">39</span></a> <span class="n">identifier</span> <span class="o">=</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)</span> -</span><span id="L-40"><a href="#L-40"><span class="linenos">40</span></a> -</span><span id="L-41"><a href="#L-41"><span class="linenos">41</span></a> <span class="k">if</span> <span class="n">identifier</span><span class="p">:</span> -</span><span id="L-42"><a href="#L-42"><span class="linenos">42</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"db"</span><span class="p">):</span> -</span><span id="L-43"><a href="#L-43"><span class="linenos">43</span></a> <span class="n">source</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"db"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">db</span><span class="p">))</span> -</span><span id="L-44"><a href="#L-44"><span class="linenos">44</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"catalog"</span><span class="p">):</span> -</span><span id="L-45"><a href="#L-45"><span class="linenos">45</span></a> <span class="n">source</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"catalog"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">catalog</span><span class="p">))</span> -</span><span id="L-46"><a href="#L-46"><span class="linenos">46</span></a> -</span><span id="L-47"><a href="#L-47"><span class="linenos">47</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">alias</span><span class="p">:</span> -</span><span id="L-48"><a href="#L-48"><span class="linenos">48</span></a> <span class="n">source</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span> -</span><span id="L-49"><a href="#L-49"><span class="linenos">49</span></a> <span class="n">alias</span><span class="p">(</span> -</span><span id="L-50"><a href="#L-50"><span class="linenos">50</span></a> <span class="n">source</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> -</span><span id="L-51"><a href="#L-51"><span class="linenos">51</span></a> <span class="n">source</span><span class="o">.</span><span class="n">this</span> <span class="k">if</span> <span class="n">identifier</span> <span class="k">else</span> <span class="n">next_name</span><span class="p">(),</span> -</span><span id="L-52"><a href="#L-52"><span class="linenos">52</span></a> <span class="n">table</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> -</span><span id="L-53"><a href="#L-53"><span class="linenos">53</span></a> <span class="p">)</span> -</span><span id="L-54"><a href="#L-54"><span class="linenos">54</span></a> <span class="p">)</span> -</span><span id="L-55"><a href="#L-55"><span class="linenos">55</span></a> -</span><span id="L-56"><a href="#L-56"><span class="linenos">56</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> -</span><span id="L-57"><a href="#L-57"><span class="linenos">57</span></a> <span class="k">with</span> <span class="n">csv_reader</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">)</span> <span class="k">as</span> <span class="n">reader</span><span class="p">:</span> -</span><span id="L-58"><a href="#L-58"><span class="linenos">58</span></a> <span class="n">header</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">reader</span><span class="p">)</span> -</span><span id="L-59"><a href="#L-59"><span class="linenos">59</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">reader</span><span class="p">)</span> -</span><span id="L-60"><a href="#L-60"><span class="linenos">60</span></a> <span class="n">schema</span><span class="o">.</span><span class="n">add_table</span><span class="p">(</span> -</span><span id="L-61"><a href="#L-61"><span class="linenos">61</span></a> <span class="n">source</span><span class="p">,</span> <span class="p">{</span><span class="n">k</span><span class="p">:</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">.</span><span class="vm">__name__</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">header</span><span class="p">,</span> <span class="n">columns</span><span class="p">)}</span> -</span><span id="L-62"><a href="#L-62"><span class="linenos">62</span></a> <span class="p">)</span> -</span><span id="L-63"><a href="#L-63"><span class="linenos">63</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="n">source</span><span class="o">.</span><span class="n">is_udtf</span><span class="p">:</span> -</span><span id="L-64"><a href="#L-64"><span class="linenos">64</span></a> <span class="n">udtf</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span> -</span><span id="L-65"><a href="#L-65"><span class="linenos">65</span></a> <span class="n">table_alias</span> <span class="o">=</span> <span class="n">udtf</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> <span class="ow">or</span> <span class="n">exp</span><span class="o">.</span><span class="n">TableAlias</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">next_name</span><span class="p">())</span> -</span><span id="L-66"><a href="#L-66"><span class="linenos">66</span></a> <span class="n">udtf</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">table_alias</span><span class="p">)</span> -</span><span id="L-67"><a href="#L-67"><span class="linenos">67</span></a> -</span><span id="L-68"><a href="#L-68"><span class="linenos">68</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_alias</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> -</span><span id="L-69"><a href="#L-69"><span class="linenos">69</span></a> <span class="n">table_alias</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"this"</span><span class="p">,</span> <span class="n">next_name</span><span class="p">())</span> -</span><span id="L-70"><a href="#L-70"><span class="linenos">70</span></a> -</span><span id="L-71"><a href="#L-71"><span class="linenos">71</span></a> <span class="k">return</span> <span class="n">expression</span> +</span><span id="L-39"><a href="#L-39"><span class="linenos">39</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">):</span> +</span><span id="L-40"><a href="#L-40"><span class="linenos">40</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"db"</span><span class="p">):</span> +</span><span id="L-41"><a href="#L-41"><span class="linenos">41</span></a> <span class="n">source</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"db"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">db</span><span class="p">))</span> +</span><span id="L-42"><a href="#L-42"><span class="linenos">42</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"catalog"</span><span class="p">):</span> +</span><span id="L-43"><a href="#L-43"><span class="linenos">43</span></a> <span class="n">source</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"catalog"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">catalog</span><span class="p">))</span> +</span><span id="L-44"><a href="#L-44"><span class="linenos">44</span></a> +</span><span id="L-45"><a href="#L-45"><span class="linenos">45</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">alias</span><span class="p">:</span> +</span><span id="L-46"><a href="#L-46"><span class="linenos">46</span></a> <span class="n">source</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span> +</span><span id="L-47"><a href="#L-47"><span class="linenos">47</span></a> <span class="n">alias</span><span class="p">(</span> +</span><span id="L-48"><a href="#L-48"><span class="linenos">48</span></a> <span class="n">source</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> +</span><span id="L-49"><a href="#L-49"><span class="linenos">49</span></a> <span class="n">name</span> <span class="k">if</span> <span class="n">name</span> <span class="k">else</span> <span class="n">next_name</span><span class="p">(),</span> +</span><span id="L-50"><a href="#L-50"><span class="linenos">50</span></a> <span class="n">table</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> +</span><span id="L-51"><a href="#L-51"><span class="linenos">51</span></a> <span class="p">)</span> +</span><span id="L-52"><a href="#L-52"><span class="linenos">52</span></a> <span class="p">)</span> +</span><span id="L-53"><a href="#L-53"><span class="linenos">53</span></a> +</span><span id="L-54"><a href="#L-54"><span class="linenos">54</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> +</span><span id="L-55"><a href="#L-55"><span class="linenos">55</span></a> <span class="k">with</span> <span class="n">csv_reader</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">)</span> <span class="k">as</span> <span class="n">reader</span><span class="p">:</span> +</span><span id="L-56"><a href="#L-56"><span class="linenos">56</span></a> <span class="n">header</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">reader</span><span class="p">)</span> +</span><span id="L-57"><a href="#L-57"><span class="linenos">57</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">reader</span><span class="p">)</span> +</span><span id="L-58"><a href="#L-58"><span class="linenos">58</span></a> <span class="n">schema</span><span class="o">.</span><span class="n">add_table</span><span class="p">(</span> +</span><span id="L-59"><a href="#L-59"><span class="linenos">59</span></a> <span class="n">source</span><span class="p">,</span> <span class="p">{</span><span class="n">k</span><span class="p">:</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">.</span><span class="vm">__name__</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">header</span><span class="p">,</span> <span class="n">columns</span><span class="p">)}</span> +</span><span id="L-60"><a href="#L-60"><span class="linenos">60</span></a> <span class="p">)</span> +</span><span id="L-61"><a href="#L-61"><span class="linenos">61</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="n">source</span><span class="o">.</span><span class="n">is_udtf</span><span class="p">:</span> +</span><span id="L-62"><a href="#L-62"><span class="linenos">62</span></a> <span class="n">udtf</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span> +</span><span id="L-63"><a href="#L-63"><span class="linenos">63</span></a> <span class="n">table_alias</span> <span class="o">=</span> <span class="n">udtf</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> <span class="ow">or</span> <span class="n">exp</span><span class="o">.</span><span class="n">TableAlias</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">next_name</span><span class="p">())</span> +</span><span id="L-64"><a href="#L-64"><span class="linenos">64</span></a> <span class="n">udtf</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">table_alias</span><span class="p">)</span> +</span><span id="L-65"><a href="#L-65"><span class="linenos">65</span></a> +</span><span id="L-66"><a href="#L-66"><span class="linenos">66</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_alias</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> +</span><span id="L-67"><a href="#L-67"><span class="linenos">67</span></a> <span class="n">table_alias</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"this"</span><span class="p">,</span> <span class="n">next_name</span><span class="p">())</span> +</span><span id="L-68"><a href="#L-68"><span class="linenos">68</span></a> +</span><span id="L-69"><a href="#L-69"><span class="linenos">69</span></a> <span class="k">return</span> <span class="n">expression</span> </span></pre></div> @@ -171,41 +169,39 @@ </span><span id="qualify_tables-35"><a href="#qualify_tables-35"><span class="linenos">35</span></a> <span class="n">derived_table</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">TableAlias</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">alias_</span><span class="p">)))</span> </span><span id="qualify_tables-36"><a href="#qualify_tables-36"><span class="linenos">36</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">rename_source</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">alias_</span><span class="p">)</span> </span><span id="qualify_tables-37"><a href="#qualify_tables-37"><span class="linenos">37</span></a> -</span><span id="qualify_tables-38"><a href="#qualify_tables-38"><span class="linenos">38</span></a> <span class="k">for</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">values</span><span class="p">():</span> +</span><span id="qualify_tables-38"><a href="#qualify_tables-38"><span class="linenos">38</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">items</span><span class="p">():</span> </span><span id="qualify_tables-39"><a href="#qualify_tables-39"><span class="linenos">39</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> -</span><span id="qualify_tables-40"><a href="#qualify_tables-40"><span class="linenos">40</span></a> <span class="n">identifier</span> <span class="o">=</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">)</span> -</span><span id="qualify_tables-41"><a href="#qualify_tables-41"><span class="linenos">41</span></a> -</span><span id="qualify_tables-42"><a href="#qualify_tables-42"><span class="linenos">42</span></a> <span class="k">if</span> <span class="n">identifier</span><span class="p">:</span> -</span><span id="qualify_tables-43"><a href="#qualify_tables-43"><span class="linenos">43</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"db"</span><span class="p">):</span> -</span><span id="qualify_tables-44"><a href="#qualify_tables-44"><span class="linenos">44</span></a> <span class="n">source</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"db"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">db</span><span class="p">))</span> -</span><span id="qualify_tables-45"><a href="#qualify_tables-45"><span class="linenos">45</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"catalog"</span><span class="p">):</span> -</span><span id="qualify_tables-46"><a href="#qualify_tables-46"><span class="linenos">46</span></a> <span class="n">source</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"catalog"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">catalog</span><span class="p">))</span> -</span><span id="qualify_tables-47"><a href="#qualify_tables-47"><span class="linenos">47</span></a> -</span><span id="qualify_tables-48"><a href="#qualify_tables-48"><span class="linenos">48</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">alias</span><span class="p">:</span> -</span><span id="qualify_tables-49"><a href="#qualify_tables-49"><span class="linenos">49</span></a> <span class="n">source</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span> -</span><span id="qualify_tables-50"><a href="#qualify_tables-50"><span class="linenos">50</span></a> <span class="n">alias</span><span class="p">(</span> -</span><span id="qualify_tables-51"><a href="#qualify_tables-51"><span class="linenos">51</span></a> <span class="n">source</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> -</span><span id="qualify_tables-52"><a href="#qualify_tables-52"><span class="linenos">52</span></a> <span class="n">source</span><span class="o">.</span><span class="n">this</span> <span class="k">if</span> <span class="n">identifier</span> <span class="k">else</span> <span class="n">next_name</span><span class="p">(),</span> -</span><span id="qualify_tables-53"><a href="#qualify_tables-53"><span class="linenos">53</span></a> <span class="n">table</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> -</span><span id="qualify_tables-54"><a href="#qualify_tables-54"><span class="linenos">54</span></a> <span class="p">)</span> -</span><span id="qualify_tables-55"><a href="#qualify_tables-55"><span class="linenos">55</span></a> <span class="p">)</span> -</span><span id="qualify_tables-56"><a href="#qualify_tables-56"><span class="linenos">56</span></a> -</span><span id="qualify_tables-57"><a href="#qualify_tables-57"><span class="linenos">57</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> -</span><span id="qualify_tables-58"><a href="#qualify_tables-58"><span class="linenos">58</span></a> <span class="k">with</span> <span class="n">csv_reader</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">)</span> <span class="k">as</span> <span class="n">reader</span><span class="p">:</span> -</span><span id="qualify_tables-59"><a href="#qualify_tables-59"><span class="linenos">59</span></a> <span class="n">header</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">reader</span><span class="p">)</span> -</span><span id="qualify_tables-60"><a href="#qualify_tables-60"><span class="linenos">60</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">reader</span><span class="p">)</span> -</span><span id="qualify_tables-61"><a href="#qualify_tables-61"><span class="linenos">61</span></a> <span class="n">schema</span><span class="o">.</span><span class="n">add_table</span><span class="p">(</span> -</span><span id="qualify_tables-62"><a href="#qualify_tables-62"><span class="linenos">62</span></a> <span class="n">source</span><span class="p">,</span> <span class="p">{</span><span class="n">k</span><span class="p">:</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">.</span><span class="vm">__name__</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">header</span><span class="p">,</span> <span class="n">columns</span><span class="p">)}</span> -</span><span id="qualify_tables-63"><a href="#qualify_tables-63"><span class="linenos">63</span></a> <span class="p">)</span> -</span><span id="qualify_tables-64"><a href="#qualify_tables-64"><span class="linenos">64</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="n">source</span><span class="o">.</span><span class="n">is_udtf</span><span class="p">:</span> -</span><span id="qualify_tables-65"><a href="#qualify_tables-65"><span class="linenos">65</span></a> <span class="n">udtf</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span> -</span><span id="qualify_tables-66"><a href="#qualify_tables-66"><span class="linenos">66</span></a> <span class="n">table_alias</span> <span class="o">=</span> <span class="n">udtf</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> <span class="ow">or</span> <span class="n">exp</span><span class="o">.</span><span class="n">TableAlias</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">next_name</span><span class="p">())</span> -</span><span id="qualify_tables-67"><a href="#qualify_tables-67"><span class="linenos">67</span></a> <span class="n">udtf</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">table_alias</span><span class="p">)</span> -</span><span id="qualify_tables-68"><a href="#qualify_tables-68"><span class="linenos">68</span></a> -</span><span id="qualify_tables-69"><a href="#qualify_tables-69"><span class="linenos">69</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_alias</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> -</span><span id="qualify_tables-70"><a href="#qualify_tables-70"><span class="linenos">70</span></a> <span class="n">table_alias</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"this"</span><span class="p">,</span> <span class="n">next_name</span><span class="p">())</span> -</span><span id="qualify_tables-71"><a href="#qualify_tables-71"><span class="linenos">71</span></a> -</span><span id="qualify_tables-72"><a href="#qualify_tables-72"><span class="linenos">72</span></a> <span class="k">return</span> <span class="n">expression</span> +</span><span id="qualify_tables-40"><a href="#qualify_tables-40"><span class="linenos">40</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Identifier</span><span class="p">):</span> +</span><span id="qualify_tables-41"><a href="#qualify_tables-41"><span class="linenos">41</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"db"</span><span class="p">):</span> +</span><span id="qualify_tables-42"><a href="#qualify_tables-42"><span class="linenos">42</span></a> <span class="n">source</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"db"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">db</span><span class="p">))</span> +</span><span id="qualify_tables-43"><a href="#qualify_tables-43"><span class="linenos">43</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"catalog"</span><span class="p">):</span> +</span><span id="qualify_tables-44"><a href="#qualify_tables-44"><span class="linenos">44</span></a> <span class="n">source</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"catalog"</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">to_identifier</span><span class="p">(</span><span class="n">catalog</span><span class="p">))</span> +</span><span id="qualify_tables-45"><a href="#qualify_tables-45"><span class="linenos">45</span></a> +</span><span id="qualify_tables-46"><a href="#qualify_tables-46"><span class="linenos">46</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">source</span><span class="o">.</span><span class="n">alias</span><span class="p">:</span> +</span><span id="qualify_tables-47"><a href="#qualify_tables-47"><span class="linenos">47</span></a> <span class="n">source</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span> +</span><span id="qualify_tables-48"><a href="#qualify_tables-48"><span class="linenos">48</span></a> <span class="n">alias</span><span class="p">(</span> +</span><span id="qualify_tables-49"><a href="#qualify_tables-49"><span class="linenos">49</span></a> <span class="n">source</span><span class="o">.</span><span class="n">copy</span><span class="p">(),</span> +</span><span id="qualify_tables-50"><a href="#qualify_tables-50"><span class="linenos">50</span></a> <span class="n">name</span> <span class="k">if</span> <span class="n">name</span> <span class="k">else</span> <span class="n">next_name</span><span class="p">(),</span> +</span><span id="qualify_tables-51"><a href="#qualify_tables-51"><span class="linenos">51</span></a> <span class="n">table</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> +</span><span id="qualify_tables-52"><a href="#qualify_tables-52"><span class="linenos">52</span></a> <span class="p">)</span> +</span><span id="qualify_tables-53"><a href="#qualify_tables-53"><span class="linenos">53</span></a> <span class="p">)</span> +</span><span id="qualify_tables-54"><a href="#qualify_tables-54"><span class="linenos">54</span></a> +</span><span id="qualify_tables-55"><a href="#qualify_tables-55"><span class="linenos">55</span></a> <span class="k">if</span> <span class="n">schema</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">ReadCSV</span><span class="p">):</span> +</span><span id="qualify_tables-56"><a href="#qualify_tables-56"><span class="linenos">56</span></a> <span class="k">with</span> <span class="n">csv_reader</span><span class="p">(</span><span class="n">source</span><span class="o">.</span><span class="n">this</span><span class="p">)</span> <span class="k">as</span> <span class="n">reader</span><span class="p">:</span> +</span><span id="qualify_tables-57"><a href="#qualify_tables-57"><span class="linenos">57</span></a> <span class="n">header</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">reader</span><span class="p">)</span> +</span><span id="qualify_tables-58"><a href="#qualify_tables-58"><span class="linenos">58</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="n">reader</span><span class="p">)</span> +</span><span id="qualify_tables-59"><a href="#qualify_tables-59"><span class="linenos">59</span></a> <span class="n">schema</span><span class="o">.</span><span class="n">add_table</span><span class="p">(</span> +</span><span id="qualify_tables-60"><a href="#qualify_tables-60"><span class="linenos">60</span></a> <span class="n">source</span><span class="p">,</span> <span class="p">{</span><span class="n">k</span><span class="p">:</span> <span class="nb">type</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">.</span><span class="vm">__name__</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">header</span><span class="p">,</span> <span class="n">columns</span><span class="p">)}</span> +</span><span id="qualify_tables-61"><a href="#qualify_tables-61"><span class="linenos">61</span></a> <span class="p">)</span> +</span><span id="qualify_tables-62"><a href="#qualify_tables-62"><span class="linenos">62</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="n">source</span><span class="o">.</span><span class="n">is_udtf</span><span class="p">:</span> +</span><span id="qualify_tables-63"><a href="#qualify_tables-63"><span class="linenos">63</span></a> <span class="n">udtf</span> <span class="o">=</span> <span class="n">source</span><span class="o">.</span><span class="n">expression</span> +</span><span id="qualify_tables-64"><a href="#qualify_tables-64"><span class="linenos">64</span></a> <span class="n">table_alias</span> <span class="o">=</span> <span class="n">udtf</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">)</span> <span class="ow">or</span> <span class="n">exp</span><span class="o">.</span><span class="n">TableAlias</span><span class="p">(</span><span class="n">this</span><span class="o">=</span><span class="n">next_name</span><span class="p">())</span> +</span><span id="qualify_tables-65"><a href="#qualify_tables-65"><span class="linenos">65</span></a> <span class="n">udtf</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"alias"</span><span class="p">,</span> <span class="n">table_alias</span><span class="p">)</span> +</span><span id="qualify_tables-66"><a href="#qualify_tables-66"><span class="linenos">66</span></a> +</span><span id="qualify_tables-67"><a href="#qualify_tables-67"><span class="linenos">67</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="n">table_alias</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> +</span><span id="qualify_tables-68"><a href="#qualify_tables-68"><span class="linenos">68</span></a> <span class="n">table_alias</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="s2">"this"</span><span class="p">,</span> <span class="n">next_name</span><span class="p">())</span> +</span><span id="qualify_tables-69"><a href="#qualify_tables-69"><span class="linenos">69</span></a> +</span><span id="qualify_tables-70"><a href="#qualify_tables-70"><span class="linenos">70</span></a> <span class="k">return</span> <span class="n">expression</span> </span></pre></div> diff --git a/docs/sqlglot/optimizer/scope.html b/docs/sqlglot/optimizer/scope.html index 537c0a9..a1bc729 100644 --- a/docs/sqlglot/optimizer/scope.html +++ b/docs/sqlglot/optimizer/scope.html @@ -194,673 +194,678 @@ </span><span id="L-4"><a href="#L-4"><span class="linenos"> 4</span></a> </span><span id="L-5"><a href="#L-5"><span class="linenos"> 5</span></a><span class="kn">from</span> <span class="nn">sqlglot</span> <span class="kn">import</span> <span class="n">exp</span> </span><span id="L-6"><a href="#L-6"><span class="linenos"> 6</span></a><span class="kn">from</span> <span class="nn">sqlglot.errors</span> <span class="kn">import</span> <span class="n">OptimizeError</span> -</span><span id="L-7"><a href="#L-7"><span class="linenos"> 7</span></a> +</span><span id="L-7"><a href="#L-7"><span class="linenos"> 7</span></a><span class="kn">from</span> <span class="nn">sqlglot.helper</span> <span class="kn">import</span> <span class="n">find_new_name</span> </span><span id="L-8"><a href="#L-8"><span class="linenos"> 8</span></a> -</span><span id="L-9"><a href="#L-9"><span class="linenos"> 9</span></a><span class="k">class</span> <span class="nc">ScopeType</span><span class="p">(</span><span class="n">Enum</span><span class="p">):</span> -</span><span id="L-10"><a href="#L-10"><span class="linenos"> 10</span></a> <span class="n">ROOT</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="L-11"><a href="#L-11"><span class="linenos"> 11</span></a> <span class="n">SUBQUERY</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="L-12"><a href="#L-12"><span class="linenos"> 12</span></a> <span class="n">DERIVED_TABLE</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="L-13"><a href="#L-13"><span class="linenos"> 13</span></a> <span class="n">CTE</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="L-14"><a href="#L-14"><span class="linenos"> 14</span></a> <span class="n">UNION</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="L-15"><a href="#L-15"><span class="linenos"> 15</span></a> <span class="n">UDTF</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="L-16"><a href="#L-16"><span class="linenos"> 16</span></a> +</span><span id="L-9"><a href="#L-9"><span class="linenos"> 9</span></a> +</span><span id="L-10"><a href="#L-10"><span class="linenos"> 10</span></a><span class="k">class</span> <span class="nc">ScopeType</span><span class="p">(</span><span class="n">Enum</span><span class="p">):</span> +</span><span id="L-11"><a href="#L-11"><span class="linenos"> 11</span></a> <span class="n">ROOT</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="L-12"><a href="#L-12"><span class="linenos"> 12</span></a> <span class="n">SUBQUERY</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="L-13"><a href="#L-13"><span class="linenos"> 13</span></a> <span class="n">DERIVED_TABLE</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="L-14"><a href="#L-14"><span class="linenos"> 14</span></a> <span class="n">CTE</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="L-15"><a href="#L-15"><span class="linenos"> 15</span></a> <span class="n">UNION</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="L-16"><a href="#L-16"><span class="linenos"> 16</span></a> <span class="n">UDTF</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> </span><span id="L-17"><a href="#L-17"><span class="linenos"> 17</span></a> -</span><span id="L-18"><a href="#L-18"><span class="linenos"> 18</span></a><span class="k">class</span> <span class="nc">Scope</span><span class="p">:</span> -</span><span id="L-19"><a href="#L-19"><span class="linenos"> 19</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-20"><a href="#L-20"><span class="linenos"> 20</span></a><span class="sd"> Selection scope.</span> -</span><span id="L-21"><a href="#L-21"><span class="linenos"> 21</span></a> -</span><span id="L-22"><a href="#L-22"><span class="linenos"> 22</span></a><span class="sd"> Attributes:</span> -</span><span id="L-23"><a href="#L-23"><span class="linenos"> 23</span></a><span class="sd"> expression (exp.Select|exp.Union): Root expression of this scope</span> -</span><span id="L-24"><a href="#L-24"><span class="linenos"> 24</span></a><span class="sd"> sources (dict[str, exp.Table|Scope]): Mapping of source name to either</span> -</span><span id="L-25"><a href="#L-25"><span class="linenos"> 25</span></a><span class="sd"> a Table expression or another Scope instance. For example:</span> -</span><span id="L-26"><a href="#L-26"><span class="linenos"> 26</span></a><span class="sd"> SELECT * FROM x {"x": Table(this="x")}</span> -</span><span id="L-27"><a href="#L-27"><span class="linenos"> 27</span></a><span class="sd"> SELECT * FROM x AS y {"y": Table(this="x")}</span> -</span><span id="L-28"><a href="#L-28"><span class="linenos"> 28</span></a><span class="sd"> SELECT * FROM (SELECT ...) AS y {"y": Scope(...)}</span> -</span><span id="L-29"><a href="#L-29"><span class="linenos"> 29</span></a><span class="sd"> lateral_sources (dict[str, exp.Table|Scope]): Sources from laterals</span> -</span><span id="L-30"><a href="#L-30"><span class="linenos"> 30</span></a><span class="sd"> For example:</span> -</span><span id="L-31"><a href="#L-31"><span class="linenos"> 31</span></a><span class="sd"> SELECT c FROM x LATERAL VIEW EXPLODE (a) AS c;</span> -</span><span id="L-32"><a href="#L-32"><span class="linenos"> 32</span></a><span class="sd"> The LATERAL VIEW EXPLODE gets x as a source.</span> -</span><span id="L-33"><a href="#L-33"><span class="linenos"> 33</span></a><span class="sd"> outer_column_list (list[str]): If this is a derived table or CTE, and the outer query</span> -</span><span id="L-34"><a href="#L-34"><span class="linenos"> 34</span></a><span class="sd"> defines a column list of it's alias of this scope, this is that list of columns.</span> -</span><span id="L-35"><a href="#L-35"><span class="linenos"> 35</span></a><span class="sd"> For example:</span> -</span><span id="L-36"><a href="#L-36"><span class="linenos"> 36</span></a><span class="sd"> SELECT * FROM (SELECT ...) AS y(col1, col2)</span> -</span><span id="L-37"><a href="#L-37"><span class="linenos"> 37</span></a><span class="sd"> The inner query would have `["col1", "col2"]` for its `outer_column_list`</span> -</span><span id="L-38"><a href="#L-38"><span class="linenos"> 38</span></a><span class="sd"> parent (Scope): Parent scope</span> -</span><span id="L-39"><a href="#L-39"><span class="linenos"> 39</span></a><span class="sd"> scope_type (ScopeType): Type of this scope, relative to it's parent</span> -</span><span id="L-40"><a href="#L-40"><span class="linenos"> 40</span></a><span class="sd"> subquery_scopes (list[Scope]): List of all child scopes for subqueries</span> -</span><span id="L-41"><a href="#L-41"><span class="linenos"> 41</span></a><span class="sd"> cte_scopes (list[Scope]): List of all child scopes for CTEs</span> -</span><span id="L-42"><a href="#L-42"><span class="linenos"> 42</span></a><span class="sd"> derived_table_scopes (list[Scope]): List of all child scopes for derived_tables</span> -</span><span id="L-43"><a href="#L-43"><span class="linenos"> 43</span></a><span class="sd"> udtf_scopes (list[Scope]): List of all child scopes for user defined tabular functions</span> -</span><span id="L-44"><a href="#L-44"><span class="linenos"> 44</span></a><span class="sd"> table_scopes (list[Scope]): derived_table_scopes + udtf_scopes, in the order that they're defined</span> -</span><span id="L-45"><a href="#L-45"><span class="linenos"> 45</span></a><span class="sd"> union_scopes (list[Scope, Scope]): If this Scope is for a Union expression, this will be</span> -</span><span id="L-46"><a href="#L-46"><span class="linenos"> 46</span></a><span class="sd"> a list of the left and right child scopes.</span> -</span><span id="L-47"><a href="#L-47"><span class="linenos"> 47</span></a><span class="sd"> """</span> -</span><span id="L-48"><a href="#L-48"><span class="linenos"> 48</span></a> -</span><span id="L-49"><a href="#L-49"><span class="linenos"> 49</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> -</span><span id="L-50"><a href="#L-50"><span class="linenos"> 50</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="L-51"><a href="#L-51"><span class="linenos"> 51</span></a> <span class="n">expression</span><span class="p">,</span> -</span><span id="L-52"><a href="#L-52"><span class="linenos"> 52</span></a> <span class="n">sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="L-53"><a href="#L-53"><span class="linenos"> 53</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="L-54"><a href="#L-54"><span class="linenos"> 54</span></a> <span class="n">parent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="L-55"><a href="#L-55"><span class="linenos"> 55</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span><span class="p">,</span> -</span><span id="L-56"><a href="#L-56"><span class="linenos"> 56</span></a> <span class="n">lateral_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="L-57"><a href="#L-57"><span class="linenos"> 57</span></a> <span class="p">):</span> -</span><span id="L-58"><a href="#L-58"><span class="linenos"> 58</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span> <span class="o">=</span> <span class="n">expression</span> -</span><span id="L-59"><a href="#L-59"><span class="linenos"> 59</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span> <span class="o">=</span> <span class="n">sources</span> <span class="ow">or</span> <span class="p">{}</span> -</span><span id="L-60"><a href="#L-60"><span class="linenos"> 60</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span> <span class="o">=</span> <span class="n">lateral_sources</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span> <span class="k">if</span> <span class="n">lateral_sources</span> <span class="k">else</span> <span class="p">{}</span> -</span><span id="L-61"><a href="#L-61"><span class="linenos"> 61</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> -</span><span id="L-62"><a href="#L-62"><span class="linenos"> 62</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">outer_column_list</span> <span class="o">=</span> <span class="n">outer_column_list</span> <span class="ow">or</span> <span class="p">[]</span> -</span><span id="L-63"><a href="#L-63"><span class="linenos"> 63</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">parent</span> <span class="o">=</span> <span class="n">parent</span> -</span><span id="L-64"><a href="#L-64"><span class="linenos"> 64</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">=</span> <span class="n">scope_type</span> -</span><span id="L-65"><a href="#L-65"><span class="linenos"> 65</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-66"><a href="#L-66"><span class="linenos"> 66</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">derived_table_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-67"><a href="#L-67"><span class="linenos"> 67</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-68"><a href="#L-68"><span class="linenos"> 68</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-69"><a href="#L-69"><span class="linenos"> 69</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-70"><a href="#L-70"><span class="linenos"> 70</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-71"><a href="#L-71"><span class="linenos"> 71</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="L-72"><a href="#L-72"><span class="linenos"> 72</span></a> -</span><span id="L-73"><a href="#L-73"><span class="linenos"> 73</span></a> <span class="k">def</span> <span class="nf">clear_cache</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-74"><a href="#L-74"><span class="linenos"> 74</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="L-75"><a href="#L-75"><span class="linenos"> 75</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-76"><a href="#L-76"><span class="linenos"> 76</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-77"><a href="#L-77"><span class="linenos"> 77</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-78"><a href="#L-78"><span class="linenos"> 78</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-79"><a href="#L-79"><span class="linenos"> 79</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-80"><a href="#L-80"><span class="linenos"> 80</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-81"><a href="#L-81"><span class="linenos"> 81</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-82"><a href="#L-82"><span class="linenos"> 82</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-83"><a href="#L-83"><span class="linenos"> 83</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-84"><a href="#L-84"><span class="linenos"> 84</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-85"><a href="#L-85"><span class="linenos"> 85</span></a> -</span><span id="L-86"><a href="#L-86"><span class="linenos"> 86</span></a> <span class="k">def</span> <span class="nf">branch</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">expression</span><span class="p">,</span> <span class="n">scope_type</span><span class="p">,</span> <span class="n">chain_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span> -</span><span id="L-87"><a href="#L-87"><span class="linenos"> 87</span></a><span class="w"> </span><span class="sd">"""Branch from the current scope to a new, inner scope"""</span> -</span><span id="L-88"><a href="#L-88"><span class="linenos"> 88</span></a> <span class="k">return</span> <span class="n">Scope</span><span class="p">(</span> -</span><span id="L-89"><a href="#L-89"><span class="linenos"> 89</span></a> <span class="n">expression</span><span class="o">=</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">(),</span> -</span><span id="L-90"><a href="#L-90"><span class="linenos"> 90</span></a> <span class="n">sources</span><span class="o">=</span><span class="p">{</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">cte_sources</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">chain_sources</span> <span class="ow">or</span> <span class="p">{})},</span> -</span><span id="L-91"><a href="#L-91"><span class="linenos"> 91</span></a> <span class="n">parent</span><span class="o">=</span><span class="bp">self</span><span class="p">,</span> -</span><span id="L-92"><a href="#L-92"><span class="linenos"> 92</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">scope_type</span><span class="p">,</span> -</span><span id="L-93"><a href="#L-93"><span class="linenos"> 93</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> -</span><span id="L-94"><a href="#L-94"><span class="linenos"> 94</span></a> <span class="p">)</span> -</span><span id="L-95"><a href="#L-95"><span class="linenos"> 95</span></a> -</span><span id="L-96"><a href="#L-96"><span class="linenos"> 96</span></a> <span class="k">def</span> <span class="nf">_collect</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-97"><a href="#L-97"><span class="linenos"> 97</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-98"><a href="#L-98"><span class="linenos"> 98</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-99"><a href="#L-99"><span class="linenos"> 99</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-100"><a href="#L-100"><span class="linenos">100</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-101"><a href="#L-101"><span class="linenos">101</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-102"><a href="#L-102"><span class="linenos">102</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-103"><a href="#L-103"><span class="linenos">103</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-104"><a href="#L-104"><span class="linenos">104</span></a> -</span><span id="L-105"><a href="#L-105"><span class="linenos">105</span></a> <span class="k">for</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> -</span><span id="L-106"><a href="#L-106"><span class="linenos">106</span></a> <span class="k">if</span> <span class="n">node</span> <span class="ow">is</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">:</span> -</span><span id="L-107"><a href="#L-107"><span class="linenos">107</span></a> <span class="k">continue</span> -</span><span id="L-108"><a href="#L-108"><span class="linenos">108</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Star</span><span class="p">):</span> -</span><span id="L-109"><a href="#L-109"><span class="linenos">109</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="L-110"><a href="#L-110"><span class="linenos">110</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">JoinHint</span><span class="p">):</span> -</span><span id="L-111"><a href="#L-111"><span class="linenos">111</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="L-112"><a href="#L-112"><span class="linenos">112</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">JoinHint</span><span class="p">):</span> -</span><span id="L-113"><a href="#L-113"><span class="linenos">113</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="L-114"><a href="#L-114"><span class="linenos">114</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">):</span> -</span><span id="L-115"><a href="#L-115"><span class="linenos">115</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="L-116"><a href="#L-116"><span class="linenos">116</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">CTE</span><span class="p">):</span> -</span><span id="L-117"><a href="#L-117"><span class="linenos">117</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="L-118"><a href="#L-118"><span class="linenos">118</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">parent</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">From</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">)):</span> -</span><span id="L-119"><a href="#L-119"><span class="linenos">119</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="L-120"><a href="#L-120"><span class="linenos">120</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> -</span><span id="L-121"><a href="#L-121"><span class="linenos">121</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="L-122"><a href="#L-122"><span class="linenos">122</span></a> -</span><span id="L-123"><a href="#L-123"><span class="linenos">123</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">True</span> -</span><span id="L-124"><a href="#L-124"><span class="linenos">124</span></a> -</span><span id="L-125"><a href="#L-125"><span class="linenos">125</span></a> <span class="k">def</span> <span class="nf">_ensure_collected</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-126"><a href="#L-126"><span class="linenos">126</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span><span class="p">:</span> -</span><span id="L-127"><a href="#L-127"><span class="linenos">127</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collect</span><span class="p">()</span> -</span><span id="L-128"><a href="#L-128"><span class="linenos">128</span></a> -</span><span id="L-129"><a href="#L-129"><span class="linenos">129</span></a> <span class="k">def</span> <span class="nf">walk</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="L-130"><a href="#L-130"><span class="linenos">130</span></a> <span class="k">return</span> <span class="n">walk_in_scope</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">)</span> -</span><span id="L-131"><a href="#L-131"><span class="linenos">131</span></a> -</span><span id="L-132"><a href="#L-132"><span class="linenos">132</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="L-133"><a href="#L-133"><span class="linenos">133</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-134"><a href="#L-134"><span class="linenos">134</span></a><span class="sd"> Returns the first node in this scope which matches at least one of the specified types.</span> -</span><span id="L-135"><a href="#L-135"><span class="linenos">135</span></a> -</span><span id="L-136"><a href="#L-136"><span class="linenos">136</span></a><span class="sd"> This does NOT traverse into subscopes.</span> -</span><span id="L-137"><a href="#L-137"><span class="linenos">137</span></a> -</span><span id="L-138"><a href="#L-138"><span class="linenos">138</span></a><span class="sd"> Args:</span> -</span><span id="L-139"><a href="#L-139"><span class="linenos">139</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> -</span><span id="L-140"><a href="#L-140"><span class="linenos">140</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> -</span><span id="L-141"><a href="#L-141"><span class="linenos">141</span></a> -</span><span id="L-142"><a href="#L-142"><span class="linenos">142</span></a><span class="sd"> Returns:</span> -</span><span id="L-143"><a href="#L-143"><span class="linenos">143</span></a><span class="sd"> exp.Expression: the node which matches the criteria or None if no node matching</span> -</span><span id="L-144"><a href="#L-144"><span class="linenos">144</span></a><span class="sd"> the criteria was found.</span> -</span><span id="L-145"><a href="#L-145"><span class="linenos">145</span></a><span class="sd"> """</span> -</span><span id="L-146"><a href="#L-146"><span class="linenos">146</span></a> <span class="k">return</span> <span class="nb">next</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">),</span> <span class="kc">None</span><span class="p">)</span> -</span><span id="L-147"><a href="#L-147"><span class="linenos">147</span></a> -</span><span id="L-148"><a href="#L-148"><span class="linenos">148</span></a> <span class="k">def</span> <span class="nf">find_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="L-149"><a href="#L-149"><span class="linenos">149</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-150"><a href="#L-150"><span class="linenos">150</span></a><span class="sd"> Returns a generator object which visits all nodes in this scope and only yields those that</span> -</span><span id="L-151"><a href="#L-151"><span class="linenos">151</span></a><span class="sd"> match at least one of the specified expression types.</span> -</span><span id="L-152"><a href="#L-152"><span class="linenos">152</span></a> -</span><span id="L-153"><a href="#L-153"><span class="linenos">153</span></a><span class="sd"> This does NOT traverse into subscopes.</span> -</span><span id="L-154"><a href="#L-154"><span class="linenos">154</span></a> -</span><span id="L-155"><a href="#L-155"><span class="linenos">155</span></a><span class="sd"> Args:</span> -</span><span id="L-156"><a href="#L-156"><span class="linenos">156</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> -</span><span id="L-157"><a href="#L-157"><span class="linenos">157</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> -</span><span id="L-158"><a href="#L-158"><span class="linenos">158</span></a> -</span><span id="L-159"><a href="#L-159"><span class="linenos">159</span></a><span class="sd"> Yields:</span> -</span><span id="L-160"><a href="#L-160"><span class="linenos">160</span></a><span class="sd"> exp.Expression: nodes</span> -</span><span id="L-161"><a href="#L-161"><span class="linenos">161</span></a><span class="sd"> """</span> -</span><span id="L-162"><a href="#L-162"><span class="linenos">162</span></a> <span class="k">for</span> <span class="n">expression</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">):</span> -</span><span id="L-163"><a href="#L-163"><span class="linenos">163</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">expression_types</span><span class="p">):</span> -</span><span id="L-164"><a href="#L-164"><span class="linenos">164</span></a> <span class="k">yield</span> <span class="n">expression</span> -</span><span id="L-165"><a href="#L-165"><span class="linenos">165</span></a> -</span><span id="L-166"><a href="#L-166"><span class="linenos">166</span></a> <span class="k">def</span> <span class="nf">replace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span> -</span><span id="L-167"><a href="#L-167"><span class="linenos">167</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-168"><a href="#L-168"><span class="linenos">168</span></a><span class="sd"> Replace `old` with `new`.</span> -</span><span id="L-169"><a href="#L-169"><span class="linenos">169</span></a> -</span><span id="L-170"><a href="#L-170"><span class="linenos">170</span></a><span class="sd"> This can be used instead of `exp.Expression.replace` to ensure the `Scope` is kept up-to-date.</span> -</span><span id="L-171"><a href="#L-171"><span class="linenos">171</span></a> -</span><span id="L-172"><a href="#L-172"><span class="linenos">172</span></a><span class="sd"> Args:</span> -</span><span id="L-173"><a href="#L-173"><span class="linenos">173</span></a><span class="sd"> old (exp.Expression): old node</span> -</span><span id="L-174"><a href="#L-174"><span class="linenos">174</span></a><span class="sd"> new (exp.Expression): new node</span> -</span><span id="L-175"><a href="#L-175"><span class="linenos">175</span></a><span class="sd"> """</span> -</span><span id="L-176"><a href="#L-176"><span class="linenos">176</span></a> <span class="n">old</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> -</span><span id="L-177"><a href="#L-177"><span class="linenos">177</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="L-178"><a href="#L-178"><span class="linenos">178</span></a> -</span><span id="L-179"><a href="#L-179"><span class="linenos">179</span></a> <span class="nd">@property</span> -</span><span id="L-180"><a href="#L-180"><span class="linenos">180</span></a> <span class="k">def</span> <span class="nf">tables</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-181"><a href="#L-181"><span class="linenos">181</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-182"><a href="#L-182"><span class="linenos">182</span></a><span class="sd"> List of tables in this scope.</span> -</span><span id="L-183"><a href="#L-183"><span class="linenos">183</span></a> -</span><span id="L-184"><a href="#L-184"><span class="linenos">184</span></a><span class="sd"> Returns:</span> -</span><span id="L-185"><a href="#L-185"><span class="linenos">185</span></a><span class="sd"> list[exp.Table]: tables</span> -</span><span id="L-186"><a href="#L-186"><span class="linenos">186</span></a><span class="sd"> """</span> -</span><span id="L-187"><a href="#L-187"><span class="linenos">187</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="L-188"><a href="#L-188"><span class="linenos">188</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> -</span><span id="L-189"><a href="#L-189"><span class="linenos">189</span></a> -</span><span id="L-190"><a href="#L-190"><span class="linenos">190</span></a> <span class="nd">@property</span> -</span><span id="L-191"><a href="#L-191"><span class="linenos">191</span></a> <span class="k">def</span> <span class="nf">ctes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-192"><a href="#L-192"><span class="linenos">192</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-193"><a href="#L-193"><span class="linenos">193</span></a><span class="sd"> List of CTEs in this scope.</span> -</span><span id="L-194"><a href="#L-194"><span class="linenos">194</span></a> -</span><span id="L-195"><a href="#L-195"><span class="linenos">195</span></a><span class="sd"> Returns:</span> -</span><span id="L-196"><a href="#L-196"><span class="linenos">196</span></a><span class="sd"> list[exp.CTE]: ctes</span> -</span><span id="L-197"><a href="#L-197"><span class="linenos">197</span></a><span class="sd"> """</span> -</span><span id="L-198"><a href="#L-198"><span class="linenos">198</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="L-199"><a href="#L-199"><span class="linenos">199</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> -</span><span id="L-200"><a href="#L-200"><span class="linenos">200</span></a> -</span><span id="L-201"><a href="#L-201"><span class="linenos">201</span></a> <span class="nd">@property</span> -</span><span id="L-202"><a href="#L-202"><span class="linenos">202</span></a> <span class="k">def</span> <span class="nf">derived_tables</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-203"><a href="#L-203"><span class="linenos">203</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-204"><a href="#L-204"><span class="linenos">204</span></a><span class="sd"> List of derived tables in this scope.</span> -</span><span id="L-205"><a href="#L-205"><span class="linenos">205</span></a> -</span><span id="L-206"><a href="#L-206"><span class="linenos">206</span></a><span class="sd"> For example:</span> -</span><span id="L-207"><a href="#L-207"><span class="linenos">207</span></a><span class="sd"> SELECT * FROM (SELECT ...) <- that's a derived table</span> -</span><span id="L-208"><a href="#L-208"><span class="linenos">208</span></a> -</span><span id="L-209"><a href="#L-209"><span class="linenos">209</span></a><span class="sd"> Returns:</span> -</span><span id="L-210"><a href="#L-210"><span class="linenos">210</span></a><span class="sd"> list[exp.Subquery]: derived tables</span> -</span><span id="L-211"><a href="#L-211"><span class="linenos">211</span></a><span class="sd"> """</span> -</span><span id="L-212"><a href="#L-212"><span class="linenos">212</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="L-213"><a href="#L-213"><span class="linenos">213</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> -</span><span id="L-214"><a href="#L-214"><span class="linenos">214</span></a> -</span><span id="L-215"><a href="#L-215"><span class="linenos">215</span></a> <span class="nd">@property</span> -</span><span id="L-216"><a href="#L-216"><span class="linenos">216</span></a> <span class="k">def</span> <span class="nf">udtfs</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-217"><a href="#L-217"><span class="linenos">217</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-218"><a href="#L-218"><span class="linenos">218</span></a><span class="sd"> List of "User Defined Tabular Functions" in this scope.</span> -</span><span id="L-219"><a href="#L-219"><span class="linenos">219</span></a> -</span><span id="L-220"><a href="#L-220"><span class="linenos">220</span></a><span class="sd"> Returns:</span> -</span><span id="L-221"><a href="#L-221"><span class="linenos">221</span></a><span class="sd"> list[exp.UDTF]: UDTFs</span> -</span><span id="L-222"><a href="#L-222"><span class="linenos">222</span></a><span class="sd"> """</span> -</span><span id="L-223"><a href="#L-223"><span class="linenos">223</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="L-224"><a href="#L-224"><span class="linenos">224</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> -</span><span id="L-225"><a href="#L-225"><span class="linenos">225</span></a> -</span><span id="L-226"><a href="#L-226"><span class="linenos">226</span></a> <span class="nd">@property</span> -</span><span id="L-227"><a href="#L-227"><span class="linenos">227</span></a> <span class="k">def</span> <span class="nf">subqueries</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-228"><a href="#L-228"><span class="linenos">228</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-229"><a href="#L-229"><span class="linenos">229</span></a><span class="sd"> List of subqueries in this scope.</span> -</span><span id="L-230"><a href="#L-230"><span class="linenos">230</span></a> -</span><span id="L-231"><a href="#L-231"><span class="linenos">231</span></a><span class="sd"> For example:</span> -</span><span id="L-232"><a href="#L-232"><span class="linenos">232</span></a><span class="sd"> SELECT * FROM x WHERE a IN (SELECT ...) <- that's a subquery</span> -</span><span id="L-233"><a href="#L-233"><span class="linenos">233</span></a> -</span><span id="L-234"><a href="#L-234"><span class="linenos">234</span></a><span class="sd"> Returns:</span> -</span><span id="L-235"><a href="#L-235"><span class="linenos">235</span></a><span class="sd"> list[exp.Subqueryable]: subqueries</span> -</span><span id="L-236"><a href="#L-236"><span class="linenos">236</span></a><span class="sd"> """</span> -</span><span id="L-237"><a href="#L-237"><span class="linenos">237</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="L-238"><a href="#L-238"><span class="linenos">238</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> -</span><span id="L-239"><a href="#L-239"><span class="linenos">239</span></a> -</span><span id="L-240"><a href="#L-240"><span class="linenos">240</span></a> <span class="nd">@property</span> -</span><span id="L-241"><a href="#L-241"><span class="linenos">241</span></a> <span class="k">def</span> <span class="nf">columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-242"><a href="#L-242"><span class="linenos">242</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-243"><a href="#L-243"><span class="linenos">243</span></a><span class="sd"> List of columns in this scope.</span> -</span><span id="L-244"><a href="#L-244"><span class="linenos">244</span></a> -</span><span id="L-245"><a href="#L-245"><span class="linenos">245</span></a><span class="sd"> Returns:</span> -</span><span id="L-246"><a href="#L-246"><span class="linenos">246</span></a><span class="sd"> list[exp.Column]: Column instances in this scope, plus any</span> -</span><span id="L-247"><a href="#L-247"><span class="linenos">247</span></a><span class="sd"> Columns that reference this scope from correlated subqueries.</span> -</span><span id="L-248"><a href="#L-248"><span class="linenos">248</span></a><span class="sd"> """</span> -</span><span id="L-249"><a href="#L-249"><span class="linenos">249</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-250"><a href="#L-250"><span class="linenos">250</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="L-251"><a href="#L-251"><span class="linenos">251</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> -</span><span id="L-252"><a href="#L-252"><span class="linenos">252</span></a> -</span><span id="L-253"><a href="#L-253"><span class="linenos">253</span></a> <span class="n">external_columns</span> <span class="o">=</span> <span class="p">[</span> -</span><span id="L-254"><a href="#L-254"><span class="linenos">254</span></a> <span class="n">column</span> -</span><span id="L-255"><a href="#L-255"><span class="linenos">255</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span><span class="p">)</span> -</span><span id="L-256"><a href="#L-256"><span class="linenos">256</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span> -</span><span id="L-257"><a href="#L-257"><span class="linenos">257</span></a> <span class="p">]</span> -</span><span id="L-258"><a href="#L-258"><span class="linenos">258</span></a> -</span><span id="L-259"><a href="#L-259"><span class="linenos">259</span></a> <span class="n">named_selects</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span><span class="p">)</span> -</span><span id="L-260"><a href="#L-260"><span class="linenos">260</span></a> -</span><span id="L-261"><a href="#L-261"><span class="linenos">261</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-262"><a href="#L-262"><span class="linenos">262</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span> <span class="o">+</span> <span class="n">external_columns</span><span class="p">:</span> -</span><span id="L-263"><a href="#L-263"><span class="linenos">263</span></a> <span class="n">ancestor</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">find_ancestor</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Qualify</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Order</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Having</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Hint</span><span class="p">)</span> -</span><span id="L-264"><a href="#L-264"><span class="linenos">264</span></a> <span class="k">if</span> <span class="p">(</span> -</span><span id="L-265"><a href="#L-265"><span class="linenos">265</span></a> <span class="ow">not</span> <span class="n">ancestor</span> -</span><span id="L-266"><a href="#L-266"><span class="linenos">266</span></a> <span class="c1"># Window functions can have an ORDER BY clause</span> -</span><span id="L-267"><a href="#L-267"><span class="linenos">267</span></a> <span class="ow">or</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ancestor</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">)</span> -</span><span id="L-268"><a href="#L-268"><span class="linenos">268</span></a> <span class="ow">or</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> -</span><span id="L-269"><a href="#L-269"><span class="linenos">269</span></a> <span class="ow">or</span> <span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">named_selects</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ancestor</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Hint</span><span class="p">))</span> -</span><span id="L-270"><a href="#L-270"><span class="linenos">270</span></a> <span class="p">):</span> -</span><span id="L-271"><a href="#L-271"><span class="linenos">271</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> -</span><span id="L-272"><a href="#L-272"><span class="linenos">272</span></a> -</span><span id="L-273"><a href="#L-273"><span class="linenos">273</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> -</span><span id="L-274"><a href="#L-274"><span class="linenos">274</span></a> -</span><span id="L-275"><a href="#L-275"><span class="linenos">275</span></a> <span class="nd">@property</span> -</span><span id="L-276"><a href="#L-276"><span class="linenos">276</span></a> <span class="k">def</span> <span class="nf">selected_sources</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-277"><a href="#L-277"><span class="linenos">277</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-278"><a href="#L-278"><span class="linenos">278</span></a><span class="sd"> Mapping of nodes and sources that are actually selected from in this scope.</span> -</span><span id="L-279"><a href="#L-279"><span class="linenos">279</span></a> -</span><span id="L-280"><a href="#L-280"><span class="linenos">280</span></a><span class="sd"> That is, all tables in a schema are selectable at any point. But a</span> -</span><span id="L-281"><a href="#L-281"><span class="linenos">281</span></a><span class="sd"> table only becomes a selected source if it's included in a FROM or JOIN clause.</span> -</span><span id="L-282"><a href="#L-282"><span class="linenos">282</span></a> -</span><span id="L-283"><a href="#L-283"><span class="linenos">283</span></a><span class="sd"> Returns:</span> -</span><span id="L-284"><a href="#L-284"><span class="linenos">284</span></a><span class="sd"> dict[str, (exp.Table|exp.Select, exp.Table|Scope)]: selected sources and nodes</span> -</span><span id="L-285"><a href="#L-285"><span class="linenos">285</span></a><span class="sd"> """</span> -</span><span id="L-286"><a href="#L-286"><span class="linenos">286</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-287"><a href="#L-287"><span class="linenos">287</span></a> <span class="n">referenced_names</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-288"><a href="#L-288"><span class="linenos">288</span></a> -</span><span id="L-289"><a href="#L-289"><span class="linenos">289</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">tables</span><span class="p">:</span> -</span><span id="L-290"><a href="#L-290"><span class="linenos">290</span></a> <span class="n">referenced_names</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">table</span><span class="o">.</span><span class="n">alias_or_name</span><span class="p">,</span> <span class="n">table</span><span class="p">))</span> -</span><span id="L-291"><a href="#L-291"><span class="linenos">291</span></a> <span class="k">for</span> <span class="n">expression</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">derived_tables</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">udtfs</span><span class="p">):</span> -</span><span id="L-292"><a href="#L-292"><span class="linenos">292</span></a> <span class="n">referenced_names</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">expression</span><span class="o">.</span><span class="n">alias</span><span class="p">,</span> <span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">()))</span> -</span><span id="L-293"><a href="#L-293"><span class="linenos">293</span></a> <span class="n">result</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="L-294"><a href="#L-294"><span class="linenos">294</span></a> -</span><span id="L-295"><a href="#L-295"><span class="linenos">295</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">referenced_names</span><span class="p">:</span> -</span><span id="L-296"><a href="#L-296"><span class="linenos">296</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> -</span><span id="L-297"><a href="#L-297"><span class="linenos">297</span></a> <span class="n">result</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">])</span> -</span><span id="L-298"><a href="#L-298"><span class="linenos">298</span></a> -</span><span id="L-299"><a href="#L-299"><span class="linenos">299</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="n">result</span> -</span><span id="L-300"><a href="#L-300"><span class="linenos">300</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> +</span><span id="L-18"><a href="#L-18"><span class="linenos"> 18</span></a> +</span><span id="L-19"><a href="#L-19"><span class="linenos"> 19</span></a><span class="k">class</span> <span class="nc">Scope</span><span class="p">:</span> +</span><span id="L-20"><a href="#L-20"><span class="linenos"> 20</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-21"><a href="#L-21"><span class="linenos"> 21</span></a><span class="sd"> Selection scope.</span> +</span><span id="L-22"><a href="#L-22"><span class="linenos"> 22</span></a> +</span><span id="L-23"><a href="#L-23"><span class="linenos"> 23</span></a><span class="sd"> Attributes:</span> +</span><span id="L-24"><a href="#L-24"><span class="linenos"> 24</span></a><span class="sd"> expression (exp.Select|exp.Union): Root expression of this scope</span> +</span><span id="L-25"><a href="#L-25"><span class="linenos"> 25</span></a><span class="sd"> sources (dict[str, exp.Table|Scope]): Mapping of source name to either</span> +</span><span id="L-26"><a href="#L-26"><span class="linenos"> 26</span></a><span class="sd"> a Table expression or another Scope instance. For example:</span> +</span><span id="L-27"><a href="#L-27"><span class="linenos"> 27</span></a><span class="sd"> SELECT * FROM x {"x": Table(this="x")}</span> +</span><span id="L-28"><a href="#L-28"><span class="linenos"> 28</span></a><span class="sd"> SELECT * FROM x AS y {"y": Table(this="x")}</span> +</span><span id="L-29"><a href="#L-29"><span class="linenos"> 29</span></a><span class="sd"> SELECT * FROM (SELECT ...) AS y {"y": Scope(...)}</span> +</span><span id="L-30"><a href="#L-30"><span class="linenos"> 30</span></a><span class="sd"> lateral_sources (dict[str, exp.Table|Scope]): Sources from laterals</span> +</span><span id="L-31"><a href="#L-31"><span class="linenos"> 31</span></a><span class="sd"> For example:</span> +</span><span id="L-32"><a href="#L-32"><span class="linenos"> 32</span></a><span class="sd"> SELECT c FROM x LATERAL VIEW EXPLODE (a) AS c;</span> +</span><span id="L-33"><a href="#L-33"><span class="linenos"> 33</span></a><span class="sd"> The LATERAL VIEW EXPLODE gets x as a source.</span> +</span><span id="L-34"><a href="#L-34"><span class="linenos"> 34</span></a><span class="sd"> outer_column_list (list[str]): If this is a derived table or CTE, and the outer query</span> +</span><span id="L-35"><a href="#L-35"><span class="linenos"> 35</span></a><span class="sd"> defines a column list of it's alias of this scope, this is that list of columns.</span> +</span><span id="L-36"><a href="#L-36"><span class="linenos"> 36</span></a><span class="sd"> For example:</span> +</span><span id="L-37"><a href="#L-37"><span class="linenos"> 37</span></a><span class="sd"> SELECT * FROM (SELECT ...) AS y(col1, col2)</span> +</span><span id="L-38"><a href="#L-38"><span class="linenos"> 38</span></a><span class="sd"> The inner query would have `["col1", "col2"]` for its `outer_column_list`</span> +</span><span id="L-39"><a href="#L-39"><span class="linenos"> 39</span></a><span class="sd"> parent (Scope): Parent scope</span> +</span><span id="L-40"><a href="#L-40"><span class="linenos"> 40</span></a><span class="sd"> scope_type (ScopeType): Type of this scope, relative to it's parent</span> +</span><span id="L-41"><a href="#L-41"><span class="linenos"> 41</span></a><span class="sd"> subquery_scopes (list[Scope]): List of all child scopes for subqueries</span> +</span><span id="L-42"><a href="#L-42"><span class="linenos"> 42</span></a><span class="sd"> cte_scopes (list[Scope]): List of all child scopes for CTEs</span> +</span><span id="L-43"><a href="#L-43"><span class="linenos"> 43</span></a><span class="sd"> derived_table_scopes (list[Scope]): List of all child scopes for derived_tables</span> +</span><span id="L-44"><a href="#L-44"><span class="linenos"> 44</span></a><span class="sd"> udtf_scopes (list[Scope]): List of all child scopes for user defined tabular functions</span> +</span><span id="L-45"><a href="#L-45"><span class="linenos"> 45</span></a><span class="sd"> table_scopes (list[Scope]): derived_table_scopes + udtf_scopes, in the order that they're defined</span> +</span><span id="L-46"><a href="#L-46"><span class="linenos"> 46</span></a><span class="sd"> union_scopes (list[Scope, Scope]): If this Scope is for a Union expression, this will be</span> +</span><span id="L-47"><a href="#L-47"><span class="linenos"> 47</span></a><span class="sd"> a list of the left and right child scopes.</span> +</span><span id="L-48"><a href="#L-48"><span class="linenos"> 48</span></a><span class="sd"> """</span> +</span><span id="L-49"><a href="#L-49"><span class="linenos"> 49</span></a> +</span><span id="L-50"><a href="#L-50"><span class="linenos"> 50</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> +</span><span id="L-51"><a href="#L-51"><span class="linenos"> 51</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="L-52"><a href="#L-52"><span class="linenos"> 52</span></a> <span class="n">expression</span><span class="p">,</span> +</span><span id="L-53"><a href="#L-53"><span class="linenos"> 53</span></a> <span class="n">sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="L-54"><a href="#L-54"><span class="linenos"> 54</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="L-55"><a href="#L-55"><span class="linenos"> 55</span></a> <span class="n">parent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="L-56"><a href="#L-56"><span class="linenos"> 56</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span><span class="p">,</span> +</span><span id="L-57"><a href="#L-57"><span class="linenos"> 57</span></a> <span class="n">lateral_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="L-58"><a href="#L-58"><span class="linenos"> 58</span></a> <span class="p">):</span> +</span><span id="L-59"><a href="#L-59"><span class="linenos"> 59</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span> <span class="o">=</span> <span class="n">expression</span> +</span><span id="L-60"><a href="#L-60"><span class="linenos"> 60</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span> <span class="o">=</span> <span class="n">sources</span> <span class="ow">or</span> <span class="p">{}</span> +</span><span id="L-61"><a href="#L-61"><span class="linenos"> 61</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span> <span class="o">=</span> <span class="n">lateral_sources</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span> <span class="k">if</span> <span class="n">lateral_sources</span> <span class="k">else</span> <span class="p">{}</span> +</span><span id="L-62"><a href="#L-62"><span class="linenos"> 62</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> +</span><span id="L-63"><a href="#L-63"><span class="linenos"> 63</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">outer_column_list</span> <span class="o">=</span> <span class="n">outer_column_list</span> <span class="ow">or</span> <span class="p">[]</span> +</span><span id="L-64"><a href="#L-64"><span class="linenos"> 64</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">parent</span> <span class="o">=</span> <span class="n">parent</span> +</span><span id="L-65"><a href="#L-65"><span class="linenos"> 65</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">=</span> <span class="n">scope_type</span> +</span><span id="L-66"><a href="#L-66"><span class="linenos"> 66</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-67"><a href="#L-67"><span class="linenos"> 67</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">derived_table_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-68"><a href="#L-68"><span class="linenos"> 68</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-69"><a href="#L-69"><span class="linenos"> 69</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-70"><a href="#L-70"><span class="linenos"> 70</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-71"><a href="#L-71"><span class="linenos"> 71</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-72"><a href="#L-72"><span class="linenos"> 72</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> +</span><span id="L-73"><a href="#L-73"><span class="linenos"> 73</span></a> +</span><span id="L-74"><a href="#L-74"><span class="linenos"> 74</span></a> <span class="k">def</span> <span class="nf">clear_cache</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-75"><a href="#L-75"><span class="linenos"> 75</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">False</span> +</span><span id="L-76"><a href="#L-76"><span class="linenos"> 76</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-77"><a href="#L-77"><span class="linenos"> 77</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-78"><a href="#L-78"><span class="linenos"> 78</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-79"><a href="#L-79"><span class="linenos"> 79</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-80"><a href="#L-80"><span class="linenos"> 80</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-81"><a href="#L-81"><span class="linenos"> 81</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-82"><a href="#L-82"><span class="linenos"> 82</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-83"><a href="#L-83"><span class="linenos"> 83</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-84"><a href="#L-84"><span class="linenos"> 84</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-85"><a href="#L-85"><span class="linenos"> 85</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-86"><a href="#L-86"><span class="linenos"> 86</span></a> +</span><span id="L-87"><a href="#L-87"><span class="linenos"> 87</span></a> <span class="k">def</span> <span class="nf">branch</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">expression</span><span class="p">,</span> <span class="n">scope_type</span><span class="p">,</span> <span class="n">chain_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span> +</span><span id="L-88"><a href="#L-88"><span class="linenos"> 88</span></a><span class="w"> </span><span class="sd">"""Branch from the current scope to a new, inner scope"""</span> +</span><span id="L-89"><a href="#L-89"><span class="linenos"> 89</span></a> <span class="k">return</span> <span class="n">Scope</span><span class="p">(</span> +</span><span id="L-90"><a href="#L-90"><span class="linenos"> 90</span></a> <span class="n">expression</span><span class="o">=</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">(),</span> +</span><span id="L-91"><a href="#L-91"><span class="linenos"> 91</span></a> <span class="n">sources</span><span class="o">=</span><span class="p">{</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">cte_sources</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">chain_sources</span> <span class="ow">or</span> <span class="p">{})},</span> +</span><span id="L-92"><a href="#L-92"><span class="linenos"> 92</span></a> <span class="n">parent</span><span class="o">=</span><span class="bp">self</span><span class="p">,</span> +</span><span id="L-93"><a href="#L-93"><span class="linenos"> 93</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">scope_type</span><span class="p">,</span> +</span><span id="L-94"><a href="#L-94"><span class="linenos"> 94</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> +</span><span id="L-95"><a href="#L-95"><span class="linenos"> 95</span></a> <span class="p">)</span> +</span><span id="L-96"><a href="#L-96"><span class="linenos"> 96</span></a> +</span><span id="L-97"><a href="#L-97"><span class="linenos"> 97</span></a> <span class="k">def</span> <span class="nf">_collect</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-98"><a href="#L-98"><span class="linenos"> 98</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-99"><a href="#L-99"><span class="linenos"> 99</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-100"><a href="#L-100"><span class="linenos">100</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-101"><a href="#L-101"><span class="linenos">101</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-102"><a href="#L-102"><span class="linenos">102</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-103"><a href="#L-103"><span class="linenos">103</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-104"><a href="#L-104"><span class="linenos">104</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-105"><a href="#L-105"><span class="linenos">105</span></a> +</span><span id="L-106"><a href="#L-106"><span class="linenos">106</span></a> <span class="k">for</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> +</span><span id="L-107"><a href="#L-107"><span class="linenos">107</span></a> <span class="k">if</span> <span class="n">node</span> <span class="ow">is</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">:</span> +</span><span id="L-108"><a href="#L-108"><span class="linenos">108</span></a> <span class="k">continue</span> +</span><span id="L-109"><a href="#L-109"><span class="linenos">109</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Star</span><span class="p">):</span> +</span><span id="L-110"><a href="#L-110"><span class="linenos">110</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="L-111"><a href="#L-111"><span class="linenos">111</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">JoinHint</span><span class="p">):</span> +</span><span id="L-112"><a href="#L-112"><span class="linenos">112</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="L-113"><a href="#L-113"><span class="linenos">113</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">JoinHint</span><span class="p">):</span> +</span><span id="L-114"><a href="#L-114"><span class="linenos">114</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="L-115"><a href="#L-115"><span class="linenos">115</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">):</span> +</span><span id="L-116"><a href="#L-116"><span class="linenos">116</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="L-117"><a href="#L-117"><span class="linenos">117</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">CTE</span><span class="p">):</span> +</span><span id="L-118"><a href="#L-118"><span class="linenos">118</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="L-119"><a href="#L-119"><span class="linenos">119</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">parent</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">From</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">)):</span> +</span><span id="L-120"><a href="#L-120"><span class="linenos">120</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="L-121"><a href="#L-121"><span class="linenos">121</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> +</span><span id="L-122"><a href="#L-122"><span class="linenos">122</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="L-123"><a href="#L-123"><span class="linenos">123</span></a> +</span><span id="L-124"><a href="#L-124"><span class="linenos">124</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">True</span> +</span><span id="L-125"><a href="#L-125"><span class="linenos">125</span></a> +</span><span id="L-126"><a href="#L-126"><span class="linenos">126</span></a> <span class="k">def</span> <span class="nf">_ensure_collected</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-127"><a href="#L-127"><span class="linenos">127</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span><span class="p">:</span> +</span><span id="L-128"><a href="#L-128"><span class="linenos">128</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collect</span><span class="p">()</span> +</span><span id="L-129"><a href="#L-129"><span class="linenos">129</span></a> +</span><span id="L-130"><a href="#L-130"><span class="linenos">130</span></a> <span class="k">def</span> <span class="nf">walk</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="L-131"><a href="#L-131"><span class="linenos">131</span></a> <span class="k">return</span> <span class="n">walk_in_scope</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">)</span> +</span><span id="L-132"><a href="#L-132"><span class="linenos">132</span></a> +</span><span id="L-133"><a href="#L-133"><span class="linenos">133</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="L-134"><a href="#L-134"><span class="linenos">134</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-135"><a href="#L-135"><span class="linenos">135</span></a><span class="sd"> Returns the first node in this scope which matches at least one of the specified types.</span> +</span><span id="L-136"><a href="#L-136"><span class="linenos">136</span></a> +</span><span id="L-137"><a href="#L-137"><span class="linenos">137</span></a><span class="sd"> This does NOT traverse into subscopes.</span> +</span><span id="L-138"><a href="#L-138"><span class="linenos">138</span></a> +</span><span id="L-139"><a href="#L-139"><span class="linenos">139</span></a><span class="sd"> Args:</span> +</span><span id="L-140"><a href="#L-140"><span class="linenos">140</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> +</span><span id="L-141"><a href="#L-141"><span class="linenos">141</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> +</span><span id="L-142"><a href="#L-142"><span class="linenos">142</span></a> +</span><span id="L-143"><a href="#L-143"><span class="linenos">143</span></a><span class="sd"> Returns:</span> +</span><span id="L-144"><a href="#L-144"><span class="linenos">144</span></a><span class="sd"> exp.Expression: the node which matches the criteria or None if no node matching</span> +</span><span id="L-145"><a href="#L-145"><span class="linenos">145</span></a><span class="sd"> the criteria was found.</span> +</span><span id="L-146"><a href="#L-146"><span class="linenos">146</span></a><span class="sd"> """</span> +</span><span id="L-147"><a href="#L-147"><span class="linenos">147</span></a> <span class="k">return</span> <span class="nb">next</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">),</span> <span class="kc">None</span><span class="p">)</span> +</span><span id="L-148"><a href="#L-148"><span class="linenos">148</span></a> +</span><span id="L-149"><a href="#L-149"><span class="linenos">149</span></a> <span class="k">def</span> <span class="nf">find_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="L-150"><a href="#L-150"><span class="linenos">150</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-151"><a href="#L-151"><span class="linenos">151</span></a><span class="sd"> Returns a generator object which visits all nodes in this scope and only yields those that</span> +</span><span id="L-152"><a href="#L-152"><span class="linenos">152</span></a><span class="sd"> match at least one of the specified expression types.</span> +</span><span id="L-153"><a href="#L-153"><span class="linenos">153</span></a> +</span><span id="L-154"><a href="#L-154"><span class="linenos">154</span></a><span class="sd"> This does NOT traverse into subscopes.</span> +</span><span id="L-155"><a href="#L-155"><span class="linenos">155</span></a> +</span><span id="L-156"><a href="#L-156"><span class="linenos">156</span></a><span class="sd"> Args:</span> +</span><span id="L-157"><a href="#L-157"><span class="linenos">157</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> +</span><span id="L-158"><a href="#L-158"><span class="linenos">158</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> +</span><span id="L-159"><a href="#L-159"><span class="linenos">159</span></a> +</span><span id="L-160"><a href="#L-160"><span class="linenos">160</span></a><span class="sd"> Yields:</span> +</span><span id="L-161"><a href="#L-161"><span class="linenos">161</span></a><span class="sd"> exp.Expression: nodes</span> +</span><span id="L-162"><a href="#L-162"><span class="linenos">162</span></a><span class="sd"> """</span> +</span><span id="L-163"><a href="#L-163"><span class="linenos">163</span></a> <span class="k">for</span> <span class="n">expression</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">):</span> +</span><span id="L-164"><a href="#L-164"><span class="linenos">164</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">expression_types</span><span class="p">):</span> +</span><span id="L-165"><a href="#L-165"><span class="linenos">165</span></a> <span class="k">yield</span> <span class="n">expression</span> +</span><span id="L-166"><a href="#L-166"><span class="linenos">166</span></a> +</span><span id="L-167"><a href="#L-167"><span class="linenos">167</span></a> <span class="k">def</span> <span class="nf">replace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span> +</span><span id="L-168"><a href="#L-168"><span class="linenos">168</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-169"><a href="#L-169"><span class="linenos">169</span></a><span class="sd"> Replace `old` with `new`.</span> +</span><span id="L-170"><a href="#L-170"><span class="linenos">170</span></a> +</span><span id="L-171"><a href="#L-171"><span class="linenos">171</span></a><span class="sd"> This can be used instead of `exp.Expression.replace` to ensure the `Scope` is kept up-to-date.</span> +</span><span id="L-172"><a href="#L-172"><span class="linenos">172</span></a> +</span><span id="L-173"><a href="#L-173"><span class="linenos">173</span></a><span class="sd"> Args:</span> +</span><span id="L-174"><a href="#L-174"><span class="linenos">174</span></a><span class="sd"> old (exp.Expression): old node</span> +</span><span id="L-175"><a href="#L-175"><span class="linenos">175</span></a><span class="sd"> new (exp.Expression): new node</span> +</span><span id="L-176"><a href="#L-176"><span class="linenos">176</span></a><span class="sd"> """</span> +</span><span id="L-177"><a href="#L-177"><span class="linenos">177</span></a> <span class="n">old</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> +</span><span id="L-178"><a href="#L-178"><span class="linenos">178</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> +</span><span id="L-179"><a href="#L-179"><span class="linenos">179</span></a> +</span><span id="L-180"><a href="#L-180"><span class="linenos">180</span></a> <span class="nd">@property</span> +</span><span id="L-181"><a href="#L-181"><span class="linenos">181</span></a> <span class="k">def</span> <span class="nf">tables</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-182"><a href="#L-182"><span class="linenos">182</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-183"><a href="#L-183"><span class="linenos">183</span></a><span class="sd"> List of tables in this scope.</span> +</span><span id="L-184"><a href="#L-184"><span class="linenos">184</span></a> +</span><span id="L-185"><a href="#L-185"><span class="linenos">185</span></a><span class="sd"> Returns:</span> +</span><span id="L-186"><a href="#L-186"><span class="linenos">186</span></a><span class="sd"> list[exp.Table]: tables</span> +</span><span id="L-187"><a href="#L-187"><span class="linenos">187</span></a><span class="sd"> """</span> +</span><span id="L-188"><a href="#L-188"><span class="linenos">188</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="L-189"><a href="#L-189"><span class="linenos">189</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> +</span><span id="L-190"><a href="#L-190"><span class="linenos">190</span></a> +</span><span id="L-191"><a href="#L-191"><span class="linenos">191</span></a> <span class="nd">@property</span> +</span><span id="L-192"><a href="#L-192"><span class="linenos">192</span></a> <span class="k">def</span> <span class="nf">ctes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-193"><a href="#L-193"><span class="linenos">193</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-194"><a href="#L-194"><span class="linenos">194</span></a><span class="sd"> List of CTEs in this scope.</span> +</span><span id="L-195"><a href="#L-195"><span class="linenos">195</span></a> +</span><span id="L-196"><a href="#L-196"><span class="linenos">196</span></a><span class="sd"> Returns:</span> +</span><span id="L-197"><a href="#L-197"><span class="linenos">197</span></a><span class="sd"> list[exp.CTE]: ctes</span> +</span><span id="L-198"><a href="#L-198"><span class="linenos">198</span></a><span class="sd"> """</span> +</span><span id="L-199"><a href="#L-199"><span class="linenos">199</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="L-200"><a href="#L-200"><span class="linenos">200</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> +</span><span id="L-201"><a href="#L-201"><span class="linenos">201</span></a> +</span><span id="L-202"><a href="#L-202"><span class="linenos">202</span></a> <span class="nd">@property</span> +</span><span id="L-203"><a href="#L-203"><span class="linenos">203</span></a> <span class="k">def</span> <span class="nf">derived_tables</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-204"><a href="#L-204"><span class="linenos">204</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-205"><a href="#L-205"><span class="linenos">205</span></a><span class="sd"> List of derived tables in this scope.</span> +</span><span id="L-206"><a href="#L-206"><span class="linenos">206</span></a> +</span><span id="L-207"><a href="#L-207"><span class="linenos">207</span></a><span class="sd"> For example:</span> +</span><span id="L-208"><a href="#L-208"><span class="linenos">208</span></a><span class="sd"> SELECT * FROM (SELECT ...) <- that's a derived table</span> +</span><span id="L-209"><a href="#L-209"><span class="linenos">209</span></a> +</span><span id="L-210"><a href="#L-210"><span class="linenos">210</span></a><span class="sd"> Returns:</span> +</span><span id="L-211"><a href="#L-211"><span class="linenos">211</span></a><span class="sd"> list[exp.Subquery]: derived tables</span> +</span><span id="L-212"><a href="#L-212"><span class="linenos">212</span></a><span class="sd"> """</span> +</span><span id="L-213"><a href="#L-213"><span class="linenos">213</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="L-214"><a href="#L-214"><span class="linenos">214</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> +</span><span id="L-215"><a href="#L-215"><span class="linenos">215</span></a> +</span><span id="L-216"><a href="#L-216"><span class="linenos">216</span></a> <span class="nd">@property</span> +</span><span id="L-217"><a href="#L-217"><span class="linenos">217</span></a> <span class="k">def</span> <span class="nf">udtfs</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-218"><a href="#L-218"><span class="linenos">218</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-219"><a href="#L-219"><span class="linenos">219</span></a><span class="sd"> List of "User Defined Tabular Functions" in this scope.</span> +</span><span id="L-220"><a href="#L-220"><span class="linenos">220</span></a> +</span><span id="L-221"><a href="#L-221"><span class="linenos">221</span></a><span class="sd"> Returns:</span> +</span><span id="L-222"><a href="#L-222"><span class="linenos">222</span></a><span class="sd"> list[exp.UDTF]: UDTFs</span> +</span><span id="L-223"><a href="#L-223"><span class="linenos">223</span></a><span class="sd"> """</span> +</span><span id="L-224"><a href="#L-224"><span class="linenos">224</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="L-225"><a href="#L-225"><span class="linenos">225</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> +</span><span id="L-226"><a href="#L-226"><span class="linenos">226</span></a> +</span><span id="L-227"><a href="#L-227"><span class="linenos">227</span></a> <span class="nd">@property</span> +</span><span id="L-228"><a href="#L-228"><span class="linenos">228</span></a> <span class="k">def</span> <span class="nf">subqueries</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-229"><a href="#L-229"><span class="linenos">229</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-230"><a href="#L-230"><span class="linenos">230</span></a><span class="sd"> List of subqueries in this scope.</span> +</span><span id="L-231"><a href="#L-231"><span class="linenos">231</span></a> +</span><span id="L-232"><a href="#L-232"><span class="linenos">232</span></a><span class="sd"> For example:</span> +</span><span id="L-233"><a href="#L-233"><span class="linenos">233</span></a><span class="sd"> SELECT * FROM x WHERE a IN (SELECT ...) <- that's a subquery</span> +</span><span id="L-234"><a href="#L-234"><span class="linenos">234</span></a> +</span><span id="L-235"><a href="#L-235"><span class="linenos">235</span></a><span class="sd"> Returns:</span> +</span><span id="L-236"><a href="#L-236"><span class="linenos">236</span></a><span class="sd"> list[exp.Subqueryable]: subqueries</span> +</span><span id="L-237"><a href="#L-237"><span class="linenos">237</span></a><span class="sd"> """</span> +</span><span id="L-238"><a href="#L-238"><span class="linenos">238</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="L-239"><a href="#L-239"><span class="linenos">239</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> +</span><span id="L-240"><a href="#L-240"><span class="linenos">240</span></a> +</span><span id="L-241"><a href="#L-241"><span class="linenos">241</span></a> <span class="nd">@property</span> +</span><span id="L-242"><a href="#L-242"><span class="linenos">242</span></a> <span class="k">def</span> <span class="nf">columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-243"><a href="#L-243"><span class="linenos">243</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-244"><a href="#L-244"><span class="linenos">244</span></a><span class="sd"> List of columns in this scope.</span> +</span><span id="L-245"><a href="#L-245"><span class="linenos">245</span></a> +</span><span id="L-246"><a href="#L-246"><span class="linenos">246</span></a><span class="sd"> Returns:</span> +</span><span id="L-247"><a href="#L-247"><span class="linenos">247</span></a><span class="sd"> list[exp.Column]: Column instances in this scope, plus any</span> +</span><span id="L-248"><a href="#L-248"><span class="linenos">248</span></a><span class="sd"> Columns that reference this scope from correlated subqueries.</span> +</span><span id="L-249"><a href="#L-249"><span class="linenos">249</span></a><span class="sd"> """</span> +</span><span id="L-250"><a href="#L-250"><span class="linenos">250</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-251"><a href="#L-251"><span class="linenos">251</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="L-252"><a href="#L-252"><span class="linenos">252</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> +</span><span id="L-253"><a href="#L-253"><span class="linenos">253</span></a> +</span><span id="L-254"><a href="#L-254"><span class="linenos">254</span></a> <span class="n">external_columns</span> <span class="o">=</span> <span class="p">[</span> +</span><span id="L-255"><a href="#L-255"><span class="linenos">255</span></a> <span class="n">column</span> +</span><span id="L-256"><a href="#L-256"><span class="linenos">256</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span><span class="p">)</span> +</span><span id="L-257"><a href="#L-257"><span class="linenos">257</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span> +</span><span id="L-258"><a href="#L-258"><span class="linenos">258</span></a> <span class="p">]</span> +</span><span id="L-259"><a href="#L-259"><span class="linenos">259</span></a> +</span><span id="L-260"><a href="#L-260"><span class="linenos">260</span></a> <span class="n">named_selects</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span><span class="p">)</span> +</span><span id="L-261"><a href="#L-261"><span class="linenos">261</span></a> +</span><span id="L-262"><a href="#L-262"><span class="linenos">262</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-263"><a href="#L-263"><span class="linenos">263</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span> <span class="o">+</span> <span class="n">external_columns</span><span class="p">:</span> +</span><span id="L-264"><a href="#L-264"><span class="linenos">264</span></a> <span class="n">ancestor</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">find_ancestor</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Qualify</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Order</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Having</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Hint</span><span class="p">)</span> +</span><span id="L-265"><a href="#L-265"><span class="linenos">265</span></a> <span class="k">if</span> <span class="p">(</span> +</span><span id="L-266"><a href="#L-266"><span class="linenos">266</span></a> <span class="ow">not</span> <span class="n">ancestor</span> +</span><span id="L-267"><a href="#L-267"><span class="linenos">267</span></a> <span class="c1"># Window functions can have an ORDER BY clause</span> +</span><span id="L-268"><a href="#L-268"><span class="linenos">268</span></a> <span class="ow">or</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ancestor</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">)</span> +</span><span id="L-269"><a href="#L-269"><span class="linenos">269</span></a> <span class="ow">or</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> +</span><span id="L-270"><a href="#L-270"><span class="linenos">270</span></a> <span class="ow">or</span> <span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">named_selects</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ancestor</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Hint</span><span class="p">))</span> +</span><span id="L-271"><a href="#L-271"><span class="linenos">271</span></a> <span class="p">):</span> +</span><span id="L-272"><a href="#L-272"><span class="linenos">272</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> +</span><span id="L-273"><a href="#L-273"><span class="linenos">273</span></a> +</span><span id="L-274"><a href="#L-274"><span class="linenos">274</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> +</span><span id="L-275"><a href="#L-275"><span class="linenos">275</span></a> +</span><span id="L-276"><a href="#L-276"><span class="linenos">276</span></a> <span class="nd">@property</span> +</span><span id="L-277"><a href="#L-277"><span class="linenos">277</span></a> <span class="k">def</span> <span class="nf">selected_sources</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-278"><a href="#L-278"><span class="linenos">278</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-279"><a href="#L-279"><span class="linenos">279</span></a><span class="sd"> Mapping of nodes and sources that are actually selected from in this scope.</span> +</span><span id="L-280"><a href="#L-280"><span class="linenos">280</span></a> +</span><span id="L-281"><a href="#L-281"><span class="linenos">281</span></a><span class="sd"> That is, all tables in a schema are selectable at any point. But a</span> +</span><span id="L-282"><a href="#L-282"><span class="linenos">282</span></a><span class="sd"> table only becomes a selected source if it's included in a FROM or JOIN clause.</span> +</span><span id="L-283"><a href="#L-283"><span class="linenos">283</span></a> +</span><span id="L-284"><a href="#L-284"><span class="linenos">284</span></a><span class="sd"> Returns:</span> +</span><span id="L-285"><a href="#L-285"><span class="linenos">285</span></a><span class="sd"> dict[str, (exp.Table|exp.Select, exp.Table|Scope)]: selected sources and nodes</span> +</span><span id="L-286"><a href="#L-286"><span class="linenos">286</span></a><span class="sd"> """</span> +</span><span id="L-287"><a href="#L-287"><span class="linenos">287</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-288"><a href="#L-288"><span class="linenos">288</span></a> <span class="n">referenced_names</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-289"><a href="#L-289"><span class="linenos">289</span></a> +</span><span id="L-290"><a href="#L-290"><span class="linenos">290</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">tables</span><span class="p">:</span> +</span><span id="L-291"><a href="#L-291"><span class="linenos">291</span></a> <span class="n">referenced_names</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">table</span><span class="o">.</span><span class="n">alias_or_name</span><span class="p">,</span> <span class="n">table</span><span class="p">))</span> +</span><span id="L-292"><a href="#L-292"><span class="linenos">292</span></a> <span class="k">for</span> <span class="n">expression</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">derived_tables</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">udtfs</span><span class="p">):</span> +</span><span id="L-293"><a href="#L-293"><span class="linenos">293</span></a> <span class="n">referenced_names</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">expression</span><span class="o">.</span><span class="n">alias</span><span class="p">,</span> <span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">()))</span> +</span><span id="L-294"><a href="#L-294"><span class="linenos">294</span></a> <span class="n">result</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-295"><a href="#L-295"><span class="linenos">295</span></a> +</span><span id="L-296"><a href="#L-296"><span class="linenos">296</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">referenced_names</span><span class="p">:</span> +</span><span id="L-297"><a href="#L-297"><span class="linenos">297</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">result</span><span class="p">:</span> +</span><span id="L-298"><a href="#L-298"><span class="linenos">298</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Alias already used: </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-299"><a href="#L-299"><span class="linenos">299</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="L-300"><a href="#L-300"><span class="linenos">300</span></a> <span class="n">result</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">])</span> </span><span id="L-301"><a href="#L-301"><span class="linenos">301</span></a> -</span><span id="L-302"><a href="#L-302"><span class="linenos">302</span></a> <span class="nd">@property</span> -</span><span id="L-303"><a href="#L-303"><span class="linenos">303</span></a> <span class="k">def</span> <span class="nf">cte_sources</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-304"><a href="#L-304"><span class="linenos">304</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-305"><a href="#L-305"><span class="linenos">305</span></a><span class="sd"> Sources that are CTEs.</span> -</span><span id="L-306"><a href="#L-306"><span class="linenos">306</span></a> -</span><span id="L-307"><a href="#L-307"><span class="linenos">307</span></a><span class="sd"> Returns:</span> -</span><span id="L-308"><a href="#L-308"><span class="linenos">308</span></a><span class="sd"> dict[str, Scope]: Mapping of source alias to Scope</span> -</span><span id="L-309"><a href="#L-309"><span class="linenos">309</span></a><span class="sd"> """</span> -</span><span id="L-310"><a href="#L-310"><span class="linenos">310</span></a> <span class="k">return</span> <span class="p">{</span> -</span><span id="L-311"><a href="#L-311"><span class="linenos">311</span></a> <span class="n">alias</span><span class="p">:</span> <span class="n">scope</span> -</span><span id="L-312"><a href="#L-312"><span class="linenos">312</span></a> <span class="k">for</span> <span class="n">alias</span><span class="p">,</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> -</span><span id="L-313"><a href="#L-313"><span class="linenos">313</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="n">scope</span><span class="o">.</span><span class="n">is_cte</span> -</span><span id="L-314"><a href="#L-314"><span class="linenos">314</span></a> <span class="p">}</span> -</span><span id="L-315"><a href="#L-315"><span class="linenos">315</span></a> -</span><span id="L-316"><a href="#L-316"><span class="linenos">316</span></a> <span class="nd">@property</span> -</span><span id="L-317"><a href="#L-317"><span class="linenos">317</span></a> <span class="k">def</span> <span class="nf">selects</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-318"><a href="#L-318"><span class="linenos">318</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-319"><a href="#L-319"><span class="linenos">319</span></a><span class="sd"> Select expressions of this scope.</span> -</span><span id="L-320"><a href="#L-320"><span class="linenos">320</span></a> -</span><span id="L-321"><a href="#L-321"><span class="linenos">321</span></a><span class="sd"> For example, for the following expression:</span> -</span><span id="L-322"><a href="#L-322"><span class="linenos">322</span></a><span class="sd"> SELECT 1 as a, 2 as b FROM x</span> +</span><span id="L-302"><a href="#L-302"><span class="linenos">302</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="n">result</span> +</span><span id="L-303"><a href="#L-303"><span class="linenos">303</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> +</span><span id="L-304"><a href="#L-304"><span class="linenos">304</span></a> +</span><span id="L-305"><a href="#L-305"><span class="linenos">305</span></a> <span class="nd">@property</span> +</span><span id="L-306"><a href="#L-306"><span class="linenos">306</span></a> <span class="k">def</span> <span class="nf">cte_sources</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-307"><a href="#L-307"><span class="linenos">307</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-308"><a href="#L-308"><span class="linenos">308</span></a><span class="sd"> Sources that are CTEs.</span> +</span><span id="L-309"><a href="#L-309"><span class="linenos">309</span></a> +</span><span id="L-310"><a href="#L-310"><span class="linenos">310</span></a><span class="sd"> Returns:</span> +</span><span id="L-311"><a href="#L-311"><span class="linenos">311</span></a><span class="sd"> dict[str, Scope]: Mapping of source alias to Scope</span> +</span><span id="L-312"><a href="#L-312"><span class="linenos">312</span></a><span class="sd"> """</span> +</span><span id="L-313"><a href="#L-313"><span class="linenos">313</span></a> <span class="k">return</span> <span class="p">{</span> +</span><span id="L-314"><a href="#L-314"><span class="linenos">314</span></a> <span class="n">alias</span><span class="p">:</span> <span class="n">scope</span> +</span><span id="L-315"><a href="#L-315"><span class="linenos">315</span></a> <span class="k">for</span> <span class="n">alias</span><span class="p">,</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> +</span><span id="L-316"><a href="#L-316"><span class="linenos">316</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="n">scope</span><span class="o">.</span><span class="n">is_cte</span> +</span><span id="L-317"><a href="#L-317"><span class="linenos">317</span></a> <span class="p">}</span> +</span><span id="L-318"><a href="#L-318"><span class="linenos">318</span></a> +</span><span id="L-319"><a href="#L-319"><span class="linenos">319</span></a> <span class="nd">@property</span> +</span><span id="L-320"><a href="#L-320"><span class="linenos">320</span></a> <span class="k">def</span> <span class="nf">selects</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-321"><a href="#L-321"><span class="linenos">321</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-322"><a href="#L-322"><span class="linenos">322</span></a><span class="sd"> Select expressions of this scope.</span> </span><span id="L-323"><a href="#L-323"><span class="linenos">323</span></a> -</span><span id="L-324"><a href="#L-324"><span class="linenos">324</span></a><span class="sd"> The outputs are the "1 as a" and "2 as b" expressions.</span> -</span><span id="L-325"><a href="#L-325"><span class="linenos">325</span></a> -</span><span id="L-326"><a href="#L-326"><span class="linenos">326</span></a><span class="sd"> Returns:</span> -</span><span id="L-327"><a href="#L-327"><span class="linenos">327</span></a><span class="sd"> list[exp.Expression]: expressions</span> -</span><span id="L-328"><a href="#L-328"><span class="linenos">328</span></a><span class="sd"> """</span> -</span><span id="L-329"><a href="#L-329"><span class="linenos">329</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> -</span><span id="L-330"><a href="#L-330"><span class="linenos">330</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">()</span><span class="o">.</span><span class="n">selects</span> -</span><span id="L-331"><a href="#L-331"><span class="linenos">331</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">selects</span> -</span><span id="L-332"><a href="#L-332"><span class="linenos">332</span></a> -</span><span id="L-333"><a href="#L-333"><span class="linenos">333</span></a> <span class="nd">@property</span> -</span><span id="L-334"><a href="#L-334"><span class="linenos">334</span></a> <span class="k">def</span> <span class="nf">external_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-335"><a href="#L-335"><span class="linenos">335</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-336"><a href="#L-336"><span class="linenos">336</span></a><span class="sd"> Columns that appear to reference sources in outer scopes.</span> -</span><span id="L-337"><a href="#L-337"><span class="linenos">337</span></a> -</span><span id="L-338"><a href="#L-338"><span class="linenos">338</span></a><span class="sd"> Returns:</span> -</span><span id="L-339"><a href="#L-339"><span class="linenos">339</span></a><span class="sd"> list[exp.Column]: Column instances that don't reference</span> -</span><span id="L-340"><a href="#L-340"><span class="linenos">340</span></a><span class="sd"> sources in the current scope.</span> -</span><span id="L-341"><a href="#L-341"><span class="linenos">341</span></a><span class="sd"> """</span> -</span><span id="L-342"><a href="#L-342"><span class="linenos">342</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-343"><a href="#L-343"><span class="linenos">343</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="p">[</span> -</span><span id="L-344"><a href="#L-344"><span class="linenos">344</span></a> <span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">selected_sources</span> -</span><span id="L-345"><a href="#L-345"><span class="linenos">345</span></a> <span class="p">]</span> -</span><span id="L-346"><a href="#L-346"><span class="linenos">346</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> -</span><span id="L-347"><a href="#L-347"><span class="linenos">347</span></a> -</span><span id="L-348"><a href="#L-348"><span class="linenos">348</span></a> <span class="nd">@property</span> -</span><span id="L-349"><a href="#L-349"><span class="linenos">349</span></a> <span class="k">def</span> <span class="nf">unqualified_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-350"><a href="#L-350"><span class="linenos">350</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-351"><a href="#L-351"><span class="linenos">351</span></a><span class="sd"> Unqualified columns in the current scope.</span> -</span><span id="L-352"><a href="#L-352"><span class="linenos">352</span></a> -</span><span id="L-353"><a href="#L-353"><span class="linenos">353</span></a><span class="sd"> Returns:</span> -</span><span id="L-354"><a href="#L-354"><span class="linenos">354</span></a><span class="sd"> list[exp.Column]: Unqualified columns</span> -</span><span id="L-355"><a href="#L-355"><span class="linenos">355</span></a><span class="sd"> """</span> -</span><span id="L-356"><a href="#L-356"><span class="linenos">356</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span><span class="p">]</span> -</span><span id="L-357"><a href="#L-357"><span class="linenos">357</span></a> -</span><span id="L-358"><a href="#L-358"><span class="linenos">358</span></a> <span class="nd">@property</span> -</span><span id="L-359"><a href="#L-359"><span class="linenos">359</span></a> <span class="k">def</span> <span class="nf">join_hints</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-360"><a href="#L-360"><span class="linenos">360</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-361"><a href="#L-361"><span class="linenos">361</span></a><span class="sd"> Hints that exist in the scope that reference tables</span> -</span><span id="L-362"><a href="#L-362"><span class="linenos">362</span></a> -</span><span id="L-363"><a href="#L-363"><span class="linenos">363</span></a><span class="sd"> Returns:</span> -</span><span id="L-364"><a href="#L-364"><span class="linenos">364</span></a><span class="sd"> list[exp.JoinHint]: Join hints that are referenced within the scope</span> -</span><span id="L-365"><a href="#L-365"><span class="linenos">365</span></a><span class="sd"> """</span> -</span><span id="L-366"><a href="#L-366"><span class="linenos">366</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="L-367"><a href="#L-367"><span class="linenos">367</span></a> <span class="k">return</span> <span class="p">[]</span> -</span><span id="L-368"><a href="#L-368"><span class="linenos">368</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> -</span><span id="L-369"><a href="#L-369"><span class="linenos">369</span></a> -</span><span id="L-370"><a href="#L-370"><span class="linenos">370</span></a> <span class="k">def</span> <span class="nf">source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_name</span><span class="p">):</span> -</span><span id="L-371"><a href="#L-371"><span class="linenos">371</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-372"><a href="#L-372"><span class="linenos">372</span></a><span class="sd"> Get all columns in the current scope for a particular source.</span> -</span><span id="L-373"><a href="#L-373"><span class="linenos">373</span></a> -</span><span id="L-374"><a href="#L-374"><span class="linenos">374</span></a><span class="sd"> Args:</span> -</span><span id="L-375"><a href="#L-375"><span class="linenos">375</span></a><span class="sd"> source_name (str): Name of the source</span> -</span><span id="L-376"><a href="#L-376"><span class="linenos">376</span></a><span class="sd"> Returns:</span> -</span><span id="L-377"><a href="#L-377"><span class="linenos">377</span></a><span class="sd"> list[exp.Column]: Column instances that reference `source_name`</span> -</span><span id="L-378"><a href="#L-378"><span class="linenos">378</span></a><span class="sd"> """</span> -</span><span id="L-379"><a href="#L-379"><span class="linenos">379</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> <span class="o">==</span> <span class="n">source_name</span><span class="p">]</span> -</span><span id="L-380"><a href="#L-380"><span class="linenos">380</span></a> -</span><span id="L-381"><a href="#L-381"><span class="linenos">381</span></a> <span class="nd">@property</span> -</span><span id="L-382"><a href="#L-382"><span class="linenos">382</span></a> <span class="k">def</span> <span class="nf">is_subquery</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-383"><a href="#L-383"><span class="linenos">383</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a subquery"""</span> -</span><span id="L-384"><a href="#L-384"><span class="linenos">384</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">SUBQUERY</span> -</span><span id="L-385"><a href="#L-385"><span class="linenos">385</span></a> -</span><span id="L-386"><a href="#L-386"><span class="linenos">386</span></a> <span class="nd">@property</span> -</span><span id="L-387"><a href="#L-387"><span class="linenos">387</span></a> <span class="k">def</span> <span class="nf">is_derived_table</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-388"><a href="#L-388"><span class="linenos">388</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a derived table"""</span> -</span><span id="L-389"><a href="#L-389"><span class="linenos">389</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">DERIVED_TABLE</span> -</span><span id="L-390"><a href="#L-390"><span class="linenos">390</span></a> -</span><span id="L-391"><a href="#L-391"><span class="linenos">391</span></a> <span class="nd">@property</span> -</span><span id="L-392"><a href="#L-392"><span class="linenos">392</span></a> <span class="k">def</span> <span class="nf">is_union</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-393"><a href="#L-393"><span class="linenos">393</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a union"""</span> -</span><span id="L-394"><a href="#L-394"><span class="linenos">394</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UNION</span> -</span><span id="L-395"><a href="#L-395"><span class="linenos">395</span></a> -</span><span id="L-396"><a href="#L-396"><span class="linenos">396</span></a> <span class="nd">@property</span> -</span><span id="L-397"><a href="#L-397"><span class="linenos">397</span></a> <span class="k">def</span> <span class="nf">is_cte</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-398"><a href="#L-398"><span class="linenos">398</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a common table expression"""</span> -</span><span id="L-399"><a href="#L-399"><span class="linenos">399</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">CTE</span> -</span><span id="L-400"><a href="#L-400"><span class="linenos">400</span></a> -</span><span id="L-401"><a href="#L-401"><span class="linenos">401</span></a> <span class="nd">@property</span> -</span><span id="L-402"><a href="#L-402"><span class="linenos">402</span></a> <span class="k">def</span> <span class="nf">is_root</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-403"><a href="#L-403"><span class="linenos">403</span></a><span class="w"> </span><span class="sd">"""Determine if this is the root scope"""</span> -</span><span id="L-404"><a href="#L-404"><span class="linenos">404</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span> -</span><span id="L-405"><a href="#L-405"><span class="linenos">405</span></a> -</span><span id="L-406"><a href="#L-406"><span class="linenos">406</span></a> <span class="nd">@property</span> -</span><span id="L-407"><a href="#L-407"><span class="linenos">407</span></a> <span class="k">def</span> <span class="nf">is_udtf</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-408"><a href="#L-408"><span class="linenos">408</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a UDTF (User Defined Table Function)"""</span> -</span><span id="L-409"><a href="#L-409"><span class="linenos">409</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UDTF</span> -</span><span id="L-410"><a href="#L-410"><span class="linenos">410</span></a> -</span><span id="L-411"><a href="#L-411"><span class="linenos">411</span></a> <span class="nd">@property</span> -</span><span id="L-412"><a href="#L-412"><span class="linenos">412</span></a> <span class="k">def</span> <span class="nf">is_correlated_subquery</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-413"><a href="#L-413"><span class="linenos">413</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a correlated subquery"""</span> -</span><span id="L-414"><a href="#L-414"><span class="linenos">414</span></a> <span class="k">return</span> <span class="nb">bool</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">is_subquery</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">external_columns</span><span class="p">)</span> -</span><span id="L-415"><a href="#L-415"><span class="linenos">415</span></a> -</span><span id="L-416"><a href="#L-416"><span class="linenos">416</span></a> <span class="k">def</span> <span class="nf">rename_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old_name</span><span class="p">,</span> <span class="n">new_name</span><span class="p">):</span> -</span><span id="L-417"><a href="#L-417"><span class="linenos">417</span></a><span class="w"> </span><span class="sd">"""Rename a source in this scope"""</span> -</span><span id="L-418"><a href="#L-418"><span class="linenos">418</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">old_name</span> <span class="ow">or</span> <span class="s2">""</span><span class="p">,</span> <span class="p">[])</span> -</span><span id="L-419"><a href="#L-419"><span class="linenos">419</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">new_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">columns</span> -</span><span id="L-420"><a href="#L-420"><span class="linenos">420</span></a> -</span><span id="L-421"><a href="#L-421"><span class="linenos">421</span></a> <span class="k">def</span> <span class="nf">add_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="p">):</span> -</span><span id="L-422"><a href="#L-422"><span class="linenos">422</span></a><span class="w"> </span><span class="sd">"""Add a source to this scope"""</span> -</span><span id="L-423"><a href="#L-423"><span class="linenos">423</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">source</span> -</span><span id="L-424"><a href="#L-424"><span class="linenos">424</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="L-425"><a href="#L-425"><span class="linenos">425</span></a> -</span><span id="L-426"><a href="#L-426"><span class="linenos">426</span></a> <span class="k">def</span> <span class="nf">remove_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span> -</span><span id="L-427"><a href="#L-427"><span class="linenos">427</span></a><span class="w"> </span><span class="sd">"""Remove a source from this scope"""</span> -</span><span id="L-428"><a href="#L-428"><span class="linenos">428</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> -</span><span id="L-429"><a href="#L-429"><span class="linenos">429</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="L-430"><a href="#L-430"><span class="linenos">430</span></a> -</span><span id="L-431"><a href="#L-431"><span class="linenos">431</span></a> <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-432"><a href="#L-432"><span class="linenos">432</span></a> <span class="k">return</span> <span class="sa">f</span><span class="s2">"Scope<</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">sql</span><span class="p">()</span><span class="si">}</span><span class="s2">>"</span> +</span><span id="L-324"><a href="#L-324"><span class="linenos">324</span></a><span class="sd"> For example, for the following expression:</span> +</span><span id="L-325"><a href="#L-325"><span class="linenos">325</span></a><span class="sd"> SELECT 1 as a, 2 as b FROM x</span> +</span><span id="L-326"><a href="#L-326"><span class="linenos">326</span></a> +</span><span id="L-327"><a href="#L-327"><span class="linenos">327</span></a><span class="sd"> The outputs are the "1 as a" and "2 as b" expressions.</span> +</span><span id="L-328"><a href="#L-328"><span class="linenos">328</span></a> +</span><span id="L-329"><a href="#L-329"><span class="linenos">329</span></a><span class="sd"> Returns:</span> +</span><span id="L-330"><a href="#L-330"><span class="linenos">330</span></a><span class="sd"> list[exp.Expression]: expressions</span> +</span><span id="L-331"><a href="#L-331"><span class="linenos">331</span></a><span class="sd"> """</span> +</span><span id="L-332"><a href="#L-332"><span class="linenos">332</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> +</span><span id="L-333"><a href="#L-333"><span class="linenos">333</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">()</span><span class="o">.</span><span class="n">selects</span> +</span><span id="L-334"><a href="#L-334"><span class="linenos">334</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">selects</span> +</span><span id="L-335"><a href="#L-335"><span class="linenos">335</span></a> +</span><span id="L-336"><a href="#L-336"><span class="linenos">336</span></a> <span class="nd">@property</span> +</span><span id="L-337"><a href="#L-337"><span class="linenos">337</span></a> <span class="k">def</span> <span class="nf">external_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-338"><a href="#L-338"><span class="linenos">338</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-339"><a href="#L-339"><span class="linenos">339</span></a><span class="sd"> Columns that appear to reference sources in outer scopes.</span> +</span><span id="L-340"><a href="#L-340"><span class="linenos">340</span></a> +</span><span id="L-341"><a href="#L-341"><span class="linenos">341</span></a><span class="sd"> Returns:</span> +</span><span id="L-342"><a href="#L-342"><span class="linenos">342</span></a><span class="sd"> list[exp.Column]: Column instances that don't reference</span> +</span><span id="L-343"><a href="#L-343"><span class="linenos">343</span></a><span class="sd"> sources in the current scope.</span> +</span><span id="L-344"><a href="#L-344"><span class="linenos">344</span></a><span class="sd"> """</span> +</span><span id="L-345"><a href="#L-345"><span class="linenos">345</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-346"><a href="#L-346"><span class="linenos">346</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="p">[</span> +</span><span id="L-347"><a href="#L-347"><span class="linenos">347</span></a> <span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">selected_sources</span> +</span><span id="L-348"><a href="#L-348"><span class="linenos">348</span></a> <span class="p">]</span> +</span><span id="L-349"><a href="#L-349"><span class="linenos">349</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> +</span><span id="L-350"><a href="#L-350"><span class="linenos">350</span></a> +</span><span id="L-351"><a href="#L-351"><span class="linenos">351</span></a> <span class="nd">@property</span> +</span><span id="L-352"><a href="#L-352"><span class="linenos">352</span></a> <span class="k">def</span> <span class="nf">unqualified_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-353"><a href="#L-353"><span class="linenos">353</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-354"><a href="#L-354"><span class="linenos">354</span></a><span class="sd"> Unqualified columns in the current scope.</span> +</span><span id="L-355"><a href="#L-355"><span class="linenos">355</span></a> +</span><span id="L-356"><a href="#L-356"><span class="linenos">356</span></a><span class="sd"> Returns:</span> +</span><span id="L-357"><a href="#L-357"><span class="linenos">357</span></a><span class="sd"> list[exp.Column]: Unqualified columns</span> +</span><span id="L-358"><a href="#L-358"><span class="linenos">358</span></a><span class="sd"> """</span> +</span><span id="L-359"><a href="#L-359"><span class="linenos">359</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span><span class="p">]</span> +</span><span id="L-360"><a href="#L-360"><span class="linenos">360</span></a> +</span><span id="L-361"><a href="#L-361"><span class="linenos">361</span></a> <span class="nd">@property</span> +</span><span id="L-362"><a href="#L-362"><span class="linenos">362</span></a> <span class="k">def</span> <span class="nf">join_hints</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-363"><a href="#L-363"><span class="linenos">363</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-364"><a href="#L-364"><span class="linenos">364</span></a><span class="sd"> Hints that exist in the scope that reference tables</span> +</span><span id="L-365"><a href="#L-365"><span class="linenos">365</span></a> +</span><span id="L-366"><a href="#L-366"><span class="linenos">366</span></a><span class="sd"> Returns:</span> +</span><span id="L-367"><a href="#L-367"><span class="linenos">367</span></a><span class="sd"> list[exp.JoinHint]: Join hints that are referenced within the scope</span> +</span><span id="L-368"><a href="#L-368"><span class="linenos">368</span></a><span class="sd"> """</span> +</span><span id="L-369"><a href="#L-369"><span class="linenos">369</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="L-370"><a href="#L-370"><span class="linenos">370</span></a> <span class="k">return</span> <span class="p">[]</span> +</span><span id="L-371"><a href="#L-371"><span class="linenos">371</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> +</span><span id="L-372"><a href="#L-372"><span class="linenos">372</span></a> +</span><span id="L-373"><a href="#L-373"><span class="linenos">373</span></a> <span class="k">def</span> <span class="nf">source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_name</span><span class="p">):</span> +</span><span id="L-374"><a href="#L-374"><span class="linenos">374</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-375"><a href="#L-375"><span class="linenos">375</span></a><span class="sd"> Get all columns in the current scope for a particular source.</span> +</span><span id="L-376"><a href="#L-376"><span class="linenos">376</span></a> +</span><span id="L-377"><a href="#L-377"><span class="linenos">377</span></a><span class="sd"> Args:</span> +</span><span id="L-378"><a href="#L-378"><span class="linenos">378</span></a><span class="sd"> source_name (str): Name of the source</span> +</span><span id="L-379"><a href="#L-379"><span class="linenos">379</span></a><span class="sd"> Returns:</span> +</span><span id="L-380"><a href="#L-380"><span class="linenos">380</span></a><span class="sd"> list[exp.Column]: Column instances that reference `source_name`</span> +</span><span id="L-381"><a href="#L-381"><span class="linenos">381</span></a><span class="sd"> """</span> +</span><span id="L-382"><a href="#L-382"><span class="linenos">382</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> <span class="o">==</span> <span class="n">source_name</span><span class="p">]</span> +</span><span id="L-383"><a href="#L-383"><span class="linenos">383</span></a> +</span><span id="L-384"><a href="#L-384"><span class="linenos">384</span></a> <span class="nd">@property</span> +</span><span id="L-385"><a href="#L-385"><span class="linenos">385</span></a> <span class="k">def</span> <span class="nf">is_subquery</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-386"><a href="#L-386"><span class="linenos">386</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a subquery"""</span> +</span><span id="L-387"><a href="#L-387"><span class="linenos">387</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">SUBQUERY</span> +</span><span id="L-388"><a href="#L-388"><span class="linenos">388</span></a> +</span><span id="L-389"><a href="#L-389"><span class="linenos">389</span></a> <span class="nd">@property</span> +</span><span id="L-390"><a href="#L-390"><span class="linenos">390</span></a> <span class="k">def</span> <span class="nf">is_derived_table</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-391"><a href="#L-391"><span class="linenos">391</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a derived table"""</span> +</span><span id="L-392"><a href="#L-392"><span class="linenos">392</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">DERIVED_TABLE</span> +</span><span id="L-393"><a href="#L-393"><span class="linenos">393</span></a> +</span><span id="L-394"><a href="#L-394"><span class="linenos">394</span></a> <span class="nd">@property</span> +</span><span id="L-395"><a href="#L-395"><span class="linenos">395</span></a> <span class="k">def</span> <span class="nf">is_union</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-396"><a href="#L-396"><span class="linenos">396</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a union"""</span> +</span><span id="L-397"><a href="#L-397"><span class="linenos">397</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UNION</span> +</span><span id="L-398"><a href="#L-398"><span class="linenos">398</span></a> +</span><span id="L-399"><a href="#L-399"><span class="linenos">399</span></a> <span class="nd">@property</span> +</span><span id="L-400"><a href="#L-400"><span class="linenos">400</span></a> <span class="k">def</span> <span class="nf">is_cte</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-401"><a href="#L-401"><span class="linenos">401</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a common table expression"""</span> +</span><span id="L-402"><a href="#L-402"><span class="linenos">402</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">CTE</span> +</span><span id="L-403"><a href="#L-403"><span class="linenos">403</span></a> +</span><span id="L-404"><a href="#L-404"><span class="linenos">404</span></a> <span class="nd">@property</span> +</span><span id="L-405"><a href="#L-405"><span class="linenos">405</span></a> <span class="k">def</span> <span class="nf">is_root</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-406"><a href="#L-406"><span class="linenos">406</span></a><span class="w"> </span><span class="sd">"""Determine if this is the root scope"""</span> +</span><span id="L-407"><a href="#L-407"><span class="linenos">407</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span> +</span><span id="L-408"><a href="#L-408"><span class="linenos">408</span></a> +</span><span id="L-409"><a href="#L-409"><span class="linenos">409</span></a> <span class="nd">@property</span> +</span><span id="L-410"><a href="#L-410"><span class="linenos">410</span></a> <span class="k">def</span> <span class="nf">is_udtf</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-411"><a href="#L-411"><span class="linenos">411</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a UDTF (User Defined Table Function)"""</span> +</span><span id="L-412"><a href="#L-412"><span class="linenos">412</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UDTF</span> +</span><span id="L-413"><a href="#L-413"><span class="linenos">413</span></a> +</span><span id="L-414"><a href="#L-414"><span class="linenos">414</span></a> <span class="nd">@property</span> +</span><span id="L-415"><a href="#L-415"><span class="linenos">415</span></a> <span class="k">def</span> <span class="nf">is_correlated_subquery</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-416"><a href="#L-416"><span class="linenos">416</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a correlated subquery"""</span> +</span><span id="L-417"><a href="#L-417"><span class="linenos">417</span></a> <span class="k">return</span> <span class="nb">bool</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">is_subquery</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">external_columns</span><span class="p">)</span> +</span><span id="L-418"><a href="#L-418"><span class="linenos">418</span></a> +</span><span id="L-419"><a href="#L-419"><span class="linenos">419</span></a> <span class="k">def</span> <span class="nf">rename_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old_name</span><span class="p">,</span> <span class="n">new_name</span><span class="p">):</span> +</span><span id="L-420"><a href="#L-420"><span class="linenos">420</span></a><span class="w"> </span><span class="sd">"""Rename a source in this scope"""</span> +</span><span id="L-421"><a href="#L-421"><span class="linenos">421</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">old_name</span> <span class="ow">or</span> <span class="s2">""</span><span class="p">,</span> <span class="p">[])</span> +</span><span id="L-422"><a href="#L-422"><span class="linenos">422</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">new_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">columns</span> +</span><span id="L-423"><a href="#L-423"><span class="linenos">423</span></a> +</span><span id="L-424"><a href="#L-424"><span class="linenos">424</span></a> <span class="k">def</span> <span class="nf">add_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="p">):</span> +</span><span id="L-425"><a href="#L-425"><span class="linenos">425</span></a><span class="w"> </span><span class="sd">"""Add a source to this scope"""</span> +</span><span id="L-426"><a href="#L-426"><span class="linenos">426</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">source</span> +</span><span id="L-427"><a href="#L-427"><span class="linenos">427</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> +</span><span id="L-428"><a href="#L-428"><span class="linenos">428</span></a> +</span><span id="L-429"><a href="#L-429"><span class="linenos">429</span></a> <span class="k">def</span> <span class="nf">remove_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span> +</span><span id="L-430"><a href="#L-430"><span class="linenos">430</span></a><span class="w"> </span><span class="sd">"""Remove a source from this scope"""</span> +</span><span id="L-431"><a href="#L-431"><span class="linenos">431</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> +</span><span id="L-432"><a href="#L-432"><span class="linenos">432</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> </span><span id="L-433"><a href="#L-433"><span class="linenos">433</span></a> -</span><span id="L-434"><a href="#L-434"><span class="linenos">434</span></a> <span class="k">def</span> <span class="nf">traverse</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-435"><a href="#L-435"><span class="linenos">435</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-436"><a href="#L-436"><span class="linenos">436</span></a><span class="sd"> Traverse the scope tree from this node.</span> -</span><span id="L-437"><a href="#L-437"><span class="linenos">437</span></a> -</span><span id="L-438"><a href="#L-438"><span class="linenos">438</span></a><span class="sd"> Yields:</span> -</span><span id="L-439"><a href="#L-439"><span class="linenos">439</span></a><span class="sd"> Scope: scope instances in depth-first-search post-order</span> -</span><span id="L-440"><a href="#L-440"><span class="linenos">440</span></a><span class="sd"> """</span> -</span><span id="L-441"><a href="#L-441"><span class="linenos">441</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span> -</span><span id="L-442"><a href="#L-442"><span class="linenos">442</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> -</span><span id="L-443"><a href="#L-443"><span class="linenos">443</span></a> <span class="p">):</span> -</span><span id="L-444"><a href="#L-444"><span class="linenos">444</span></a> <span class="k">yield from</span> <span class="n">child_scope</span><span class="o">.</span><span class="n">traverse</span><span class="p">()</span> -</span><span id="L-445"><a href="#L-445"><span class="linenos">445</span></a> <span class="k">yield</span> <span class="bp">self</span> -</span><span id="L-446"><a href="#L-446"><span class="linenos">446</span></a> -</span><span id="L-447"><a href="#L-447"><span class="linenos">447</span></a> <span class="k">def</span> <span class="nf">ref_count</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="L-448"><a href="#L-448"><span class="linenos">448</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-449"><a href="#L-449"><span class="linenos">449</span></a><span class="sd"> Count the number of times each scope in this tree is referenced.</span> -</span><span id="L-450"><a href="#L-450"><span class="linenos">450</span></a> -</span><span id="L-451"><a href="#L-451"><span class="linenos">451</span></a><span class="sd"> Returns:</span> -</span><span id="L-452"><a href="#L-452"><span class="linenos">452</span></a><span class="sd"> dict[int, int]: Mapping of Scope instance ID to reference count</span> -</span><span id="L-453"><a href="#L-453"><span class="linenos">453</span></a><span class="sd"> """</span> -</span><span id="L-454"><a href="#L-454"><span class="linenos">454</span></a> <span class="n">scope_ref_count</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="mi">0</span><span class="p">)</span> -</span><span id="L-455"><a href="#L-455"><span class="linenos">455</span></a> -</span><span id="L-456"><a href="#L-456"><span class="linenos">456</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">traverse</span><span class="p">():</span> -</span><span id="L-457"><a href="#L-457"><span class="linenos">457</span></a> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">values</span><span class="p">():</span> -</span><span id="L-458"><a href="#L-458"><span class="linenos">458</span></a> <span class="n">scope_ref_count</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">source</span><span class="p">)]</span> <span class="o">+=</span> <span class="mi">1</span> -</span><span id="L-459"><a href="#L-459"><span class="linenos">459</span></a> -</span><span id="L-460"><a href="#L-460"><span class="linenos">460</span></a> <span class="k">return</span> <span class="n">scope_ref_count</span> -</span><span id="L-461"><a href="#L-461"><span class="linenos">461</span></a> +</span><span id="L-434"><a href="#L-434"><span class="linenos">434</span></a> <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-435"><a href="#L-435"><span class="linenos">435</span></a> <span class="k">return</span> <span class="sa">f</span><span class="s2">"Scope<</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">sql</span><span class="p">()</span><span class="si">}</span><span class="s2">>"</span> +</span><span id="L-436"><a href="#L-436"><span class="linenos">436</span></a> +</span><span id="L-437"><a href="#L-437"><span class="linenos">437</span></a> <span class="k">def</span> <span class="nf">traverse</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-438"><a href="#L-438"><span class="linenos">438</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-439"><a href="#L-439"><span class="linenos">439</span></a><span class="sd"> Traverse the scope tree from this node.</span> +</span><span id="L-440"><a href="#L-440"><span class="linenos">440</span></a> +</span><span id="L-441"><a href="#L-441"><span class="linenos">441</span></a><span class="sd"> Yields:</span> +</span><span id="L-442"><a href="#L-442"><span class="linenos">442</span></a><span class="sd"> Scope: scope instances in depth-first-search post-order</span> +</span><span id="L-443"><a href="#L-443"><span class="linenos">443</span></a><span class="sd"> """</span> +</span><span id="L-444"><a href="#L-444"><span class="linenos">444</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span> +</span><span id="L-445"><a href="#L-445"><span class="linenos">445</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> +</span><span id="L-446"><a href="#L-446"><span class="linenos">446</span></a> <span class="p">):</span> +</span><span id="L-447"><a href="#L-447"><span class="linenos">447</span></a> <span class="k">yield from</span> <span class="n">child_scope</span><span class="o">.</span><span class="n">traverse</span><span class="p">()</span> +</span><span id="L-448"><a href="#L-448"><span class="linenos">448</span></a> <span class="k">yield</span> <span class="bp">self</span> +</span><span id="L-449"><a href="#L-449"><span class="linenos">449</span></a> +</span><span id="L-450"><a href="#L-450"><span class="linenos">450</span></a> <span class="k">def</span> <span class="nf">ref_count</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="L-451"><a href="#L-451"><span class="linenos">451</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-452"><a href="#L-452"><span class="linenos">452</span></a><span class="sd"> Count the number of times each scope in this tree is referenced.</span> +</span><span id="L-453"><a href="#L-453"><span class="linenos">453</span></a> +</span><span id="L-454"><a href="#L-454"><span class="linenos">454</span></a><span class="sd"> Returns:</span> +</span><span id="L-455"><a href="#L-455"><span class="linenos">455</span></a><span class="sd"> dict[int, int]: Mapping of Scope instance ID to reference count</span> +</span><span id="L-456"><a href="#L-456"><span class="linenos">456</span></a><span class="sd"> """</span> +</span><span id="L-457"><a href="#L-457"><span class="linenos">457</span></a> <span class="n">scope_ref_count</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="mi">0</span><span class="p">)</span> +</span><span id="L-458"><a href="#L-458"><span class="linenos">458</span></a> +</span><span id="L-459"><a href="#L-459"><span class="linenos">459</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">traverse</span><span class="p">():</span> +</span><span id="L-460"><a href="#L-460"><span class="linenos">460</span></a> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">values</span><span class="p">():</span> +</span><span id="L-461"><a href="#L-461"><span class="linenos">461</span></a> <span class="n">scope_ref_count</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">source</span><span class="p">)]</span> <span class="o">+=</span> <span class="mi">1</span> </span><span id="L-462"><a href="#L-462"><span class="linenos">462</span></a> -</span><span id="L-463"><a href="#L-463"><span class="linenos">463</span></a><span class="k">def</span> <span class="nf">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> -</span><span id="L-464"><a href="#L-464"><span class="linenos">464</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-465"><a href="#L-465"><span class="linenos">465</span></a><span class="sd"> Traverse an expression by it's "scopes".</span> -</span><span id="L-466"><a href="#L-466"><span class="linenos">466</span></a> -</span><span id="L-467"><a href="#L-467"><span class="linenos">467</span></a><span class="sd"> "Scope" represents the current context of a Select statement.</span> -</span><span id="L-468"><a href="#L-468"><span class="linenos">468</span></a> -</span><span id="L-469"><a href="#L-469"><span class="linenos">469</span></a><span class="sd"> This is helpful for optimizing queries, where we need more information than</span> -</span><span id="L-470"><a href="#L-470"><span class="linenos">470</span></a><span class="sd"> the expression tree itself. For example, we might care about the source</span> -</span><span id="L-471"><a href="#L-471"><span class="linenos">471</span></a><span class="sd"> names within a subquery. Returns a list because a generator could result in</span> -</span><span id="L-472"><a href="#L-472"><span class="linenos">472</span></a><span class="sd"> incomplete properties which is confusing.</span> -</span><span id="L-473"><a href="#L-473"><span class="linenos">473</span></a> -</span><span id="L-474"><a href="#L-474"><span class="linenos">474</span></a><span class="sd"> Examples:</span> -</span><span id="L-475"><a href="#L-475"><span class="linenos">475</span></a><span class="sd"> >>> import sqlglot</span> -</span><span id="L-476"><a href="#L-476"><span class="linenos">476</span></a><span class="sd"> >>> expression = sqlglot.parse_one("SELECT a FROM (SELECT a FROM x) AS y")</span> -</span><span id="L-477"><a href="#L-477"><span class="linenos">477</span></a><span class="sd"> >>> scopes = traverse_scope(expression)</span> -</span><span id="L-478"><a href="#L-478"><span class="linenos">478</span></a><span class="sd"> >>> scopes[0].expression.sql(), list(scopes[0].sources)</span> -</span><span id="L-479"><a href="#L-479"><span class="linenos">479</span></a><span class="sd"> ('SELECT a FROM x', ['x'])</span> -</span><span id="L-480"><a href="#L-480"><span class="linenos">480</span></a><span class="sd"> >>> scopes[1].expression.sql(), list(scopes[1].sources)</span> -</span><span id="L-481"><a href="#L-481"><span class="linenos">481</span></a><span class="sd"> ('SELECT a FROM (SELECT a FROM x) AS y', ['y'])</span> -</span><span id="L-482"><a href="#L-482"><span class="linenos">482</span></a> -</span><span id="L-483"><a href="#L-483"><span class="linenos">483</span></a><span class="sd"> Args:</span> -</span><span id="L-484"><a href="#L-484"><span class="linenos">484</span></a><span class="sd"> expression (exp.Expression): expression to traverse</span> -</span><span id="L-485"><a href="#L-485"><span class="linenos">485</span></a><span class="sd"> Returns:</span> -</span><span id="L-486"><a href="#L-486"><span class="linenos">486</span></a><span class="sd"> list[Scope]: scope instances</span> -</span><span id="L-487"><a href="#L-487"><span class="linenos">487</span></a><span class="sd"> """</span> -</span><span id="L-488"><a href="#L-488"><span class="linenos">488</span></a> <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">_traverse_scope</span><span class="p">(</span><span class="n">Scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)))</span> -</span><span id="L-489"><a href="#L-489"><span class="linenos">489</span></a> -</span><span id="L-490"><a href="#L-490"><span class="linenos">490</span></a> -</span><span id="L-491"><a href="#L-491"><span class="linenos">491</span></a><span class="k">def</span> <span class="nf">build_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> -</span><span id="L-492"><a href="#L-492"><span class="linenos">492</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-493"><a href="#L-493"><span class="linenos">493</span></a><span class="sd"> Build a scope tree.</span> -</span><span id="L-494"><a href="#L-494"><span class="linenos">494</span></a> -</span><span id="L-495"><a href="#L-495"><span class="linenos">495</span></a><span class="sd"> Args:</span> -</span><span id="L-496"><a href="#L-496"><span class="linenos">496</span></a><span class="sd"> expression (exp.Expression): expression to build the scope tree for</span> -</span><span id="L-497"><a href="#L-497"><span class="linenos">497</span></a><span class="sd"> Returns:</span> -</span><span id="L-498"><a href="#L-498"><span class="linenos">498</span></a><span class="sd"> Scope: root scope</span> -</span><span id="L-499"><a href="#L-499"><span class="linenos">499</span></a><span class="sd"> """</span> -</span><span id="L-500"><a href="#L-500"><span class="linenos">500</span></a> <span class="k">return</span> <span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span> -</span><span id="L-501"><a href="#L-501"><span class="linenos">501</span></a> -</span><span id="L-502"><a href="#L-502"><span class="linenos">502</span></a> -</span><span id="L-503"><a href="#L-503"><span class="linenos">503</span></a><span class="k">def</span> <span class="nf">_traverse_scope</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> -</span><span id="L-504"><a href="#L-504"><span class="linenos">504</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> -</span><span id="L-505"><a href="#L-505"><span class="linenos">505</span></a> <span class="k">yield from</span> <span class="n">_traverse_select</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> -</span><span id="L-506"><a href="#L-506"><span class="linenos">506</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> -</span><span id="L-507"><a href="#L-507"><span class="linenos">507</span></a> <span class="k">yield from</span> <span class="n">_traverse_union</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> -</span><span id="L-508"><a href="#L-508"><span class="linenos">508</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">):</span> -</span><span id="L-509"><a href="#L-509"><span class="linenos">509</span></a> <span class="k">yield from</span> <span class="n">_traverse_subqueries</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> -</span><span id="L-510"><a href="#L-510"><span class="linenos">510</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">):</span> -</span><span id="L-511"><a href="#L-511"><span class="linenos">511</span></a> <span class="k">pass</span> -</span><span id="L-512"><a href="#L-512"><span class="linenos">512</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-513"><a href="#L-513"><span class="linenos">513</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unexpected expression type: </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> -</span><span id="L-514"><a href="#L-514"><span class="linenos">514</span></a> <span class="k">yield</span> <span class="n">scope</span> -</span><span id="L-515"><a href="#L-515"><span class="linenos">515</span></a> -</span><span id="L-516"><a href="#L-516"><span class="linenos">516</span></a> -</span><span id="L-517"><a href="#L-517"><span class="linenos">517</span></a><span class="k">def</span> <span class="nf">_traverse_select</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> -</span><span id="L-518"><a href="#L-518"><span class="linenos">518</span></a> <span class="k">yield from</span> <span class="n">_traverse_ctes</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> -</span><span id="L-519"><a href="#L-519"><span class="linenos">519</span></a> <span class="k">yield from</span> <span class="n">_traverse_tables</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> -</span><span id="L-520"><a href="#L-520"><span class="linenos">520</span></a> <span class="k">yield from</span> <span class="n">_traverse_subqueries</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> -</span><span id="L-521"><a href="#L-521"><span class="linenos">521</span></a> -</span><span id="L-522"><a href="#L-522"><span class="linenos">522</span></a> -</span><span id="L-523"><a href="#L-523"><span class="linenos">523</span></a><span class="k">def</span> <span class="nf">_traverse_union</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> -</span><span id="L-524"><a href="#L-524"><span class="linenos">524</span></a> <span class="k">yield from</span> <span class="n">_traverse_ctes</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> +</span><span id="L-463"><a href="#L-463"><span class="linenos">463</span></a> <span class="k">return</span> <span class="n">scope_ref_count</span> +</span><span id="L-464"><a href="#L-464"><span class="linenos">464</span></a> +</span><span id="L-465"><a href="#L-465"><span class="linenos">465</span></a> +</span><span id="L-466"><a href="#L-466"><span class="linenos">466</span></a><span class="k">def</span> <span class="nf">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> +</span><span id="L-467"><a href="#L-467"><span class="linenos">467</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-468"><a href="#L-468"><span class="linenos">468</span></a><span class="sd"> Traverse an expression by it's "scopes".</span> +</span><span id="L-469"><a href="#L-469"><span class="linenos">469</span></a> +</span><span id="L-470"><a href="#L-470"><span class="linenos">470</span></a><span class="sd"> "Scope" represents the current context of a Select statement.</span> +</span><span id="L-471"><a href="#L-471"><span class="linenos">471</span></a> +</span><span id="L-472"><a href="#L-472"><span class="linenos">472</span></a><span class="sd"> This is helpful for optimizing queries, where we need more information than</span> +</span><span id="L-473"><a href="#L-473"><span class="linenos">473</span></a><span class="sd"> the expression tree itself. For example, we might care about the source</span> +</span><span id="L-474"><a href="#L-474"><span class="linenos">474</span></a><span class="sd"> names within a subquery. Returns a list because a generator could result in</span> +</span><span id="L-475"><a href="#L-475"><span class="linenos">475</span></a><span class="sd"> incomplete properties which is confusing.</span> +</span><span id="L-476"><a href="#L-476"><span class="linenos">476</span></a> +</span><span id="L-477"><a href="#L-477"><span class="linenos">477</span></a><span class="sd"> Examples:</span> +</span><span id="L-478"><a href="#L-478"><span class="linenos">478</span></a><span class="sd"> >>> import sqlglot</span> +</span><span id="L-479"><a href="#L-479"><span class="linenos">479</span></a><span class="sd"> >>> expression = sqlglot.parse_one("SELECT a FROM (SELECT a FROM x) AS y")</span> +</span><span id="L-480"><a href="#L-480"><span class="linenos">480</span></a><span class="sd"> >>> scopes = traverse_scope(expression)</span> +</span><span id="L-481"><a href="#L-481"><span class="linenos">481</span></a><span class="sd"> >>> scopes[0].expression.sql(), list(scopes[0].sources)</span> +</span><span id="L-482"><a href="#L-482"><span class="linenos">482</span></a><span class="sd"> ('SELECT a FROM x', ['x'])</span> +</span><span id="L-483"><a href="#L-483"><span class="linenos">483</span></a><span class="sd"> >>> scopes[1].expression.sql(), list(scopes[1].sources)</span> +</span><span id="L-484"><a href="#L-484"><span class="linenos">484</span></a><span class="sd"> ('SELECT a FROM (SELECT a FROM x) AS y', ['y'])</span> +</span><span id="L-485"><a href="#L-485"><span class="linenos">485</span></a> +</span><span id="L-486"><a href="#L-486"><span class="linenos">486</span></a><span class="sd"> Args:</span> +</span><span id="L-487"><a href="#L-487"><span class="linenos">487</span></a><span class="sd"> expression (exp.Expression): expression to traverse</span> +</span><span id="L-488"><a href="#L-488"><span class="linenos">488</span></a><span class="sd"> Returns:</span> +</span><span id="L-489"><a href="#L-489"><span class="linenos">489</span></a><span class="sd"> list[Scope]: scope instances</span> +</span><span id="L-490"><a href="#L-490"><span class="linenos">490</span></a><span class="sd"> """</span> +</span><span id="L-491"><a href="#L-491"><span class="linenos">491</span></a> <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">_traverse_scope</span><span class="p">(</span><span class="n">Scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)))</span> +</span><span id="L-492"><a href="#L-492"><span class="linenos">492</span></a> +</span><span id="L-493"><a href="#L-493"><span class="linenos">493</span></a> +</span><span id="L-494"><a href="#L-494"><span class="linenos">494</span></a><span class="k">def</span> <span class="nf">build_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> +</span><span id="L-495"><a href="#L-495"><span class="linenos">495</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-496"><a href="#L-496"><span class="linenos">496</span></a><span class="sd"> Build a scope tree.</span> +</span><span id="L-497"><a href="#L-497"><span class="linenos">497</span></a> +</span><span id="L-498"><a href="#L-498"><span class="linenos">498</span></a><span class="sd"> Args:</span> +</span><span id="L-499"><a href="#L-499"><span class="linenos">499</span></a><span class="sd"> expression (exp.Expression): expression to build the scope tree for</span> +</span><span id="L-500"><a href="#L-500"><span class="linenos">500</span></a><span class="sd"> Returns:</span> +</span><span id="L-501"><a href="#L-501"><span class="linenos">501</span></a><span class="sd"> Scope: root scope</span> +</span><span id="L-502"><a href="#L-502"><span class="linenos">502</span></a><span class="sd"> """</span> +</span><span id="L-503"><a href="#L-503"><span class="linenos">503</span></a> <span class="k">return</span> <span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span> +</span><span id="L-504"><a href="#L-504"><span class="linenos">504</span></a> +</span><span id="L-505"><a href="#L-505"><span class="linenos">505</span></a> +</span><span id="L-506"><a href="#L-506"><span class="linenos">506</span></a><span class="k">def</span> <span class="nf">_traverse_scope</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> +</span><span id="L-507"><a href="#L-507"><span class="linenos">507</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">):</span> +</span><span id="L-508"><a href="#L-508"><span class="linenos">508</span></a> <span class="k">yield from</span> <span class="n">_traverse_select</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> +</span><span id="L-509"><a href="#L-509"><span class="linenos">509</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> +</span><span id="L-510"><a href="#L-510"><span class="linenos">510</span></a> <span class="k">yield from</span> <span class="n">_traverse_union</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> +</span><span id="L-511"><a href="#L-511"><span class="linenos">511</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">):</span> +</span><span id="L-512"><a href="#L-512"><span class="linenos">512</span></a> <span class="k">yield from</span> <span class="n">_traverse_subqueries</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> +</span><span id="L-513"><a href="#L-513"><span class="linenos">513</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">):</span> +</span><span id="L-514"><a href="#L-514"><span class="linenos">514</span></a> <span class="k">pass</span> +</span><span id="L-515"><a href="#L-515"><span class="linenos">515</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-516"><a href="#L-516"><span class="linenos">516</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Unexpected expression type: </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="L-517"><a href="#L-517"><span class="linenos">517</span></a> <span class="k">yield</span> <span class="n">scope</span> +</span><span id="L-518"><a href="#L-518"><span class="linenos">518</span></a> +</span><span id="L-519"><a href="#L-519"><span class="linenos">519</span></a> +</span><span id="L-520"><a href="#L-520"><span class="linenos">520</span></a><span class="k">def</span> <span class="nf">_traverse_select</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> +</span><span id="L-521"><a href="#L-521"><span class="linenos">521</span></a> <span class="k">yield from</span> <span class="n">_traverse_ctes</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> +</span><span id="L-522"><a href="#L-522"><span class="linenos">522</span></a> <span class="k">yield from</span> <span class="n">_traverse_tables</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> +</span><span id="L-523"><a href="#L-523"><span class="linenos">523</span></a> <span class="k">yield from</span> <span class="n">_traverse_subqueries</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> +</span><span id="L-524"><a href="#L-524"><span class="linenos">524</span></a> </span><span id="L-525"><a href="#L-525"><span class="linenos">525</span></a> -</span><span id="L-526"><a href="#L-526"><span class="linenos">526</span></a> <span class="c1"># The last scope to be yield should be the top most scope</span> -</span><span id="L-527"><a href="#L-527"><span class="linenos">527</span></a> <span class="n">left</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-528"><a href="#L-528"><span class="linenos">528</span></a> <span class="k">for</span> <span class="n">left</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">left</span><span class="p">,</span> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">UNION</span><span class="p">)):</span> -</span><span id="L-529"><a href="#L-529"><span class="linenos">529</span></a> <span class="k">yield</span> <span class="n">left</span> -</span><span id="L-530"><a href="#L-530"><span class="linenos">530</span></a> -</span><span id="L-531"><a href="#L-531"><span class="linenos">531</span></a> <span class="n">right</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-532"><a href="#L-532"><span class="linenos">532</span></a> <span class="k">for</span> <span class="n">right</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">right</span><span class="p">,</span> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">UNION</span><span class="p">)):</span> -</span><span id="L-533"><a href="#L-533"><span class="linenos">533</span></a> <span class="k">yield</span> <span class="n">right</span> -</span><span id="L-534"><a href="#L-534"><span class="linenos">534</span></a> -</span><span id="L-535"><a href="#L-535"><span class="linenos">535</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">union_scopes</span> <span class="o">=</span> <span class="p">[</span><span class="n">left</span><span class="p">,</span> <span class="n">right</span><span class="p">]</span> -</span><span id="L-536"><a href="#L-536"><span class="linenos">536</span></a> +</span><span id="L-526"><a href="#L-526"><span class="linenos">526</span></a><span class="k">def</span> <span class="nf">_traverse_union</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> +</span><span id="L-527"><a href="#L-527"><span class="linenos">527</span></a> <span class="k">yield from</span> <span class="n">_traverse_ctes</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span> +</span><span id="L-528"><a href="#L-528"><span class="linenos">528</span></a> +</span><span id="L-529"><a href="#L-529"><span class="linenos">529</span></a> <span class="c1"># The last scope to be yield should be the top most scope</span> +</span><span id="L-530"><a href="#L-530"><span class="linenos">530</span></a> <span class="n">left</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-531"><a href="#L-531"><span class="linenos">531</span></a> <span class="k">for</span> <span class="n">left</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">left</span><span class="p">,</span> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">UNION</span><span class="p">)):</span> +</span><span id="L-532"><a href="#L-532"><span class="linenos">532</span></a> <span class="k">yield</span> <span class="n">left</span> +</span><span id="L-533"><a href="#L-533"><span class="linenos">533</span></a> +</span><span id="L-534"><a href="#L-534"><span class="linenos">534</span></a> <span class="n">right</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-535"><a href="#L-535"><span class="linenos">535</span></a> <span class="k">for</span> <span class="n">right</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">right</span><span class="p">,</span> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">UNION</span><span class="p">)):</span> +</span><span id="L-536"><a href="#L-536"><span class="linenos">536</span></a> <span class="k">yield</span> <span class="n">right</span> </span><span id="L-537"><a href="#L-537"><span class="linenos">537</span></a> -</span><span id="L-538"><a href="#L-538"><span class="linenos">538</span></a><span class="k">def</span> <span class="nf">_traverse_ctes</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> -</span><span id="L-539"><a href="#L-539"><span class="linenos">539</span></a> <span class="n">sources</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-538"><a href="#L-538"><span class="linenos">538</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">union_scopes</span> <span class="o">=</span> <span class="p">[</span><span class="n">left</span><span class="p">,</span> <span class="n">right</span><span class="p">]</span> +</span><span id="L-539"><a href="#L-539"><span class="linenos">539</span></a> </span><span id="L-540"><a href="#L-540"><span class="linenos">540</span></a> -</span><span id="L-541"><a href="#L-541"><span class="linenos">541</span></a> <span class="k">for</span> <span class="n">cte</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">ctes</span><span class="p">:</span> -</span><span id="L-542"><a href="#L-542"><span class="linenos">542</span></a> <span class="n">recursive_scope</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-541"><a href="#L-541"><span class="linenos">541</span></a><span class="k">def</span> <span class="nf">_traverse_ctes</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> +</span><span id="L-542"><a href="#L-542"><span class="linenos">542</span></a> <span class="n">sources</span> <span class="o">=</span> <span class="p">{}</span> </span><span id="L-543"><a href="#L-543"><span class="linenos">543</span></a> -</span><span id="L-544"><a href="#L-544"><span class="linenos">544</span></a> <span class="c1"># if the scope is a recursive cte, it must be in the form of</span> -</span><span id="L-545"><a href="#L-545"><span class="linenos">545</span></a> <span class="c1"># base_case UNION recursive. thus the recursive scope is the first</span> -</span><span id="L-546"><a href="#L-546"><span class="linenos">546</span></a> <span class="c1"># section of the union.</span> -</span><span id="L-547"><a href="#L-547"><span class="linenos">547</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="s2">"with"</span><span class="p">]</span><span class="o">.</span><span class="n">recursive</span><span class="p">:</span> -</span><span id="L-548"><a href="#L-548"><span class="linenos">548</span></a> <span class="n">union</span> <span class="o">=</span> <span class="n">cte</span><span class="o">.</span><span class="n">this</span> -</span><span id="L-549"><a href="#L-549"><span class="linenos">549</span></a> -</span><span id="L-550"><a href="#L-550"><span class="linenos">550</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">union</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> -</span><span id="L-551"><a href="#L-551"><span class="linenos">551</span></a> <span class="n">recursive_scope</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span><span class="n">union</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">CTE</span><span class="p">)</span> +</span><span id="L-544"><a href="#L-544"><span class="linenos">544</span></a> <span class="k">for</span> <span class="n">cte</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">ctes</span><span class="p">:</span> +</span><span id="L-545"><a href="#L-545"><span class="linenos">545</span></a> <span class="n">recursive_scope</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-546"><a href="#L-546"><span class="linenos">546</span></a> +</span><span id="L-547"><a href="#L-547"><span class="linenos">547</span></a> <span class="c1"># if the scope is a recursive cte, it must be in the form of</span> +</span><span id="L-548"><a href="#L-548"><span class="linenos">548</span></a> <span class="c1"># base_case UNION recursive. thus the recursive scope is the first</span> +</span><span id="L-549"><a href="#L-549"><span class="linenos">549</span></a> <span class="c1"># section of the union.</span> +</span><span id="L-550"><a href="#L-550"><span class="linenos">550</span></a> <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="s2">"with"</span><span class="p">]</span><span class="o">.</span><span class="n">recursive</span><span class="p">:</span> +</span><span id="L-551"><a href="#L-551"><span class="linenos">551</span></a> <span class="n">union</span> <span class="o">=</span> <span class="n">cte</span><span class="o">.</span><span class="n">this</span> </span><span id="L-552"><a href="#L-552"><span class="linenos">552</span></a> -</span><span id="L-553"><a href="#L-553"><span class="linenos">553</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span> -</span><span id="L-554"><a href="#L-554"><span class="linenos">554</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span> -</span><span id="L-555"><a href="#L-555"><span class="linenos">555</span></a> <span class="n">cte</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> -</span><span id="L-556"><a href="#L-556"><span class="linenos">556</span></a> <span class="n">chain_sources</span><span class="o">=</span><span class="n">sources</span><span class="p">,</span> -</span><span id="L-557"><a href="#L-557"><span class="linenos">557</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="n">cte</span><span class="o">.</span><span class="n">alias_column_names</span><span class="p">,</span> -</span><span id="L-558"><a href="#L-558"><span class="linenos">558</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">CTE</span><span class="p">,</span> -</span><span id="L-559"><a href="#L-559"><span class="linenos">559</span></a> <span class="p">)</span> -</span><span id="L-560"><a href="#L-560"><span class="linenos">560</span></a> <span class="p">):</span> -</span><span id="L-561"><a href="#L-561"><span class="linenos">561</span></a> <span class="k">yield</span> <span class="n">child_scope</span> -</span><span id="L-562"><a href="#L-562"><span class="linenos">562</span></a> -</span><span id="L-563"><a href="#L-563"><span class="linenos">563</span></a> <span class="n">alias</span> <span class="o">=</span> <span class="n">cte</span><span class="o">.</span><span class="n">alias</span> -</span><span id="L-564"><a href="#L-564"><span class="linenos">564</span></a> <span class="n">sources</span><span class="p">[</span><span class="n">alias</span><span class="p">]</span> <span class="o">=</span> <span class="n">child_scope</span> +</span><span id="L-553"><a href="#L-553"><span class="linenos">553</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">union</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> +</span><span id="L-554"><a href="#L-554"><span class="linenos">554</span></a> <span class="n">recursive_scope</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span><span class="n">union</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">CTE</span><span class="p">)</span> +</span><span id="L-555"><a href="#L-555"><span class="linenos">555</span></a> +</span><span id="L-556"><a href="#L-556"><span class="linenos">556</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span> +</span><span id="L-557"><a href="#L-557"><span class="linenos">557</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span> +</span><span id="L-558"><a href="#L-558"><span class="linenos">558</span></a> <span class="n">cte</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> +</span><span id="L-559"><a href="#L-559"><span class="linenos">559</span></a> <span class="n">chain_sources</span><span class="o">=</span><span class="n">sources</span><span class="p">,</span> +</span><span id="L-560"><a href="#L-560"><span class="linenos">560</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="n">cte</span><span class="o">.</span><span class="n">alias_column_names</span><span class="p">,</span> +</span><span id="L-561"><a href="#L-561"><span class="linenos">561</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">CTE</span><span class="p">,</span> +</span><span id="L-562"><a href="#L-562"><span class="linenos">562</span></a> <span class="p">)</span> +</span><span id="L-563"><a href="#L-563"><span class="linenos">563</span></a> <span class="p">):</span> +</span><span id="L-564"><a href="#L-564"><span class="linenos">564</span></a> <span class="k">yield</span> <span class="n">child_scope</span> </span><span id="L-565"><a href="#L-565"><span class="linenos">565</span></a> -</span><span id="L-566"><a href="#L-566"><span class="linenos">566</span></a> <span class="k">if</span> <span class="n">recursive_scope</span><span class="p">:</span> -</span><span id="L-567"><a href="#L-567"><span class="linenos">567</span></a> <span class="n">child_scope</span><span class="o">.</span><span class="n">add_source</span><span class="p">(</span><span class="n">alias</span><span class="p">,</span> <span class="n">recursive_scope</span><span class="p">)</span> +</span><span id="L-566"><a href="#L-566"><span class="linenos">566</span></a> <span class="n">alias</span> <span class="o">=</span> <span class="n">cte</span><span class="o">.</span><span class="n">alias</span> +</span><span id="L-567"><a href="#L-567"><span class="linenos">567</span></a> <span class="n">sources</span><span class="p">[</span><span class="n">alias</span><span class="p">]</span> <span class="o">=</span> <span class="n">child_scope</span> </span><span id="L-568"><a href="#L-568"><span class="linenos">568</span></a> -</span><span id="L-569"><a href="#L-569"><span class="linenos">569</span></a> <span class="c1"># append the final child_scope yielded</span> -</span><span id="L-570"><a href="#L-570"><span class="linenos">570</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">cte_scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">child_scope</span><span class="p">)</span> +</span><span id="L-569"><a href="#L-569"><span class="linenos">569</span></a> <span class="k">if</span> <span class="n">recursive_scope</span><span class="p">:</span> +</span><span id="L-570"><a href="#L-570"><span class="linenos">570</span></a> <span class="n">child_scope</span><span class="o">.</span><span class="n">add_source</span><span class="p">(</span><span class="n">alias</span><span class="p">,</span> <span class="n">recursive_scope</span><span class="p">)</span> </span><span id="L-571"><a href="#L-571"><span class="linenos">571</span></a> -</span><span id="L-572"><a href="#L-572"><span class="linenos">572</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">sources</span><span class="p">)</span> -</span><span id="L-573"><a href="#L-573"><span class="linenos">573</span></a> +</span><span id="L-572"><a href="#L-572"><span class="linenos">572</span></a> <span class="c1"># append the final child_scope yielded</span> +</span><span id="L-573"><a href="#L-573"><span class="linenos">573</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">cte_scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">child_scope</span><span class="p">)</span> </span><span id="L-574"><a href="#L-574"><span class="linenos">574</span></a> -</span><span id="L-575"><a href="#L-575"><span class="linenos">575</span></a><span class="k">def</span> <span class="nf">_traverse_tables</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> -</span><span id="L-576"><a href="#L-576"><span class="linenos">576</span></a> <span class="n">sources</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-575"><a href="#L-575"><span class="linenos">575</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">sources</span><span class="p">)</span> +</span><span id="L-576"><a href="#L-576"><span class="linenos">576</span></a> </span><span id="L-577"><a href="#L-577"><span class="linenos">577</span></a> -</span><span id="L-578"><a href="#L-578"><span class="linenos">578</span></a> <span class="c1"># Traverse FROMs, JOINs, and LATERALs in the order they are defined</span> -</span><span id="L-579"><a href="#L-579"><span class="linenos">579</span></a> <span class="n">expressions</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="L-580"><a href="#L-580"><span class="linenos">580</span></a> <span class="n">from_</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"from"</span><span class="p">)</span> -</span><span id="L-581"><a href="#L-581"><span class="linenos">581</span></a> <span class="k">if</span> <span class="n">from_</span><span class="p">:</span> -</span><span id="L-582"><a href="#L-582"><span class="linenos">582</span></a> <span class="n">expressions</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">from_</span><span class="o">.</span><span class="n">expressions</span><span class="p">)</span> -</span><span id="L-583"><a href="#L-583"><span class="linenos">583</span></a> -</span><span id="L-584"><a href="#L-584"><span class="linenos">584</span></a> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"joins"</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[]:</span> -</span><span id="L-585"><a href="#L-585"><span class="linenos">585</span></a> <span class="n">expressions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">join</span><span class="o">.</span><span class="n">this</span><span class="p">)</span> +</span><span id="L-578"><a href="#L-578"><span class="linenos">578</span></a><span class="k">def</span> <span class="nf">_traverse_tables</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> +</span><span id="L-579"><a href="#L-579"><span class="linenos">579</span></a> <span class="n">sources</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="L-580"><a href="#L-580"><span class="linenos">580</span></a> +</span><span id="L-581"><a href="#L-581"><span class="linenos">581</span></a> <span class="c1"># Traverse FROMs, JOINs, and LATERALs in the order they are defined</span> +</span><span id="L-582"><a href="#L-582"><span class="linenos">582</span></a> <span class="n">expressions</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="L-583"><a href="#L-583"><span class="linenos">583</span></a> <span class="n">from_</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"from"</span><span class="p">)</span> +</span><span id="L-584"><a href="#L-584"><span class="linenos">584</span></a> <span class="k">if</span> <span class="n">from_</span><span class="p">:</span> +</span><span id="L-585"><a href="#L-585"><span class="linenos">585</span></a> <span class="n">expressions</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">from_</span><span class="o">.</span><span class="n">expressions</span><span class="p">)</span> </span><span id="L-586"><a href="#L-586"><span class="linenos">586</span></a> -</span><span id="L-587"><a href="#L-587"><span class="linenos">587</span></a> <span class="n">expressions</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"laterals"</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[])</span> -</span><span id="L-588"><a href="#L-588"><span class="linenos">588</span></a> -</span><span id="L-589"><a href="#L-589"><span class="linenos">589</span></a> <span class="k">for</span> <span class="n">expression</span> <span class="ow">in</span> <span class="n">expressions</span><span class="p">:</span> -</span><span id="L-590"><a href="#L-590"><span class="linenos">590</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> -</span><span id="L-591"><a href="#L-591"><span class="linenos">591</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">name</span> -</span><span id="L-592"><a href="#L-592"><span class="linenos">592</span></a> <span class="n">source_name</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">alias_or_name</span> -</span><span id="L-593"><a href="#L-593"><span class="linenos">593</span></a> -</span><span id="L-594"><a href="#L-594"><span class="linenos">594</span></a> <span class="k">if</span> <span class="n">table_name</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> -</span><span id="L-595"><a href="#L-595"><span class="linenos">595</span></a> <span class="c1"># This is a reference to a parent source (e.g. a CTE), not an actual table.</span> -</span><span id="L-596"><a href="#L-596"><span class="linenos">596</span></a> <span class="n">sources</span><span class="p">[</span><span class="n">source_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">table_name</span><span class="p">]</span> -</span><span id="L-597"><a href="#L-597"><span class="linenos">597</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-598"><a href="#L-598"><span class="linenos">598</span></a> <span class="n">sources</span><span class="p">[</span><span class="n">source_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">expression</span> -</span><span id="L-599"><a href="#L-599"><span class="linenos">599</span></a> <span class="k">continue</span> -</span><span id="L-600"><a href="#L-600"><span class="linenos">600</span></a> -</span><span id="L-601"><a href="#L-601"><span class="linenos">601</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">):</span> -</span><span id="L-602"><a href="#L-602"><span class="linenos">602</span></a> <span class="n">lateral_sources</span> <span class="o">=</span> <span class="n">sources</span> -</span><span id="L-603"><a href="#L-603"><span class="linenos">603</span></a> <span class="n">scope_type</span> <span class="o">=</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UDTF</span> -</span><span id="L-604"><a href="#L-604"><span class="linenos">604</span></a> <span class="n">scopes</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">udtf_scopes</span> -</span><span id="L-605"><a href="#L-605"><span class="linenos">605</span></a> <span class="k">else</span><span class="p">:</span> -</span><span id="L-606"><a href="#L-606"><span class="linenos">606</span></a> <span class="n">lateral_sources</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-607"><a href="#L-607"><span class="linenos">607</span></a> <span class="n">scope_type</span> <span class="o">=</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">DERIVED_TABLE</span> -</span><span id="L-608"><a href="#L-608"><span class="linenos">608</span></a> <span class="n">scopes</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">derived_table_scopes</span> -</span><span id="L-609"><a href="#L-609"><span class="linenos">609</span></a> -</span><span id="L-610"><a href="#L-610"><span class="linenos">610</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span> -</span><span id="L-611"><a href="#L-611"><span class="linenos">611</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span> -</span><span id="L-612"><a href="#L-612"><span class="linenos">612</span></a> <span class="n">expression</span><span class="p">,</span> -</span><span id="L-613"><a href="#L-613"><span class="linenos">613</span></a> <span class="n">lateral_sources</span><span class="o">=</span><span class="n">lateral_sources</span><span class="p">,</span> -</span><span id="L-614"><a href="#L-614"><span class="linenos">614</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="n">expression</span><span class="o">.</span><span class="n">alias_column_names</span><span class="p">,</span> -</span><span id="L-615"><a href="#L-615"><span class="linenos">615</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">scope_type</span><span class="p">,</span> -</span><span id="L-616"><a href="#L-616"><span class="linenos">616</span></a> <span class="p">)</span> -</span><span id="L-617"><a href="#L-617"><span class="linenos">617</span></a> <span class="p">):</span> -</span><span id="L-618"><a href="#L-618"><span class="linenos">618</span></a> <span class="k">yield</span> <span class="n">child_scope</span> -</span><span id="L-619"><a href="#L-619"><span class="linenos">619</span></a> -</span><span id="L-620"><a href="#L-620"><span class="linenos">620</span></a> <span class="c1"># Tables without aliases will be set as ""</span> -</span><span id="L-621"><a href="#L-621"><span class="linenos">621</span></a> <span class="c1"># This shouldn't be a problem once qualify_columns runs, as it adds aliases on everything.</span> -</span><span id="L-622"><a href="#L-622"><span class="linenos">622</span></a> <span class="c1"># Until then, this means that only a single, unaliased derived table is allowed (rather,</span> -</span><span id="L-623"><a href="#L-623"><span class="linenos">623</span></a> <span class="c1"># the latest one wins.</span> -</span><span id="L-624"><a href="#L-624"><span class="linenos">624</span></a> <span class="n">alias</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">alias</span> -</span><span id="L-625"><a href="#L-625"><span class="linenos">625</span></a> <span class="n">sources</span><span class="p">[</span><span class="n">alias</span><span class="p">]</span> <span class="o">=</span> <span class="n">child_scope</span> -</span><span id="L-626"><a href="#L-626"><span class="linenos">626</span></a> -</span><span id="L-627"><a href="#L-627"><span class="linenos">627</span></a> <span class="c1"># append the final child_scope yielded</span> -</span><span id="L-628"><a href="#L-628"><span class="linenos">628</span></a> <span class="n">scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">child_scope</span><span class="p">)</span> -</span><span id="L-629"><a href="#L-629"><span class="linenos">629</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">table_scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">child_scope</span><span class="p">)</span> -</span><span id="L-630"><a href="#L-630"><span class="linenos">630</span></a> -</span><span id="L-631"><a href="#L-631"><span class="linenos">631</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">sources</span><span class="p">)</span> -</span><span id="L-632"><a href="#L-632"><span class="linenos">632</span></a> -</span><span id="L-633"><a href="#L-633"><span class="linenos">633</span></a> -</span><span id="L-634"><a href="#L-634"><span class="linenos">634</span></a><span class="k">def</span> <span class="nf">_traverse_subqueries</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> -</span><span id="L-635"><a href="#L-635"><span class="linenos">635</span></a> <span class="k">for</span> <span class="n">subquery</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">subqueries</span><span class="p">:</span> -</span><span id="L-636"><a href="#L-636"><span class="linenos">636</span></a> <span class="n">top</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="L-637"><a href="#L-637"><span class="linenos">637</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span><span class="n">subquery</span><span class="p">,</span> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">SUBQUERY</span><span class="p">)):</span> -</span><span id="L-638"><a href="#L-638"><span class="linenos">638</span></a> <span class="k">yield</span> <span class="n">child_scope</span> -</span><span id="L-639"><a href="#L-639"><span class="linenos">639</span></a> <span class="n">top</span> <span class="o">=</span> <span class="n">child_scope</span> -</span><span id="L-640"><a href="#L-640"><span class="linenos">640</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">subquery_scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">top</span><span class="p">)</span> -</span><span id="L-641"><a href="#L-641"><span class="linenos">641</span></a> -</span><span id="L-642"><a href="#L-642"><span class="linenos">642</span></a> -</span><span id="L-643"><a href="#L-643"><span class="linenos">643</span></a><span class="k">def</span> <span class="nf">walk_in_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="L-644"><a href="#L-644"><span class="linenos">644</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="L-645"><a href="#L-645"><span class="linenos">645</span></a><span class="sd"> Returns a generator object which visits all nodes in the syntrax tree, stopping at</span> -</span><span id="L-646"><a href="#L-646"><span class="linenos">646</span></a><span class="sd"> nodes that start child scopes.</span> +</span><span id="L-587"><a href="#L-587"><span class="linenos">587</span></a> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"joins"</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[]:</span> +</span><span id="L-588"><a href="#L-588"><span class="linenos">588</span></a> <span class="n">expressions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">join</span><span class="o">.</span><span class="n">this</span><span class="p">)</span> +</span><span id="L-589"><a href="#L-589"><span class="linenos">589</span></a> +</span><span id="L-590"><a href="#L-590"><span class="linenos">590</span></a> <span class="n">expressions</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">args</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">"laterals"</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[])</span> +</span><span id="L-591"><a href="#L-591"><span class="linenos">591</span></a> +</span><span id="L-592"><a href="#L-592"><span class="linenos">592</span></a> <span class="k">for</span> <span class="n">expression</span> <span class="ow">in</span> <span class="n">expressions</span><span class="p">:</span> +</span><span id="L-593"><a href="#L-593"><span class="linenos">593</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">):</span> +</span><span id="L-594"><a href="#L-594"><span class="linenos">594</span></a> <span class="n">table_name</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">name</span> +</span><span id="L-595"><a href="#L-595"><span class="linenos">595</span></a> <span class="n">source_name</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">alias_or_name</span> +</span><span id="L-596"><a href="#L-596"><span class="linenos">596</span></a> +</span><span id="L-597"><a href="#L-597"><span class="linenos">597</span></a> <span class="k">if</span> <span class="n">table_name</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="L-598"><a href="#L-598"><span class="linenos">598</span></a> <span class="c1"># This is a reference to a parent source (e.g. a CTE), not an actual table.</span> +</span><span id="L-599"><a href="#L-599"><span class="linenos">599</span></a> <span class="n">sources</span><span class="p">[</span><span class="n">source_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">table_name</span><span class="p">]</span> +</span><span id="L-600"><a href="#L-600"><span class="linenos">600</span></a> <span class="k">elif</span> <span class="n">source_name</span> <span class="ow">in</span> <span class="n">sources</span><span class="p">:</span> +</span><span id="L-601"><a href="#L-601"><span class="linenos">601</span></a> <span class="n">sources</span><span class="p">[</span><span class="n">find_new_name</span><span class="p">(</span><span class="n">sources</span><span class="p">,</span> <span class="n">table_name</span><span class="p">)]</span> <span class="o">=</span> <span class="n">expression</span> +</span><span id="L-602"><a href="#L-602"><span class="linenos">602</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-603"><a href="#L-603"><span class="linenos">603</span></a> <span class="n">sources</span><span class="p">[</span><span class="n">source_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">expression</span> +</span><span id="L-604"><a href="#L-604"><span class="linenos">604</span></a> <span class="k">continue</span> +</span><span id="L-605"><a href="#L-605"><span class="linenos">605</span></a> +</span><span id="L-606"><a href="#L-606"><span class="linenos">606</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">):</span> +</span><span id="L-607"><a href="#L-607"><span class="linenos">607</span></a> <span class="n">lateral_sources</span> <span class="o">=</span> <span class="n">sources</span> +</span><span id="L-608"><a href="#L-608"><span class="linenos">608</span></a> <span class="n">scope_type</span> <span class="o">=</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UDTF</span> +</span><span id="L-609"><a href="#L-609"><span class="linenos">609</span></a> <span class="n">scopes</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">udtf_scopes</span> +</span><span id="L-610"><a href="#L-610"><span class="linenos">610</span></a> <span class="k">else</span><span class="p">:</span> +</span><span id="L-611"><a href="#L-611"><span class="linenos">611</span></a> <span class="n">lateral_sources</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-612"><a href="#L-612"><span class="linenos">612</span></a> <span class="n">scope_type</span> <span class="o">=</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">DERIVED_TABLE</span> +</span><span id="L-613"><a href="#L-613"><span class="linenos">613</span></a> <span class="n">scopes</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">derived_table_scopes</span> +</span><span id="L-614"><a href="#L-614"><span class="linenos">614</span></a> +</span><span id="L-615"><a href="#L-615"><span class="linenos">615</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span> +</span><span id="L-616"><a href="#L-616"><span class="linenos">616</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span> +</span><span id="L-617"><a href="#L-617"><span class="linenos">617</span></a> <span class="n">expression</span><span class="p">,</span> +</span><span id="L-618"><a href="#L-618"><span class="linenos">618</span></a> <span class="n">lateral_sources</span><span class="o">=</span><span class="n">lateral_sources</span><span class="p">,</span> +</span><span id="L-619"><a href="#L-619"><span class="linenos">619</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="n">expression</span><span class="o">.</span><span class="n">alias_column_names</span><span class="p">,</span> +</span><span id="L-620"><a href="#L-620"><span class="linenos">620</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">scope_type</span><span class="p">,</span> +</span><span id="L-621"><a href="#L-621"><span class="linenos">621</span></a> <span class="p">)</span> +</span><span id="L-622"><a href="#L-622"><span class="linenos">622</span></a> <span class="p">):</span> +</span><span id="L-623"><a href="#L-623"><span class="linenos">623</span></a> <span class="k">yield</span> <span class="n">child_scope</span> +</span><span id="L-624"><a href="#L-624"><span class="linenos">624</span></a> +</span><span id="L-625"><a href="#L-625"><span class="linenos">625</span></a> <span class="c1"># Tables without aliases will be set as ""</span> +</span><span id="L-626"><a href="#L-626"><span class="linenos">626</span></a> <span class="c1"># This shouldn't be a problem once qualify_columns runs, as it adds aliases on everything.</span> +</span><span id="L-627"><a href="#L-627"><span class="linenos">627</span></a> <span class="c1"># Until then, this means that only a single, unaliased derived table is allowed (rather,</span> +</span><span id="L-628"><a href="#L-628"><span class="linenos">628</span></a> <span class="c1"># the latest one wins.</span> +</span><span id="L-629"><a href="#L-629"><span class="linenos">629</span></a> <span class="n">alias</span> <span class="o">=</span> <span class="n">expression</span><span class="o">.</span><span class="n">alias</span> +</span><span id="L-630"><a href="#L-630"><span class="linenos">630</span></a> <span class="n">sources</span><span class="p">[</span><span class="n">alias</span><span class="p">]</span> <span class="o">=</span> <span class="n">child_scope</span> +</span><span id="L-631"><a href="#L-631"><span class="linenos">631</span></a> +</span><span id="L-632"><a href="#L-632"><span class="linenos">632</span></a> <span class="c1"># append the final child_scope yielded</span> +</span><span id="L-633"><a href="#L-633"><span class="linenos">633</span></a> <span class="n">scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">child_scope</span><span class="p">)</span> +</span><span id="L-634"><a href="#L-634"><span class="linenos">634</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">table_scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">child_scope</span><span class="p">)</span> +</span><span id="L-635"><a href="#L-635"><span class="linenos">635</span></a> +</span><span id="L-636"><a href="#L-636"><span class="linenos">636</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">sources</span><span class="p">)</span> +</span><span id="L-637"><a href="#L-637"><span class="linenos">637</span></a> +</span><span id="L-638"><a href="#L-638"><span class="linenos">638</span></a> +</span><span id="L-639"><a href="#L-639"><span class="linenos">639</span></a><span class="k">def</span> <span class="nf">_traverse_subqueries</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span> +</span><span id="L-640"><a href="#L-640"><span class="linenos">640</span></a> <span class="k">for</span> <span class="n">subquery</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">subqueries</span><span class="p">:</span> +</span><span id="L-641"><a href="#L-641"><span class="linenos">641</span></a> <span class="n">top</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="L-642"><a href="#L-642"><span class="linenos">642</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">_traverse_scope</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">branch</span><span class="p">(</span><span class="n">subquery</span><span class="p">,</span> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">SUBQUERY</span><span class="p">)):</span> +</span><span id="L-643"><a href="#L-643"><span class="linenos">643</span></a> <span class="k">yield</span> <span class="n">child_scope</span> +</span><span id="L-644"><a href="#L-644"><span class="linenos">644</span></a> <span class="n">top</span> <span class="o">=</span> <span class="n">child_scope</span> +</span><span id="L-645"><a href="#L-645"><span class="linenos">645</span></a> <span class="n">scope</span><span class="o">.</span><span class="n">subquery_scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">top</span><span class="p">)</span> +</span><span id="L-646"><a href="#L-646"><span class="linenos">646</span></a> </span><span id="L-647"><a href="#L-647"><span class="linenos">647</span></a> -</span><span id="L-648"><a href="#L-648"><span class="linenos">648</span></a><span class="sd"> Args:</span> -</span><span id="L-649"><a href="#L-649"><span class="linenos">649</span></a><span class="sd"> expression (exp.Expression):</span> -</span><span id="L-650"><a href="#L-650"><span class="linenos">650</span></a><span class="sd"> bfs (bool): if set to True the BFS traversal order will be applied,</span> -</span><span id="L-651"><a href="#L-651"><span class="linenos">651</span></a><span class="sd"> otherwise the DFS traversal will be used instead.</span> +</span><span id="L-648"><a href="#L-648"><span class="linenos">648</span></a><span class="k">def</span> <span class="nf">walk_in_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="L-649"><a href="#L-649"><span class="linenos">649</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="L-650"><a href="#L-650"><span class="linenos">650</span></a><span class="sd"> Returns a generator object which visits all nodes in the syntrax tree, stopping at</span> +</span><span id="L-651"><a href="#L-651"><span class="linenos">651</span></a><span class="sd"> nodes that start child scopes.</span> </span><span id="L-652"><a href="#L-652"><span class="linenos">652</span></a> -</span><span id="L-653"><a href="#L-653"><span class="linenos">653</span></a><span class="sd"> Yields:</span> -</span><span id="L-654"><a href="#L-654"><span class="linenos">654</span></a><span class="sd"> tuple[exp.Expression, Optional[exp.Expression], str]: node, parent, arg key</span> -</span><span id="L-655"><a href="#L-655"><span class="linenos">655</span></a><span class="sd"> """</span> -</span><span id="L-656"><a href="#L-656"><span class="linenos">656</span></a> <span class="c1"># We'll use this variable to pass state into the dfs generator.</span> -</span><span id="L-657"><a href="#L-657"><span class="linenos">657</span></a> <span class="c1"># Whenever we set it to True, we exclude a subtree from traversal.</span> -</span><span id="L-658"><a href="#L-658"><span class="linenos">658</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="L-659"><a href="#L-659"><span class="linenos">659</span></a> -</span><span id="L-660"><a href="#L-660"><span class="linenos">660</span></a> <span class="k">for</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">expression</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">,</span> <span class="n">prune</span><span class="o">=</span><span class="k">lambda</span> <span class="o">*</span><span class="n">_</span><span class="p">:</span> <span class="n">prune</span><span class="p">):</span> -</span><span id="L-661"><a href="#L-661"><span class="linenos">661</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="L-662"><a href="#L-662"><span class="linenos">662</span></a> -</span><span id="L-663"><a href="#L-663"><span class="linenos">663</span></a> <span class="k">yield</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">key</span> +</span><span id="L-653"><a href="#L-653"><span class="linenos">653</span></a><span class="sd"> Args:</span> +</span><span id="L-654"><a href="#L-654"><span class="linenos">654</span></a><span class="sd"> expression (exp.Expression):</span> +</span><span id="L-655"><a href="#L-655"><span class="linenos">655</span></a><span class="sd"> bfs (bool): if set to True the BFS traversal order will be applied,</span> +</span><span id="L-656"><a href="#L-656"><span class="linenos">656</span></a><span class="sd"> otherwise the DFS traversal will be used instead.</span> +</span><span id="L-657"><a href="#L-657"><span class="linenos">657</span></a> +</span><span id="L-658"><a href="#L-658"><span class="linenos">658</span></a><span class="sd"> Yields:</span> +</span><span id="L-659"><a href="#L-659"><span class="linenos">659</span></a><span class="sd"> tuple[exp.Expression, Optional[exp.Expression], str]: node, parent, arg key</span> +</span><span id="L-660"><a href="#L-660"><span class="linenos">660</span></a><span class="sd"> """</span> +</span><span id="L-661"><a href="#L-661"><span class="linenos">661</span></a> <span class="c1"># We'll use this variable to pass state into the dfs generator.</span> +</span><span id="L-662"><a href="#L-662"><span class="linenos">662</span></a> <span class="c1"># Whenever we set it to True, we exclude a subtree from traversal.</span> +</span><span id="L-663"><a href="#L-663"><span class="linenos">663</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">False</span> </span><span id="L-664"><a href="#L-664"><span class="linenos">664</span></a> -</span><span id="L-665"><a href="#L-665"><span class="linenos">665</span></a> <span class="k">if</span> <span class="n">node</span> <span class="ow">is</span> <span class="n">expression</span><span class="p">:</span> -</span><span id="L-666"><a href="#L-666"><span class="linenos">666</span></a> <span class="k">continue</span> -</span><span id="L-667"><a href="#L-667"><span class="linenos">667</span></a> <span class="k">if</span> <span class="p">(</span> -</span><span id="L-668"><a href="#L-668"><span class="linenos">668</span></a> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">CTE</span><span class="p">)</span> -</span><span id="L-669"><a href="#L-669"><span class="linenos">669</span></a> <span class="ow">or</span> <span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">parent</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">From</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">)))</span> -</span><span id="L-670"><a href="#L-670"><span class="linenos">670</span></a> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">)</span> -</span><span id="L-671"><a href="#L-671"><span class="linenos">671</span></a> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">)</span> -</span><span id="L-672"><a href="#L-672"><span class="linenos">672</span></a> <span class="p">):</span> -</span><span id="L-673"><a href="#L-673"><span class="linenos">673</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">True</span> +</span><span id="L-665"><a href="#L-665"><span class="linenos">665</span></a> <span class="k">for</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">expression</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">,</span> <span class="n">prune</span><span class="o">=</span><span class="k">lambda</span> <span class="o">*</span><span class="n">_</span><span class="p">:</span> <span class="n">prune</span><span class="p">):</span> +</span><span id="L-666"><a href="#L-666"><span class="linenos">666</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">False</span> +</span><span id="L-667"><a href="#L-667"><span class="linenos">667</span></a> +</span><span id="L-668"><a href="#L-668"><span class="linenos">668</span></a> <span class="k">yield</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">key</span> +</span><span id="L-669"><a href="#L-669"><span class="linenos">669</span></a> +</span><span id="L-670"><a href="#L-670"><span class="linenos">670</span></a> <span class="k">if</span> <span class="n">node</span> <span class="ow">is</span> <span class="n">expression</span><span class="p">:</span> +</span><span id="L-671"><a href="#L-671"><span class="linenos">671</span></a> <span class="k">continue</span> +</span><span id="L-672"><a href="#L-672"><span class="linenos">672</span></a> <span class="k">if</span> <span class="p">(</span> +</span><span id="L-673"><a href="#L-673"><span class="linenos">673</span></a> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">CTE</span><span class="p">)</span> +</span><span id="L-674"><a href="#L-674"><span class="linenos">674</span></a> <span class="ow">or</span> <span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">parent</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">From</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">)))</span> +</span><span id="L-675"><a href="#L-675"><span class="linenos">675</span></a> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">)</span> +</span><span id="L-676"><a href="#L-676"><span class="linenos">676</span></a> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">)</span> +</span><span id="L-677"><a href="#L-677"><span class="linenos">677</span></a> <span class="p">):</span> +</span><span id="L-678"><a href="#L-678"><span class="linenos">678</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">True</span> </span></pre></div> @@ -876,13 +881,13 @@ </div> <a class="headerlink" href="#ScopeType"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="ScopeType-10"><a href="#ScopeType-10"><span class="linenos">10</span></a><span class="k">class</span> <span class="nc">ScopeType</span><span class="p">(</span><span class="n">Enum</span><span class="p">):</span> -</span><span id="ScopeType-11"><a href="#ScopeType-11"><span class="linenos">11</span></a> <span class="n">ROOT</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="ScopeType-12"><a href="#ScopeType-12"><span class="linenos">12</span></a> <span class="n">SUBQUERY</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="ScopeType-13"><a href="#ScopeType-13"><span class="linenos">13</span></a> <span class="n">DERIVED_TABLE</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="ScopeType-14"><a href="#ScopeType-14"><span class="linenos">14</span></a> <span class="n">CTE</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="ScopeType-15"><a href="#ScopeType-15"><span class="linenos">15</span></a> <span class="n">UNION</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> -</span><span id="ScopeType-16"><a href="#ScopeType-16"><span class="linenos">16</span></a> <span class="n">UDTF</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="ScopeType-11"><a href="#ScopeType-11"><span class="linenos">11</span></a><span class="k">class</span> <span class="nc">ScopeType</span><span class="p">(</span><span class="n">Enum</span><span class="p">):</span> +</span><span id="ScopeType-12"><a href="#ScopeType-12"><span class="linenos">12</span></a> <span class="n">ROOT</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="ScopeType-13"><a href="#ScopeType-13"><span class="linenos">13</span></a> <span class="n">SUBQUERY</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="ScopeType-14"><a href="#ScopeType-14"><span class="linenos">14</span></a> <span class="n">DERIVED_TABLE</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="ScopeType-15"><a href="#ScopeType-15"><span class="linenos">15</span></a> <span class="n">CTE</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="ScopeType-16"><a href="#ScopeType-16"><span class="linenos">16</span></a> <span class="n">UNION</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> +</span><span id="ScopeType-17"><a href="#ScopeType-17"><span class="linenos">17</span></a> <span class="n">UDTF</span> <span class="o">=</span> <span class="n">auto</span><span class="p">()</span> </span></pre></div> @@ -984,449 +989,451 @@ </div> <a class="headerlink" href="#Scope"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope-19"><a href="#Scope-19"><span class="linenos"> 19</span></a><span class="k">class</span> <span class="nc">Scope</span><span class="p">:</span> -</span><span id="Scope-20"><a href="#Scope-20"><span class="linenos"> 20</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-21"><a href="#Scope-21"><span class="linenos"> 21</span></a><span class="sd"> Selection scope.</span> -</span><span id="Scope-22"><a href="#Scope-22"><span class="linenos"> 22</span></a> -</span><span id="Scope-23"><a href="#Scope-23"><span class="linenos"> 23</span></a><span class="sd"> Attributes:</span> -</span><span id="Scope-24"><a href="#Scope-24"><span class="linenos"> 24</span></a><span class="sd"> expression (exp.Select|exp.Union): Root expression of this scope</span> -</span><span id="Scope-25"><a href="#Scope-25"><span class="linenos"> 25</span></a><span class="sd"> sources (dict[str, exp.Table|Scope]): Mapping of source name to either</span> -</span><span id="Scope-26"><a href="#Scope-26"><span class="linenos"> 26</span></a><span class="sd"> a Table expression or another Scope instance. For example:</span> -</span><span id="Scope-27"><a href="#Scope-27"><span class="linenos"> 27</span></a><span class="sd"> SELECT * FROM x {"x": Table(this="x")}</span> -</span><span id="Scope-28"><a href="#Scope-28"><span class="linenos"> 28</span></a><span class="sd"> SELECT * FROM x AS y {"y": Table(this="x")}</span> -</span><span id="Scope-29"><a href="#Scope-29"><span class="linenos"> 29</span></a><span class="sd"> SELECT * FROM (SELECT ...) AS y {"y": Scope(...)}</span> -</span><span id="Scope-30"><a href="#Scope-30"><span class="linenos"> 30</span></a><span class="sd"> lateral_sources (dict[str, exp.Table|Scope]): Sources from laterals</span> -</span><span id="Scope-31"><a href="#Scope-31"><span class="linenos"> 31</span></a><span class="sd"> For example:</span> -</span><span id="Scope-32"><a href="#Scope-32"><span class="linenos"> 32</span></a><span class="sd"> SELECT c FROM x LATERAL VIEW EXPLODE (a) AS c;</span> -</span><span id="Scope-33"><a href="#Scope-33"><span class="linenos"> 33</span></a><span class="sd"> The LATERAL VIEW EXPLODE gets x as a source.</span> -</span><span id="Scope-34"><a href="#Scope-34"><span class="linenos"> 34</span></a><span class="sd"> outer_column_list (list[str]): If this is a derived table or CTE, and the outer query</span> -</span><span id="Scope-35"><a href="#Scope-35"><span class="linenos"> 35</span></a><span class="sd"> defines a column list of it's alias of this scope, this is that list of columns.</span> -</span><span id="Scope-36"><a href="#Scope-36"><span class="linenos"> 36</span></a><span class="sd"> For example:</span> -</span><span id="Scope-37"><a href="#Scope-37"><span class="linenos"> 37</span></a><span class="sd"> SELECT * FROM (SELECT ...) AS y(col1, col2)</span> -</span><span id="Scope-38"><a href="#Scope-38"><span class="linenos"> 38</span></a><span class="sd"> The inner query would have `["col1", "col2"]` for its `outer_column_list`</span> -</span><span id="Scope-39"><a href="#Scope-39"><span class="linenos"> 39</span></a><span class="sd"> parent (Scope): Parent scope</span> -</span><span id="Scope-40"><a href="#Scope-40"><span class="linenos"> 40</span></a><span class="sd"> scope_type (ScopeType): Type of this scope, relative to it's parent</span> -</span><span id="Scope-41"><a href="#Scope-41"><span class="linenos"> 41</span></a><span class="sd"> subquery_scopes (list[Scope]): List of all child scopes for subqueries</span> -</span><span id="Scope-42"><a href="#Scope-42"><span class="linenos"> 42</span></a><span class="sd"> cte_scopes (list[Scope]): List of all child scopes for CTEs</span> -</span><span id="Scope-43"><a href="#Scope-43"><span class="linenos"> 43</span></a><span class="sd"> derived_table_scopes (list[Scope]): List of all child scopes for derived_tables</span> -</span><span id="Scope-44"><a href="#Scope-44"><span class="linenos"> 44</span></a><span class="sd"> udtf_scopes (list[Scope]): List of all child scopes for user defined tabular functions</span> -</span><span id="Scope-45"><a href="#Scope-45"><span class="linenos"> 45</span></a><span class="sd"> table_scopes (list[Scope]): derived_table_scopes + udtf_scopes, in the order that they're defined</span> -</span><span id="Scope-46"><a href="#Scope-46"><span class="linenos"> 46</span></a><span class="sd"> union_scopes (list[Scope, Scope]): If this Scope is for a Union expression, this will be</span> -</span><span id="Scope-47"><a href="#Scope-47"><span class="linenos"> 47</span></a><span class="sd"> a list of the left and right child scopes.</span> -</span><span id="Scope-48"><a href="#Scope-48"><span class="linenos"> 48</span></a><span class="sd"> """</span> -</span><span id="Scope-49"><a href="#Scope-49"><span class="linenos"> 49</span></a> -</span><span id="Scope-50"><a href="#Scope-50"><span class="linenos"> 50</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> -</span><span id="Scope-51"><a href="#Scope-51"><span class="linenos"> 51</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="Scope-52"><a href="#Scope-52"><span class="linenos"> 52</span></a> <span class="n">expression</span><span class="p">,</span> -</span><span id="Scope-53"><a href="#Scope-53"><span class="linenos"> 53</span></a> <span class="n">sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="Scope-54"><a href="#Scope-54"><span class="linenos"> 54</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="Scope-55"><a href="#Scope-55"><span class="linenos"> 55</span></a> <span class="n">parent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="Scope-56"><a href="#Scope-56"><span class="linenos"> 56</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span><span class="p">,</span> -</span><span id="Scope-57"><a href="#Scope-57"><span class="linenos"> 57</span></a> <span class="n">lateral_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="Scope-58"><a href="#Scope-58"><span class="linenos"> 58</span></a> <span class="p">):</span> -</span><span id="Scope-59"><a href="#Scope-59"><span class="linenos"> 59</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span> <span class="o">=</span> <span class="n">expression</span> -</span><span id="Scope-60"><a href="#Scope-60"><span class="linenos"> 60</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span> <span class="o">=</span> <span class="n">sources</span> <span class="ow">or</span> <span class="p">{}</span> -</span><span id="Scope-61"><a href="#Scope-61"><span class="linenos"> 61</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span> <span class="o">=</span> <span class="n">lateral_sources</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span> <span class="k">if</span> <span class="n">lateral_sources</span> <span class="k">else</span> <span class="p">{}</span> -</span><span id="Scope-62"><a href="#Scope-62"><span class="linenos"> 62</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> -</span><span id="Scope-63"><a href="#Scope-63"><span class="linenos"> 63</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">outer_column_list</span> <span class="o">=</span> <span class="n">outer_column_list</span> <span class="ow">or</span> <span class="p">[]</span> -</span><span id="Scope-64"><a href="#Scope-64"><span class="linenos"> 64</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">parent</span> <span class="o">=</span> <span class="n">parent</span> -</span><span id="Scope-65"><a href="#Scope-65"><span class="linenos"> 65</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">=</span> <span class="n">scope_type</span> -</span><span id="Scope-66"><a href="#Scope-66"><span class="linenos"> 66</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-67"><a href="#Scope-67"><span class="linenos"> 67</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">derived_table_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-68"><a href="#Scope-68"><span class="linenos"> 68</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-69"><a href="#Scope-69"><span class="linenos"> 69</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-70"><a href="#Scope-70"><span class="linenos"> 70</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-71"><a href="#Scope-71"><span class="linenos"> 71</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-72"><a href="#Scope-72"><span class="linenos"> 72</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="Scope-73"><a href="#Scope-73"><span class="linenos"> 73</span></a> -</span><span id="Scope-74"><a href="#Scope-74"><span class="linenos"> 74</span></a> <span class="k">def</span> <span class="nf">clear_cache</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-75"><a href="#Scope-75"><span class="linenos"> 75</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="Scope-76"><a href="#Scope-76"><span class="linenos"> 76</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-77"><a href="#Scope-77"><span class="linenos"> 77</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-78"><a href="#Scope-78"><span class="linenos"> 78</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-79"><a href="#Scope-79"><span class="linenos"> 79</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-80"><a href="#Scope-80"><span class="linenos"> 80</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-81"><a href="#Scope-81"><span class="linenos"> 81</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-82"><a href="#Scope-82"><span class="linenos"> 82</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-83"><a href="#Scope-83"><span class="linenos"> 83</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-84"><a href="#Scope-84"><span class="linenos"> 84</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-85"><a href="#Scope-85"><span class="linenos"> 85</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope-86"><a href="#Scope-86"><span class="linenos"> 86</span></a> -</span><span id="Scope-87"><a href="#Scope-87"><span class="linenos"> 87</span></a> <span class="k">def</span> <span class="nf">branch</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">expression</span><span class="p">,</span> <span class="n">scope_type</span><span class="p">,</span> <span class="n">chain_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span> -</span><span id="Scope-88"><a href="#Scope-88"><span class="linenos"> 88</span></a><span class="w"> </span><span class="sd">"""Branch from the current scope to a new, inner scope"""</span> -</span><span id="Scope-89"><a href="#Scope-89"><span class="linenos"> 89</span></a> <span class="k">return</span> <span class="n">Scope</span><span class="p">(</span> -</span><span id="Scope-90"><a href="#Scope-90"><span class="linenos"> 90</span></a> <span class="n">expression</span><span class="o">=</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">(),</span> -</span><span id="Scope-91"><a href="#Scope-91"><span class="linenos"> 91</span></a> <span class="n">sources</span><span class="o">=</span><span class="p">{</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">cte_sources</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">chain_sources</span> <span class="ow">or</span> <span class="p">{})},</span> -</span><span id="Scope-92"><a href="#Scope-92"><span class="linenos"> 92</span></a> <span class="n">parent</span><span class="o">=</span><span class="bp">self</span><span class="p">,</span> -</span><span id="Scope-93"><a href="#Scope-93"><span class="linenos"> 93</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">scope_type</span><span class="p">,</span> -</span><span id="Scope-94"><a href="#Scope-94"><span class="linenos"> 94</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> -</span><span id="Scope-95"><a href="#Scope-95"><span class="linenos"> 95</span></a> <span class="p">)</span> -</span><span id="Scope-96"><a href="#Scope-96"><span class="linenos"> 96</span></a> -</span><span id="Scope-97"><a href="#Scope-97"><span class="linenos"> 97</span></a> <span class="k">def</span> <span class="nf">_collect</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-98"><a href="#Scope-98"><span class="linenos"> 98</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-99"><a href="#Scope-99"><span class="linenos"> 99</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-100"><a href="#Scope-100"><span class="linenos">100</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-101"><a href="#Scope-101"><span class="linenos">101</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-102"><a href="#Scope-102"><span class="linenos">102</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-103"><a href="#Scope-103"><span class="linenos">103</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-104"><a href="#Scope-104"><span class="linenos">104</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-105"><a href="#Scope-105"><span class="linenos">105</span></a> -</span><span id="Scope-106"><a href="#Scope-106"><span class="linenos">106</span></a> <span class="k">for</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> -</span><span id="Scope-107"><a href="#Scope-107"><span class="linenos">107</span></a> <span class="k">if</span> <span class="n">node</span> <span class="ow">is</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">:</span> -</span><span id="Scope-108"><a href="#Scope-108"><span class="linenos">108</span></a> <span class="k">continue</span> -</span><span id="Scope-109"><a href="#Scope-109"><span class="linenos">109</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Star</span><span class="p">):</span> -</span><span id="Scope-110"><a href="#Scope-110"><span class="linenos">110</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="Scope-111"><a href="#Scope-111"><span class="linenos">111</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">JoinHint</span><span class="p">):</span> -</span><span id="Scope-112"><a href="#Scope-112"><span class="linenos">112</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="Scope-113"><a href="#Scope-113"><span class="linenos">113</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">JoinHint</span><span class="p">):</span> -</span><span id="Scope-114"><a href="#Scope-114"><span class="linenos">114</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="Scope-115"><a href="#Scope-115"><span class="linenos">115</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">):</span> -</span><span id="Scope-116"><a href="#Scope-116"><span class="linenos">116</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="Scope-117"><a href="#Scope-117"><span class="linenos">117</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">CTE</span><span class="p">):</span> -</span><span id="Scope-118"><a href="#Scope-118"><span class="linenos">118</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="Scope-119"><a href="#Scope-119"><span class="linenos">119</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">parent</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">From</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">)):</span> -</span><span id="Scope-120"><a href="#Scope-120"><span class="linenos">120</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="Scope-121"><a href="#Scope-121"><span class="linenos">121</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> -</span><span id="Scope-122"><a href="#Scope-122"><span class="linenos">122</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> -</span><span id="Scope-123"><a href="#Scope-123"><span class="linenos">123</span></a> -</span><span id="Scope-124"><a href="#Scope-124"><span class="linenos">124</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">True</span> -</span><span id="Scope-125"><a href="#Scope-125"><span class="linenos">125</span></a> -</span><span id="Scope-126"><a href="#Scope-126"><span class="linenos">126</span></a> <span class="k">def</span> <span class="nf">_ensure_collected</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-127"><a href="#Scope-127"><span class="linenos">127</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span><span class="p">:</span> -</span><span id="Scope-128"><a href="#Scope-128"><span class="linenos">128</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collect</span><span class="p">()</span> -</span><span id="Scope-129"><a href="#Scope-129"><span class="linenos">129</span></a> -</span><span id="Scope-130"><a href="#Scope-130"><span class="linenos">130</span></a> <span class="k">def</span> <span class="nf">walk</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="Scope-131"><a href="#Scope-131"><span class="linenos">131</span></a> <span class="k">return</span> <span class="n">walk_in_scope</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">)</span> -</span><span id="Scope-132"><a href="#Scope-132"><span class="linenos">132</span></a> -</span><span id="Scope-133"><a href="#Scope-133"><span class="linenos">133</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="Scope-134"><a href="#Scope-134"><span class="linenos">134</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-135"><a href="#Scope-135"><span class="linenos">135</span></a><span class="sd"> Returns the first node in this scope which matches at least one of the specified types.</span> -</span><span id="Scope-136"><a href="#Scope-136"><span class="linenos">136</span></a> -</span><span id="Scope-137"><a href="#Scope-137"><span class="linenos">137</span></a><span class="sd"> This does NOT traverse into subscopes.</span> -</span><span id="Scope-138"><a href="#Scope-138"><span class="linenos">138</span></a> -</span><span id="Scope-139"><a href="#Scope-139"><span class="linenos">139</span></a><span class="sd"> Args:</span> -</span><span id="Scope-140"><a href="#Scope-140"><span class="linenos">140</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> -</span><span id="Scope-141"><a href="#Scope-141"><span class="linenos">141</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> -</span><span id="Scope-142"><a href="#Scope-142"><span class="linenos">142</span></a> -</span><span id="Scope-143"><a href="#Scope-143"><span class="linenos">143</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-144"><a href="#Scope-144"><span class="linenos">144</span></a><span class="sd"> exp.Expression: the node which matches the criteria or None if no node matching</span> -</span><span id="Scope-145"><a href="#Scope-145"><span class="linenos">145</span></a><span class="sd"> the criteria was found.</span> -</span><span id="Scope-146"><a href="#Scope-146"><span class="linenos">146</span></a><span class="sd"> """</span> -</span><span id="Scope-147"><a href="#Scope-147"><span class="linenos">147</span></a> <span class="k">return</span> <span class="nb">next</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">),</span> <span class="kc">None</span><span class="p">)</span> -</span><span id="Scope-148"><a href="#Scope-148"><span class="linenos">148</span></a> -</span><span id="Scope-149"><a href="#Scope-149"><span class="linenos">149</span></a> <span class="k">def</span> <span class="nf">find_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="Scope-150"><a href="#Scope-150"><span class="linenos">150</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-151"><a href="#Scope-151"><span class="linenos">151</span></a><span class="sd"> Returns a generator object which visits all nodes in this scope and only yields those that</span> -</span><span id="Scope-152"><a href="#Scope-152"><span class="linenos">152</span></a><span class="sd"> match at least one of the specified expression types.</span> -</span><span id="Scope-153"><a href="#Scope-153"><span class="linenos">153</span></a> -</span><span id="Scope-154"><a href="#Scope-154"><span class="linenos">154</span></a><span class="sd"> This does NOT traverse into subscopes.</span> -</span><span id="Scope-155"><a href="#Scope-155"><span class="linenos">155</span></a> -</span><span id="Scope-156"><a href="#Scope-156"><span class="linenos">156</span></a><span class="sd"> Args:</span> -</span><span id="Scope-157"><a href="#Scope-157"><span class="linenos">157</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> -</span><span id="Scope-158"><a href="#Scope-158"><span class="linenos">158</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> -</span><span id="Scope-159"><a href="#Scope-159"><span class="linenos">159</span></a> -</span><span id="Scope-160"><a href="#Scope-160"><span class="linenos">160</span></a><span class="sd"> Yields:</span> -</span><span id="Scope-161"><a href="#Scope-161"><span class="linenos">161</span></a><span class="sd"> exp.Expression: nodes</span> -</span><span id="Scope-162"><a href="#Scope-162"><span class="linenos">162</span></a><span class="sd"> """</span> -</span><span id="Scope-163"><a href="#Scope-163"><span class="linenos">163</span></a> <span class="k">for</span> <span class="n">expression</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">):</span> -</span><span id="Scope-164"><a href="#Scope-164"><span class="linenos">164</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">expression_types</span><span class="p">):</span> -</span><span id="Scope-165"><a href="#Scope-165"><span class="linenos">165</span></a> <span class="k">yield</span> <span class="n">expression</span> -</span><span id="Scope-166"><a href="#Scope-166"><span class="linenos">166</span></a> -</span><span id="Scope-167"><a href="#Scope-167"><span class="linenos">167</span></a> <span class="k">def</span> <span class="nf">replace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span> -</span><span id="Scope-168"><a href="#Scope-168"><span class="linenos">168</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-169"><a href="#Scope-169"><span class="linenos">169</span></a><span class="sd"> Replace `old` with `new`.</span> -</span><span id="Scope-170"><a href="#Scope-170"><span class="linenos">170</span></a> -</span><span id="Scope-171"><a href="#Scope-171"><span class="linenos">171</span></a><span class="sd"> This can be used instead of `exp.Expression.replace` to ensure the `Scope` is kept up-to-date.</span> -</span><span id="Scope-172"><a href="#Scope-172"><span class="linenos">172</span></a> -</span><span id="Scope-173"><a href="#Scope-173"><span class="linenos">173</span></a><span class="sd"> Args:</span> -</span><span id="Scope-174"><a href="#Scope-174"><span class="linenos">174</span></a><span class="sd"> old (exp.Expression): old node</span> -</span><span id="Scope-175"><a href="#Scope-175"><span class="linenos">175</span></a><span class="sd"> new (exp.Expression): new node</span> -</span><span id="Scope-176"><a href="#Scope-176"><span class="linenos">176</span></a><span class="sd"> """</span> -</span><span id="Scope-177"><a href="#Scope-177"><span class="linenos">177</span></a> <span class="n">old</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> -</span><span id="Scope-178"><a href="#Scope-178"><span class="linenos">178</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="Scope-179"><a href="#Scope-179"><span class="linenos">179</span></a> -</span><span id="Scope-180"><a href="#Scope-180"><span class="linenos">180</span></a> <span class="nd">@property</span> -</span><span id="Scope-181"><a href="#Scope-181"><span class="linenos">181</span></a> <span class="k">def</span> <span class="nf">tables</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-182"><a href="#Scope-182"><span class="linenos">182</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-183"><a href="#Scope-183"><span class="linenos">183</span></a><span class="sd"> List of tables in this scope.</span> -</span><span id="Scope-184"><a href="#Scope-184"><span class="linenos">184</span></a> -</span><span id="Scope-185"><a href="#Scope-185"><span class="linenos">185</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-186"><a href="#Scope-186"><span class="linenos">186</span></a><span class="sd"> list[exp.Table]: tables</span> -</span><span id="Scope-187"><a href="#Scope-187"><span class="linenos">187</span></a><span class="sd"> """</span> -</span><span id="Scope-188"><a href="#Scope-188"><span class="linenos">188</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="Scope-189"><a href="#Scope-189"><span class="linenos">189</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> -</span><span id="Scope-190"><a href="#Scope-190"><span class="linenos">190</span></a> -</span><span id="Scope-191"><a href="#Scope-191"><span class="linenos">191</span></a> <span class="nd">@property</span> -</span><span id="Scope-192"><a href="#Scope-192"><span class="linenos">192</span></a> <span class="k">def</span> <span class="nf">ctes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-193"><a href="#Scope-193"><span class="linenos">193</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-194"><a href="#Scope-194"><span class="linenos">194</span></a><span class="sd"> List of CTEs in this scope.</span> -</span><span id="Scope-195"><a href="#Scope-195"><span class="linenos">195</span></a> -</span><span id="Scope-196"><a href="#Scope-196"><span class="linenos">196</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-197"><a href="#Scope-197"><span class="linenos">197</span></a><span class="sd"> list[exp.CTE]: ctes</span> -</span><span id="Scope-198"><a href="#Scope-198"><span class="linenos">198</span></a><span class="sd"> """</span> -</span><span id="Scope-199"><a href="#Scope-199"><span class="linenos">199</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="Scope-200"><a href="#Scope-200"><span class="linenos">200</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> -</span><span id="Scope-201"><a href="#Scope-201"><span class="linenos">201</span></a> -</span><span id="Scope-202"><a href="#Scope-202"><span class="linenos">202</span></a> <span class="nd">@property</span> -</span><span id="Scope-203"><a href="#Scope-203"><span class="linenos">203</span></a> <span class="k">def</span> <span class="nf">derived_tables</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-204"><a href="#Scope-204"><span class="linenos">204</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-205"><a href="#Scope-205"><span class="linenos">205</span></a><span class="sd"> List of derived tables in this scope.</span> -</span><span id="Scope-206"><a href="#Scope-206"><span class="linenos">206</span></a> -</span><span id="Scope-207"><a href="#Scope-207"><span class="linenos">207</span></a><span class="sd"> For example:</span> -</span><span id="Scope-208"><a href="#Scope-208"><span class="linenos">208</span></a><span class="sd"> SELECT * FROM (SELECT ...) <- that's a derived table</span> -</span><span id="Scope-209"><a href="#Scope-209"><span class="linenos">209</span></a> -</span><span id="Scope-210"><a href="#Scope-210"><span class="linenos">210</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-211"><a href="#Scope-211"><span class="linenos">211</span></a><span class="sd"> list[exp.Subquery]: derived tables</span> -</span><span id="Scope-212"><a href="#Scope-212"><span class="linenos">212</span></a><span class="sd"> """</span> -</span><span id="Scope-213"><a href="#Scope-213"><span class="linenos">213</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="Scope-214"><a href="#Scope-214"><span class="linenos">214</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> -</span><span id="Scope-215"><a href="#Scope-215"><span class="linenos">215</span></a> -</span><span id="Scope-216"><a href="#Scope-216"><span class="linenos">216</span></a> <span class="nd">@property</span> -</span><span id="Scope-217"><a href="#Scope-217"><span class="linenos">217</span></a> <span class="k">def</span> <span class="nf">udtfs</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-218"><a href="#Scope-218"><span class="linenos">218</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-219"><a href="#Scope-219"><span class="linenos">219</span></a><span class="sd"> List of "User Defined Tabular Functions" in this scope.</span> -</span><span id="Scope-220"><a href="#Scope-220"><span class="linenos">220</span></a> -</span><span id="Scope-221"><a href="#Scope-221"><span class="linenos">221</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-222"><a href="#Scope-222"><span class="linenos">222</span></a><span class="sd"> list[exp.UDTF]: UDTFs</span> -</span><span id="Scope-223"><a href="#Scope-223"><span class="linenos">223</span></a><span class="sd"> """</span> -</span><span id="Scope-224"><a href="#Scope-224"><span class="linenos">224</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="Scope-225"><a href="#Scope-225"><span class="linenos">225</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> -</span><span id="Scope-226"><a href="#Scope-226"><span class="linenos">226</span></a> -</span><span id="Scope-227"><a href="#Scope-227"><span class="linenos">227</span></a> <span class="nd">@property</span> -</span><span id="Scope-228"><a href="#Scope-228"><span class="linenos">228</span></a> <span class="k">def</span> <span class="nf">subqueries</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-229"><a href="#Scope-229"><span class="linenos">229</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-230"><a href="#Scope-230"><span class="linenos">230</span></a><span class="sd"> List of subqueries in this scope.</span> -</span><span id="Scope-231"><a href="#Scope-231"><span class="linenos">231</span></a> -</span><span id="Scope-232"><a href="#Scope-232"><span class="linenos">232</span></a><span class="sd"> For example:</span> -</span><span id="Scope-233"><a href="#Scope-233"><span class="linenos">233</span></a><span class="sd"> SELECT * FROM x WHERE a IN (SELECT ...) <- that's a subquery</span> -</span><span id="Scope-234"><a href="#Scope-234"><span class="linenos">234</span></a> -</span><span id="Scope-235"><a href="#Scope-235"><span class="linenos">235</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-236"><a href="#Scope-236"><span class="linenos">236</span></a><span class="sd"> list[exp.Subqueryable]: subqueries</span> -</span><span id="Scope-237"><a href="#Scope-237"><span class="linenos">237</span></a><span class="sd"> """</span> -</span><span id="Scope-238"><a href="#Scope-238"><span class="linenos">238</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="Scope-239"><a href="#Scope-239"><span class="linenos">239</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> -</span><span id="Scope-240"><a href="#Scope-240"><span class="linenos">240</span></a> -</span><span id="Scope-241"><a href="#Scope-241"><span class="linenos">241</span></a> <span class="nd">@property</span> -</span><span id="Scope-242"><a href="#Scope-242"><span class="linenos">242</span></a> <span class="k">def</span> <span class="nf">columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-243"><a href="#Scope-243"><span class="linenos">243</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-244"><a href="#Scope-244"><span class="linenos">244</span></a><span class="sd"> List of columns in this scope.</span> -</span><span id="Scope-245"><a href="#Scope-245"><span class="linenos">245</span></a> -</span><span id="Scope-246"><a href="#Scope-246"><span class="linenos">246</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-247"><a href="#Scope-247"><span class="linenos">247</span></a><span class="sd"> list[exp.Column]: Column instances in this scope, plus any</span> -</span><span id="Scope-248"><a href="#Scope-248"><span class="linenos">248</span></a><span class="sd"> Columns that reference this scope from correlated subqueries.</span> -</span><span id="Scope-249"><a href="#Scope-249"><span class="linenos">249</span></a><span class="sd"> """</span> -</span><span id="Scope-250"><a href="#Scope-250"><span class="linenos">250</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Scope-251"><a href="#Scope-251"><span class="linenos">251</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> -</span><span id="Scope-252"><a href="#Scope-252"><span class="linenos">252</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> -</span><span id="Scope-253"><a href="#Scope-253"><span class="linenos">253</span></a> -</span><span id="Scope-254"><a href="#Scope-254"><span class="linenos">254</span></a> <span class="n">external_columns</span> <span class="o">=</span> <span class="p">[</span> -</span><span id="Scope-255"><a href="#Scope-255"><span class="linenos">255</span></a> <span class="n">column</span> -</span><span id="Scope-256"><a href="#Scope-256"><span class="linenos">256</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span><span class="p">)</span> -</span><span id="Scope-257"><a href="#Scope-257"><span class="linenos">257</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span> -</span><span id="Scope-258"><a href="#Scope-258"><span class="linenos">258</span></a> <span class="p">]</span> -</span><span id="Scope-259"><a href="#Scope-259"><span class="linenos">259</span></a> -</span><span id="Scope-260"><a href="#Scope-260"><span class="linenos">260</span></a> <span class="n">named_selects</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span><span class="p">)</span> -</span><span id="Scope-261"><a href="#Scope-261"><span class="linenos">261</span></a> -</span><span id="Scope-262"><a href="#Scope-262"><span class="linenos">262</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-263"><a href="#Scope-263"><span class="linenos">263</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span> <span class="o">+</span> <span class="n">external_columns</span><span class="p">:</span> -</span><span id="Scope-264"><a href="#Scope-264"><span class="linenos">264</span></a> <span class="n">ancestor</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">find_ancestor</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Qualify</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Order</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Having</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Hint</span><span class="p">)</span> -</span><span id="Scope-265"><a href="#Scope-265"><span class="linenos">265</span></a> <span class="k">if</span> <span class="p">(</span> -</span><span id="Scope-266"><a href="#Scope-266"><span class="linenos">266</span></a> <span class="ow">not</span> <span class="n">ancestor</span> -</span><span id="Scope-267"><a href="#Scope-267"><span class="linenos">267</span></a> <span class="c1"># Window functions can have an ORDER BY clause</span> -</span><span id="Scope-268"><a href="#Scope-268"><span class="linenos">268</span></a> <span class="ow">or</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ancestor</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">)</span> -</span><span id="Scope-269"><a href="#Scope-269"><span class="linenos">269</span></a> <span class="ow">or</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> -</span><span id="Scope-270"><a href="#Scope-270"><span class="linenos">270</span></a> <span class="ow">or</span> <span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">named_selects</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ancestor</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Hint</span><span class="p">))</span> -</span><span id="Scope-271"><a href="#Scope-271"><span class="linenos">271</span></a> <span class="p">):</span> -</span><span id="Scope-272"><a href="#Scope-272"><span class="linenos">272</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> -</span><span id="Scope-273"><a href="#Scope-273"><span class="linenos">273</span></a> -</span><span id="Scope-274"><a href="#Scope-274"><span class="linenos">274</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> -</span><span id="Scope-275"><a href="#Scope-275"><span class="linenos">275</span></a> -</span><span id="Scope-276"><a href="#Scope-276"><span class="linenos">276</span></a> <span class="nd">@property</span> -</span><span id="Scope-277"><a href="#Scope-277"><span class="linenos">277</span></a> <span class="k">def</span> <span class="nf">selected_sources</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-278"><a href="#Scope-278"><span class="linenos">278</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-279"><a href="#Scope-279"><span class="linenos">279</span></a><span class="sd"> Mapping of nodes and sources that are actually selected from in this scope.</span> -</span><span id="Scope-280"><a href="#Scope-280"><span class="linenos">280</span></a> -</span><span id="Scope-281"><a href="#Scope-281"><span class="linenos">281</span></a><span class="sd"> That is, all tables in a schema are selectable at any point. But a</span> -</span><span id="Scope-282"><a href="#Scope-282"><span class="linenos">282</span></a><span class="sd"> table only becomes a selected source if it's included in a FROM or JOIN clause.</span> -</span><span id="Scope-283"><a href="#Scope-283"><span class="linenos">283</span></a> -</span><span id="Scope-284"><a href="#Scope-284"><span class="linenos">284</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-285"><a href="#Scope-285"><span class="linenos">285</span></a><span class="sd"> dict[str, (exp.Table|exp.Select, exp.Table|Scope)]: selected sources and nodes</span> -</span><span id="Scope-286"><a href="#Scope-286"><span class="linenos">286</span></a><span class="sd"> """</span> -</span><span id="Scope-287"><a href="#Scope-287"><span class="linenos">287</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Scope-288"><a href="#Scope-288"><span class="linenos">288</span></a> <span class="n">referenced_names</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope-289"><a href="#Scope-289"><span class="linenos">289</span></a> -</span><span id="Scope-290"><a href="#Scope-290"><span class="linenos">290</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">tables</span><span class="p">:</span> -</span><span id="Scope-291"><a href="#Scope-291"><span class="linenos">291</span></a> <span class="n">referenced_names</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">table</span><span class="o">.</span><span class="n">alias_or_name</span><span class="p">,</span> <span class="n">table</span><span class="p">))</span> -</span><span id="Scope-292"><a href="#Scope-292"><span class="linenos">292</span></a> <span class="k">for</span> <span class="n">expression</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">derived_tables</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">udtfs</span><span class="p">):</span> -</span><span id="Scope-293"><a href="#Scope-293"><span class="linenos">293</span></a> <span class="n">referenced_names</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">expression</span><span class="o">.</span><span class="n">alias</span><span class="p">,</span> <span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">()))</span> -</span><span id="Scope-294"><a href="#Scope-294"><span class="linenos">294</span></a> <span class="n">result</span> <span class="o">=</span> <span class="p">{}</span> -</span><span id="Scope-295"><a href="#Scope-295"><span class="linenos">295</span></a> -</span><span id="Scope-296"><a href="#Scope-296"><span class="linenos">296</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">referenced_names</span><span class="p">:</span> -</span><span id="Scope-297"><a href="#Scope-297"><span class="linenos">297</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> -</span><span id="Scope-298"><a href="#Scope-298"><span class="linenos">298</span></a> <span class="n">result</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">])</span> -</span><span id="Scope-299"><a href="#Scope-299"><span class="linenos">299</span></a> -</span><span id="Scope-300"><a href="#Scope-300"><span class="linenos">300</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="n">result</span> -</span><span id="Scope-301"><a href="#Scope-301"><span class="linenos">301</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope-20"><a href="#Scope-20"><span class="linenos"> 20</span></a><span class="k">class</span> <span class="nc">Scope</span><span class="p">:</span> +</span><span id="Scope-21"><a href="#Scope-21"><span class="linenos"> 21</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-22"><a href="#Scope-22"><span class="linenos"> 22</span></a><span class="sd"> Selection scope.</span> +</span><span id="Scope-23"><a href="#Scope-23"><span class="linenos"> 23</span></a> +</span><span id="Scope-24"><a href="#Scope-24"><span class="linenos"> 24</span></a><span class="sd"> Attributes:</span> +</span><span id="Scope-25"><a href="#Scope-25"><span class="linenos"> 25</span></a><span class="sd"> expression (exp.Select|exp.Union): Root expression of this scope</span> +</span><span id="Scope-26"><a href="#Scope-26"><span class="linenos"> 26</span></a><span class="sd"> sources (dict[str, exp.Table|Scope]): Mapping of source name to either</span> +</span><span id="Scope-27"><a href="#Scope-27"><span class="linenos"> 27</span></a><span class="sd"> a Table expression or another Scope instance. For example:</span> +</span><span id="Scope-28"><a href="#Scope-28"><span class="linenos"> 28</span></a><span class="sd"> SELECT * FROM x {"x": Table(this="x")}</span> +</span><span id="Scope-29"><a href="#Scope-29"><span class="linenos"> 29</span></a><span class="sd"> SELECT * FROM x AS y {"y": Table(this="x")}</span> +</span><span id="Scope-30"><a href="#Scope-30"><span class="linenos"> 30</span></a><span class="sd"> SELECT * FROM (SELECT ...) AS y {"y": Scope(...)}</span> +</span><span id="Scope-31"><a href="#Scope-31"><span class="linenos"> 31</span></a><span class="sd"> lateral_sources (dict[str, exp.Table|Scope]): Sources from laterals</span> +</span><span id="Scope-32"><a href="#Scope-32"><span class="linenos"> 32</span></a><span class="sd"> For example:</span> +</span><span id="Scope-33"><a href="#Scope-33"><span class="linenos"> 33</span></a><span class="sd"> SELECT c FROM x LATERAL VIEW EXPLODE (a) AS c;</span> +</span><span id="Scope-34"><a href="#Scope-34"><span class="linenos"> 34</span></a><span class="sd"> The LATERAL VIEW EXPLODE gets x as a source.</span> +</span><span id="Scope-35"><a href="#Scope-35"><span class="linenos"> 35</span></a><span class="sd"> outer_column_list (list[str]): If this is a derived table or CTE, and the outer query</span> +</span><span id="Scope-36"><a href="#Scope-36"><span class="linenos"> 36</span></a><span class="sd"> defines a column list of it's alias of this scope, this is that list of columns.</span> +</span><span id="Scope-37"><a href="#Scope-37"><span class="linenos"> 37</span></a><span class="sd"> For example:</span> +</span><span id="Scope-38"><a href="#Scope-38"><span class="linenos"> 38</span></a><span class="sd"> SELECT * FROM (SELECT ...) AS y(col1, col2)</span> +</span><span id="Scope-39"><a href="#Scope-39"><span class="linenos"> 39</span></a><span class="sd"> The inner query would have `["col1", "col2"]` for its `outer_column_list`</span> +</span><span id="Scope-40"><a href="#Scope-40"><span class="linenos"> 40</span></a><span class="sd"> parent (Scope): Parent scope</span> +</span><span id="Scope-41"><a href="#Scope-41"><span class="linenos"> 41</span></a><span class="sd"> scope_type (ScopeType): Type of this scope, relative to it's parent</span> +</span><span id="Scope-42"><a href="#Scope-42"><span class="linenos"> 42</span></a><span class="sd"> subquery_scopes (list[Scope]): List of all child scopes for subqueries</span> +</span><span id="Scope-43"><a href="#Scope-43"><span class="linenos"> 43</span></a><span class="sd"> cte_scopes (list[Scope]): List of all child scopes for CTEs</span> +</span><span id="Scope-44"><a href="#Scope-44"><span class="linenos"> 44</span></a><span class="sd"> derived_table_scopes (list[Scope]): List of all child scopes for derived_tables</span> +</span><span id="Scope-45"><a href="#Scope-45"><span class="linenos"> 45</span></a><span class="sd"> udtf_scopes (list[Scope]): List of all child scopes for user defined tabular functions</span> +</span><span id="Scope-46"><a href="#Scope-46"><span class="linenos"> 46</span></a><span class="sd"> table_scopes (list[Scope]): derived_table_scopes + udtf_scopes, in the order that they're defined</span> +</span><span id="Scope-47"><a href="#Scope-47"><span class="linenos"> 47</span></a><span class="sd"> union_scopes (list[Scope, Scope]): If this Scope is for a Union expression, this will be</span> +</span><span id="Scope-48"><a href="#Scope-48"><span class="linenos"> 48</span></a><span class="sd"> a list of the left and right child scopes.</span> +</span><span id="Scope-49"><a href="#Scope-49"><span class="linenos"> 49</span></a><span class="sd"> """</span> +</span><span id="Scope-50"><a href="#Scope-50"><span class="linenos"> 50</span></a> +</span><span id="Scope-51"><a href="#Scope-51"><span class="linenos"> 51</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> +</span><span id="Scope-52"><a href="#Scope-52"><span class="linenos"> 52</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="Scope-53"><a href="#Scope-53"><span class="linenos"> 53</span></a> <span class="n">expression</span><span class="p">,</span> +</span><span id="Scope-54"><a href="#Scope-54"><span class="linenos"> 54</span></a> <span class="n">sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="Scope-55"><a href="#Scope-55"><span class="linenos"> 55</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="Scope-56"><a href="#Scope-56"><span class="linenos"> 56</span></a> <span class="n">parent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="Scope-57"><a href="#Scope-57"><span class="linenos"> 57</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span><span class="p">,</span> +</span><span id="Scope-58"><a href="#Scope-58"><span class="linenos"> 58</span></a> <span class="n">lateral_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="Scope-59"><a href="#Scope-59"><span class="linenos"> 59</span></a> <span class="p">):</span> +</span><span id="Scope-60"><a href="#Scope-60"><span class="linenos"> 60</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span> <span class="o">=</span> <span class="n">expression</span> +</span><span id="Scope-61"><a href="#Scope-61"><span class="linenos"> 61</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span> <span class="o">=</span> <span class="n">sources</span> <span class="ow">or</span> <span class="p">{}</span> +</span><span id="Scope-62"><a href="#Scope-62"><span class="linenos"> 62</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span> <span class="o">=</span> <span class="n">lateral_sources</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span> <span class="k">if</span> <span class="n">lateral_sources</span> <span class="k">else</span> <span class="p">{}</span> +</span><span id="Scope-63"><a href="#Scope-63"><span class="linenos"> 63</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> +</span><span id="Scope-64"><a href="#Scope-64"><span class="linenos"> 64</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">outer_column_list</span> <span class="o">=</span> <span class="n">outer_column_list</span> <span class="ow">or</span> <span class="p">[]</span> +</span><span id="Scope-65"><a href="#Scope-65"><span class="linenos"> 65</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">parent</span> <span class="o">=</span> <span class="n">parent</span> +</span><span id="Scope-66"><a href="#Scope-66"><span class="linenos"> 66</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">=</span> <span class="n">scope_type</span> +</span><span id="Scope-67"><a href="#Scope-67"><span class="linenos"> 67</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-68"><a href="#Scope-68"><span class="linenos"> 68</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">derived_table_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-69"><a href="#Scope-69"><span class="linenos"> 69</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-70"><a href="#Scope-70"><span class="linenos"> 70</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-71"><a href="#Scope-71"><span class="linenos"> 71</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-72"><a href="#Scope-72"><span class="linenos"> 72</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-73"><a href="#Scope-73"><span class="linenos"> 73</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> +</span><span id="Scope-74"><a href="#Scope-74"><span class="linenos"> 74</span></a> +</span><span id="Scope-75"><a href="#Scope-75"><span class="linenos"> 75</span></a> <span class="k">def</span> <span class="nf">clear_cache</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-76"><a href="#Scope-76"><span class="linenos"> 76</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">False</span> +</span><span id="Scope-77"><a href="#Scope-77"><span class="linenos"> 77</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-78"><a href="#Scope-78"><span class="linenos"> 78</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-79"><a href="#Scope-79"><span class="linenos"> 79</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-80"><a href="#Scope-80"><span class="linenos"> 80</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-81"><a href="#Scope-81"><span class="linenos"> 81</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-82"><a href="#Scope-82"><span class="linenos"> 82</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-83"><a href="#Scope-83"><span class="linenos"> 83</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-84"><a href="#Scope-84"><span class="linenos"> 84</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-85"><a href="#Scope-85"><span class="linenos"> 85</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-86"><a href="#Scope-86"><span class="linenos"> 86</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope-87"><a href="#Scope-87"><span class="linenos"> 87</span></a> +</span><span id="Scope-88"><a href="#Scope-88"><span class="linenos"> 88</span></a> <span class="k">def</span> <span class="nf">branch</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">expression</span><span class="p">,</span> <span class="n">scope_type</span><span class="p">,</span> <span class="n">chain_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span> +</span><span id="Scope-89"><a href="#Scope-89"><span class="linenos"> 89</span></a><span class="w"> </span><span class="sd">"""Branch from the current scope to a new, inner scope"""</span> +</span><span id="Scope-90"><a href="#Scope-90"><span class="linenos"> 90</span></a> <span class="k">return</span> <span class="n">Scope</span><span class="p">(</span> +</span><span id="Scope-91"><a href="#Scope-91"><span class="linenos"> 91</span></a> <span class="n">expression</span><span class="o">=</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">(),</span> +</span><span id="Scope-92"><a href="#Scope-92"><span class="linenos"> 92</span></a> <span class="n">sources</span><span class="o">=</span><span class="p">{</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">cte_sources</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">chain_sources</span> <span class="ow">or</span> <span class="p">{})},</span> +</span><span id="Scope-93"><a href="#Scope-93"><span class="linenos"> 93</span></a> <span class="n">parent</span><span class="o">=</span><span class="bp">self</span><span class="p">,</span> +</span><span id="Scope-94"><a href="#Scope-94"><span class="linenos"> 94</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">scope_type</span><span class="p">,</span> +</span><span id="Scope-95"><a href="#Scope-95"><span class="linenos"> 95</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> +</span><span id="Scope-96"><a href="#Scope-96"><span class="linenos"> 96</span></a> <span class="p">)</span> +</span><span id="Scope-97"><a href="#Scope-97"><span class="linenos"> 97</span></a> +</span><span id="Scope-98"><a href="#Scope-98"><span class="linenos"> 98</span></a> <span class="k">def</span> <span class="nf">_collect</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-99"><a href="#Scope-99"><span class="linenos"> 99</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-100"><a href="#Scope-100"><span class="linenos">100</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-101"><a href="#Scope-101"><span class="linenos">101</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-102"><a href="#Scope-102"><span class="linenos">102</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-103"><a href="#Scope-103"><span class="linenos">103</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-104"><a href="#Scope-104"><span class="linenos">104</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-105"><a href="#Scope-105"><span class="linenos">105</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-106"><a href="#Scope-106"><span class="linenos">106</span></a> +</span><span id="Scope-107"><a href="#Scope-107"><span class="linenos">107</span></a> <span class="k">for</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span> +</span><span id="Scope-108"><a href="#Scope-108"><span class="linenos">108</span></a> <span class="k">if</span> <span class="n">node</span> <span class="ow">is</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">:</span> +</span><span id="Scope-109"><a href="#Scope-109"><span class="linenos">109</span></a> <span class="k">continue</span> +</span><span id="Scope-110"><a href="#Scope-110"><span class="linenos">110</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Column</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">this</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Star</span><span class="p">):</span> +</span><span id="Scope-111"><a href="#Scope-111"><span class="linenos">111</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="Scope-112"><a href="#Scope-112"><span class="linenos">112</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Table</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">JoinHint</span><span class="p">):</span> +</span><span id="Scope-113"><a href="#Scope-113"><span class="linenos">113</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="Scope-114"><a href="#Scope-114"><span class="linenos">114</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">JoinHint</span><span class="p">):</span> +</span><span id="Scope-115"><a href="#Scope-115"><span class="linenos">115</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="Scope-116"><a href="#Scope-116"><span class="linenos">116</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">):</span> +</span><span id="Scope-117"><a href="#Scope-117"><span class="linenos">117</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="Scope-118"><a href="#Scope-118"><span class="linenos">118</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">CTE</span><span class="p">):</span> +</span><span id="Scope-119"><a href="#Scope-119"><span class="linenos">119</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="Scope-120"><a href="#Scope-120"><span class="linenos">120</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">parent</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">From</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">)):</span> +</span><span id="Scope-121"><a href="#Scope-121"><span class="linenos">121</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="Scope-122"><a href="#Scope-122"><span class="linenos">122</span></a> <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">):</span> +</span><span id="Scope-123"><a href="#Scope-123"><span class="linenos">123</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">node</span><span class="p">)</span> +</span><span id="Scope-124"><a href="#Scope-124"><span class="linenos">124</span></a> +</span><span id="Scope-125"><a href="#Scope-125"><span class="linenos">125</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">True</span> +</span><span id="Scope-126"><a href="#Scope-126"><span class="linenos">126</span></a> +</span><span id="Scope-127"><a href="#Scope-127"><span class="linenos">127</span></a> <span class="k">def</span> <span class="nf">_ensure_collected</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-128"><a href="#Scope-128"><span class="linenos">128</span></a> <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span><span class="p">:</span> +</span><span id="Scope-129"><a href="#Scope-129"><span class="linenos">129</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collect</span><span class="p">()</span> +</span><span id="Scope-130"><a href="#Scope-130"><span class="linenos">130</span></a> +</span><span id="Scope-131"><a href="#Scope-131"><span class="linenos">131</span></a> <span class="k">def</span> <span class="nf">walk</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="Scope-132"><a href="#Scope-132"><span class="linenos">132</span></a> <span class="k">return</span> <span class="n">walk_in_scope</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">)</span> +</span><span id="Scope-133"><a href="#Scope-133"><span class="linenos">133</span></a> +</span><span id="Scope-134"><a href="#Scope-134"><span class="linenos">134</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="Scope-135"><a href="#Scope-135"><span class="linenos">135</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-136"><a href="#Scope-136"><span class="linenos">136</span></a><span class="sd"> Returns the first node in this scope which matches at least one of the specified types.</span> +</span><span id="Scope-137"><a href="#Scope-137"><span class="linenos">137</span></a> +</span><span id="Scope-138"><a href="#Scope-138"><span class="linenos">138</span></a><span class="sd"> This does NOT traverse into subscopes.</span> +</span><span id="Scope-139"><a href="#Scope-139"><span class="linenos">139</span></a> +</span><span id="Scope-140"><a href="#Scope-140"><span class="linenos">140</span></a><span class="sd"> Args:</span> +</span><span id="Scope-141"><a href="#Scope-141"><span class="linenos">141</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> +</span><span id="Scope-142"><a href="#Scope-142"><span class="linenos">142</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> +</span><span id="Scope-143"><a href="#Scope-143"><span class="linenos">143</span></a> +</span><span id="Scope-144"><a href="#Scope-144"><span class="linenos">144</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-145"><a href="#Scope-145"><span class="linenos">145</span></a><span class="sd"> exp.Expression: the node which matches the criteria or None if no node matching</span> +</span><span id="Scope-146"><a href="#Scope-146"><span class="linenos">146</span></a><span class="sd"> the criteria was found.</span> +</span><span id="Scope-147"><a href="#Scope-147"><span class="linenos">147</span></a><span class="sd"> """</span> +</span><span id="Scope-148"><a href="#Scope-148"><span class="linenos">148</span></a> <span class="k">return</span> <span class="nb">next</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">),</span> <span class="kc">None</span><span class="p">)</span> +</span><span id="Scope-149"><a href="#Scope-149"><span class="linenos">149</span></a> +</span><span id="Scope-150"><a href="#Scope-150"><span class="linenos">150</span></a> <span class="k">def</span> <span class="nf">find_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="Scope-151"><a href="#Scope-151"><span class="linenos">151</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-152"><a href="#Scope-152"><span class="linenos">152</span></a><span class="sd"> Returns a generator object which visits all nodes in this scope and only yields those that</span> +</span><span id="Scope-153"><a href="#Scope-153"><span class="linenos">153</span></a><span class="sd"> match at least one of the specified expression types.</span> +</span><span id="Scope-154"><a href="#Scope-154"><span class="linenos">154</span></a> +</span><span id="Scope-155"><a href="#Scope-155"><span class="linenos">155</span></a><span class="sd"> This does NOT traverse into subscopes.</span> +</span><span id="Scope-156"><a href="#Scope-156"><span class="linenos">156</span></a> +</span><span id="Scope-157"><a href="#Scope-157"><span class="linenos">157</span></a><span class="sd"> Args:</span> +</span><span id="Scope-158"><a href="#Scope-158"><span class="linenos">158</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> +</span><span id="Scope-159"><a href="#Scope-159"><span class="linenos">159</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> +</span><span id="Scope-160"><a href="#Scope-160"><span class="linenos">160</span></a> +</span><span id="Scope-161"><a href="#Scope-161"><span class="linenos">161</span></a><span class="sd"> Yields:</span> +</span><span id="Scope-162"><a href="#Scope-162"><span class="linenos">162</span></a><span class="sd"> exp.Expression: nodes</span> +</span><span id="Scope-163"><a href="#Scope-163"><span class="linenos">163</span></a><span class="sd"> """</span> +</span><span id="Scope-164"><a href="#Scope-164"><span class="linenos">164</span></a> <span class="k">for</span> <span class="n">expression</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">):</span> +</span><span id="Scope-165"><a href="#Scope-165"><span class="linenos">165</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">expression_types</span><span class="p">):</span> +</span><span id="Scope-166"><a href="#Scope-166"><span class="linenos">166</span></a> <span class="k">yield</span> <span class="n">expression</span> +</span><span id="Scope-167"><a href="#Scope-167"><span class="linenos">167</span></a> +</span><span id="Scope-168"><a href="#Scope-168"><span class="linenos">168</span></a> <span class="k">def</span> <span class="nf">replace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span> +</span><span id="Scope-169"><a href="#Scope-169"><span class="linenos">169</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-170"><a href="#Scope-170"><span class="linenos">170</span></a><span class="sd"> Replace `old` with `new`.</span> +</span><span id="Scope-171"><a href="#Scope-171"><span class="linenos">171</span></a> +</span><span id="Scope-172"><a href="#Scope-172"><span class="linenos">172</span></a><span class="sd"> This can be used instead of `exp.Expression.replace` to ensure the `Scope` is kept up-to-date.</span> +</span><span id="Scope-173"><a href="#Scope-173"><span class="linenos">173</span></a> +</span><span id="Scope-174"><a href="#Scope-174"><span class="linenos">174</span></a><span class="sd"> Args:</span> +</span><span id="Scope-175"><a href="#Scope-175"><span class="linenos">175</span></a><span class="sd"> old (exp.Expression): old node</span> +</span><span id="Scope-176"><a href="#Scope-176"><span class="linenos">176</span></a><span class="sd"> new (exp.Expression): new node</span> +</span><span id="Scope-177"><a href="#Scope-177"><span class="linenos">177</span></a><span class="sd"> """</span> +</span><span id="Scope-178"><a href="#Scope-178"><span class="linenos">178</span></a> <span class="n">old</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> +</span><span id="Scope-179"><a href="#Scope-179"><span class="linenos">179</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> +</span><span id="Scope-180"><a href="#Scope-180"><span class="linenos">180</span></a> +</span><span id="Scope-181"><a href="#Scope-181"><span class="linenos">181</span></a> <span class="nd">@property</span> +</span><span id="Scope-182"><a href="#Scope-182"><span class="linenos">182</span></a> <span class="k">def</span> <span class="nf">tables</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-183"><a href="#Scope-183"><span class="linenos">183</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-184"><a href="#Scope-184"><span class="linenos">184</span></a><span class="sd"> List of tables in this scope.</span> +</span><span id="Scope-185"><a href="#Scope-185"><span class="linenos">185</span></a> +</span><span id="Scope-186"><a href="#Scope-186"><span class="linenos">186</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-187"><a href="#Scope-187"><span class="linenos">187</span></a><span class="sd"> list[exp.Table]: tables</span> +</span><span id="Scope-188"><a href="#Scope-188"><span class="linenos">188</span></a><span class="sd"> """</span> +</span><span id="Scope-189"><a href="#Scope-189"><span class="linenos">189</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="Scope-190"><a href="#Scope-190"><span class="linenos">190</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> +</span><span id="Scope-191"><a href="#Scope-191"><span class="linenos">191</span></a> +</span><span id="Scope-192"><a href="#Scope-192"><span class="linenos">192</span></a> <span class="nd">@property</span> +</span><span id="Scope-193"><a href="#Scope-193"><span class="linenos">193</span></a> <span class="k">def</span> <span class="nf">ctes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-194"><a href="#Scope-194"><span class="linenos">194</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-195"><a href="#Scope-195"><span class="linenos">195</span></a><span class="sd"> List of CTEs in this scope.</span> +</span><span id="Scope-196"><a href="#Scope-196"><span class="linenos">196</span></a> +</span><span id="Scope-197"><a href="#Scope-197"><span class="linenos">197</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-198"><a href="#Scope-198"><span class="linenos">198</span></a><span class="sd"> list[exp.CTE]: ctes</span> +</span><span id="Scope-199"><a href="#Scope-199"><span class="linenos">199</span></a><span class="sd"> """</span> +</span><span id="Scope-200"><a href="#Scope-200"><span class="linenos">200</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="Scope-201"><a href="#Scope-201"><span class="linenos">201</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> +</span><span id="Scope-202"><a href="#Scope-202"><span class="linenos">202</span></a> +</span><span id="Scope-203"><a href="#Scope-203"><span class="linenos">203</span></a> <span class="nd">@property</span> +</span><span id="Scope-204"><a href="#Scope-204"><span class="linenos">204</span></a> <span class="k">def</span> <span class="nf">derived_tables</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-205"><a href="#Scope-205"><span class="linenos">205</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-206"><a href="#Scope-206"><span class="linenos">206</span></a><span class="sd"> List of derived tables in this scope.</span> +</span><span id="Scope-207"><a href="#Scope-207"><span class="linenos">207</span></a> +</span><span id="Scope-208"><a href="#Scope-208"><span class="linenos">208</span></a><span class="sd"> For example:</span> +</span><span id="Scope-209"><a href="#Scope-209"><span class="linenos">209</span></a><span class="sd"> SELECT * FROM (SELECT ...) <- that's a derived table</span> +</span><span id="Scope-210"><a href="#Scope-210"><span class="linenos">210</span></a> +</span><span id="Scope-211"><a href="#Scope-211"><span class="linenos">211</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-212"><a href="#Scope-212"><span class="linenos">212</span></a><span class="sd"> list[exp.Subquery]: derived tables</span> +</span><span id="Scope-213"><a href="#Scope-213"><span class="linenos">213</span></a><span class="sd"> """</span> +</span><span id="Scope-214"><a href="#Scope-214"><span class="linenos">214</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="Scope-215"><a href="#Scope-215"><span class="linenos">215</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> +</span><span id="Scope-216"><a href="#Scope-216"><span class="linenos">216</span></a> +</span><span id="Scope-217"><a href="#Scope-217"><span class="linenos">217</span></a> <span class="nd">@property</span> +</span><span id="Scope-218"><a href="#Scope-218"><span class="linenos">218</span></a> <span class="k">def</span> <span class="nf">udtfs</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-219"><a href="#Scope-219"><span class="linenos">219</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-220"><a href="#Scope-220"><span class="linenos">220</span></a><span class="sd"> List of "User Defined Tabular Functions" in this scope.</span> +</span><span id="Scope-221"><a href="#Scope-221"><span class="linenos">221</span></a> +</span><span id="Scope-222"><a href="#Scope-222"><span class="linenos">222</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-223"><a href="#Scope-223"><span class="linenos">223</span></a><span class="sd"> list[exp.UDTF]: UDTFs</span> +</span><span id="Scope-224"><a href="#Scope-224"><span class="linenos">224</span></a><span class="sd"> """</span> +</span><span id="Scope-225"><a href="#Scope-225"><span class="linenos">225</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="Scope-226"><a href="#Scope-226"><span class="linenos">226</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> +</span><span id="Scope-227"><a href="#Scope-227"><span class="linenos">227</span></a> +</span><span id="Scope-228"><a href="#Scope-228"><span class="linenos">228</span></a> <span class="nd">@property</span> +</span><span id="Scope-229"><a href="#Scope-229"><span class="linenos">229</span></a> <span class="k">def</span> <span class="nf">subqueries</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-230"><a href="#Scope-230"><span class="linenos">230</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-231"><a href="#Scope-231"><span class="linenos">231</span></a><span class="sd"> List of subqueries in this scope.</span> +</span><span id="Scope-232"><a href="#Scope-232"><span class="linenos">232</span></a> +</span><span id="Scope-233"><a href="#Scope-233"><span class="linenos">233</span></a><span class="sd"> For example:</span> +</span><span id="Scope-234"><a href="#Scope-234"><span class="linenos">234</span></a><span class="sd"> SELECT * FROM x WHERE a IN (SELECT ...) <- that's a subquery</span> +</span><span id="Scope-235"><a href="#Scope-235"><span class="linenos">235</span></a> +</span><span id="Scope-236"><a href="#Scope-236"><span class="linenos">236</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-237"><a href="#Scope-237"><span class="linenos">237</span></a><span class="sd"> list[exp.Subqueryable]: subqueries</span> +</span><span id="Scope-238"><a href="#Scope-238"><span class="linenos">238</span></a><span class="sd"> """</span> +</span><span id="Scope-239"><a href="#Scope-239"><span class="linenos">239</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="Scope-240"><a href="#Scope-240"><span class="linenos">240</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> +</span><span id="Scope-241"><a href="#Scope-241"><span class="linenos">241</span></a> +</span><span id="Scope-242"><a href="#Scope-242"><span class="linenos">242</span></a> <span class="nd">@property</span> +</span><span id="Scope-243"><a href="#Scope-243"><span class="linenos">243</span></a> <span class="k">def</span> <span class="nf">columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-244"><a href="#Scope-244"><span class="linenos">244</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-245"><a href="#Scope-245"><span class="linenos">245</span></a><span class="sd"> List of columns in this scope.</span> +</span><span id="Scope-246"><a href="#Scope-246"><span class="linenos">246</span></a> +</span><span id="Scope-247"><a href="#Scope-247"><span class="linenos">247</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-248"><a href="#Scope-248"><span class="linenos">248</span></a><span class="sd"> list[exp.Column]: Column instances in this scope, plus any</span> +</span><span id="Scope-249"><a href="#Scope-249"><span class="linenos">249</span></a><span class="sd"> Columns that reference this scope from correlated subqueries.</span> +</span><span id="Scope-250"><a href="#Scope-250"><span class="linenos">250</span></a><span class="sd"> """</span> +</span><span id="Scope-251"><a href="#Scope-251"><span class="linenos">251</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Scope-252"><a href="#Scope-252"><span class="linenos">252</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ensure_collected</span><span class="p">()</span> +</span><span id="Scope-253"><a href="#Scope-253"><span class="linenos">253</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> +</span><span id="Scope-254"><a href="#Scope-254"><span class="linenos">254</span></a> +</span><span id="Scope-255"><a href="#Scope-255"><span class="linenos">255</span></a> <span class="n">external_columns</span> <span class="o">=</span> <span class="p">[</span> +</span><span id="Scope-256"><a href="#Scope-256"><span class="linenos">256</span></a> <span class="n">column</span> +</span><span id="Scope-257"><a href="#Scope-257"><span class="linenos">257</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span><span class="p">)</span> +</span><span id="Scope-258"><a href="#Scope-258"><span class="linenos">258</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">external_columns</span> +</span><span id="Scope-259"><a href="#Scope-259"><span class="linenos">259</span></a> <span class="p">]</span> +</span><span id="Scope-260"><a href="#Scope-260"><span class="linenos">260</span></a> +</span><span id="Scope-261"><a href="#Scope-261"><span class="linenos">261</span></a> <span class="n">named_selects</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">named_selects</span><span class="p">)</span> +</span><span id="Scope-262"><a href="#Scope-262"><span class="linenos">262</span></a> +</span><span id="Scope-263"><a href="#Scope-263"><span class="linenos">263</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-264"><a href="#Scope-264"><span class="linenos">264</span></a> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">columns</span> <span class="o">+</span> <span class="n">external_columns</span><span class="p">:</span> +</span><span id="Scope-265"><a href="#Scope-265"><span class="linenos">265</span></a> <span class="n">ancestor</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">find_ancestor</span><span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">Qualify</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Order</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Having</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Hint</span><span class="p">)</span> +</span><span id="Scope-266"><a href="#Scope-266"><span class="linenos">266</span></a> <span class="k">if</span> <span class="p">(</span> +</span><span id="Scope-267"><a href="#Scope-267"><span class="linenos">267</span></a> <span class="ow">not</span> <span class="n">ancestor</span> +</span><span id="Scope-268"><a href="#Scope-268"><span class="linenos">268</span></a> <span class="c1"># Window functions can have an ORDER BY clause</span> +</span><span id="Scope-269"><a href="#Scope-269"><span class="linenos">269</span></a> <span class="ow">or</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ancestor</span><span class="o">.</span><span class="n">parent</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Select</span><span class="p">)</span> +</span><span id="Scope-270"><a href="#Scope-270"><span class="linenos">270</span></a> <span class="ow">or</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> +</span><span id="Scope-271"><a href="#Scope-271"><span class="linenos">271</span></a> <span class="ow">or</span> <span class="p">(</span><span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">named_selects</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ancestor</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Hint</span><span class="p">))</span> +</span><span id="Scope-272"><a href="#Scope-272"><span class="linenos">272</span></a> <span class="p">):</span> +</span><span id="Scope-273"><a href="#Scope-273"><span class="linenos">273</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> +</span><span id="Scope-274"><a href="#Scope-274"><span class="linenos">274</span></a> +</span><span id="Scope-275"><a href="#Scope-275"><span class="linenos">275</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> +</span><span id="Scope-276"><a href="#Scope-276"><span class="linenos">276</span></a> +</span><span id="Scope-277"><a href="#Scope-277"><span class="linenos">277</span></a> <span class="nd">@property</span> +</span><span id="Scope-278"><a href="#Scope-278"><span class="linenos">278</span></a> <span class="k">def</span> <span class="nf">selected_sources</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-279"><a href="#Scope-279"><span class="linenos">279</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-280"><a href="#Scope-280"><span class="linenos">280</span></a><span class="sd"> Mapping of nodes and sources that are actually selected from in this scope.</span> +</span><span id="Scope-281"><a href="#Scope-281"><span class="linenos">281</span></a> +</span><span id="Scope-282"><a href="#Scope-282"><span class="linenos">282</span></a><span class="sd"> That is, all tables in a schema are selectable at any point. But a</span> +</span><span id="Scope-283"><a href="#Scope-283"><span class="linenos">283</span></a><span class="sd"> table only becomes a selected source if it's included in a FROM or JOIN clause.</span> +</span><span id="Scope-284"><a href="#Scope-284"><span class="linenos">284</span></a> +</span><span id="Scope-285"><a href="#Scope-285"><span class="linenos">285</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-286"><a href="#Scope-286"><span class="linenos">286</span></a><span class="sd"> dict[str, (exp.Table|exp.Select, exp.Table|Scope)]: selected sources and nodes</span> +</span><span id="Scope-287"><a href="#Scope-287"><span class="linenos">287</span></a><span class="sd"> """</span> +</span><span id="Scope-288"><a href="#Scope-288"><span class="linenos">288</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Scope-289"><a href="#Scope-289"><span class="linenos">289</span></a> <span class="n">referenced_names</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope-290"><a href="#Scope-290"><span class="linenos">290</span></a> +</span><span id="Scope-291"><a href="#Scope-291"><span class="linenos">291</span></a> <span class="k">for</span> <span class="n">table</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">tables</span><span class="p">:</span> +</span><span id="Scope-292"><a href="#Scope-292"><span class="linenos">292</span></a> <span class="n">referenced_names</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">table</span><span class="o">.</span><span class="n">alias_or_name</span><span class="p">,</span> <span class="n">table</span><span class="p">))</span> +</span><span id="Scope-293"><a href="#Scope-293"><span class="linenos">293</span></a> <span class="k">for</span> <span class="n">expression</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">derived_tables</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">udtfs</span><span class="p">):</span> +</span><span id="Scope-294"><a href="#Scope-294"><span class="linenos">294</span></a> <span class="n">referenced_names</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">expression</span><span class="o">.</span><span class="n">alias</span><span class="p">,</span> <span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">()))</span> +</span><span id="Scope-295"><a href="#Scope-295"><span class="linenos">295</span></a> <span class="n">result</span> <span class="o">=</span> <span class="p">{}</span> +</span><span id="Scope-296"><a href="#Scope-296"><span class="linenos">296</span></a> +</span><span id="Scope-297"><a href="#Scope-297"><span class="linenos">297</span></a> <span class="k">for</span> <span class="n">name</span><span class="p">,</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">referenced_names</span><span class="p">:</span> +</span><span id="Scope-298"><a href="#Scope-298"><span class="linenos">298</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">result</span><span class="p">:</span> +</span><span id="Scope-299"><a href="#Scope-299"><span class="linenos">299</span></a> <span class="k">raise</span> <span class="n">OptimizeError</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Alias already used: </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span> +</span><span id="Scope-300"><a href="#Scope-300"><span class="linenos">300</span></a> <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">:</span> +</span><span id="Scope-301"><a href="#Scope-301"><span class="linenos">301</span></a> <span class="n">result</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">])</span> </span><span id="Scope-302"><a href="#Scope-302"><span class="linenos">302</span></a> -</span><span id="Scope-303"><a href="#Scope-303"><span class="linenos">303</span></a> <span class="nd">@property</span> -</span><span id="Scope-304"><a href="#Scope-304"><span class="linenos">304</span></a> <span class="k">def</span> <span class="nf">cte_sources</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-305"><a href="#Scope-305"><span class="linenos">305</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-306"><a href="#Scope-306"><span class="linenos">306</span></a><span class="sd"> Sources that are CTEs.</span> -</span><span id="Scope-307"><a href="#Scope-307"><span class="linenos">307</span></a> -</span><span id="Scope-308"><a href="#Scope-308"><span class="linenos">308</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-309"><a href="#Scope-309"><span class="linenos">309</span></a><span class="sd"> dict[str, Scope]: Mapping of source alias to Scope</span> -</span><span id="Scope-310"><a href="#Scope-310"><span class="linenos">310</span></a><span class="sd"> """</span> -</span><span id="Scope-311"><a href="#Scope-311"><span class="linenos">311</span></a> <span class="k">return</span> <span class="p">{</span> -</span><span id="Scope-312"><a href="#Scope-312"><span class="linenos">312</span></a> <span class="n">alias</span><span class="p">:</span> <span class="n">scope</span> -</span><span id="Scope-313"><a href="#Scope-313"><span class="linenos">313</span></a> <span class="k">for</span> <span class="n">alias</span><span class="p">,</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> -</span><span id="Scope-314"><a href="#Scope-314"><span class="linenos">314</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="n">scope</span><span class="o">.</span><span class="n">is_cte</span> -</span><span id="Scope-315"><a href="#Scope-315"><span class="linenos">315</span></a> <span class="p">}</span> -</span><span id="Scope-316"><a href="#Scope-316"><span class="linenos">316</span></a> -</span><span id="Scope-317"><a href="#Scope-317"><span class="linenos">317</span></a> <span class="nd">@property</span> -</span><span id="Scope-318"><a href="#Scope-318"><span class="linenos">318</span></a> <span class="k">def</span> <span class="nf">selects</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-319"><a href="#Scope-319"><span class="linenos">319</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-320"><a href="#Scope-320"><span class="linenos">320</span></a><span class="sd"> Select expressions of this scope.</span> -</span><span id="Scope-321"><a href="#Scope-321"><span class="linenos">321</span></a> -</span><span id="Scope-322"><a href="#Scope-322"><span class="linenos">322</span></a><span class="sd"> For example, for the following expression:</span> -</span><span id="Scope-323"><a href="#Scope-323"><span class="linenos">323</span></a><span class="sd"> SELECT 1 as a, 2 as b FROM x</span> +</span><span id="Scope-303"><a href="#Scope-303"><span class="linenos">303</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="n">result</span> +</span><span id="Scope-304"><a href="#Scope-304"><span class="linenos">304</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> +</span><span id="Scope-305"><a href="#Scope-305"><span class="linenos">305</span></a> +</span><span id="Scope-306"><a href="#Scope-306"><span class="linenos">306</span></a> <span class="nd">@property</span> +</span><span id="Scope-307"><a href="#Scope-307"><span class="linenos">307</span></a> <span class="k">def</span> <span class="nf">cte_sources</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-308"><a href="#Scope-308"><span class="linenos">308</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-309"><a href="#Scope-309"><span class="linenos">309</span></a><span class="sd"> Sources that are CTEs.</span> +</span><span id="Scope-310"><a href="#Scope-310"><span class="linenos">310</span></a> +</span><span id="Scope-311"><a href="#Scope-311"><span class="linenos">311</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-312"><a href="#Scope-312"><span class="linenos">312</span></a><span class="sd"> dict[str, Scope]: Mapping of source alias to Scope</span> +</span><span id="Scope-313"><a href="#Scope-313"><span class="linenos">313</span></a><span class="sd"> """</span> +</span><span id="Scope-314"><a href="#Scope-314"><span class="linenos">314</span></a> <span class="k">return</span> <span class="p">{</span> +</span><span id="Scope-315"><a href="#Scope-315"><span class="linenos">315</span></a> <span class="n">alias</span><span class="p">:</span> <span class="n">scope</span> +</span><span id="Scope-316"><a href="#Scope-316"><span class="linenos">316</span></a> <span class="k">for</span> <span class="n">alias</span><span class="p">,</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">items</span><span class="p">()</span> +</span><span id="Scope-317"><a href="#Scope-317"><span class="linenos">317</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">Scope</span><span class="p">)</span> <span class="ow">and</span> <span class="n">scope</span><span class="o">.</span><span class="n">is_cte</span> +</span><span id="Scope-318"><a href="#Scope-318"><span class="linenos">318</span></a> <span class="p">}</span> +</span><span id="Scope-319"><a href="#Scope-319"><span class="linenos">319</span></a> +</span><span id="Scope-320"><a href="#Scope-320"><span class="linenos">320</span></a> <span class="nd">@property</span> +</span><span id="Scope-321"><a href="#Scope-321"><span class="linenos">321</span></a> <span class="k">def</span> <span class="nf">selects</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-322"><a href="#Scope-322"><span class="linenos">322</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-323"><a href="#Scope-323"><span class="linenos">323</span></a><span class="sd"> Select expressions of this scope.</span> </span><span id="Scope-324"><a href="#Scope-324"><span class="linenos">324</span></a> -</span><span id="Scope-325"><a href="#Scope-325"><span class="linenos">325</span></a><span class="sd"> The outputs are the "1 as a" and "2 as b" expressions.</span> -</span><span id="Scope-326"><a href="#Scope-326"><span class="linenos">326</span></a> -</span><span id="Scope-327"><a href="#Scope-327"><span class="linenos">327</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-328"><a href="#Scope-328"><span class="linenos">328</span></a><span class="sd"> list[exp.Expression]: expressions</span> -</span><span id="Scope-329"><a href="#Scope-329"><span class="linenos">329</span></a><span class="sd"> """</span> -</span><span id="Scope-330"><a href="#Scope-330"><span class="linenos">330</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> -</span><span id="Scope-331"><a href="#Scope-331"><span class="linenos">331</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">()</span><span class="o">.</span><span class="n">selects</span> -</span><span id="Scope-332"><a href="#Scope-332"><span class="linenos">332</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">selects</span> -</span><span id="Scope-333"><a href="#Scope-333"><span class="linenos">333</span></a> -</span><span id="Scope-334"><a href="#Scope-334"><span class="linenos">334</span></a> <span class="nd">@property</span> -</span><span id="Scope-335"><a href="#Scope-335"><span class="linenos">335</span></a> <span class="k">def</span> <span class="nf">external_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-336"><a href="#Scope-336"><span class="linenos">336</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-337"><a href="#Scope-337"><span class="linenos">337</span></a><span class="sd"> Columns that appear to reference sources in outer scopes.</span> -</span><span id="Scope-338"><a href="#Scope-338"><span class="linenos">338</span></a> -</span><span id="Scope-339"><a href="#Scope-339"><span class="linenos">339</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-340"><a href="#Scope-340"><span class="linenos">340</span></a><span class="sd"> list[exp.Column]: Column instances that don't reference</span> -</span><span id="Scope-341"><a href="#Scope-341"><span class="linenos">341</span></a><span class="sd"> sources in the current scope.</span> -</span><span id="Scope-342"><a href="#Scope-342"><span class="linenos">342</span></a><span class="sd"> """</span> -</span><span id="Scope-343"><a href="#Scope-343"><span class="linenos">343</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Scope-344"><a href="#Scope-344"><span class="linenos">344</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="p">[</span> -</span><span id="Scope-345"><a href="#Scope-345"><span class="linenos">345</span></a> <span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">selected_sources</span> -</span><span id="Scope-346"><a href="#Scope-346"><span class="linenos">346</span></a> <span class="p">]</span> -</span><span id="Scope-347"><a href="#Scope-347"><span class="linenos">347</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> -</span><span id="Scope-348"><a href="#Scope-348"><span class="linenos">348</span></a> -</span><span id="Scope-349"><a href="#Scope-349"><span class="linenos">349</span></a> <span class="nd">@property</span> -</span><span id="Scope-350"><a href="#Scope-350"><span class="linenos">350</span></a> <span class="k">def</span> <span class="nf">unqualified_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-351"><a href="#Scope-351"><span class="linenos">351</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-352"><a href="#Scope-352"><span class="linenos">352</span></a><span class="sd"> Unqualified columns in the current scope.</span> -</span><span id="Scope-353"><a href="#Scope-353"><span class="linenos">353</span></a> -</span><span id="Scope-354"><a href="#Scope-354"><span class="linenos">354</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-355"><a href="#Scope-355"><span class="linenos">355</span></a><span class="sd"> list[exp.Column]: Unqualified columns</span> -</span><span id="Scope-356"><a href="#Scope-356"><span class="linenos">356</span></a><span class="sd"> """</span> -</span><span id="Scope-357"><a href="#Scope-357"><span class="linenos">357</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span><span class="p">]</span> -</span><span id="Scope-358"><a href="#Scope-358"><span class="linenos">358</span></a> -</span><span id="Scope-359"><a href="#Scope-359"><span class="linenos">359</span></a> <span class="nd">@property</span> -</span><span id="Scope-360"><a href="#Scope-360"><span class="linenos">360</span></a> <span class="k">def</span> <span class="nf">join_hints</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-361"><a href="#Scope-361"><span class="linenos">361</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-362"><a href="#Scope-362"><span class="linenos">362</span></a><span class="sd"> Hints that exist in the scope that reference tables</span> -</span><span id="Scope-363"><a href="#Scope-363"><span class="linenos">363</span></a> -</span><span id="Scope-364"><a href="#Scope-364"><span class="linenos">364</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-365"><a href="#Scope-365"><span class="linenos">365</span></a><span class="sd"> list[exp.JoinHint]: Join hints that are referenced within the scope</span> -</span><span id="Scope-366"><a href="#Scope-366"><span class="linenos">366</span></a><span class="sd"> """</span> -</span><span id="Scope-367"><a href="#Scope-367"><span class="linenos">367</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> -</span><span id="Scope-368"><a href="#Scope-368"><span class="linenos">368</span></a> <span class="k">return</span> <span class="p">[]</span> -</span><span id="Scope-369"><a href="#Scope-369"><span class="linenos">369</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> -</span><span id="Scope-370"><a href="#Scope-370"><span class="linenos">370</span></a> -</span><span id="Scope-371"><a href="#Scope-371"><span class="linenos">371</span></a> <span class="k">def</span> <span class="nf">source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_name</span><span class="p">):</span> -</span><span id="Scope-372"><a href="#Scope-372"><span class="linenos">372</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-373"><a href="#Scope-373"><span class="linenos">373</span></a><span class="sd"> Get all columns in the current scope for a particular source.</span> -</span><span id="Scope-374"><a href="#Scope-374"><span class="linenos">374</span></a> -</span><span id="Scope-375"><a href="#Scope-375"><span class="linenos">375</span></a><span class="sd"> Args:</span> -</span><span id="Scope-376"><a href="#Scope-376"><span class="linenos">376</span></a><span class="sd"> source_name (str): Name of the source</span> -</span><span id="Scope-377"><a href="#Scope-377"><span class="linenos">377</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-378"><a href="#Scope-378"><span class="linenos">378</span></a><span class="sd"> list[exp.Column]: Column instances that reference `source_name`</span> -</span><span id="Scope-379"><a href="#Scope-379"><span class="linenos">379</span></a><span class="sd"> """</span> -</span><span id="Scope-380"><a href="#Scope-380"><span class="linenos">380</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> <span class="o">==</span> <span class="n">source_name</span><span class="p">]</span> -</span><span id="Scope-381"><a href="#Scope-381"><span class="linenos">381</span></a> -</span><span id="Scope-382"><a href="#Scope-382"><span class="linenos">382</span></a> <span class="nd">@property</span> -</span><span id="Scope-383"><a href="#Scope-383"><span class="linenos">383</span></a> <span class="k">def</span> <span class="nf">is_subquery</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-384"><a href="#Scope-384"><span class="linenos">384</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a subquery"""</span> -</span><span id="Scope-385"><a href="#Scope-385"><span class="linenos">385</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">SUBQUERY</span> -</span><span id="Scope-386"><a href="#Scope-386"><span class="linenos">386</span></a> -</span><span id="Scope-387"><a href="#Scope-387"><span class="linenos">387</span></a> <span class="nd">@property</span> -</span><span id="Scope-388"><a href="#Scope-388"><span class="linenos">388</span></a> <span class="k">def</span> <span class="nf">is_derived_table</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-389"><a href="#Scope-389"><span class="linenos">389</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a derived table"""</span> -</span><span id="Scope-390"><a href="#Scope-390"><span class="linenos">390</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">DERIVED_TABLE</span> -</span><span id="Scope-391"><a href="#Scope-391"><span class="linenos">391</span></a> -</span><span id="Scope-392"><a href="#Scope-392"><span class="linenos">392</span></a> <span class="nd">@property</span> -</span><span id="Scope-393"><a href="#Scope-393"><span class="linenos">393</span></a> <span class="k">def</span> <span class="nf">is_union</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-394"><a href="#Scope-394"><span class="linenos">394</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a union"""</span> -</span><span id="Scope-395"><a href="#Scope-395"><span class="linenos">395</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UNION</span> -</span><span id="Scope-396"><a href="#Scope-396"><span class="linenos">396</span></a> -</span><span id="Scope-397"><a href="#Scope-397"><span class="linenos">397</span></a> <span class="nd">@property</span> -</span><span id="Scope-398"><a href="#Scope-398"><span class="linenos">398</span></a> <span class="k">def</span> <span class="nf">is_cte</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-399"><a href="#Scope-399"><span class="linenos">399</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a common table expression"""</span> -</span><span id="Scope-400"><a href="#Scope-400"><span class="linenos">400</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">CTE</span> -</span><span id="Scope-401"><a href="#Scope-401"><span class="linenos">401</span></a> -</span><span id="Scope-402"><a href="#Scope-402"><span class="linenos">402</span></a> <span class="nd">@property</span> -</span><span id="Scope-403"><a href="#Scope-403"><span class="linenos">403</span></a> <span class="k">def</span> <span class="nf">is_root</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-404"><a href="#Scope-404"><span class="linenos">404</span></a><span class="w"> </span><span class="sd">"""Determine if this is the root scope"""</span> -</span><span id="Scope-405"><a href="#Scope-405"><span class="linenos">405</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span> -</span><span id="Scope-406"><a href="#Scope-406"><span class="linenos">406</span></a> -</span><span id="Scope-407"><a href="#Scope-407"><span class="linenos">407</span></a> <span class="nd">@property</span> -</span><span id="Scope-408"><a href="#Scope-408"><span class="linenos">408</span></a> <span class="k">def</span> <span class="nf">is_udtf</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-409"><a href="#Scope-409"><span class="linenos">409</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a UDTF (User Defined Table Function)"""</span> -</span><span id="Scope-410"><a href="#Scope-410"><span class="linenos">410</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UDTF</span> -</span><span id="Scope-411"><a href="#Scope-411"><span class="linenos">411</span></a> -</span><span id="Scope-412"><a href="#Scope-412"><span class="linenos">412</span></a> <span class="nd">@property</span> -</span><span id="Scope-413"><a href="#Scope-413"><span class="linenos">413</span></a> <span class="k">def</span> <span class="nf">is_correlated_subquery</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-414"><a href="#Scope-414"><span class="linenos">414</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a correlated subquery"""</span> -</span><span id="Scope-415"><a href="#Scope-415"><span class="linenos">415</span></a> <span class="k">return</span> <span class="nb">bool</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">is_subquery</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">external_columns</span><span class="p">)</span> -</span><span id="Scope-416"><a href="#Scope-416"><span class="linenos">416</span></a> -</span><span id="Scope-417"><a href="#Scope-417"><span class="linenos">417</span></a> <span class="k">def</span> <span class="nf">rename_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old_name</span><span class="p">,</span> <span class="n">new_name</span><span class="p">):</span> -</span><span id="Scope-418"><a href="#Scope-418"><span class="linenos">418</span></a><span class="w"> </span><span class="sd">"""Rename a source in this scope"""</span> -</span><span id="Scope-419"><a href="#Scope-419"><span class="linenos">419</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">old_name</span> <span class="ow">or</span> <span class="s2">""</span><span class="p">,</span> <span class="p">[])</span> -</span><span id="Scope-420"><a href="#Scope-420"><span class="linenos">420</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">new_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">columns</span> -</span><span id="Scope-421"><a href="#Scope-421"><span class="linenos">421</span></a> -</span><span id="Scope-422"><a href="#Scope-422"><span class="linenos">422</span></a> <span class="k">def</span> <span class="nf">add_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="p">):</span> -</span><span id="Scope-423"><a href="#Scope-423"><span class="linenos">423</span></a><span class="w"> </span><span class="sd">"""Add a source to this scope"""</span> -</span><span id="Scope-424"><a href="#Scope-424"><span class="linenos">424</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">source</span> -</span><span id="Scope-425"><a href="#Scope-425"><span class="linenos">425</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="Scope-426"><a href="#Scope-426"><span class="linenos">426</span></a> -</span><span id="Scope-427"><a href="#Scope-427"><span class="linenos">427</span></a> <span class="k">def</span> <span class="nf">remove_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span> -</span><span id="Scope-428"><a href="#Scope-428"><span class="linenos">428</span></a><span class="w"> </span><span class="sd">"""Remove a source from this scope"""</span> -</span><span id="Scope-429"><a href="#Scope-429"><span class="linenos">429</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> -</span><span id="Scope-430"><a href="#Scope-430"><span class="linenos">430</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> -</span><span id="Scope-431"><a href="#Scope-431"><span class="linenos">431</span></a> -</span><span id="Scope-432"><a href="#Scope-432"><span class="linenos">432</span></a> <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-433"><a href="#Scope-433"><span class="linenos">433</span></a> <span class="k">return</span> <span class="sa">f</span><span class="s2">"Scope<</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">sql</span><span class="p">()</span><span class="si">}</span><span class="s2">>"</span> +</span><span id="Scope-325"><a href="#Scope-325"><span class="linenos">325</span></a><span class="sd"> For example, for the following expression:</span> +</span><span id="Scope-326"><a href="#Scope-326"><span class="linenos">326</span></a><span class="sd"> SELECT 1 as a, 2 as b FROM x</span> +</span><span id="Scope-327"><a href="#Scope-327"><span class="linenos">327</span></a> +</span><span id="Scope-328"><a href="#Scope-328"><span class="linenos">328</span></a><span class="sd"> The outputs are the "1 as a" and "2 as b" expressions.</span> +</span><span id="Scope-329"><a href="#Scope-329"><span class="linenos">329</span></a> +</span><span id="Scope-330"><a href="#Scope-330"><span class="linenos">330</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-331"><a href="#Scope-331"><span class="linenos">331</span></a><span class="sd"> list[exp.Expression]: expressions</span> +</span><span id="Scope-332"><a href="#Scope-332"><span class="linenos">332</span></a><span class="sd"> """</span> +</span><span id="Scope-333"><a href="#Scope-333"><span class="linenos">333</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Union</span><span class="p">):</span> +</span><span id="Scope-334"><a href="#Scope-334"><span class="linenos">334</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">()</span><span class="o">.</span><span class="n">selects</span> +</span><span id="Scope-335"><a href="#Scope-335"><span class="linenos">335</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">selects</span> +</span><span id="Scope-336"><a href="#Scope-336"><span class="linenos">336</span></a> +</span><span id="Scope-337"><a href="#Scope-337"><span class="linenos">337</span></a> <span class="nd">@property</span> +</span><span id="Scope-338"><a href="#Scope-338"><span class="linenos">338</span></a> <span class="k">def</span> <span class="nf">external_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-339"><a href="#Scope-339"><span class="linenos">339</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-340"><a href="#Scope-340"><span class="linenos">340</span></a><span class="sd"> Columns that appear to reference sources in outer scopes.</span> +</span><span id="Scope-341"><a href="#Scope-341"><span class="linenos">341</span></a> +</span><span id="Scope-342"><a href="#Scope-342"><span class="linenos">342</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-343"><a href="#Scope-343"><span class="linenos">343</span></a><span class="sd"> list[exp.Column]: Column instances that don't reference</span> +</span><span id="Scope-344"><a href="#Scope-344"><span class="linenos">344</span></a><span class="sd"> sources in the current scope.</span> +</span><span id="Scope-345"><a href="#Scope-345"><span class="linenos">345</span></a><span class="sd"> """</span> +</span><span id="Scope-346"><a href="#Scope-346"><span class="linenos">346</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Scope-347"><a href="#Scope-347"><span class="linenos">347</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="p">[</span> +</span><span id="Scope-348"><a href="#Scope-348"><span class="linenos">348</span></a> <span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">selected_sources</span> +</span><span id="Scope-349"><a href="#Scope-349"><span class="linenos">349</span></a> <span class="p">]</span> +</span><span id="Scope-350"><a href="#Scope-350"><span class="linenos">350</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> +</span><span id="Scope-351"><a href="#Scope-351"><span class="linenos">351</span></a> +</span><span id="Scope-352"><a href="#Scope-352"><span class="linenos">352</span></a> <span class="nd">@property</span> +</span><span id="Scope-353"><a href="#Scope-353"><span class="linenos">353</span></a> <span class="k">def</span> <span class="nf">unqualified_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-354"><a href="#Scope-354"><span class="linenos">354</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-355"><a href="#Scope-355"><span class="linenos">355</span></a><span class="sd"> Unqualified columns in the current scope.</span> +</span><span id="Scope-356"><a href="#Scope-356"><span class="linenos">356</span></a> +</span><span id="Scope-357"><a href="#Scope-357"><span class="linenos">357</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-358"><a href="#Scope-358"><span class="linenos">358</span></a><span class="sd"> list[exp.Column]: Unqualified columns</span> +</span><span id="Scope-359"><a href="#Scope-359"><span class="linenos">359</span></a><span class="sd"> """</span> +</span><span id="Scope-360"><a href="#Scope-360"><span class="linenos">360</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">c</span> <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">c</span><span class="o">.</span><span class="n">table</span><span class="p">]</span> +</span><span id="Scope-361"><a href="#Scope-361"><span class="linenos">361</span></a> +</span><span id="Scope-362"><a href="#Scope-362"><span class="linenos">362</span></a> <span class="nd">@property</span> +</span><span id="Scope-363"><a href="#Scope-363"><span class="linenos">363</span></a> <span class="k">def</span> <span class="nf">join_hints</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-364"><a href="#Scope-364"><span class="linenos">364</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-365"><a href="#Scope-365"><span class="linenos">365</span></a><span class="sd"> Hints that exist in the scope that reference tables</span> +</span><span id="Scope-366"><a href="#Scope-366"><span class="linenos">366</span></a> +</span><span id="Scope-367"><a href="#Scope-367"><span class="linenos">367</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-368"><a href="#Scope-368"><span class="linenos">368</span></a><span class="sd"> list[exp.JoinHint]: Join hints that are referenced within the scope</span> +</span><span id="Scope-369"><a href="#Scope-369"><span class="linenos">369</span></a><span class="sd"> """</span> +</span><span id="Scope-370"><a href="#Scope-370"><span class="linenos">370</span></a> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span> +</span><span id="Scope-371"><a href="#Scope-371"><span class="linenos">371</span></a> <span class="k">return</span> <span class="p">[]</span> +</span><span id="Scope-372"><a href="#Scope-372"><span class="linenos">372</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> +</span><span id="Scope-373"><a href="#Scope-373"><span class="linenos">373</span></a> +</span><span id="Scope-374"><a href="#Scope-374"><span class="linenos">374</span></a> <span class="k">def</span> <span class="nf">source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_name</span><span class="p">):</span> +</span><span id="Scope-375"><a href="#Scope-375"><span class="linenos">375</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-376"><a href="#Scope-376"><span class="linenos">376</span></a><span class="sd"> Get all columns in the current scope for a particular source.</span> +</span><span id="Scope-377"><a href="#Scope-377"><span class="linenos">377</span></a> +</span><span id="Scope-378"><a href="#Scope-378"><span class="linenos">378</span></a><span class="sd"> Args:</span> +</span><span id="Scope-379"><a href="#Scope-379"><span class="linenos">379</span></a><span class="sd"> source_name (str): Name of the source</span> +</span><span id="Scope-380"><a href="#Scope-380"><span class="linenos">380</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-381"><a href="#Scope-381"><span class="linenos">381</span></a><span class="sd"> list[exp.Column]: Column instances that reference `source_name`</span> +</span><span id="Scope-382"><a href="#Scope-382"><span class="linenos">382</span></a><span class="sd"> """</span> +</span><span id="Scope-383"><a href="#Scope-383"><span class="linenos">383</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> <span class="o">==</span> <span class="n">source_name</span><span class="p">]</span> +</span><span id="Scope-384"><a href="#Scope-384"><span class="linenos">384</span></a> +</span><span id="Scope-385"><a href="#Scope-385"><span class="linenos">385</span></a> <span class="nd">@property</span> +</span><span id="Scope-386"><a href="#Scope-386"><span class="linenos">386</span></a> <span class="k">def</span> <span class="nf">is_subquery</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-387"><a href="#Scope-387"><span class="linenos">387</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a subquery"""</span> +</span><span id="Scope-388"><a href="#Scope-388"><span class="linenos">388</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">SUBQUERY</span> +</span><span id="Scope-389"><a href="#Scope-389"><span class="linenos">389</span></a> +</span><span id="Scope-390"><a href="#Scope-390"><span class="linenos">390</span></a> <span class="nd">@property</span> +</span><span id="Scope-391"><a href="#Scope-391"><span class="linenos">391</span></a> <span class="k">def</span> <span class="nf">is_derived_table</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-392"><a href="#Scope-392"><span class="linenos">392</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a derived table"""</span> +</span><span id="Scope-393"><a href="#Scope-393"><span class="linenos">393</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">DERIVED_TABLE</span> +</span><span id="Scope-394"><a href="#Scope-394"><span class="linenos">394</span></a> +</span><span id="Scope-395"><a href="#Scope-395"><span class="linenos">395</span></a> <span class="nd">@property</span> +</span><span id="Scope-396"><a href="#Scope-396"><span class="linenos">396</span></a> <span class="k">def</span> <span class="nf">is_union</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-397"><a href="#Scope-397"><span class="linenos">397</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a union"""</span> +</span><span id="Scope-398"><a href="#Scope-398"><span class="linenos">398</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UNION</span> +</span><span id="Scope-399"><a href="#Scope-399"><span class="linenos">399</span></a> +</span><span id="Scope-400"><a href="#Scope-400"><span class="linenos">400</span></a> <span class="nd">@property</span> +</span><span id="Scope-401"><a href="#Scope-401"><span class="linenos">401</span></a> <span class="k">def</span> <span class="nf">is_cte</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-402"><a href="#Scope-402"><span class="linenos">402</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a common table expression"""</span> +</span><span id="Scope-403"><a href="#Scope-403"><span class="linenos">403</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">CTE</span> +</span><span id="Scope-404"><a href="#Scope-404"><span class="linenos">404</span></a> +</span><span id="Scope-405"><a href="#Scope-405"><span class="linenos">405</span></a> <span class="nd">@property</span> +</span><span id="Scope-406"><a href="#Scope-406"><span class="linenos">406</span></a> <span class="k">def</span> <span class="nf">is_root</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-407"><a href="#Scope-407"><span class="linenos">407</span></a><span class="w"> </span><span class="sd">"""Determine if this is the root scope"""</span> +</span><span id="Scope-408"><a href="#Scope-408"><span class="linenos">408</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span> +</span><span id="Scope-409"><a href="#Scope-409"><span class="linenos">409</span></a> +</span><span id="Scope-410"><a href="#Scope-410"><span class="linenos">410</span></a> <span class="nd">@property</span> +</span><span id="Scope-411"><a href="#Scope-411"><span class="linenos">411</span></a> <span class="k">def</span> <span class="nf">is_udtf</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-412"><a href="#Scope-412"><span class="linenos">412</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a UDTF (User Defined Table Function)"""</span> +</span><span id="Scope-413"><a href="#Scope-413"><span class="linenos">413</span></a> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">==</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">UDTF</span> +</span><span id="Scope-414"><a href="#Scope-414"><span class="linenos">414</span></a> +</span><span id="Scope-415"><a href="#Scope-415"><span class="linenos">415</span></a> <span class="nd">@property</span> +</span><span id="Scope-416"><a href="#Scope-416"><span class="linenos">416</span></a> <span class="k">def</span> <span class="nf">is_correlated_subquery</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-417"><a href="#Scope-417"><span class="linenos">417</span></a><span class="w"> </span><span class="sd">"""Determine if this scope is a correlated subquery"""</span> +</span><span id="Scope-418"><a href="#Scope-418"><span class="linenos">418</span></a> <span class="k">return</span> <span class="nb">bool</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">is_subquery</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">external_columns</span><span class="p">)</span> +</span><span id="Scope-419"><a href="#Scope-419"><span class="linenos">419</span></a> +</span><span id="Scope-420"><a href="#Scope-420"><span class="linenos">420</span></a> <span class="k">def</span> <span class="nf">rename_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old_name</span><span class="p">,</span> <span class="n">new_name</span><span class="p">):</span> +</span><span id="Scope-421"><a href="#Scope-421"><span class="linenos">421</span></a><span class="w"> </span><span class="sd">"""Rename a source in this scope"""</span> +</span><span id="Scope-422"><a href="#Scope-422"><span class="linenos">422</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">old_name</span> <span class="ow">or</span> <span class="s2">""</span><span class="p">,</span> <span class="p">[])</span> +</span><span id="Scope-423"><a href="#Scope-423"><span class="linenos">423</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">new_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">columns</span> +</span><span id="Scope-424"><a href="#Scope-424"><span class="linenos">424</span></a> +</span><span id="Scope-425"><a href="#Scope-425"><span class="linenos">425</span></a> <span class="k">def</span> <span class="nf">add_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="p">):</span> +</span><span id="Scope-426"><a href="#Scope-426"><span class="linenos">426</span></a><span class="w"> </span><span class="sd">"""Add a source to this scope"""</span> +</span><span id="Scope-427"><a href="#Scope-427"><span class="linenos">427</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">source</span> +</span><span id="Scope-428"><a href="#Scope-428"><span class="linenos">428</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> +</span><span id="Scope-429"><a href="#Scope-429"><span class="linenos">429</span></a> +</span><span id="Scope-430"><a href="#Scope-430"><span class="linenos">430</span></a> <span class="k">def</span> <span class="nf">remove_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span> +</span><span id="Scope-431"><a href="#Scope-431"><span class="linenos">431</span></a><span class="w"> </span><span class="sd">"""Remove a source from this scope"""</span> +</span><span id="Scope-432"><a href="#Scope-432"><span class="linenos">432</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> +</span><span id="Scope-433"><a href="#Scope-433"><span class="linenos">433</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> </span><span id="Scope-434"><a href="#Scope-434"><span class="linenos">434</span></a> -</span><span id="Scope-435"><a href="#Scope-435"><span class="linenos">435</span></a> <span class="k">def</span> <span class="nf">traverse</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-436"><a href="#Scope-436"><span class="linenos">436</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-437"><a href="#Scope-437"><span class="linenos">437</span></a><span class="sd"> Traverse the scope tree from this node.</span> -</span><span id="Scope-438"><a href="#Scope-438"><span class="linenos">438</span></a> -</span><span id="Scope-439"><a href="#Scope-439"><span class="linenos">439</span></a><span class="sd"> Yields:</span> -</span><span id="Scope-440"><a href="#Scope-440"><span class="linenos">440</span></a><span class="sd"> Scope: scope instances in depth-first-search post-order</span> -</span><span id="Scope-441"><a href="#Scope-441"><span class="linenos">441</span></a><span class="sd"> """</span> -</span><span id="Scope-442"><a href="#Scope-442"><span class="linenos">442</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span> -</span><span id="Scope-443"><a href="#Scope-443"><span class="linenos">443</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> -</span><span id="Scope-444"><a href="#Scope-444"><span class="linenos">444</span></a> <span class="p">):</span> -</span><span id="Scope-445"><a href="#Scope-445"><span class="linenos">445</span></a> <span class="k">yield from</span> <span class="n">child_scope</span><span class="o">.</span><span class="n">traverse</span><span class="p">()</span> -</span><span id="Scope-446"><a href="#Scope-446"><span class="linenos">446</span></a> <span class="k">yield</span> <span class="bp">self</span> -</span><span id="Scope-447"><a href="#Scope-447"><span class="linenos">447</span></a> -</span><span id="Scope-448"><a href="#Scope-448"><span class="linenos">448</span></a> <span class="k">def</span> <span class="nf">ref_count</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope-449"><a href="#Scope-449"><span class="linenos">449</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope-450"><a href="#Scope-450"><span class="linenos">450</span></a><span class="sd"> Count the number of times each scope in this tree is referenced.</span> -</span><span id="Scope-451"><a href="#Scope-451"><span class="linenos">451</span></a> -</span><span id="Scope-452"><a href="#Scope-452"><span class="linenos">452</span></a><span class="sd"> Returns:</span> -</span><span id="Scope-453"><a href="#Scope-453"><span class="linenos">453</span></a><span class="sd"> dict[int, int]: Mapping of Scope instance ID to reference count</span> -</span><span id="Scope-454"><a href="#Scope-454"><span class="linenos">454</span></a><span class="sd"> """</span> -</span><span id="Scope-455"><a href="#Scope-455"><span class="linenos">455</span></a> <span class="n">scope_ref_count</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="mi">0</span><span class="p">)</span> -</span><span id="Scope-456"><a href="#Scope-456"><span class="linenos">456</span></a> -</span><span id="Scope-457"><a href="#Scope-457"><span class="linenos">457</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">traverse</span><span class="p">():</span> -</span><span id="Scope-458"><a href="#Scope-458"><span class="linenos">458</span></a> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">values</span><span class="p">():</span> -</span><span id="Scope-459"><a href="#Scope-459"><span class="linenos">459</span></a> <span class="n">scope_ref_count</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">source</span><span class="p">)]</span> <span class="o">+=</span> <span class="mi">1</span> -</span><span id="Scope-460"><a href="#Scope-460"><span class="linenos">460</span></a> -</span><span id="Scope-461"><a href="#Scope-461"><span class="linenos">461</span></a> <span class="k">return</span> <span class="n">scope_ref_count</span> +</span><span id="Scope-435"><a href="#Scope-435"><span class="linenos">435</span></a> <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-436"><a href="#Scope-436"><span class="linenos">436</span></a> <span class="k">return</span> <span class="sa">f</span><span class="s2">"Scope<</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="o">.</span><span class="n">sql</span><span class="p">()</span><span class="si">}</span><span class="s2">>"</span> +</span><span id="Scope-437"><a href="#Scope-437"><span class="linenos">437</span></a> +</span><span id="Scope-438"><a href="#Scope-438"><span class="linenos">438</span></a> <span class="k">def</span> <span class="nf">traverse</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-439"><a href="#Scope-439"><span class="linenos">439</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-440"><a href="#Scope-440"><span class="linenos">440</span></a><span class="sd"> Traverse the scope tree from this node.</span> +</span><span id="Scope-441"><a href="#Scope-441"><span class="linenos">441</span></a> +</span><span id="Scope-442"><a href="#Scope-442"><span class="linenos">442</span></a><span class="sd"> Yields:</span> +</span><span id="Scope-443"><a href="#Scope-443"><span class="linenos">443</span></a><span class="sd"> Scope: scope instances in depth-first-search post-order</span> +</span><span id="Scope-444"><a href="#Scope-444"><span class="linenos">444</span></a><span class="sd"> """</span> +</span><span id="Scope-445"><a href="#Scope-445"><span class="linenos">445</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span> +</span><span id="Scope-446"><a href="#Scope-446"><span class="linenos">446</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> +</span><span id="Scope-447"><a href="#Scope-447"><span class="linenos">447</span></a> <span class="p">):</span> +</span><span id="Scope-448"><a href="#Scope-448"><span class="linenos">448</span></a> <span class="k">yield from</span> <span class="n">child_scope</span><span class="o">.</span><span class="n">traverse</span><span class="p">()</span> +</span><span id="Scope-449"><a href="#Scope-449"><span class="linenos">449</span></a> <span class="k">yield</span> <span class="bp">self</span> +</span><span id="Scope-450"><a href="#Scope-450"><span class="linenos">450</span></a> +</span><span id="Scope-451"><a href="#Scope-451"><span class="linenos">451</span></a> <span class="k">def</span> <span class="nf">ref_count</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope-452"><a href="#Scope-452"><span class="linenos">452</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope-453"><a href="#Scope-453"><span class="linenos">453</span></a><span class="sd"> Count the number of times each scope in this tree is referenced.</span> +</span><span id="Scope-454"><a href="#Scope-454"><span class="linenos">454</span></a> +</span><span id="Scope-455"><a href="#Scope-455"><span class="linenos">455</span></a><span class="sd"> Returns:</span> +</span><span id="Scope-456"><a href="#Scope-456"><span class="linenos">456</span></a><span class="sd"> dict[int, int]: Mapping of Scope instance ID to reference count</span> +</span><span id="Scope-457"><a href="#Scope-457"><span class="linenos">457</span></a><span class="sd"> """</span> +</span><span id="Scope-458"><a href="#Scope-458"><span class="linenos">458</span></a> <span class="n">scope_ref_count</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="mi">0</span><span class="p">)</span> +</span><span id="Scope-459"><a href="#Scope-459"><span class="linenos">459</span></a> +</span><span id="Scope-460"><a href="#Scope-460"><span class="linenos">460</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">traverse</span><span class="p">():</span> +</span><span id="Scope-461"><a href="#Scope-461"><span class="linenos">461</span></a> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">values</span><span class="p">():</span> +</span><span id="Scope-462"><a href="#Scope-462"><span class="linenos">462</span></a> <span class="n">scope_ref_count</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">source</span><span class="p">)]</span> <span class="o">+=</span> <span class="mi">1</span> +</span><span id="Scope-463"><a href="#Scope-463"><span class="linenos">463</span></a> +</span><span id="Scope-464"><a href="#Scope-464"><span class="linenos">464</span></a> <span class="k">return</span> <span class="n">scope_ref_count</span> </span></pre></div> @@ -1473,29 +1480,29 @@ a list of the left and right child scopes.</li> </div> <a class="headerlink" href="#Scope.__init__"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.__init__-50"><a href="#Scope.__init__-50"><span class="linenos">50</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> -</span><span id="Scope.__init__-51"><a href="#Scope.__init__-51"><span class="linenos">51</span></a> <span class="bp">self</span><span class="p">,</span> -</span><span id="Scope.__init__-52"><a href="#Scope.__init__-52"><span class="linenos">52</span></a> <span class="n">expression</span><span class="p">,</span> -</span><span id="Scope.__init__-53"><a href="#Scope.__init__-53"><span class="linenos">53</span></a> <span class="n">sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="Scope.__init__-54"><a href="#Scope.__init__-54"><span class="linenos">54</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="Scope.__init__-55"><a href="#Scope.__init__-55"><span class="linenos">55</span></a> <span class="n">parent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="Scope.__init__-56"><a href="#Scope.__init__-56"><span class="linenos">56</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span><span class="p">,</span> -</span><span id="Scope.__init__-57"><a href="#Scope.__init__-57"><span class="linenos">57</span></a> <span class="n">lateral_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> -</span><span id="Scope.__init__-58"><a href="#Scope.__init__-58"><span class="linenos">58</span></a> <span class="p">):</span> -</span><span id="Scope.__init__-59"><a href="#Scope.__init__-59"><span class="linenos">59</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span> <span class="o">=</span> <span class="n">expression</span> -</span><span id="Scope.__init__-60"><a href="#Scope.__init__-60"><span class="linenos">60</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span> <span class="o">=</span> <span class="n">sources</span> <span class="ow">or</span> <span class="p">{}</span> -</span><span id="Scope.__init__-61"><a href="#Scope.__init__-61"><span class="linenos">61</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span> <span class="o">=</span> <span class="n">lateral_sources</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span> <span class="k">if</span> <span class="n">lateral_sources</span> <span class="k">else</span> <span class="p">{}</span> -</span><span id="Scope.__init__-62"><a href="#Scope.__init__-62"><span class="linenos">62</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> -</span><span id="Scope.__init__-63"><a href="#Scope.__init__-63"><span class="linenos">63</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">outer_column_list</span> <span class="o">=</span> <span class="n">outer_column_list</span> <span class="ow">or</span> <span class="p">[]</span> -</span><span id="Scope.__init__-64"><a href="#Scope.__init__-64"><span class="linenos">64</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">parent</span> <span class="o">=</span> <span class="n">parent</span> -</span><span id="Scope.__init__-65"><a href="#Scope.__init__-65"><span class="linenos">65</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">=</span> <span class="n">scope_type</span> -</span><span id="Scope.__init__-66"><a href="#Scope.__init__-66"><span class="linenos">66</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope.__init__-67"><a href="#Scope.__init__-67"><span class="linenos">67</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">derived_table_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope.__init__-68"><a href="#Scope.__init__-68"><span class="linenos">68</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope.__init__-69"><a href="#Scope.__init__-69"><span class="linenos">69</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope.__init__-70"><a href="#Scope.__init__-70"><span class="linenos">70</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope.__init__-71"><a href="#Scope.__init__-71"><span class="linenos">71</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span> <span class="o">=</span> <span class="p">[]</span> -</span><span id="Scope.__init__-72"><a href="#Scope.__init__-72"><span class="linenos">72</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.__init__-51"><a href="#Scope.__init__-51"><span class="linenos">51</span></a> <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span> +</span><span id="Scope.__init__-52"><a href="#Scope.__init__-52"><span class="linenos">52</span></a> <span class="bp">self</span><span class="p">,</span> +</span><span id="Scope.__init__-53"><a href="#Scope.__init__-53"><span class="linenos">53</span></a> <span class="n">expression</span><span class="p">,</span> +</span><span id="Scope.__init__-54"><a href="#Scope.__init__-54"><span class="linenos">54</span></a> <span class="n">sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="Scope.__init__-55"><a href="#Scope.__init__-55"><span class="linenos">55</span></a> <span class="n">outer_column_list</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="Scope.__init__-56"><a href="#Scope.__init__-56"><span class="linenos">56</span></a> <span class="n">parent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="Scope.__init__-57"><a href="#Scope.__init__-57"><span class="linenos">57</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">ROOT</span><span class="p">,</span> +</span><span id="Scope.__init__-58"><a href="#Scope.__init__-58"><span class="linenos">58</span></a> <span class="n">lateral_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> +</span><span id="Scope.__init__-59"><a href="#Scope.__init__-59"><span class="linenos">59</span></a> <span class="p">):</span> +</span><span id="Scope.__init__-60"><a href="#Scope.__init__-60"><span class="linenos">60</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">expression</span> <span class="o">=</span> <span class="n">expression</span> +</span><span id="Scope.__init__-61"><a href="#Scope.__init__-61"><span class="linenos">61</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span> <span class="o">=</span> <span class="n">sources</span> <span class="ow">or</span> <span class="p">{}</span> +</span><span id="Scope.__init__-62"><a href="#Scope.__init__-62"><span class="linenos">62</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span> <span class="o">=</span> <span class="n">lateral_sources</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span> <span class="k">if</span> <span class="n">lateral_sources</span> <span class="k">else</span> <span class="p">{}</span> +</span><span id="Scope.__init__-63"><a href="#Scope.__init__-63"><span class="linenos">63</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">lateral_sources</span><span class="p">)</span> +</span><span id="Scope.__init__-64"><a href="#Scope.__init__-64"><span class="linenos">64</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">outer_column_list</span> <span class="o">=</span> <span class="n">outer_column_list</span> <span class="ow">or</span> <span class="p">[]</span> +</span><span id="Scope.__init__-65"><a href="#Scope.__init__-65"><span class="linenos">65</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">parent</span> <span class="o">=</span> <span class="n">parent</span> +</span><span id="Scope.__init__-66"><a href="#Scope.__init__-66"><span class="linenos">66</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">scope_type</span> <span class="o">=</span> <span class="n">scope_type</span> +</span><span id="Scope.__init__-67"><a href="#Scope.__init__-67"><span class="linenos">67</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope.__init__-68"><a href="#Scope.__init__-68"><span class="linenos">68</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">derived_table_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope.__init__-69"><a href="#Scope.__init__-69"><span class="linenos">69</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope.__init__-70"><a href="#Scope.__init__-70"><span class="linenos">70</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope.__init__-71"><a href="#Scope.__init__-71"><span class="linenos">71</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope.__init__-72"><a href="#Scope.__init__-72"><span class="linenos">72</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">udtf_scopes</span> <span class="o">=</span> <span class="p">[]</span> +</span><span id="Scope.__init__-73"><a href="#Scope.__init__-73"><span class="linenos">73</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> </span></pre></div> @@ -1513,18 +1520,18 @@ a list of the left and right child scopes.</li> </div> <a class="headerlink" href="#Scope.clear_cache"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.clear_cache-74"><a href="#Scope.clear_cache-74"><span class="linenos">74</span></a> <span class="k">def</span> <span class="nf">clear_cache</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope.clear_cache-75"><a href="#Scope.clear_cache-75"><span class="linenos">75</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="Scope.clear_cache-76"><a href="#Scope.clear_cache-76"><span class="linenos">76</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope.clear_cache-77"><a href="#Scope.clear_cache-77"><span class="linenos">77</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope.clear_cache-78"><a href="#Scope.clear_cache-78"><span class="linenos">78</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope.clear_cache-79"><a href="#Scope.clear_cache-79"><span class="linenos">79</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope.clear_cache-80"><a href="#Scope.clear_cache-80"><span class="linenos">80</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope.clear_cache-81"><a href="#Scope.clear_cache-81"><span class="linenos">81</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope.clear_cache-82"><a href="#Scope.clear_cache-82"><span class="linenos">82</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope.clear_cache-83"><a href="#Scope.clear_cache-83"><span class="linenos">83</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope.clear_cache-84"><a href="#Scope.clear_cache-84"><span class="linenos">84</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="kc">None</span> -</span><span id="Scope.clear_cache-85"><a href="#Scope.clear_cache-85"><span class="linenos">85</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="kc">None</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.clear_cache-75"><a href="#Scope.clear_cache-75"><span class="linenos">75</span></a> <span class="k">def</span> <span class="nf">clear_cache</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope.clear_cache-76"><a href="#Scope.clear_cache-76"><span class="linenos">76</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_collected</span> <span class="o">=</span> <span class="kc">False</span> +</span><span id="Scope.clear_cache-77"><a href="#Scope.clear_cache-77"><span class="linenos">77</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_raw_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope.clear_cache-78"><a href="#Scope.clear_cache-78"><span class="linenos">78</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_derived_tables</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope.clear_cache-79"><a href="#Scope.clear_cache-79"><span class="linenos">79</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_udtfs</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope.clear_cache-80"><a href="#Scope.clear_cache-80"><span class="linenos">80</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_tables</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope.clear_cache-81"><a href="#Scope.clear_cache-81"><span class="linenos">81</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_ctes</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope.clear_cache-82"><a href="#Scope.clear_cache-82"><span class="linenos">82</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_subqueries</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope.clear_cache-83"><a href="#Scope.clear_cache-83"><span class="linenos">83</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_selected_sources</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope.clear_cache-84"><a href="#Scope.clear_cache-84"><span class="linenos">84</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope.clear_cache-85"><a href="#Scope.clear_cache-85"><span class="linenos">85</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_external_columns</span> <span class="o">=</span> <span class="kc">None</span> +</span><span id="Scope.clear_cache-86"><a href="#Scope.clear_cache-86"><span class="linenos">86</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">_join_hints</span> <span class="o">=</span> <span class="kc">None</span> </span></pre></div> @@ -1542,15 +1549,15 @@ a list of the left and right child scopes.</li> </div> <a class="headerlink" href="#Scope.branch"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.branch-87"><a href="#Scope.branch-87"><span class="linenos">87</span></a> <span class="k">def</span> <span class="nf">branch</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">expression</span><span class="p">,</span> <span class="n">scope_type</span><span class="p">,</span> <span class="n">chain_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span> -</span><span id="Scope.branch-88"><a href="#Scope.branch-88"><span class="linenos">88</span></a><span class="w"> </span><span class="sd">"""Branch from the current scope to a new, inner scope"""</span> -</span><span id="Scope.branch-89"><a href="#Scope.branch-89"><span class="linenos">89</span></a> <span class="k">return</span> <span class="n">Scope</span><span class="p">(</span> -</span><span id="Scope.branch-90"><a href="#Scope.branch-90"><span class="linenos">90</span></a> <span class="n">expression</span><span class="o">=</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">(),</span> -</span><span id="Scope.branch-91"><a href="#Scope.branch-91"><span class="linenos">91</span></a> <span class="n">sources</span><span class="o">=</span><span class="p">{</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">cte_sources</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">chain_sources</span> <span class="ow">or</span> <span class="p">{})},</span> -</span><span id="Scope.branch-92"><a href="#Scope.branch-92"><span class="linenos">92</span></a> <span class="n">parent</span><span class="o">=</span><span class="bp">self</span><span class="p">,</span> -</span><span id="Scope.branch-93"><a href="#Scope.branch-93"><span class="linenos">93</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">scope_type</span><span class="p">,</span> -</span><span id="Scope.branch-94"><a href="#Scope.branch-94"><span class="linenos">94</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> -</span><span id="Scope.branch-95"><a href="#Scope.branch-95"><span class="linenos">95</span></a> <span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.branch-88"><a href="#Scope.branch-88"><span class="linenos">88</span></a> <span class="k">def</span> <span class="nf">branch</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">expression</span><span class="p">,</span> <span class="n">scope_type</span><span class="p">,</span> <span class="n">chain_sources</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span> +</span><span id="Scope.branch-89"><a href="#Scope.branch-89"><span class="linenos">89</span></a><span class="w"> </span><span class="sd">"""Branch from the current scope to a new, inner scope"""</span> +</span><span id="Scope.branch-90"><a href="#Scope.branch-90"><span class="linenos">90</span></a> <span class="k">return</span> <span class="n">Scope</span><span class="p">(</span> +</span><span id="Scope.branch-91"><a href="#Scope.branch-91"><span class="linenos">91</span></a> <span class="n">expression</span><span class="o">=</span><span class="n">expression</span><span class="o">.</span><span class="n">unnest</span><span class="p">(),</span> +</span><span id="Scope.branch-92"><a href="#Scope.branch-92"><span class="linenos">92</span></a> <span class="n">sources</span><span class="o">=</span><span class="p">{</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">cte_sources</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">chain_sources</span> <span class="ow">or</span> <span class="p">{})},</span> +</span><span id="Scope.branch-93"><a href="#Scope.branch-93"><span class="linenos">93</span></a> <span class="n">parent</span><span class="o">=</span><span class="bp">self</span><span class="p">,</span> +</span><span id="Scope.branch-94"><a href="#Scope.branch-94"><span class="linenos">94</span></a> <span class="n">scope_type</span><span class="o">=</span><span class="n">scope_type</span><span class="p">,</span> +</span><span id="Scope.branch-95"><a href="#Scope.branch-95"><span class="linenos">95</span></a> <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span> +</span><span id="Scope.branch-96"><a href="#Scope.branch-96"><span class="linenos">96</span></a> <span class="p">)</span> </span></pre></div> @@ -1570,8 +1577,8 @@ a list of the left and right child scopes.</li> </div> <a class="headerlink" href="#Scope.walk"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.walk-130"><a href="#Scope.walk-130"><span class="linenos">130</span></a> <span class="k">def</span> <span class="nf">walk</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="Scope.walk-131"><a href="#Scope.walk-131"><span class="linenos">131</span></a> <span class="k">return</span> <span class="n">walk_in_scope</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.walk-131"><a href="#Scope.walk-131"><span class="linenos">131</span></a> <span class="k">def</span> <span class="nf">walk</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="Scope.walk-132"><a href="#Scope.walk-132"><span class="linenos">132</span></a> <span class="k">return</span> <span class="n">walk_in_scope</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">)</span> </span></pre></div> @@ -1589,21 +1596,21 @@ a list of the left and right child scopes.</li> </div> <a class="headerlink" href="#Scope.find"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.find-133"><a href="#Scope.find-133"><span class="linenos">133</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="Scope.find-134"><a href="#Scope.find-134"><span class="linenos">134</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope.find-135"><a href="#Scope.find-135"><span class="linenos">135</span></a><span class="sd"> Returns the first node in this scope which matches at least one of the specified types.</span> -</span><span id="Scope.find-136"><a href="#Scope.find-136"><span class="linenos">136</span></a> -</span><span id="Scope.find-137"><a href="#Scope.find-137"><span class="linenos">137</span></a><span class="sd"> This does NOT traverse into subscopes.</span> -</span><span id="Scope.find-138"><a href="#Scope.find-138"><span class="linenos">138</span></a> -</span><span id="Scope.find-139"><a href="#Scope.find-139"><span class="linenos">139</span></a><span class="sd"> Args:</span> -</span><span id="Scope.find-140"><a href="#Scope.find-140"><span class="linenos">140</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> -</span><span id="Scope.find-141"><a href="#Scope.find-141"><span class="linenos">141</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> -</span><span id="Scope.find-142"><a href="#Scope.find-142"><span class="linenos">142</span></a> -</span><span id="Scope.find-143"><a href="#Scope.find-143"><span class="linenos">143</span></a><span class="sd"> Returns:</span> -</span><span id="Scope.find-144"><a href="#Scope.find-144"><span class="linenos">144</span></a><span class="sd"> exp.Expression: the node which matches the criteria or None if no node matching</span> -</span><span id="Scope.find-145"><a href="#Scope.find-145"><span class="linenos">145</span></a><span class="sd"> the criteria was found.</span> -</span><span id="Scope.find-146"><a href="#Scope.find-146"><span class="linenos">146</span></a><span class="sd"> """</span> -</span><span id="Scope.find-147"><a href="#Scope.find-147"><span class="linenos">147</span></a> <span class="k">return</span> <span class="nb">next</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">),</span> <span class="kc">None</span><span class="p">)</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.find-134"><a href="#Scope.find-134"><span class="linenos">134</span></a> <span class="k">def</span> <span class="nf">find</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="Scope.find-135"><a href="#Scope.find-135"><span class="linenos">135</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope.find-136"><a href="#Scope.find-136"><span class="linenos">136</span></a><span class="sd"> Returns the first node in this scope which matches at least one of the specified types.</span> +</span><span id="Scope.find-137"><a href="#Scope.find-137"><span class="linenos">137</span></a> +</span><span id="Scope.find-138"><a href="#Scope.find-138"><span class="linenos">138</span></a><span class="sd"> This does NOT traverse into subscopes.</span> +</span><span id="Scope.find-139"><a href="#Scope.find-139"><span class="linenos">139</span></a> +</span><span id="Scope.find-140"><a href="#Scope.find-140"><span class="linenos">140</span></a><span class="sd"> Args:</span> +</span><span id="Scope.find-141"><a href="#Scope.find-141"><span class="linenos">141</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> +</span><span id="Scope.find-142"><a href="#Scope.find-142"><span class="linenos">142</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> +</span><span id="Scope.find-143"><a href="#Scope.find-143"><span class="linenos">143</span></a> +</span><span id="Scope.find-144"><a href="#Scope.find-144"><span class="linenos">144</span></a><span class="sd"> Returns:</span> +</span><span id="Scope.find-145"><a href="#Scope.find-145"><span class="linenos">145</span></a><span class="sd"> exp.Expression: the node which matches the criteria or None if no node matching</span> +</span><span id="Scope.find-146"><a href="#Scope.find-146"><span class="linenos">146</span></a><span class="sd"> the criteria was found.</span> +</span><span id="Scope.find-147"><a href="#Scope.find-147"><span class="linenos">147</span></a><span class="sd"> """</span> +</span><span id="Scope.find-148"><a href="#Scope.find-148"><span class="linenos">148</span></a> <span class="k">return</span> <span class="nb">next</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">find_all</span><span class="p">(</span><span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">),</span> <span class="kc">None</span><span class="p">)</span> </span></pre></div> @@ -1639,23 +1646,23 @@ a list of the left and right child scopes.</li> </div> <a class="headerlink" href="#Scope.find_all"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.find_all-149"><a href="#Scope.find_all-149"><span class="linenos">149</span></a> <span class="k">def</span> <span class="nf">find_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="Scope.find_all-150"><a href="#Scope.find_all-150"><span class="linenos">150</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope.find_all-151"><a href="#Scope.find_all-151"><span class="linenos">151</span></a><span class="sd"> Returns a generator object which visits all nodes in this scope and only yields those that</span> -</span><span id="Scope.find_all-152"><a href="#Scope.find_all-152"><span class="linenos">152</span></a><span class="sd"> match at least one of the specified expression types.</span> -</span><span id="Scope.find_all-153"><a href="#Scope.find_all-153"><span class="linenos">153</span></a> -</span><span id="Scope.find_all-154"><a href="#Scope.find_all-154"><span class="linenos">154</span></a><span class="sd"> This does NOT traverse into subscopes.</span> -</span><span id="Scope.find_all-155"><a href="#Scope.find_all-155"><span class="linenos">155</span></a> -</span><span id="Scope.find_all-156"><a href="#Scope.find_all-156"><span class="linenos">156</span></a><span class="sd"> Args:</span> -</span><span id="Scope.find_all-157"><a href="#Scope.find_all-157"><span class="linenos">157</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> -</span><span id="Scope.find_all-158"><a href="#Scope.find_all-158"><span class="linenos">158</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> -</span><span id="Scope.find_all-159"><a href="#Scope.find_all-159"><span class="linenos">159</span></a> -</span><span id="Scope.find_all-160"><a href="#Scope.find_all-160"><span class="linenos">160</span></a><span class="sd"> Yields:</span> -</span><span id="Scope.find_all-161"><a href="#Scope.find_all-161"><span class="linenos">161</span></a><span class="sd"> exp.Expression: nodes</span> -</span><span id="Scope.find_all-162"><a href="#Scope.find_all-162"><span class="linenos">162</span></a><span class="sd"> """</span> -</span><span id="Scope.find_all-163"><a href="#Scope.find_all-163"><span class="linenos">163</span></a> <span class="k">for</span> <span class="n">expression</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">):</span> -</span><span id="Scope.find_all-164"><a href="#Scope.find_all-164"><span class="linenos">164</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">expression_types</span><span class="p">):</span> -</span><span id="Scope.find_all-165"><a href="#Scope.find_all-165"><span class="linenos">165</span></a> <span class="k">yield</span> <span class="n">expression</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.find_all-150"><a href="#Scope.find_all-150"><span class="linenos">150</span></a> <span class="k">def</span> <span class="nf">find_all</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">expression_types</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="Scope.find_all-151"><a href="#Scope.find_all-151"><span class="linenos">151</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope.find_all-152"><a href="#Scope.find_all-152"><span class="linenos">152</span></a><span class="sd"> Returns a generator object which visits all nodes in this scope and only yields those that</span> +</span><span id="Scope.find_all-153"><a href="#Scope.find_all-153"><span class="linenos">153</span></a><span class="sd"> match at least one of the specified expression types.</span> +</span><span id="Scope.find_all-154"><a href="#Scope.find_all-154"><span class="linenos">154</span></a> +</span><span id="Scope.find_all-155"><a href="#Scope.find_all-155"><span class="linenos">155</span></a><span class="sd"> This does NOT traverse into subscopes.</span> +</span><span id="Scope.find_all-156"><a href="#Scope.find_all-156"><span class="linenos">156</span></a> +</span><span id="Scope.find_all-157"><a href="#Scope.find_all-157"><span class="linenos">157</span></a><span class="sd"> Args:</span> +</span><span id="Scope.find_all-158"><a href="#Scope.find_all-158"><span class="linenos">158</span></a><span class="sd"> expression_types (type): the expression type(s) to match.</span> +</span><span id="Scope.find_all-159"><a href="#Scope.find_all-159"><span class="linenos">159</span></a><span class="sd"> bfs (bool): True to use breadth-first search, False to use depth-first.</span> +</span><span id="Scope.find_all-160"><a href="#Scope.find_all-160"><span class="linenos">160</span></a> +</span><span id="Scope.find_all-161"><a href="#Scope.find_all-161"><span class="linenos">161</span></a><span class="sd"> Yields:</span> +</span><span id="Scope.find_all-162"><a href="#Scope.find_all-162"><span class="linenos">162</span></a><span class="sd"> exp.Expression: nodes</span> +</span><span id="Scope.find_all-163"><a href="#Scope.find_all-163"><span class="linenos">163</span></a><span class="sd"> """</span> +</span><span id="Scope.find_all-164"><a href="#Scope.find_all-164"><span class="linenos">164</span></a> <span class="k">for</span> <span class="n">expression</span><span class="p">,</span> <span class="n">_</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">):</span> +</span><span id="Scope.find_all-165"><a href="#Scope.find_all-165"><span class="linenos">165</span></a> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">expression_types</span><span class="p">):</span> +</span><span id="Scope.find_all-166"><a href="#Scope.find_all-166"><span class="linenos">166</span></a> <span class="k">yield</span> <span class="n">expression</span> </span></pre></div> @@ -1691,18 +1698,18 @@ match at least one of the specified expression types.</p> </div> <a class="headerlink" href="#Scope.replace"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.replace-167"><a href="#Scope.replace-167"><span class="linenos">167</span></a> <span class="k">def</span> <span class="nf">replace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span> -</span><span id="Scope.replace-168"><a href="#Scope.replace-168"><span class="linenos">168</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope.replace-169"><a href="#Scope.replace-169"><span class="linenos">169</span></a><span class="sd"> Replace `old` with `new`.</span> -</span><span id="Scope.replace-170"><a href="#Scope.replace-170"><span class="linenos">170</span></a> -</span><span id="Scope.replace-171"><a href="#Scope.replace-171"><span class="linenos">171</span></a><span class="sd"> This can be used instead of `exp.Expression.replace` to ensure the `Scope` is kept up-to-date.</span> -</span><span id="Scope.replace-172"><a href="#Scope.replace-172"><span class="linenos">172</span></a> -</span><span id="Scope.replace-173"><a href="#Scope.replace-173"><span class="linenos">173</span></a><span class="sd"> Args:</span> -</span><span id="Scope.replace-174"><a href="#Scope.replace-174"><span class="linenos">174</span></a><span class="sd"> old (exp.Expression): old node</span> -</span><span id="Scope.replace-175"><a href="#Scope.replace-175"><span class="linenos">175</span></a><span class="sd"> new (exp.Expression): new node</span> -</span><span id="Scope.replace-176"><a href="#Scope.replace-176"><span class="linenos">176</span></a><span class="sd"> """</span> -</span><span id="Scope.replace-177"><a href="#Scope.replace-177"><span class="linenos">177</span></a> <span class="n">old</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> -</span><span id="Scope.replace-178"><a href="#Scope.replace-178"><span class="linenos">178</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.replace-168"><a href="#Scope.replace-168"><span class="linenos">168</span></a> <span class="k">def</span> <span class="nf">replace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old</span><span class="p">,</span> <span class="n">new</span><span class="p">):</span> +</span><span id="Scope.replace-169"><a href="#Scope.replace-169"><span class="linenos">169</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope.replace-170"><a href="#Scope.replace-170"><span class="linenos">170</span></a><span class="sd"> Replace `old` with `new`.</span> +</span><span id="Scope.replace-171"><a href="#Scope.replace-171"><span class="linenos">171</span></a> +</span><span id="Scope.replace-172"><a href="#Scope.replace-172"><span class="linenos">172</span></a><span class="sd"> This can be used instead of `exp.Expression.replace` to ensure the `Scope` is kept up-to-date.</span> +</span><span id="Scope.replace-173"><a href="#Scope.replace-173"><span class="linenos">173</span></a> +</span><span id="Scope.replace-174"><a href="#Scope.replace-174"><span class="linenos">174</span></a><span class="sd"> Args:</span> +</span><span id="Scope.replace-175"><a href="#Scope.replace-175"><span class="linenos">175</span></a><span class="sd"> old (exp.Expression): old node</span> +</span><span id="Scope.replace-176"><a href="#Scope.replace-176"><span class="linenos">176</span></a><span class="sd"> new (exp.Expression): new node</span> +</span><span id="Scope.replace-177"><a href="#Scope.replace-177"><span class="linenos">177</span></a><span class="sd"> """</span> +</span><span id="Scope.replace-178"><a href="#Scope.replace-178"><span class="linenos">178</span></a> <span class="n">old</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">new</span><span class="p">)</span> +</span><span id="Scope.replace-179"><a href="#Scope.replace-179"><span class="linenos">179</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> </span></pre></div> @@ -1981,16 +1988,16 @@ table only becomes a selected source if it's included in a FROM or JOIN clause.< </div> <a class="headerlink" href="#Scope.source_columns"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.source_columns-371"><a href="#Scope.source_columns-371"><span class="linenos">371</span></a> <span class="k">def</span> <span class="nf">source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_name</span><span class="p">):</span> -</span><span id="Scope.source_columns-372"><a href="#Scope.source_columns-372"><span class="linenos">372</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope.source_columns-373"><a href="#Scope.source_columns-373"><span class="linenos">373</span></a><span class="sd"> Get all columns in the current scope for a particular source.</span> -</span><span id="Scope.source_columns-374"><a href="#Scope.source_columns-374"><span class="linenos">374</span></a> -</span><span id="Scope.source_columns-375"><a href="#Scope.source_columns-375"><span class="linenos">375</span></a><span class="sd"> Args:</span> -</span><span id="Scope.source_columns-376"><a href="#Scope.source_columns-376"><span class="linenos">376</span></a><span class="sd"> source_name (str): Name of the source</span> -</span><span id="Scope.source_columns-377"><a href="#Scope.source_columns-377"><span class="linenos">377</span></a><span class="sd"> Returns:</span> -</span><span id="Scope.source_columns-378"><a href="#Scope.source_columns-378"><span class="linenos">378</span></a><span class="sd"> list[exp.Column]: Column instances that reference `source_name`</span> -</span><span id="Scope.source_columns-379"><a href="#Scope.source_columns-379"><span class="linenos">379</span></a><span class="sd"> """</span> -</span><span id="Scope.source_columns-380"><a href="#Scope.source_columns-380"><span class="linenos">380</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> <span class="o">==</span> <span class="n">source_name</span><span class="p">]</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.source_columns-374"><a href="#Scope.source_columns-374"><span class="linenos">374</span></a> <span class="k">def</span> <span class="nf">source_columns</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">source_name</span><span class="p">):</span> +</span><span id="Scope.source_columns-375"><a href="#Scope.source_columns-375"><span class="linenos">375</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope.source_columns-376"><a href="#Scope.source_columns-376"><span class="linenos">376</span></a><span class="sd"> Get all columns in the current scope for a particular source.</span> +</span><span id="Scope.source_columns-377"><a href="#Scope.source_columns-377"><span class="linenos">377</span></a> +</span><span id="Scope.source_columns-378"><a href="#Scope.source_columns-378"><span class="linenos">378</span></a><span class="sd"> Args:</span> +</span><span id="Scope.source_columns-379"><a href="#Scope.source_columns-379"><span class="linenos">379</span></a><span class="sd"> source_name (str): Name of the source</span> +</span><span id="Scope.source_columns-380"><a href="#Scope.source_columns-380"><span class="linenos">380</span></a><span class="sd"> Returns:</span> +</span><span id="Scope.source_columns-381"><a href="#Scope.source_columns-381"><span class="linenos">381</span></a><span class="sd"> list[exp.Column]: Column instances that reference `source_name`</span> +</span><span id="Scope.source_columns-382"><a href="#Scope.source_columns-382"><span class="linenos">382</span></a><span class="sd"> """</span> +</span><span id="Scope.source_columns-383"><a href="#Scope.source_columns-383"><span class="linenos">383</span></a> <span class="k">return</span> <span class="p">[</span><span class="n">column</span> <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">columns</span> <span class="k">if</span> <span class="n">column</span><span class="o">.</span><span class="n">table</span> <span class="o">==</span> <span class="n">source_name</span><span class="p">]</span> </span></pre></div> @@ -2113,10 +2120,10 @@ table only becomes a selected source if it's included in a FROM or JOIN clause.< </div> <a class="headerlink" href="#Scope.rename_source"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.rename_source-417"><a href="#Scope.rename_source-417"><span class="linenos">417</span></a> <span class="k">def</span> <span class="nf">rename_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old_name</span><span class="p">,</span> <span class="n">new_name</span><span class="p">):</span> -</span><span id="Scope.rename_source-418"><a href="#Scope.rename_source-418"><span class="linenos">418</span></a><span class="w"> </span><span class="sd">"""Rename a source in this scope"""</span> -</span><span id="Scope.rename_source-419"><a href="#Scope.rename_source-419"><span class="linenos">419</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">old_name</span> <span class="ow">or</span> <span class="s2">""</span><span class="p">,</span> <span class="p">[])</span> -</span><span id="Scope.rename_source-420"><a href="#Scope.rename_source-420"><span class="linenos">420</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">new_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">columns</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.rename_source-420"><a href="#Scope.rename_source-420"><span class="linenos">420</span></a> <span class="k">def</span> <span class="nf">rename_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">old_name</span><span class="p">,</span> <span class="n">new_name</span><span class="p">):</span> +</span><span id="Scope.rename_source-421"><a href="#Scope.rename_source-421"><span class="linenos">421</span></a><span class="w"> </span><span class="sd">"""Rename a source in this scope"""</span> +</span><span id="Scope.rename_source-422"><a href="#Scope.rename_source-422"><span class="linenos">422</span></a> <span class="n">columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">old_name</span> <span class="ow">or</span> <span class="s2">""</span><span class="p">,</span> <span class="p">[])</span> +</span><span id="Scope.rename_source-423"><a href="#Scope.rename_source-423"><span class="linenos">423</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">new_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">columns</span> </span></pre></div> @@ -2136,10 +2143,10 @@ table only becomes a selected source if it's included in a FROM or JOIN clause.< </div> <a class="headerlink" href="#Scope.add_source"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.add_source-422"><a href="#Scope.add_source-422"><span class="linenos">422</span></a> <span class="k">def</span> <span class="nf">add_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="p">):</span> -</span><span id="Scope.add_source-423"><a href="#Scope.add_source-423"><span class="linenos">423</span></a><span class="w"> </span><span class="sd">"""Add a source to this scope"""</span> -</span><span id="Scope.add_source-424"><a href="#Scope.add_source-424"><span class="linenos">424</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">source</span> -</span><span id="Scope.add_source-425"><a href="#Scope.add_source-425"><span class="linenos">425</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.add_source-425"><a href="#Scope.add_source-425"><span class="linenos">425</span></a> <span class="k">def</span> <span class="nf">add_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="p">):</span> +</span><span id="Scope.add_source-426"><a href="#Scope.add_source-426"><span class="linenos">426</span></a><span class="w"> </span><span class="sd">"""Add a source to this scope"""</span> +</span><span id="Scope.add_source-427"><a href="#Scope.add_source-427"><span class="linenos">427</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">source</span> +</span><span id="Scope.add_source-428"><a href="#Scope.add_source-428"><span class="linenos">428</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> </span></pre></div> @@ -2159,10 +2166,10 @@ table only becomes a selected source if it's included in a FROM or JOIN clause.< </div> <a class="headerlink" href="#Scope.remove_source"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.remove_source-427"><a href="#Scope.remove_source-427"><span class="linenos">427</span></a> <span class="k">def</span> <span class="nf">remove_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span> -</span><span id="Scope.remove_source-428"><a href="#Scope.remove_source-428"><span class="linenos">428</span></a><span class="w"> </span><span class="sd">"""Remove a source from this scope"""</span> -</span><span id="Scope.remove_source-429"><a href="#Scope.remove_source-429"><span class="linenos">429</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> -</span><span id="Scope.remove_source-430"><a href="#Scope.remove_source-430"><span class="linenos">430</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.remove_source-430"><a href="#Scope.remove_source-430"><span class="linenos">430</span></a> <span class="k">def</span> <span class="nf">remove_source</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">):</span> +</span><span id="Scope.remove_source-431"><a href="#Scope.remove_source-431"><span class="linenos">431</span></a><span class="w"> </span><span class="sd">"""Remove a source from this scope"""</span> +</span><span id="Scope.remove_source-432"><a href="#Scope.remove_source-432"><span class="linenos">432</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">sources</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span> +</span><span id="Scope.remove_source-433"><a href="#Scope.remove_source-433"><span class="linenos">433</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">clear_cache</span><span class="p">()</span> </span></pre></div> @@ -2182,18 +2189,18 @@ table only becomes a selected source if it's included in a FROM or JOIN clause.< </div> <a class="headerlink" href="#Scope.traverse"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.traverse-435"><a href="#Scope.traverse-435"><span class="linenos">435</span></a> <span class="k">def</span> <span class="nf">traverse</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope.traverse-436"><a href="#Scope.traverse-436"><span class="linenos">436</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope.traverse-437"><a href="#Scope.traverse-437"><span class="linenos">437</span></a><span class="sd"> Traverse the scope tree from this node.</span> -</span><span id="Scope.traverse-438"><a href="#Scope.traverse-438"><span class="linenos">438</span></a> -</span><span id="Scope.traverse-439"><a href="#Scope.traverse-439"><span class="linenos">439</span></a><span class="sd"> Yields:</span> -</span><span id="Scope.traverse-440"><a href="#Scope.traverse-440"><span class="linenos">440</span></a><span class="sd"> Scope: scope instances in depth-first-search post-order</span> -</span><span id="Scope.traverse-441"><a href="#Scope.traverse-441"><span class="linenos">441</span></a><span class="sd"> """</span> -</span><span id="Scope.traverse-442"><a href="#Scope.traverse-442"><span class="linenos">442</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span> -</span><span id="Scope.traverse-443"><a href="#Scope.traverse-443"><span class="linenos">443</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> -</span><span id="Scope.traverse-444"><a href="#Scope.traverse-444"><span class="linenos">444</span></a> <span class="p">):</span> -</span><span id="Scope.traverse-445"><a href="#Scope.traverse-445"><span class="linenos">445</span></a> <span class="k">yield from</span> <span class="n">child_scope</span><span class="o">.</span><span class="n">traverse</span><span class="p">()</span> -</span><span id="Scope.traverse-446"><a href="#Scope.traverse-446"><span class="linenos">446</span></a> <span class="k">yield</span> <span class="bp">self</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.traverse-438"><a href="#Scope.traverse-438"><span class="linenos">438</span></a> <span class="k">def</span> <span class="nf">traverse</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope.traverse-439"><a href="#Scope.traverse-439"><span class="linenos">439</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope.traverse-440"><a href="#Scope.traverse-440"><span class="linenos">440</span></a><span class="sd"> Traverse the scope tree from this node.</span> +</span><span id="Scope.traverse-441"><a href="#Scope.traverse-441"><span class="linenos">441</span></a> +</span><span id="Scope.traverse-442"><a href="#Scope.traverse-442"><span class="linenos">442</span></a><span class="sd"> Yields:</span> +</span><span id="Scope.traverse-443"><a href="#Scope.traverse-443"><span class="linenos">443</span></a><span class="sd"> Scope: scope instances in depth-first-search post-order</span> +</span><span id="Scope.traverse-444"><a href="#Scope.traverse-444"><span class="linenos">444</span></a><span class="sd"> """</span> +</span><span id="Scope.traverse-445"><a href="#Scope.traverse-445"><span class="linenos">445</span></a> <span class="k">for</span> <span class="n">child_scope</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">chain</span><span class="p">(</span> +</span><span id="Scope.traverse-446"><a href="#Scope.traverse-446"><span class="linenos">446</span></a> <span class="bp">self</span><span class="o">.</span><span class="n">cte_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">union_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">table_scopes</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">subquery_scopes</span> +</span><span id="Scope.traverse-447"><a href="#Scope.traverse-447"><span class="linenos">447</span></a> <span class="p">):</span> +</span><span id="Scope.traverse-448"><a href="#Scope.traverse-448"><span class="linenos">448</span></a> <span class="k">yield from</span> <span class="n">child_scope</span><span class="o">.</span><span class="n">traverse</span><span class="p">()</span> +</span><span id="Scope.traverse-449"><a href="#Scope.traverse-449"><span class="linenos">449</span></a> <span class="k">yield</span> <span class="bp">self</span> </span></pre></div> @@ -2219,20 +2226,20 @@ table only becomes a selected source if it's included in a FROM or JOIN clause.< </div> <a class="headerlink" href="#Scope.ref_count"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.ref_count-448"><a href="#Scope.ref_count-448"><span class="linenos">448</span></a> <span class="k">def</span> <span class="nf">ref_count</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> -</span><span id="Scope.ref_count-449"><a href="#Scope.ref_count-449"><span class="linenos">449</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="Scope.ref_count-450"><a href="#Scope.ref_count-450"><span class="linenos">450</span></a><span class="sd"> Count the number of times each scope in this tree is referenced.</span> -</span><span id="Scope.ref_count-451"><a href="#Scope.ref_count-451"><span class="linenos">451</span></a> -</span><span id="Scope.ref_count-452"><a href="#Scope.ref_count-452"><span class="linenos">452</span></a><span class="sd"> Returns:</span> -</span><span id="Scope.ref_count-453"><a href="#Scope.ref_count-453"><span class="linenos">453</span></a><span class="sd"> dict[int, int]: Mapping of Scope instance ID to reference count</span> -</span><span id="Scope.ref_count-454"><a href="#Scope.ref_count-454"><span class="linenos">454</span></a><span class="sd"> """</span> -</span><span id="Scope.ref_count-455"><a href="#Scope.ref_count-455"><span class="linenos">455</span></a> <span class="n">scope_ref_count</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="mi">0</span><span class="p">)</span> -</span><span id="Scope.ref_count-456"><a href="#Scope.ref_count-456"><span class="linenos">456</span></a> -</span><span id="Scope.ref_count-457"><a href="#Scope.ref_count-457"><span class="linenos">457</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">traverse</span><span class="p">():</span> -</span><span id="Scope.ref_count-458"><a href="#Scope.ref_count-458"><span class="linenos">458</span></a> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">values</span><span class="p">():</span> -</span><span id="Scope.ref_count-459"><a href="#Scope.ref_count-459"><span class="linenos">459</span></a> <span class="n">scope_ref_count</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">source</span><span class="p">)]</span> <span class="o">+=</span> <span class="mi">1</span> -</span><span id="Scope.ref_count-460"><a href="#Scope.ref_count-460"><span class="linenos">460</span></a> -</span><span id="Scope.ref_count-461"><a href="#Scope.ref_count-461"><span class="linenos">461</span></a> <span class="k">return</span> <span class="n">scope_ref_count</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="Scope.ref_count-451"><a href="#Scope.ref_count-451"><span class="linenos">451</span></a> <span class="k">def</span> <span class="nf">ref_count</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> +</span><span id="Scope.ref_count-452"><a href="#Scope.ref_count-452"><span class="linenos">452</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="Scope.ref_count-453"><a href="#Scope.ref_count-453"><span class="linenos">453</span></a><span class="sd"> Count the number of times each scope in this tree is referenced.</span> +</span><span id="Scope.ref_count-454"><a href="#Scope.ref_count-454"><span class="linenos">454</span></a> +</span><span id="Scope.ref_count-455"><a href="#Scope.ref_count-455"><span class="linenos">455</span></a><span class="sd"> Returns:</span> +</span><span id="Scope.ref_count-456"><a href="#Scope.ref_count-456"><span class="linenos">456</span></a><span class="sd"> dict[int, int]: Mapping of Scope instance ID to reference count</span> +</span><span id="Scope.ref_count-457"><a href="#Scope.ref_count-457"><span class="linenos">457</span></a><span class="sd"> """</span> +</span><span id="Scope.ref_count-458"><a href="#Scope.ref_count-458"><span class="linenos">458</span></a> <span class="n">scope_ref_count</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="mi">0</span><span class="p">)</span> +</span><span id="Scope.ref_count-459"><a href="#Scope.ref_count-459"><span class="linenos">459</span></a> +</span><span id="Scope.ref_count-460"><a href="#Scope.ref_count-460"><span class="linenos">460</span></a> <span class="k">for</span> <span class="n">scope</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">traverse</span><span class="p">():</span> +</span><span id="Scope.ref_count-461"><a href="#Scope.ref_count-461"><span class="linenos">461</span></a> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">source</span> <span class="ow">in</span> <span class="n">scope</span><span class="o">.</span><span class="n">selected_sources</span><span class="o">.</span><span class="n">values</span><span class="p">():</span> +</span><span id="Scope.ref_count-462"><a href="#Scope.ref_count-462"><span class="linenos">462</span></a> <span class="n">scope_ref_count</span><span class="p">[</span><span class="nb">id</span><span class="p">(</span><span class="n">source</span><span class="p">)]</span> <span class="o">+=</span> <span class="mi">1</span> +</span><span id="Scope.ref_count-463"><a href="#Scope.ref_count-463"><span class="linenos">463</span></a> +</span><span id="Scope.ref_count-464"><a href="#Scope.ref_count-464"><span class="linenos">464</span></a> <span class="k">return</span> <span class="n">scope_ref_count</span> </span></pre></div> @@ -2259,32 +2266,32 @@ table only becomes a selected source if it's included in a FROM or JOIN clause.< </div> <a class="headerlink" href="#traverse_scope"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="traverse_scope-464"><a href="#traverse_scope-464"><span class="linenos">464</span></a><span class="k">def</span> <span class="nf">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> -</span><span id="traverse_scope-465"><a href="#traverse_scope-465"><span class="linenos">465</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="traverse_scope-466"><a href="#traverse_scope-466"><span class="linenos">466</span></a><span class="sd"> Traverse an expression by it's "scopes".</span> -</span><span id="traverse_scope-467"><a href="#traverse_scope-467"><span class="linenos">467</span></a> -</span><span id="traverse_scope-468"><a href="#traverse_scope-468"><span class="linenos">468</span></a><span class="sd"> "Scope" represents the current context of a Select statement.</span> -</span><span id="traverse_scope-469"><a href="#traverse_scope-469"><span class="linenos">469</span></a> -</span><span id="traverse_scope-470"><a href="#traverse_scope-470"><span class="linenos">470</span></a><span class="sd"> This is helpful for optimizing queries, where we need more information than</span> -</span><span id="traverse_scope-471"><a href="#traverse_scope-471"><span class="linenos">471</span></a><span class="sd"> the expression tree itself. For example, we might care about the source</span> -</span><span id="traverse_scope-472"><a href="#traverse_scope-472"><span class="linenos">472</span></a><span class="sd"> names within a subquery. Returns a list because a generator could result in</span> -</span><span id="traverse_scope-473"><a href="#traverse_scope-473"><span class="linenos">473</span></a><span class="sd"> incomplete properties which is confusing.</span> -</span><span id="traverse_scope-474"><a href="#traverse_scope-474"><span class="linenos">474</span></a> -</span><span id="traverse_scope-475"><a href="#traverse_scope-475"><span class="linenos">475</span></a><span class="sd"> Examples:</span> -</span><span id="traverse_scope-476"><a href="#traverse_scope-476"><span class="linenos">476</span></a><span class="sd"> >>> import sqlglot</span> -</span><span id="traverse_scope-477"><a href="#traverse_scope-477"><span class="linenos">477</span></a><span class="sd"> >>> expression = sqlglot.parse_one("SELECT a FROM (SELECT a FROM x) AS y")</span> -</span><span id="traverse_scope-478"><a href="#traverse_scope-478"><span class="linenos">478</span></a><span class="sd"> >>> scopes = traverse_scope(expression)</span> -</span><span id="traverse_scope-479"><a href="#traverse_scope-479"><span class="linenos">479</span></a><span class="sd"> >>> scopes[0].expression.sql(), list(scopes[0].sources)</span> -</span><span id="traverse_scope-480"><a href="#traverse_scope-480"><span class="linenos">480</span></a><span class="sd"> ('SELECT a FROM x', ['x'])</span> -</span><span id="traverse_scope-481"><a href="#traverse_scope-481"><span class="linenos">481</span></a><span class="sd"> >>> scopes[1].expression.sql(), list(scopes[1].sources)</span> -</span><span id="traverse_scope-482"><a href="#traverse_scope-482"><span class="linenos">482</span></a><span class="sd"> ('SELECT a FROM (SELECT a FROM x) AS y', ['y'])</span> -</span><span id="traverse_scope-483"><a href="#traverse_scope-483"><span class="linenos">483</span></a> -</span><span id="traverse_scope-484"><a href="#traverse_scope-484"><span class="linenos">484</span></a><span class="sd"> Args:</span> -</span><span id="traverse_scope-485"><a href="#traverse_scope-485"><span class="linenos">485</span></a><span class="sd"> expression (exp.Expression): expression to traverse</span> -</span><span id="traverse_scope-486"><a href="#traverse_scope-486"><span class="linenos">486</span></a><span class="sd"> Returns:</span> -</span><span id="traverse_scope-487"><a href="#traverse_scope-487"><span class="linenos">487</span></a><span class="sd"> list[Scope]: scope instances</span> -</span><span id="traverse_scope-488"><a href="#traverse_scope-488"><span class="linenos">488</span></a><span class="sd"> """</span> -</span><span id="traverse_scope-489"><a href="#traverse_scope-489"><span class="linenos">489</span></a> <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">_traverse_scope</span><span class="p">(</span><span class="n">Scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)))</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="traverse_scope-467"><a href="#traverse_scope-467"><span class="linenos">467</span></a><span class="k">def</span> <span class="nf">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> +</span><span id="traverse_scope-468"><a href="#traverse_scope-468"><span class="linenos">468</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="traverse_scope-469"><a href="#traverse_scope-469"><span class="linenos">469</span></a><span class="sd"> Traverse an expression by it's "scopes".</span> +</span><span id="traverse_scope-470"><a href="#traverse_scope-470"><span class="linenos">470</span></a> +</span><span id="traverse_scope-471"><a href="#traverse_scope-471"><span class="linenos">471</span></a><span class="sd"> "Scope" represents the current context of a Select statement.</span> +</span><span id="traverse_scope-472"><a href="#traverse_scope-472"><span class="linenos">472</span></a> +</span><span id="traverse_scope-473"><a href="#traverse_scope-473"><span class="linenos">473</span></a><span class="sd"> This is helpful for optimizing queries, where we need more information than</span> +</span><span id="traverse_scope-474"><a href="#traverse_scope-474"><span class="linenos">474</span></a><span class="sd"> the expression tree itself. For example, we might care about the source</span> +</span><span id="traverse_scope-475"><a href="#traverse_scope-475"><span class="linenos">475</span></a><span class="sd"> names within a subquery. Returns a list because a generator could result in</span> +</span><span id="traverse_scope-476"><a href="#traverse_scope-476"><span class="linenos">476</span></a><span class="sd"> incomplete properties which is confusing.</span> +</span><span id="traverse_scope-477"><a href="#traverse_scope-477"><span class="linenos">477</span></a> +</span><span id="traverse_scope-478"><a href="#traverse_scope-478"><span class="linenos">478</span></a><span class="sd"> Examples:</span> +</span><span id="traverse_scope-479"><a href="#traverse_scope-479"><span class="linenos">479</span></a><span class="sd"> >>> import sqlglot</span> +</span><span id="traverse_scope-480"><a href="#traverse_scope-480"><span class="linenos">480</span></a><span class="sd"> >>> expression = sqlglot.parse_one("SELECT a FROM (SELECT a FROM x) AS y")</span> +</span><span id="traverse_scope-481"><a href="#traverse_scope-481"><span class="linenos">481</span></a><span class="sd"> >>> scopes = traverse_scope(expression)</span> +</span><span id="traverse_scope-482"><a href="#traverse_scope-482"><span class="linenos">482</span></a><span class="sd"> >>> scopes[0].expression.sql(), list(scopes[0].sources)</span> +</span><span id="traverse_scope-483"><a href="#traverse_scope-483"><span class="linenos">483</span></a><span class="sd"> ('SELECT a FROM x', ['x'])</span> +</span><span id="traverse_scope-484"><a href="#traverse_scope-484"><span class="linenos">484</span></a><span class="sd"> >>> scopes[1].expression.sql(), list(scopes[1].sources)</span> +</span><span id="traverse_scope-485"><a href="#traverse_scope-485"><span class="linenos">485</span></a><span class="sd"> ('SELECT a FROM (SELECT a FROM x) AS y', ['y'])</span> +</span><span id="traverse_scope-486"><a href="#traverse_scope-486"><span class="linenos">486</span></a> +</span><span id="traverse_scope-487"><a href="#traverse_scope-487"><span class="linenos">487</span></a><span class="sd"> Args:</span> +</span><span id="traverse_scope-488"><a href="#traverse_scope-488"><span class="linenos">488</span></a><span class="sd"> expression (exp.Expression): expression to traverse</span> +</span><span id="traverse_scope-489"><a href="#traverse_scope-489"><span class="linenos">489</span></a><span class="sd"> Returns:</span> +</span><span id="traverse_scope-490"><a href="#traverse_scope-490"><span class="linenos">490</span></a><span class="sd"> list[Scope]: scope instances</span> +</span><span id="traverse_scope-491"><a href="#traverse_scope-491"><span class="linenos">491</span></a><span class="sd"> """</span> +</span><span id="traverse_scope-492"><a href="#traverse_scope-492"><span class="linenos">492</span></a> <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">_traverse_scope</span><span class="p">(</span><span class="n">Scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)))</span> </span></pre></div> @@ -2338,16 +2345,16 @@ incomplete properties which is confusing.</p> </div> <a class="headerlink" href="#build_scope"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="build_scope-492"><a href="#build_scope-492"><span class="linenos">492</span></a><span class="k">def</span> <span class="nf">build_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> -</span><span id="build_scope-493"><a href="#build_scope-493"><span class="linenos">493</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="build_scope-494"><a href="#build_scope-494"><span class="linenos">494</span></a><span class="sd"> Build a scope tree.</span> -</span><span id="build_scope-495"><a href="#build_scope-495"><span class="linenos">495</span></a> -</span><span id="build_scope-496"><a href="#build_scope-496"><span class="linenos">496</span></a><span class="sd"> Args:</span> -</span><span id="build_scope-497"><a href="#build_scope-497"><span class="linenos">497</span></a><span class="sd"> expression (exp.Expression): expression to build the scope tree for</span> -</span><span id="build_scope-498"><a href="#build_scope-498"><span class="linenos">498</span></a><span class="sd"> Returns:</span> -</span><span id="build_scope-499"><a href="#build_scope-499"><span class="linenos">499</span></a><span class="sd"> Scope: root scope</span> -</span><span id="build_scope-500"><a href="#build_scope-500"><span class="linenos">500</span></a><span class="sd"> """</span> -</span><span id="build_scope-501"><a href="#build_scope-501"><span class="linenos">501</span></a> <span class="k">return</span> <span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="build_scope-495"><a href="#build_scope-495"><span class="linenos">495</span></a><span class="k">def</span> <span class="nf">build_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">):</span> +</span><span id="build_scope-496"><a href="#build_scope-496"><span class="linenos">496</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="build_scope-497"><a href="#build_scope-497"><span class="linenos">497</span></a><span class="sd"> Build a scope tree.</span> +</span><span id="build_scope-498"><a href="#build_scope-498"><span class="linenos">498</span></a> +</span><span id="build_scope-499"><a href="#build_scope-499"><span class="linenos">499</span></a><span class="sd"> Args:</span> +</span><span id="build_scope-500"><a href="#build_scope-500"><span class="linenos">500</span></a><span class="sd"> expression (exp.Expression): expression to build the scope tree for</span> +</span><span id="build_scope-501"><a href="#build_scope-501"><span class="linenos">501</span></a><span class="sd"> Returns:</span> +</span><span id="build_scope-502"><a href="#build_scope-502"><span class="linenos">502</span></a><span class="sd"> Scope: root scope</span> +</span><span id="build_scope-503"><a href="#build_scope-503"><span class="linenos">503</span></a><span class="sd"> """</span> +</span><span id="build_scope-504"><a href="#build_scope-504"><span class="linenos">504</span></a> <span class="k">return</span> <span class="n">traverse_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">)[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span> </span></pre></div> @@ -2379,37 +2386,37 @@ incomplete properties which is confusing.</p> </div> <a class="headerlink" href="#walk_in_scope"></a> - <div class="pdoc-code codehilite"><pre><span></span><span id="walk_in_scope-644"><a href="#walk_in_scope-644"><span class="linenos">644</span></a><span class="k">def</span> <span class="nf">walk_in_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> -</span><span id="walk_in_scope-645"><a href="#walk_in_scope-645"><span class="linenos">645</span></a><span class="w"> </span><span class="sd">"""</span> -</span><span id="walk_in_scope-646"><a href="#walk_in_scope-646"><span class="linenos">646</span></a><span class="sd"> Returns a generator object which visits all nodes in the syntrax tree, stopping at</span> -</span><span id="walk_in_scope-647"><a href="#walk_in_scope-647"><span class="linenos">647</span></a><span class="sd"> nodes that start child scopes.</span> -</span><span id="walk_in_scope-648"><a href="#walk_in_scope-648"><span class="linenos">648</span></a> -</span><span id="walk_in_scope-649"><a href="#walk_in_scope-649"><span class="linenos">649</span></a><span class="sd"> Args:</span> -</span><span id="walk_in_scope-650"><a href="#walk_in_scope-650"><span class="linenos">650</span></a><span class="sd"> expression (exp.Expression):</span> -</span><span id="walk_in_scope-651"><a href="#walk_in_scope-651"><span class="linenos">651</span></a><span class="sd"> bfs (bool): if set to True the BFS traversal order will be applied,</span> -</span><span id="walk_in_scope-652"><a href="#walk_in_scope-652"><span class="linenos">652</span></a><span class="sd"> otherwise the DFS traversal will be used instead.</span> + <div class="pdoc-code codehilite"><pre><span></span><span id="walk_in_scope-649"><a href="#walk_in_scope-649"><span class="linenos">649</span></a><span class="k">def</span> <span class="nf">walk_in_scope</span><span class="p">(</span><span class="n">expression</span><span class="p">,</span> <span class="n">bfs</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span> +</span><span id="walk_in_scope-650"><a href="#walk_in_scope-650"><span class="linenos">650</span></a><span class="w"> </span><span class="sd">"""</span> +</span><span id="walk_in_scope-651"><a href="#walk_in_scope-651"><span class="linenos">651</span></a><span class="sd"> Returns a generator object which visits all nodes in the syntrax tree, stopping at</span> +</span><span id="walk_in_scope-652"><a href="#walk_in_scope-652"><span class="linenos">652</span></a><span class="sd"> nodes that start child scopes.</span> </span><span id="walk_in_scope-653"><a href="#walk_in_scope-653"><span class="linenos">653</span></a> -</span><span id="walk_in_scope-654"><a href="#walk_in_scope-654"><span class="linenos">654</span></a><span class="sd"> Yields:</span> -</span><span id="walk_in_scope-655"><a href="#walk_in_scope-655"><span class="linenos">655</span></a><span class="sd"> tuple[exp.Expression, Optional[exp.Expression], str]: node, parent, arg key</span> -</span><span id="walk_in_scope-656"><a href="#walk_in_scope-656"><span class="linenos">656</span></a><span class="sd"> """</span> -</span><span id="walk_in_scope-657"><a href="#walk_in_scope-657"><span class="linenos">657</span></a> <span class="c1"># We'll use this variable to pass state into the dfs generator.</span> -</span><span id="walk_in_scope-658"><a href="#walk_in_scope-658"><span class="linenos">658</span></a> <span class="c1"># Whenever we set it to True, we exclude a subtree from traversal.</span> -</span><span id="walk_in_scope-659"><a href="#walk_in_scope-659"><span class="linenos">659</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="walk_in_scope-660"><a href="#walk_in_scope-660"><span class="linenos">660</span></a> -</span><span id="walk_in_scope-661"><a href="#walk_in_scope-661"><span class="linenos">661</span></a> <span class="k">for</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">expression</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">,</span> <span class="n">prune</span><span class="o">=</span><span class="k">lambda</span> <span class="o">*</span><span class="n">_</span><span class="p">:</span> <span class="n">prune</span><span class="p">):</span> -</span><span id="walk_in_scope-662"><a href="#walk_in_scope-662"><span class="linenos">662</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">False</span> -</span><span id="walk_in_scope-663"><a href="#walk_in_scope-663"><span class="linenos">663</span></a> -</span><span id="walk_in_scope-664"><a href="#walk_in_scope-664"><span class="linenos">664</span></a> <span class="k">yield</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">key</span> +</span><span id="walk_in_scope-654"><a href="#walk_in_scope-654"><span class="linenos">654</span></a><span class="sd"> Args:</span> +</span><span id="walk_in_scope-655"><a href="#walk_in_scope-655"><span class="linenos">655</span></a><span class="sd"> expression (exp.Expression):</span> +</span><span id="walk_in_scope-656"><a href="#walk_in_scope-656"><span class="linenos">656</span></a><span class="sd"> bfs (bool): if set to True the BFS traversal order will be applied,</span> +</span><span id="walk_in_scope-657"><a href="#walk_in_scope-657"><span class="linenos">657</span></a><span class="sd"> otherwise the DFS traversal will be used instead.</span> +</span><span id="walk_in_scope-658"><a href="#walk_in_scope-658"><span class="linenos">658</span></a> +</span><span id="walk_in_scope-659"><a href="#walk_in_scope-659"><span class="linenos">659</span></a><span class="sd"> Yields:</span> +</span><span id="walk_in_scope-660"><a href="#walk_in_scope-660"><span class="linenos">660</span></a><span class="sd"> tuple[exp.Expression, Optional[exp.Expression], str]: node, parent, arg key</span> +</span><span id="walk_in_scope-661"><a href="#walk_in_scope-661"><span class="linenos">661</span></a><span class="sd"> """</span> +</span><span id="walk_in_scope-662"><a href="#walk_in_scope-662"><span class="linenos">662</span></a> <span class="c1"># We'll use this variable to pass state into the dfs generator.</span> +</span><span id="walk_in_scope-663"><a href="#walk_in_scope-663"><span class="linenos">663</span></a> <span class="c1"># Whenever we set it to True, we exclude a subtree from traversal.</span> +</span><span id="walk_in_scope-664"><a href="#walk_in_scope-664"><span class="linenos">664</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">False</span> </span><span id="walk_in_scope-665"><a href="#walk_in_scope-665"><span class="linenos">665</span></a> -</span><span id="walk_in_scope-666"><a href="#walk_in_scope-666"><span class="linenos">666</span></a> <span class="k">if</span> <span class="n">node</span> <span class="ow">is</span> <span class="n">expression</span><span class="p">:</span> -</span><span id="walk_in_scope-667"><a href="#walk_in_scope-667"><span class="linenos">667</span></a> <span class="k">continue</span> -</span><span id="walk_in_scope-668"><a href="#walk_in_scope-668"><span class="linenos">668</span></a> <span class="k">if</span> <span class="p">(</span> -</span><span id="walk_in_scope-669"><a href="#walk_in_scope-669"><span class="linenos">669</span></a> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">CTE</span><span class="p">)</span> -</span><span id="walk_in_scope-670"><a href="#walk_in_scope-670"><span class="linenos">670</span></a> <span class="ow">or</span> <span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">parent</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">From</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">)))</span> -</span><span id="walk_in_scope-671"><a href="#walk_in_scope-671"><span class="linenos">671</span></a> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">)</span> -</span><span id="walk_in_scope-672"><a href="#walk_in_scope-672"><span class="linenos">672</span></a> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">)</span> -</span><span id="walk_in_scope-673"><a href="#walk_in_scope-673"><span class="linenos">673</span></a> <span class="p">):</span> -</span><span id="walk_in_scope-674"><a href="#walk_in_scope-674"><span class="linenos">674</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">True</span> +</span><span id="walk_in_scope-666"><a href="#walk_in_scope-666"><span class="linenos">666</span></a> <span class="k">for</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">expression</span><span class="o">.</span><span class="n">walk</span><span class="p">(</span><span class="n">bfs</span><span class="o">=</span><span class="n">bfs</span><span class="p">,</span> <span class="n">prune</span><span class="o">=</span><span class="k">lambda</span> <span class="o">*</span><span class="n">_</span><span class="p">:</span> <span class="n">prune</span><span class="p">):</span> +</span><span id="walk_in_scope-667"><a href="#walk_in_scope-667"><span class="linenos">667</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">False</span> +</span><span id="walk_in_scope-668"><a href="#walk_in_scope-668"><span class="linenos">668</span></a> +</span><span id="walk_in_scope-669"><a href="#walk_in_scope-669"><span class="linenos">669</span></a> <span class="k">yield</span> <span class="n">node</span><span class="p">,</span> <span class="n">parent</span><span class="p">,</span> <span class="n">key</span> +</span><span id="walk_in_scope-670"><a href="#walk_in_scope-670"><span class="linenos">670</span></a> +</span><span id="walk_in_scope-671"><a href="#walk_in_scope-671"><span class="linenos">671</span></a> <span class="k">if</span> <span class="n">node</span> <span class="ow">is</span> <span class="n">expression</span><span class="p">:</span> +</span><span id="walk_in_scope-672"><a href="#walk_in_scope-672"><span class="linenos">672</span></a> <span class="k">continue</span> +</span><span id="walk_in_scope-673"><a href="#walk_in_scope-673"><span class="linenos">673</span></a> <span class="k">if</span> <span class="p">(</span> +</span><span id="walk_in_scope-674"><a href="#walk_in_scope-674"><span class="linenos">674</span></a> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">CTE</span><span class="p">)</span> +</span><span id="walk_in_scope-675"><a href="#walk_in_scope-675"><span class="linenos">675</span></a> <span class="ow">or</span> <span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subquery</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">parent</span><span class="p">,</span> <span class="p">(</span><span class="n">exp</span><span class="o">.</span><span class="n">From</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Join</span><span class="p">)))</span> +</span><span id="walk_in_scope-676"><a href="#walk_in_scope-676"><span class="linenos">676</span></a> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">UDTF</span><span class="p">)</span> +</span><span id="walk_in_scope-677"><a href="#walk_in_scope-677"><span class="linenos">677</span></a> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">node</span><span class="p">,</span> <span class="n">exp</span><span class="o">.</span><span class="n">Subqueryable</span><span class="p">)</span> +</span><span id="walk_in_scope-678"><a href="#walk_in_scope-678"><span class="linenos">678</span></a> <span class="p">):</span> +</span><span id="walk_in_scope-679"><a href="#walk_in_scope-679"><span class="linenos">679</span></a> <span class="n">prune</span> <span class="o">=</span> <span class="kc">True</span> </span></pre></div> |