Doco example to help people line up their ducks

[olivergeorge]

It took me a while to work out how to line up my ducks, so to speak, and get a DuckDB WASM query working. I think adding an example in the doco might be a good idea.

I got a steer from this:
#57

  <script type="module" pinned>
    const db = DuckDBClient.of({});
  </script>
  <script type="application/sql" database="var:db" pinned>
    SELECT 1+2
  </script>=

[mbostock]

I haven’t written any documentation yet for standard library features, but yes, this would be a good thing to add when we do. 👍

For what it’s worth, I recommend using the DuckDB (native) database connector (added in 1.1.0) instead of DuckDB-Wasm unless you specifically need interactive querying (e.g., brushing) when sharing a notebook. DuckDB-Wasm is a large download (35 MB Wasm file, plus a few hundred KB of supporting JavaScript), meaning there is often a noticeable delay before it loads; so you can greatly improve performance by precomputing the results. Also, the native DuckDB connector can handle much larger files (gigabytes) by reading from the local file system rather than putting everything in memory.

[olivergeorge]

Thanks Mike. Noted.