Skip to content

Commit

Permalink
build based on 3aa5eae
Browse files Browse the repository at this point in the history
  • Loading branch information
Documenter.jl committed Jan 8, 2025
1 parent 3e8ca11 commit 4575015
Show file tree
Hide file tree
Showing 4 changed files with 51 additions and 51 deletions.
23 changes: 12 additions & 11 deletions latest/examples/generated/UserGuide/ex_joining/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -826,7 +826,7 @@ <h1>Joining Tables</h1>
<h2 id="general-syntax">General Syntax<a class="headerlink" href="#general-syntax" title="Permanent link">¤</a></h2>
<p>All joins share the same argument format</p>
<ul>
<li>`*<em>join(query, join</em>table, joining_keys...)</li>
<li><code>*_join(query, join_table, joining_keys...)</code></li>
</ul>
<p><a id='Equi-Joins'></a></p>
<p><a id='Equi-Joins-1'></a></p>
Expand Down Expand Up @@ -987,16 +987,17 @@ <h2 id="using-a-view">Using a View<a class="headerlink" href="#using-a-view" tit
<p><a id='AsOf/Rolling-join-1'></a></p>
<h2 id="asofrolling-join">AsOf/Rolling join<a class="headerlink" href="#asofrolling-join" title="Permanent link">¤</a></h2>
<p>This example reproduces an example in the (DuckDB Docs)[https://duckdb.org/docs/guides/sql<em>features/asof</em>join.html#what-is-an-asof-join]</p>
<div class="highlight"><pre><span></span><code>prices = db_table(db, &quot;https://duckdb.org/data/prices.csv&quot;, &quot;prices&quot;)
holdings = db_table(db, &quot;https://duckdb.org/data/holdings.csv&quot;, &quot;holdings&quot;)

@chain t(holdings) begin
@inner_join(t(prices), ticker = ticker, closest(when &gt;= when))
@select(holdings.ticker, holdings.when)
@mutate(value = price * shares)
@collect
end
4×3 DataFrame
<div class="highlight"><pre><span></span><code><span class="n">prices</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">db_table</span><span class="p">(</span><span class="n">db</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;https://duckdb.org/data/prices.csv&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;prices&quot;</span><span class="p">)</span>
<span class="n">holdings</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">db_table</span><span class="p">(</span><span class="n">db</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;https://duckdb.org/data/holdings.csv&quot;</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;holdings&quot;</span><span class="p">)</span>

<span class="nd">@chain</span><span class="w"> </span><span class="n">t</span><span class="p">(</span><span class="n">holdings</span><span class="p">)</span><span class="w"> </span><span class="k">begin</span>
<span class="w"> </span><span class="nd">@inner_join</span><span class="p">(</span><span class="n">t</span><span class="p">(</span><span class="n">prices</span><span class="p">),</span><span class="w"> </span><span class="n">ticker</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ticker</span><span class="p">,</span><span class="w"> </span><span class="n">closest</span><span class="p">(</span><span class="n">when</span><span class="w"> </span><span class="o">&gt;=</span><span class="w"> </span><span class="n">when</span><span class="p">))</span>
<span class="w"> </span><span class="nd">@select</span><span class="p">(</span><span class="n">holdings</span><span class="o">.</span><span class="n">ticker</span><span class="p">,</span><span class="w"> </span><span class="n">holdings</span><span class="o">.</span><span class="n">when</span><span class="p">)</span>
<span class="w"> </span><span class="nd">@mutate</span><span class="p">(</span><span class="n">value</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">price</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">shares</span><span class="p">)</span>
<span class="w"> </span><span class="nd">@collect</span>
<span class="k">end</span>
</code></pre></div>
<div class="highlight"><pre><span></span><code> 4×3 DataFrame
Row │ ticker when value
│ String DateTime Float64
─────┼──────────────────────────────────────
Expand Down
13 changes: 6 additions & 7 deletions latest/examples/generated/UserGuide/from_queryex/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -721,9 +721,9 @@ <h1>Reusing a Query (and Views)</h1>
<p><a id='Setup-1'></a></p>
<h2 id="setup">Setup<a class="headerlink" href="#setup" title="Permanent link">¤</a></h2>
<div class="highlight"><pre><span></span><code><span class="k">import</span><span class="w"> </span><span class="n">TidierDB</span><span class="w"> </span><span class="n">as</span><span class="w"> </span><span class="n">DB</span>
<span class="n">con</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="n">duckdb</span><span class="p">())</span>
<span class="n">con</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="n">DB</span><span class="o">.</span><span class="n">duckdb</span><span class="p">())</span>
<span class="n">mtcars_path</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;https://gist.githubusercontent.com/seankross/a412dfbd88b3db70b74b/raw/5f23f993cd87c283ce766e7ac6b329ee7cc2e1d1/mtcars.csv&quot;</span>
<span class="n">mtcars</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">db_table</span><span class="p">(</span><span class="n">con</span><span class="p">,</span><span class="w"> </span><span class="n">mtcars_path</span><span class="p">)</span>
<span class="n">mtcars</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">db_table</span><span class="p">(</span><span class="n">con</span><span class="p">,</span><span class="w"> </span><span class="n">mtcars_path</span><span class="p">);</span>
</code></pre></div>
<p>Start a query to analyze fuel efficiency by number of cylinders. However, to further build on this query later, end the chain without using <code>@show_query</code> or <code>@collect</code></p>
<div class="highlight"><pre><span></span><code><span class="n">query</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@chain</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">t</span><span class="p">(</span><span class="n">mtcars</span><span class="p">)</span><span class="w"> </span><span class="k">begin</span>
Expand Down Expand Up @@ -762,8 +762,8 @@ <h2 id="from_query-or-tquery"><code>from_query()</code> or <code>t(query)</code>
<p><a id='@create_view-1'></a></p>
<h2 id="create_view">@create_view<a class="headerlink" href="#create_view" title="Permanent link">¤</a></h2>
<p>This can also be done with <code>@create_view</code>.</p>
<div class="highlight"><pre><span></span><code><span class="n">query2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nd">@chain</span><span class="w"> </span><span class="n">t</span><span class="p">(</span><span class="n">mtcars</span><span class="p">)</span><span class="w"> </span><span class="nd">@filter</span><span class="p">(</span><span class="n">mpg</span><span class="o">&gt;</span><span class="mi">20</span><span class="p">)</span><span class="w"> </span><span class="nd">@mutate</span><span class="p">(</span><span class="n">mpg</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mpg</span><span class="w"> </span><span class="o">*</span><span class="mi">4</span><span class="p">);</span>
<span class="n">DB</span><span class="o">.</span><span class="nd">@chain</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">db_table</span><span class="p">(</span><span class="n">db</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;mtcars&quot;</span><span class="p">)</span><span class="w"> </span><span class="k">begin</span>
<div class="highlight"><pre><span></span><code><span class="n">query2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nd">@chain</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">t</span><span class="p">(</span><span class="n">mtcars</span><span class="p">)</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@filter</span><span class="p">(</span><span class="n">mpg</span><span class="o">&gt;</span><span class="mi">20</span><span class="p">)</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@mutate</span><span class="p">(</span><span class="n">mpg</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mpg</span><span class="w"> </span><span class="o">*</span><span class="mi">4</span><span class="p">);</span>
<span class="n">DB</span><span class="o">.</span><span class="nd">@chain</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">t</span><span class="p">(</span><span class="n">mtcars</span><span class="p">)</span><span class="w"> </span><span class="k">begin</span>
<span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@group_by</span><span class="w"> </span><span class="n">cyl</span>
<span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@summarize</span><span class="w"> </span><span class="k">begin</span>
<span class="w"> </span><span class="n">across</span><span class="p">(</span><span class="n">mpg</span><span class="p">,</span><span class="w"> </span><span class="p">(</span><span class="n">mean</span><span class="p">,</span><span class="w"> </span><span class="n">minimum</span><span class="p">,</span><span class="w"> </span><span class="n">maximum</span><span class="p">))</span>
Expand All @@ -779,10 +779,9 @@ <h2 id="create_view">@create_view<a class="headerlink" href="#create_view" title
<span class="w"> </span><span class="k">end</span><span class="p">;</span>


<span class="n">DB</span><span class="o">.</span><span class="nd">@chain</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">db_table</span><span class="p">(</span><span class="n">db</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;viewer&quot;</span><span class="p">)</span><span class="w"> </span><span class="k">begin</span>
<span class="n">DB</span><span class="o">.</span><span class="nd">@chain</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="n">db_table</span><span class="p">(</span><span class="n">con</span><span class="p">,</span><span class="w"> </span><span class="s">&quot;viewer&quot;</span><span class="p">)</span><span class="w"> </span><span class="k">begin</span>
<span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@left_join</span><span class="p">(</span><span class="n">DB</span><span class="o">.</span><span class="n">t</span><span class="p">(</span><span class="n">query2</span><span class="p">),</span><span class="w"> </span><span class="n">cyl</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">cyl</span><span class="p">)</span>
<span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@group_by</span><span class="p">(</span><span class="n">efficiency</span><span class="p">)</span>
<span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@summarize</span><span class="p">(</span><span class="n">avg_mean</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mean</span><span class="p">(</span><span class="n">mpg</span><span class="p">))</span>
<span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@summarize</span><span class="p">(</span><span class="n">avg_mean</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mean</span><span class="p">(</span><span class="n">mpg</span><span class="p">),</span><span class="w"> </span><span class="n">_by</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">efficiency</span><span class="p">)</span>
<span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@mutate</span><span class="p">(</span><span class="n">mean</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">avg_mean</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mi">4</span><span class="w"> </span><span class="p">)</span>
<span class="w"> </span><span class="nd">@aside</span><span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@show_query</span><span class="w"> </span><span class="n">_</span>
<span class="w"> </span><span class="n">DB</span><span class="o">.</span><span class="nd">@collect</span>
Expand Down
Loading

0 comments on commit 4575015

Please sign in to comment.