dwh 0.1.0 → 0.1.1

data/docs/file.creating-adapters.html

@@ -68,426 +68,416 @@
 <p>DWH adapters have a simple, focused architecture:</p>
 
 <ul>
-  <li><strong>5 Core Methods</strong>: Every adapter must implement 5 essential methods</li>
-  <li><strong>YAML Settings</strong>: Database-specific behavior controlled by YAML configuration</li>
-  <li><strong>Configuration Validation</strong>: Automatic validation of connection parameters</li>
-  <li><strong>Function Translation</strong>: SQL functions automatically translated to database-specific syntax</li>
+<li><strong>5 Core Methods</strong>: Every adapter must implement 5 essential methods</li>
+<li><strong>YAML Settings</strong>: Database-specific behavior controlled by YAML configuration</li>
+<li><strong>Configuration Validation</strong>: Automatic validation of connection parameters</li>
+<li><strong>Function Translation</strong>: SQL functions automatically translated to database-specific syntax</li>
 </ul>
 
 <h2 id="minimal-adapter-example">Minimal Adapter Example</h2>
 
-<p>Here’s a minimal adapter implementation:</p>
-
-<p>```ruby
-module DWH
-  module Adapters
-    class MyCustomAdapter &lt; Adapter
-      # Define required configuration parameters
-      config :host, String, required: true, message: ‘server host ip address or domain name’
-      config :port, Integer, required: false, default: 1234, message: ‘port to connect to’
-      config :database, String, required: true, message: ‘name of database to connect to’
-      config :username, String, required: true, message: ‘connection username’
-      config :password, String, required: false, default: nil, message: ‘connection password’</p>
-
-<pre class="code ruby"><code class="ruby">  # Implement required methods
-  def connection
-    # Return your database connection object
-    # This is cached, so implement connection reuse here
-    @connection ||= create_connection
-  end
-
-  def tables(catalog: nil, schema: nil)
-    # Return array of DWH::Table objects
-    # Use catalog/schema for filtering if supported
-  end
-
-  def metadata(table_name, catalog: nil, schema: nil)
-    # Return single DWH::Table object with column information
-  end
-
-  def stats(table_name, date_column: nil, catalog: nil, schema: nil)
-    # Return DWH::TableStats object with row counts and date ranges
-  end
-
-  def execute(sql, format: :array, retries: 0)
-    # Execute SQL and return results in specified format
-    # Formats: :array, :object, :csv, :native
-  end
-
-  def execute_stream(sql, io, stats: nil)
-    # Execute SQL and stream results directly to IO object
-  end
-
-  def stream(sql, &amp;block)
-    # Execute SQL and yield chunks to block
-  end
-
-  private
-
-  def create_connection
-    # Your database-specific connection logic
-    MyDatabaseClient.connect(
-      host: config[:host],
-      port: config[:port],
-      database: config[:database],
-      username: config[:username],
-      password: config[:password]
-    )
-  end
-end   end end
+<p>Here&#39;s a minimal adapter implementation:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>module</span> <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span>
+  <span class='kw'>module</span> <span class='const'>Adapters</span>
+    <span class='kw'>class</span> <span class='const'>MyCustomAdapter</span> <span class='op'>&lt;</span> <span class='const'>Adapter</span>
+      <span class='comment'># Define required configuration parameters
+</span>      <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:host</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>server host ip address or domain name</span><span class='tstring_end'>&#39;</span></span>
+      <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:port</span><span class='comma'>,</span> <span class='const'>Integer</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>default:</span> <span class='int'>1234</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>port to connect to</span><span class='tstring_end'>&#39;</span></span>
+      <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:database</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>name of database to connect to</span><span class='tstring_end'>&#39;</span></span>
+      <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:username</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>connection username</span><span class='tstring_end'>&#39;</span></span>
+      <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:password</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>default:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>connection password</span><span class='tstring_end'>&#39;</span></span>
+
+      <span class='comment'># Implement required methods
+</span>      <span class='kw'>def</span> <span class='id identifier rubyid_connection'>connection</span>
+        <span class='comment'># Return your database connection object
+</span>        <span class='comment'># This is cached, so implement connection reuse here
+</span>        <span class='ivar'>@connection</span> <span class='op'>||=</span> <span class='id identifier rubyid_create_connection'>create_connection</span>
+      <span class='kw'>end</span>
+
+      <span class='kw'>def</span> <span class='id identifier rubyid_tables'>tables</span><span class='lparen'>(</span><span class='label'>catalog:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+        <span class='comment'># Return array of DWH::Table objects
+</span>        <span class='comment'># Use catalog/schema for filtering if supported
+</span>      <span class='kw'>end</span>
+
+      <span class='kw'>def</span> <span class='id identifier rubyid_metadata'>metadata</span><span class='lparen'>(</span><span class='id identifier rubyid_table_name'>table_name</span><span class='comma'>,</span> <span class='label'>catalog:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+        <span class='comment'># Return single DWH::Table object with column information
+</span>      <span class='kw'>end</span>
+
+      <span class='kw'>def</span> <span class='id identifier rubyid_stats'>stats</span><span class='lparen'>(</span><span class='id identifier rubyid_table_name'>table_name</span><span class='comma'>,</span> <span class='label'>date_column:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>catalog:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+        <span class='comment'># Return DWH::TableStats object with row counts and date ranges
+</span>      <span class='kw'>end</span>
+
+      <span class='kw'>def</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_sql'>sql</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='symbol'>:array</span><span class='comma'>,</span> <span class='label'>retries:</span> <span class='int'>0</span><span class='rparen'>)</span>
+        <span class='comment'># Execute SQL and return results in specified format
+</span>        <span class='comment'># Formats: :array, :object, :csv, :native
+</span>      <span class='kw'>end</span>
+
+      <span class='kw'>def</span> <span class='id identifier rubyid_execute_stream'>execute_stream</span><span class='lparen'>(</span><span class='id identifier rubyid_sql'>sql</span><span class='comma'>,</span> <span class='id identifier rubyid_io'>io</span><span class='comma'>,</span> <span class='label'>stats:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+        <span class='comment'># Execute SQL and stream results directly to IO object
+</span>      <span class='kw'>end</span>
+
+      <span class='kw'>def</span> <span class='id identifier rubyid_stream'>stream</span><span class='lparen'>(</span><span class='id identifier rubyid_sql'>sql</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
+        <span class='comment'># Execute SQL and yield chunks to block
+</span>      <span class='kw'>end</span>
+
+      <span class='id identifier rubyid_private'>private</span>
+
+      <span class='kw'>def</span> <span class='id identifier rubyid_create_connection'>create_connection</span>
+        <span class='comment'># Your database-specific connection logic
+</span>        <span class='const'>MyDatabaseClient</span><span class='period'>.</span><span class='id identifier rubyid_connect'>connect</span><span class='lparen'>(</span>
+          <span class='label'>host:</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:host</span><span class='rbracket'>]</span><span class='comma'>,</span>
+          <span class='label'>port:</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:port</span><span class='rbracket'>]</span><span class='comma'>,</span>
+          <span class='label'>database:</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:database</span><span class='rbracket'>]</span><span class='comma'>,</span>
+          <span class='label'>username:</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:username</span><span class='rbracket'>]</span><span class='comma'>,</span>
+          <span class='label'>password:</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:password</span><span class='rbracket'>]</span>
+        <span class='rparen'>)</span>
+      <span class='kw'>end</span>
+    <span class='kw'>end</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span>
+
+<span class='comment'># Register your adapter
+</span><span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='period'>.</span><span class='id identifier rubyid_register'><span class='object_link'><a href="DWH/Factory.html#register-instance_method" title="DWH::Factory#register (method)">register</a></span></span><span class='lparen'>(</span><span class='symbol'>:mycustom</span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/Adapters.html" title="DWH::Adapters (module)">Adapters</a></span></span><span class='op'>::</span><span class='const'>MyCustomAdapter</span><span class='rparen'>)</span>
 </code></pre>
 
-<h1 id="register-your-adapter">Register your adapter</h1>
-<p>DWH.register(:mycustom, DWH::Adapters::MyCustomAdapter)
-```</p>
-
 <h2 id="step-by-step-implementation">Step-by-Step Implementation</h2>
 
-<h3 id="define-configuration-parameters">1. Define Configuration Parameters</h3>
+<h3 id="1-define-configuration-parameters">1. Define Configuration Parameters</h3>
 
 <p>Use the <code>config</code> class method to define connection parameters:</p>
 
-<p>```ruby
-class MyCustomAdapter &lt; Adapter
-  # Required parameters
-  config :host, String, required: true, message: ‘server host ip address or domain name’
-  config :database, String, required: true, message: ‘name of database to connect to’</p>
-
-<p># Optional parameters with defaults
-  config :port, Integer, required: false, default: 5432, message: ‘port to connect to’
-  config :timeout, Integer, required: false, default: 30, message: ‘connection timeout’</p>
-
-<p># Boolean parameters
-  config :ssl, Boolean, required: false, default: false, message: ‘use ssl connection’</p>
-
-<p># Parameters with allowed values
-  config :auth_type, String, required: false, default: ‘basic’, 
-         message: ‘authentication type’, allowed: %w[basic oauth token]
-end
-```</p>
-
-<h3 id="implement-connection-management">2. Implement Connection Management</h3>
-
-<p>```ruby
-def connection
-  return @connection if @connection &amp;&amp; connection_valid?</p>
-
-<p>@connection = create_connection
-end</p>
-
-<p>private</p>
-
-<p>def create_connection
-  # Example for HTTP-based database
-  Faraday.new(
-    url: “#protocol://#config[:host]:#config[:port]”,
-    headers: build_headers,
-    request: {
-      timeout: config[:timeout]
-    }
-  )
-end</p>
-
-<p>def build_headers
-  headers = { ‘Content-Type’ =&gt; ‘application/json’ }
-  headers[‘Authorization’] = “Bearer #config[:token]” if config[:token]
-  headers
-end</p>
-
-<p>def connection_valid?
-  # Implement connection health check
-  @connection&amp;.get(‘/health’)&amp;.success?
-rescue
-  false
-end
-```</p>
-
-<h3 id="implement-table-discovery">3. Implement Table Discovery</h3>
-
-<p>```ruby
-def tables(catalog: nil, schema: nil)
-  query = build_tables_query(catalog: catalog, schema: schema)
-  results = execute(query, format: :array)</p>
-
-<p>results.map do |row|
-    DWH::Table.new(
-      physical_name: row[0],
-      schema: row[1] || ‘default’,
-      catalog: row[2],
-      table_type: row[3] || ‘TABLE’
-    )
-  end
-end</p>
-
-<p>private</p>
-
-<p>def build_tables_query(catalog: nil, schema: nil)
-  query = “SHOW TABLES”</p>
-
-<p>conditions = []
-  conditions « “FROM #catalog” if catalog
-  conditions « “LIKE ‘#schema.%’” if schema</p>
-
-<p>query += “ #‘)” unless conditions.empty?
-  query
-end
-```</p>
-
-<h3 id="implement-metadata-extraction">4. Implement Metadata Extraction</h3>
-
-<p>```ruby
-def metadata(table_name, catalog: nil, schema: nil)
-  # Parse table name if it includes schema/catalog
-  parsed = parse_table_name(table_name, catalog: catalog, schema: schema)</p>
-
-<p>query = build_describe_query(parsed[:table], parsed[:schema], parsed[:catalog])
-  results = execute(query, format: :array)</p>
-
-<p>columns = results.map do |row|
-    DWH::Column.new(
-      name: row[0],
-      data_type: row[1],
-      normalized_data_type: normalize_data_type(row[1]),
-      nullable: row[2] != ‘NO’,
-      default_value: row[3],
-      character_maximum_length: row[4],
-      numeric_precision: row[5],
-      numeric_scale: row[6]
-    )
-  end</p>
-
-<p>DWH::Table.new(
-    physical_name: parsed[:table],
-    schema: parsed[:schema],
-    catalog: parsed[:catalog],
-    columns: columns
-  )
-end
-```</p>
-
-<h3 id="implement-statistics-collection">5. Implement Statistics Collection</h3>
-
-<p>```ruby
-def stats(table_name, date_column: nil, catalog: nil, schema: nil)
-  parsed = parse_table_name(table_name, catalog: catalog, schema: schema)
-  full_table_name = build_full_table_name(parsed)</p>
-
-<p># Get row count
-  count_query = “SELECT COUNT(*) FROM #full_table_name”
-  row_count = execute(count_query, format: :array).first.first</p>
-
-<p># Get date range if date column provided
-  date_start = date_end = nil
-  if date_column
-    date_query = “SELECT MIN(#date_column), MAX(#date_column) FROM #full_table_name”
-    date_result = execute(date_query, format: :array).first
-    date_start, date_end = date_result
-  end</p>
-
-<p>DWH::TableStats.new(
-    row_count: row_count,
-    date_start: date_start,
-    date_end: date_end
-  )
-end
-```</p>
-
-<h3 id="implement-query-execution">6. Implement Query Execution</h3>
-
-<p>```ruby
-def execute(sql, format: :array, retries: 0)
-  response = connection.post(‘/query’, { sql: sql }.to_json)</p>
-
-<p>raise DWH::ExecutionError, “Query failed: #responseresponse.body” unless response.success?</p>
-
-<p>raw_data = JSON.parse(response.body)
-  format_results(raw_data, format)
-rescue =&gt; e
-  if retries &gt; 0
-    sleep(1)
-    execute(sql, format: format, retries: retries - 1)
-  else
-    raise DWH::ExecutionError, “Query execution failed: #ee.message”
-  end
-end</p>
-
-<p>def execute_stream(sql, io, stats: nil)
-  # For HTTP APIs, you might need to paginate or use streaming endpoints
-  offset = 0
-  limit = 10_000</p>
-
-<p>loop do
-    paginated_sql = “#sql LIMIT #limit OFFSET #offset”
-    results = execute(paginated_sql, format: :array)</p>
-
-<pre class="code ruby"><code class="ruby">break if results.empty?
-
-results.each do |row|
-  csv_row = CSV.generate_line(row)
-  io.write(csv_row)
-  stats&amp;.add_row(row)
-end
-
-offset += limit   end end
+<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>MyCustomAdapter</span> <span class='op'>&lt;</span> <span class='const'>Adapter</span>
+  <span class='comment'># Required parameters
+</span>  <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:host</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>server host ip address or domain name</span><span class='tstring_end'>&#39;</span></span>
+  <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:database</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>name of database to connect to</span><span class='tstring_end'>&#39;</span></span>
+
+  <span class='comment'># Optional parameters with defaults
+</span>  <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:port</span><span class='comma'>,</span> <span class='const'>Integer</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>default:</span> <span class='int'>5432</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>port to connect to</span><span class='tstring_end'>&#39;</span></span>
+  <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:timeout</span><span class='comma'>,</span> <span class='const'>Integer</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>default:</span> <span class='int'>30</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>connection timeout</span><span class='tstring_end'>&#39;</span></span>
+
+  <span class='comment'># Boolean parameters
+</span>  <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:ssl</span><span class='comma'>,</span> <span class='const'>Boolean</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>default:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>use ssl connection</span><span class='tstring_end'>&#39;</span></span>
+
+  <span class='comment'># Parameters with allowed values
+</span>  <span class='id identifier rubyid_config'>config</span> <span class='symbol'>:auth_type</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>default:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>basic</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> 
+         <span class='label'>message:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>authentication type</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='label'>allowed:</span> <span class='qwords_beg'>%w[</span><span class='tstring_content'>basic</span><span class='words_sep'> </span><span class='tstring_content'>oauth</span><span class='words_sep'> </span><span class='tstring_content'>token</span><span class='tstring_end'>]</span></span>
+<span class='kw'>end</span>
+</code></pre>
+
+<h3 id="2-implement-connection-management">2. Implement Connection Management</h3>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_connection'>connection</span>
+  <span class='kw'>return</span> <span class='ivar'>@connection</span> <span class='kw'>if</span> <span class='ivar'>@connection</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_connection_valid?'>connection_valid?</span>
+
+  <span class='ivar'>@connection</span> <span class='op'>=</span> <span class='id identifier rubyid_create_connection'>create_connection</span>
+<span class='kw'>end</span>
+
+<span class='id identifier rubyid_private'>private</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_create_connection'>create_connection</span>
+  <span class='comment'># Example for HTTP-based database
+</span>  <span class='const'>Faraday</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
+    <span class='label'>url:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_protocol'>protocol</span><span class='embexpr_end'>}</span><span class='tstring_content'>://</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:host</span><span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='tstring_content'>:</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:port</span><span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
+    <span class='label'>headers:</span> <span class='id identifier rubyid_build_headers'>build_headers</span><span class='comma'>,</span>
+    <span class='label'>request:</span> <span class='lbrace'>{</span>
+      <span class='label'>timeout:</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:timeout</span><span class='rbracket'>]</span>
+    <span class='rbrace'>}</span>
+  <span class='rparen'>)</span>
+<span class='kw'>end</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_build_headers'>build_headers</span>
+  <span class='id identifier rubyid_headers'>headers</span> <span class='op'>=</span> <span class='lbrace'>{</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Content-Type</span><span class='tstring_end'>&#39;</span></span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>application/json</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span>
+  <span class='id identifier rubyid_headers'>headers</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Authorization</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Bearer </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:token</span><span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:token</span><span class='rbracket'>]</span>
+  <span class='id identifier rubyid_headers'>headers</span>
+<span class='kw'>end</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_connection_valid?'>connection_valid?</span>
+  <span class='comment'># Implement connection health check
+</span>  <span class='ivar'>@connection</span><span class='op'>&amp;.</span><span class='id identifier rubyid_get'>get</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>/health</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='op'>&amp;.</span><span class='id identifier rubyid_success?'>success?</span>
+<span class='kw'>rescue</span>
+  <span class='kw'>false</span>
+<span class='kw'>end</span>
 </code></pre>
 
-<p>def stream(sql, &amp;block)
-  # Similar to execute_stream but yields chunks to block
-  offset = 0
-  limit = 10_000</p>
+<h3 id="3-implement-table-discovery">3. Implement Table Discovery</h3>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_tables'>tables</span><span class='lparen'>(</span><span class='label'>catalog:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_query'>query</span> <span class='op'>=</span> <span class='id identifier rubyid_build_tables_query'>build_tables_query</span><span class='lparen'>(</span><span class='label'>catalog:</span> <span class='id identifier rubyid_catalog'>catalog</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='id identifier rubyid_schema'>schema</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_results'>results</span> <span class='op'>=</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_query'>query</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='symbol'>:array</span><span class='rparen'>)</span>
+
+  <span class='id identifier rubyid_results'>results</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_row'>row</span><span class='op'>|</span>
+    <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/Table.html" title="DWH::Table (class)">Table</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="DWH/Table.html#initialize-instance_method" title="DWH::Table#initialize (method)">new</a></span></span><span class='lparen'>(</span>
+      <span class='label'>physical_name:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='comma'>,</span>
+      <span class='label'>schema:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>default</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span>
+      <span class='label'>catalog:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span><span class='comma'>,</span>
+      <span class='label'>table_type:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>TABLE</span><span class='tstring_end'>&#39;</span></span>
+    <span class='rparen'>)</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span>
+
+<span class='id identifier rubyid_private'>private</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_build_tables_query'>build_tables_query</span><span class='lparen'>(</span><span class='label'>catalog:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_query'>query</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>SHOW TABLES</span><span class='tstring_end'>&quot;</span></span>
 
-<p>loop do
-    paginated_sql = “#sql LIMIT #limit OFFSET #offset”
-    chunk = execute(paginated_sql, format: :array)</p>
+  <span class='id identifier rubyid_conditions'>conditions</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
+  <span class='id identifier rubyid_conditions'>conditions</span> <span class='op'>&lt;&lt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>FROM </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_catalog'>catalog</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_catalog'>catalog</span>
+  <span class='id identifier rubyid_conditions'>conditions</span> <span class='op'>&lt;&lt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>LIKE &#39;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_schema'>schema</span><span class='embexpr_end'>}</span><span class='tstring_content'>.%&#39;</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_schema'>schema</span>
 
-<pre class="code ruby"><code class="ruby">break if chunk.empty?
+  <span class='id identifier rubyid_query'>query</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_conditions'>conditions</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'> </span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_conditions'>conditions</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
+  <span class='id identifier rubyid_query'>query</span>
+<span class='kw'>end</span>
+</code></pre>
 
-yield chunk
-offset += limit   end end
+<h3 id="4-implement-metadata-extraction">4. Implement Metadata Extraction</h3>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_metadata'>metadata</span><span class='lparen'>(</span><span class='id identifier rubyid_table_name'>table_name</span><span class='comma'>,</span> <span class='label'>catalog:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='comment'># Parse table name if it includes schema/catalog
+</span>  <span class='id identifier rubyid_parsed'>parsed</span> <span class='op'>=</span> <span class='id identifier rubyid_parse_table_name'>parse_table_name</span><span class='lparen'>(</span><span class='id identifier rubyid_table_name'>table_name</span><span class='comma'>,</span> <span class='label'>catalog:</span> <span class='id identifier rubyid_catalog'>catalog</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='id identifier rubyid_schema'>schema</span><span class='rparen'>)</span>
+
+  <span class='id identifier rubyid_query'>query</span> <span class='op'>=</span> <span class='id identifier rubyid_build_describe_query'>build_describe_query</span><span class='lparen'>(</span><span class='id identifier rubyid_parsed'>parsed</span><span class='lbracket'>[</span><span class='symbol'>:table</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_parsed'>parsed</span><span class='lbracket'>[</span><span class='symbol'>:schema</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_parsed'>parsed</span><span class='lbracket'>[</span><span class='symbol'>:catalog</span><span class='rbracket'>]</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_results'>results</span> <span class='op'>=</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_query'>query</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='symbol'>:array</span><span class='rparen'>)</span>
+
+  <span class='id identifier rubyid_columns'>columns</span> <span class='op'>=</span> <span class='id identifier rubyid_results'>results</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_row'>row</span><span class='op'>|</span>
+    <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/Column.html" title="DWH::Column (class)">Column</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="DWH/Column.html#initialize-instance_method" title="DWH::Column#initialize (method)">new</a></span></span><span class='lparen'>(</span>
+      <span class='label'>name:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='comma'>,</span>
+      <span class='label'>data_type:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span><span class='comma'>,</span>
+      <span class='label'>normalized_data_type:</span> <span class='id identifier rubyid_normalize_data_type'>normalize_data_type</span><span class='lparen'>(</span><span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span><span class='rparen'>)</span><span class='comma'>,</span>
+      <span class='label'>nullable:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span> <span class='op'>!=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>NO</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span>
+      <span class='label'>default_value:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span><span class='comma'>,</span>
+      <span class='label'>character_maximum_length:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>4</span><span class='rbracket'>]</span><span class='comma'>,</span>
+      <span class='label'>numeric_precision:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>5</span><span class='rbracket'>]</span><span class='comma'>,</span>
+      <span class='label'>numeric_scale:</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>6</span><span class='rbracket'>]</span>
+    <span class='rparen'>)</span>
+  <span class='kw'>end</span>
+
+  <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/Table.html" title="DWH::Table (class)">Table</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="DWH/Table.html#initialize-instance_method" title="DWH::Table#initialize (method)">new</a></span></span><span class='lparen'>(</span>
+    <span class='label'>physical_name:</span> <span class='id identifier rubyid_parsed'>parsed</span><span class='lbracket'>[</span><span class='symbol'>:table</span><span class='rbracket'>]</span><span class='comma'>,</span>
+    <span class='label'>schema:</span> <span class='id identifier rubyid_parsed'>parsed</span><span class='lbracket'>[</span><span class='symbol'>:schema</span><span class='rbracket'>]</span><span class='comma'>,</span>
+    <span class='label'>catalog:</span> <span class='id identifier rubyid_parsed'>parsed</span><span class='lbracket'>[</span><span class='symbol'>:catalog</span><span class='rbracket'>]</span><span class='comma'>,</span>
+    <span class='label'>columns:</span> <span class='id identifier rubyid_columns'>columns</span>
+  <span class='rparen'>)</span>
+<span class='kw'>end</span>
 </code></pre>
 
-<p>private</p>
-
-<p>def format_results(raw_data, format)
-  case format
-  when :array
-    raw_data[‘rows’]
-  when :object
-    columns = raw_data[‘columns’]
-    raw_data[‘rows’].map { |row| columns.zip(row).to_h }
-  when :csv
-    CSV.generate do |csv|
-      raw_data[‘rows’].each { |row| csv « row }
-    end
-  when :native
-    raw_data
-  else
-    raise ArgumentError, “Unsupported format: #format”
-  end
-end
-```</p>
+<h3 id="5-implement-statistics-collection">5. Implement Statistics Collection</h3>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_stats'>stats</span><span class='lparen'>(</span><span class='id identifier rubyid_table_name'>table_name</span><span class='comma'>,</span> <span class='label'>date_column:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>catalog:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_parsed'>parsed</span> <span class='op'>=</span> <span class='id identifier rubyid_parse_table_name'>parse_table_name</span><span class='lparen'>(</span><span class='id identifier rubyid_table_name'>table_name</span><span class='comma'>,</span> <span class='label'>catalog:</span> <span class='id identifier rubyid_catalog'>catalog</span><span class='comma'>,</span> <span class='label'>schema:</span> <span class='id identifier rubyid_schema'>schema</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_full_table_name'>full_table_name</span> <span class='op'>=</span> <span class='id identifier rubyid_build_full_table_name'>build_full_table_name</span><span class='lparen'>(</span><span class='id identifier rubyid_parsed'>parsed</span><span class='rparen'>)</span>
+
+  <span class='comment'># Get row count
+</span>  <span class='id identifier rubyid_count_query'>count_query</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>SELECT COUNT(*) FROM </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_full_table_name'>full_table_name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+  <span class='id identifier rubyid_row_count'>row_count</span> <span class='op'>=</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_count_query'>count_query</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='symbol'>:array</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span>
+
+  <span class='comment'># Get date range if date column provided
+</span>  <span class='id identifier rubyid_date_start'>date_start</span> <span class='op'>=</span> <span class='id identifier rubyid_date_end'>date_end</span> <span class='op'>=</span> <span class='kw'>nil</span>
+  <span class='kw'>if</span> <span class='id identifier rubyid_date_column'>date_column</span>
+    <span class='id identifier rubyid_date_query'>date_query</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>SELECT MIN(</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_date_column'>date_column</span><span class='embexpr_end'>}</span><span class='tstring_content'>), MAX(</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_date_column'>date_column</span><span class='embexpr_end'>}</span><span class='tstring_content'>) FROM </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_full_table_name'>full_table_name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+    <span class='id identifier rubyid_date_result'>date_result</span> <span class='op'>=</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_date_query'>date_query</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='symbol'>:array</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span>
+    <span class='id identifier rubyid_date_start'>date_start</span><span class='comma'>,</span> <span class='id identifier rubyid_date_end'>date_end</span> <span class='op'>=</span> <span class='id identifier rubyid_date_result'>date_result</span>
+  <span class='kw'>end</span>
+
+  <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/TableStats.html" title="DWH::TableStats (class)">TableStats</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="DWH/TableStats.html#initialize-instance_method" title="DWH::TableStats#initialize (method)">new</a></span></span><span class='lparen'>(</span>
+    <span class='label'>row_count:</span> <span class='id identifier rubyid_row_count'>row_count</span><span class='comma'>,</span>
+    <span class='label'>date_start:</span> <span class='id identifier rubyid_date_start'>date_start</span><span class='comma'>,</span>
+    <span class='label'>date_end:</span> <span class='id identifier rubyid_date_end'>date_end</span>
+  <span class='rparen'>)</span>
+<span class='kw'>end</span>
+</code></pre>
+
+<h3 id="6-implement-query-execution">6. Implement Query Execution</h3>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_sql'>sql</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='symbol'>:array</span><span class='comma'>,</span> <span class='label'>retries:</span> <span class='int'>0</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='id identifier rubyid_connection'>connection</span><span class='period'>.</span><span class='id identifier rubyid_post'>post</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>/query</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='label'>sql:</span> <span class='id identifier rubyid_sql'>sql</span> <span class='rbrace'>}</span><span class='period'>.</span><span class='id identifier rubyid_to_json'>to_json</span><span class='rparen'>)</span>
+
+  <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/ExecutionError.html" title="DWH::ExecutionError (class)">ExecutionError</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Query failed: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_body'>body</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_success?'>success?</span>
+
+  <span class='id identifier rubyid_raw_data'>raw_data</span> <span class='op'>=</span> <span class='const'>JSON</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_body'>body</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_format_results'>format_results</span><span class='lparen'>(</span><span class='id identifier rubyid_raw_data'>raw_data</span><span class='comma'>,</span> <span class='id identifier rubyid_format'>format</span><span class='rparen'>)</span>
+<span class='kw'>rescue</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
+  <span class='kw'>if</span> <span class='id identifier rubyid_retries'>retries</span> <span class='op'>&gt;</span> <span class='int'>0</span>
+    <span class='id identifier rubyid_sleep'>sleep</span><span class='lparen'>(</span><span class='int'>1</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_sql'>sql</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='id identifier rubyid_format'>format</span><span class='comma'>,</span> <span class='label'>retries:</span> <span class='id identifier rubyid_retries'>retries</span> <span class='op'>-</span> <span class='int'>1</span><span class='rparen'>)</span>
+  <span class='kw'>else</span>
+    <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/ExecutionError.html" title="DWH::ExecutionError (class)">ExecutionError</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Query execution failed: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_message'>message</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_execute_stream'>execute_stream</span><span class='lparen'>(</span><span class='id identifier rubyid_sql'>sql</span><span class='comma'>,</span> <span class='id identifier rubyid_io'>io</span><span class='comma'>,</span> <span class='label'>stats:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='comment'># For HTTP APIs, you might need to paginate or use streaming endpoints
+</span>  <span class='id identifier rubyid_offset'>offset</span> <span class='op'>=</span> <span class='int'>0</span>
+  <span class='id identifier rubyid_limit'>limit</span> <span class='op'>=</span> <span class='int'>10_000</span>
+
+  <span class='id identifier rubyid_loop'>loop</span> <span class='kw'>do</span>
+    <span class='id identifier rubyid_paginated_sql'>paginated_sql</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_sql'>sql</span><span class='embexpr_end'>}</span><span class='tstring_content'> LIMIT </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_limit'>limit</span><span class='embexpr_end'>}</span><span class='tstring_content'> OFFSET </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_offset'>offset</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+    <span class='id identifier rubyid_results'>results</span> <span class='op'>=</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_paginated_sql'>paginated_sql</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='symbol'>:array</span><span class='rparen'>)</span>
+
+    <span class='kw'>break</span> <span class='kw'>if</span> <span class='id identifier rubyid_results'>results</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
+
+    <span class='id identifier rubyid_results'>results</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_row'>row</span><span class='op'>|</span>
+      <span class='id identifier rubyid_csv_row'>csv_row</span> <span class='op'>=</span> <span class='const'>CSV</span><span class='period'>.</span><span class='id identifier rubyid_generate_line'>generate_line</span><span class='lparen'>(</span><span class='id identifier rubyid_row'>row</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_io'>io</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='id identifier rubyid_csv_row'>csv_row</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_stats'>stats</span><span class='op'>&amp;.</span><span class='id identifier rubyid_add_row'>add_row</span><span class='lparen'>(</span><span class='id identifier rubyid_row'>row</span><span class='rparen'>)</span>
+    <span class='kw'>end</span>
+
+    <span class='id identifier rubyid_offset'>offset</span> <span class='op'>+=</span> <span class='id identifier rubyid_limit'>limit</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_stream'>stream</span><span class='lparen'>(</span><span class='id identifier rubyid_sql'>sql</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
+  <span class='comment'># Similar to execute_stream but yields chunks to block
+</span>  <span class='id identifier rubyid_offset'>offset</span> <span class='op'>=</span> <span class='int'>0</span>
+  <span class='id identifier rubyid_limit'>limit</span> <span class='op'>=</span> <span class='int'>10_000</span>
+
+  <span class='id identifier rubyid_loop'>loop</span> <span class='kw'>do</span>
+    <span class='id identifier rubyid_paginated_sql'>paginated_sql</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_sql'>sql</span><span class='embexpr_end'>}</span><span class='tstring_content'> LIMIT </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_limit'>limit</span><span class='embexpr_end'>}</span><span class='tstring_content'> OFFSET </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_offset'>offset</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+    <span class='id identifier rubyid_chunk'>chunk</span> <span class='op'>=</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_paginated_sql'>paginated_sql</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='symbol'>:array</span><span class='rparen'>)</span>
+
+    <span class='kw'>break</span> <span class='kw'>if</span> <span class='id identifier rubyid_chunk'>chunk</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
+
+    <span class='kw'>yield</span> <span class='id identifier rubyid_chunk'>chunk</span>
+    <span class='id identifier rubyid_offset'>offset</span> <span class='op'>+=</span> <span class='id identifier rubyid_limit'>limit</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span>
+
+<span class='id identifier rubyid_private'>private</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_format_results'>format_results</span><span class='lparen'>(</span><span class='id identifier rubyid_raw_data'>raw_data</span><span class='comma'>,</span> <span class='id identifier rubyid_format'>format</span><span class='rparen'>)</span>
+  <span class='kw'>case</span> <span class='id identifier rubyid_format'>format</span>
+  <span class='kw'>when</span> <span class='symbol'>:array</span>
+    <span class='id identifier rubyid_raw_data'>raw_data</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>rows</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span>
+  <span class='kw'>when</span> <span class='symbol'>:object</span>
+    <span class='id identifier rubyid_columns'>columns</span> <span class='op'>=</span> <span class='id identifier rubyid_raw_data'>raw_data</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>columns</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span>
+    <span class='id identifier rubyid_raw_data'>raw_data</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>rows</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_row'>row</span><span class='op'>|</span> <span class='id identifier rubyid_columns'>columns</span><span class='period'>.</span><span class='id identifier rubyid_zip'>zip</span><span class='lparen'>(</span><span class='id identifier rubyid_row'>row</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_h'>to_h</span> <span class='rbrace'>}</span>
+  <span class='kw'>when</span> <span class='symbol'>:csv</span>
+    <span class='const'>CSV</span><span class='period'>.</span><span class='id identifier rubyid_generate'>generate</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_csv'>csv</span><span class='op'>|</span>
+      <span class='id identifier rubyid_raw_data'>raw_data</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>rows</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_row'>row</span><span class='op'>|</span> <span class='id identifier rubyid_csv'>csv</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_row'>row</span> <span class='rbrace'>}</span>
+    <span class='kw'>end</span>
+  <span class='kw'>when</span> <span class='symbol'>:native</span>
+    <span class='id identifier rubyid_raw_data'>raw_data</span>
+  <span class='kw'>else</span>
+    <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unsupported format: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_format'>format</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span>
+</code></pre>
 
 <h2 id="creating-custom-settings">Creating Custom Settings</h2>
 
-<h3 id="create-settings-file">1. Create Settings File</h3>
+<h3 id="1-create-settings-file">1. Create Settings File</h3>
 
 <p>Create by copying the <a href="https://github.com/stratasite/dwh/blob/main/lib/dwh/settings/base.yml">base settings file</a> to a relative directory like so:<code>settings/mycustom.yml</code></p>
 
-<p>```yaml
-# Override base settings for your database</p>
+<pre class="code yaml"><code class="yaml"># Override base settings for your database
 
-<h1 id="function-mappings">Function mappings</h1>
-<p>truncate_date: “DATE_TRUNC(‘@unit’, @exp)”
-date_literal: “DATE(‘@val’)”
-cast: “CAST(@exp AS @type)”</p>
+# Function mappings
+truncate_date: &quot;DATE_TRUNC(&#39;@unit&#39;, @exp)&quot;
+date_literal: &quot;DATE(&#39;@val&#39;)&quot;
+cast: &quot;CAST(@exp AS @type)&quot;
 
-<h1 id="string-functions">String functions</h1>
-<p>trim: “LTRIM(RTRIM(@exp))”
-upper_case: “UPPER(@exp)”
-lower_case: “LOWER(@exp)”</p>
+# String functions
+trim: &quot;LTRIM(RTRIM(@exp))&quot;
+upper_case: &quot;UPPER(@exp)&quot;
+lower_case: &quot;LOWER(@exp)&quot;
 
-<h1 id="null-handling">Null handling</h1>
-<p>if_null: “ISNULL(@exp, @when_null)”
-null_if: “CASE WHEN @exp = @target THEN NULL ELSE @exp END”</p>
+# Null handling
+if_null: &quot;ISNULL(@exp, @when_null)&quot;
+null_if: &quot;CASE WHEN @exp = @target THEN NULL ELSE @exp END&quot;
 
-<h1 id="capabilities">Capabilities</h1>
-<p>supports_window_functions: true
+# Capabilities
+supports_window_functions: true
 supports_array_functions: false
 supports_common_table_expressions: true
-supports_temp_tables: false</p>
+supports_temp_tables: false
 
-<h1 id="query-behavior">Query behavior</h1>
-<p>temp_table_type: “subquery”  # options: cte, subquery, temp
-final_pass_measure_join_type: “inner”  # inner, left, right, full</p>
+# Query behavior
+temp_table_type: &quot;subquery&quot;  # options: cte, subquery, temp
+final_pass_measure_join_type: &quot;inner&quot;  # inner, left, right, full
 
-<h1 id="custom-settings-for-your-database">Custom settings for your database</h1>
-<p>custom_query_prefix: “/* Generated by DWH */”
+# Custom settings for your database
+custom_query_prefix: &quot;/* Generated by DWH */&quot;
 max_query_length: 1000000
-```</p>
+</code></pre>
 
-<h3 id="custom-settings-location">2. Custom Settings Location</h3>
+<h3 id="2-custom-settings-location">2. Custom Settings Location</h3>
 
-<p>```ruby
-class MyCustomAdapter &lt; Adapter
-  # Specify custom settings file location
-  settings_file_path “/path/to/my_custom_settings.yml”</p>
+<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>MyCustomAdapter</span> <span class='op'>&lt;</span> <span class='const'>Adapter</span>
+  <span class='comment'># Specify custom settings file location
+</span>  <span class='id identifier rubyid_settings_file_path'>settings_file_path</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/path/to/my_custom_settings.yml</span><span class='tstring_end'>&quot;</span></span>
 
-<p># … rest of implementation
-end
-```</p>
+  <span class='comment'># ... rest of implementation
+</span><span class='kw'>end</span>
+</code></pre>
 
 <h2 id="advanced-features">Advanced Features</h2>
 
 <h3 id="error-handling">Error Handling</h3>
 
-<p><code>ruby
-def execute(sql, format: :array, retries: 0)
-  # Your execution logic
-rescue MyDatabaseClient::ConnectionError =&gt; e
-  raise DWH::ConnectionError, "Database connection failed: #{e.message}"
-rescue MyDatabaseClient::QueryError =&gt; e
-  raise DWH::ExecutionError, "Query execution failed: #{e.message}"
-rescue =&gt; e
-  raise DWH::AdapterError, "Unexpected error: #{e.message}"
-end
-</code></p>
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_sql'>sql</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='symbol'>:array</span><span class='comma'>,</span> <span class='label'>retries:</span> <span class='int'>0</span><span class='rparen'>)</span>
+  <span class='comment'># Your execution logic
+</span><span class='kw'>rescue</span> <span class='const'>MyDatabaseClient</span><span class='op'>::</span><span class='const'>ConnectionError</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
+  <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/ConnectionError.html" title="DWH::ConnectionError (class)">ConnectionError</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Database connection failed: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_message'>message</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+<span class='kw'>rescue</span> <span class='const'>MyDatabaseClient</span><span class='op'>::</span><span class='const'>QueryError</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
+  <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/ExecutionError.html" title="DWH::ExecutionError (class)">ExecutionError</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Query execution failed: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_message'>message</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+<span class='kw'>rescue</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
+  <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'>AdapterError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unexpected error: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_message'>message</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+<span class='kw'>end</span>
+</code></pre>
 
 <h3 id="custom-function-translation">Custom Function Translation</h3>
 
-<p>```ruby
-def custom_function(expression, param1, param2)
-  # Access settings for function templates
-  template = settings[:custom_function] || “CUSTOM_FUNC(@exp, @p1, @p2)”</p>
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_custom_function'>custom_function</span><span class='lparen'>(</span><span class='id identifier rubyid_expression'>expression</span><span class='comma'>,</span> <span class='id identifier rubyid_param1'>param1</span><span class='comma'>,</span> <span class='id identifier rubyid_param2'>param2</span><span class='rparen'>)</span>
+  <span class='comment'># Access settings for function templates
+</span>  <span class='id identifier rubyid_template'>template</span> <span class='op'>=</span> <span class='id identifier rubyid_settings'>settings</span><span class='lbracket'>[</span><span class='symbol'>:custom_function</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>CUSTOM_FUNC(@exp, @p1, @p2)</span><span class='tstring_end'>&quot;</span></span>
 
-<p>template.gsub(‘@exp’, expression)
-          .gsub(‘@p1’, param1.to_s)
-          .gsub(‘@p2’, param2.to_s)
-end
-```</p>
+  <span class='id identifier rubyid_template'>template</span><span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>@exp</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_expression'>expression</span><span class='rparen'>)</span>
+          <span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>@p1</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_param1'>param1</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rparen'>)</span>
+          <span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>@p2</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_param2'>param2</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rparen'>)</span>
+<span class='kw'>end</span>
+</code></pre>
 
 <h2 id="registration-and-usage">Registration and Usage</h2>
 
-<h3 id="register-your-adapter-1">Register Your Adapter</h3>
+<h3 id="register-your-adapter">Register Your Adapter</h3>
 
-<p>```ruby
-# In your gem or application initialization
-require ‘dwh’
-require ‘my_custom_adapter’</p>
+<pre class="code ruby"><code class="ruby"><span class='comment'># In your gem or application initialization
+</span><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>dwh</span><span class='tstring_end'>&#39;</span></span>
+<span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>my_custom_adapter</span><span class='tstring_end'>&#39;</span></span>
 
-<p>DWH.register(:mycustom, DWH::Adapters::MyCustomAdapter)
-```</p>
+<span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='period'>.</span><span class='id identifier rubyid_register'><span class='object_link'><a href="DWH/Factory.html#register-instance_method" title="DWH::Factory#register (method)">register</a></span></span><span class='lparen'>(</span><span class='symbol'>:mycustom</span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DWH/Adapters.html" title="DWH::Adapters (module)">Adapters</a></span></span><span class='op'>::</span><span class='const'>MyCustomAdapter</span><span class='rparen'>)</span>
+</code></pre>
 
 <h3 id="use-your-adapter">Use Your Adapter</h3>
 
-<p>```ruby
-# Create adapter instance
-adapter = DWH.create(:mycustom, {
-  host: ‘database.example.com’,
-  port: 1234,
-  database: ‘analytics’,
-  username: ‘analyst’,
-  password: ‘secret’
-})</p>
-
-<h1 id="use-standard-dwh-interface">Use standard DWH interface</h1>
-<p>tables = adapter.tables
-metadata = adapter.metadata(‘users’)
-results = adapter.execute(“SELECT COUNT(*) FROM users”)
-```</p>
+<pre class="code ruby"><code class="ruby"><span class='comment'># Create adapter instance
+</span><span class='id identifier rubyid_adapter'>adapter</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="DWH.html" title="DWH (module)">DWH</a></span></span><span class='period'>.</span><span class='id identifier rubyid_create'><span class='object_link'><a href="DWH/Factory.html#create-instance_method" title="DWH::Factory#create (method)">create</a></span></span><span class='lparen'>(</span><span class='symbol'>:mycustom</span><span class='comma'>,</span> <span class='lbrace'>{</span>
+  <span class='label'>host:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>database.example.com</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span>
+  <span class='label'>port:</span> <span class='int'>1234</span><span class='comma'>,</span>
+  <span class='label'>database:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>analytics</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span>
+  <span class='label'>username:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>analyst</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span>
+  <span class='label'>password:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>secret</span><span class='tstring_end'>&#39;</span></span>
+<span class='rbrace'>}</span><span class='rparen'>)</span>
+
+<span class='comment'># Use standard DWH interface
+</span><span class='id identifier rubyid_tables'>tables</span> <span class='op'>=</span> <span class='id identifier rubyid_adapter'>adapter</span><span class='period'>.</span><span class='id identifier rubyid_tables'>tables</span>
+<span class='id identifier rubyid_metadata'>metadata</span> <span class='op'>=</span> <span class='id identifier rubyid_adapter'>adapter</span><span class='period'>.</span><span class='id identifier rubyid_metadata'>metadata</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>users</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='id identifier rubyid_results'>results</span> <span class='op'>=</span> <span class='id identifier rubyid_adapter'>adapter</span><span class='period'>.</span><span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>SELECT COUNT(*) FROM users</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
+</code></pre>
 
 <h2 id="examples-to-study">Examples to Study</h2>
 
 <p>Look at existing adapters for implementation patterns:</p>
 
 <ul>
-  <li><strong>PostgreSQL</strong> (<code>lib/dwh/adapters/postgres.rb</code>) - RDBMS with full SQL support</li>
-  <li><strong>Druid</strong> (<code>lib/dwh/adapters/druid.rb</code>) - HTTP API-based adapter</li>
-  <li><strong>DuckDB</strong> (<code>lib/dwh/adapters/duck_db.rb</code>) - Embedded database adapter</li>
+<li><strong>PostgreSQL</strong> (<code>lib/dwh/adapters/postgres.rb</code>) - RDBMS with full SQL support</li>
+<li><strong>Druid</strong> (<code>lib/dwh/adapters/druid.rb</code>) - HTTP API-based adapter</li>
+<li><strong>DuckDB</strong> (<code>lib/dwh/adapters/duck_db.rb</code>) - Embedded database adapter</li>
 </ul>
 </div></div>
 
       <div id="footer">
-  Generated on Fri Aug 22 08:31:21 2025 by
+  Generated on Mon Aug 25 10:59:27 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.4.4).
 </div>