Simplify database initialization examples with direct SQL execution

Author: ejboy

howto/create-database.html

@@ -94,7 +94,21 @@ <h2>MariaDB</h2>
         <h2>Initialize it with Scriptella</h2>
         <p>If you have not installed Scriptella yet, use the <a href="../download.html#one-command-installer">one-command installer</a>:</p>
         <pre><code>curl -fsSL https://scriptella.org/install.sh | sh</code></pre>
-        <p>Follow the installer's instructions for adding Scriptella to your <code>PATH</code>. If it updates a startup file, start a new shell or reload that file before using <code>scriptella.sh</code>; if it says PATH was not changed automatically, add the printed export line. Download the <a href="https://jdbc.postgresql.org/download/">PostgreSQL pgJDBC driver</a> and place the JAR in <code>${HOME}/.local/scriptella/lib</code>. Save this example as <code>init.etl.xml</code>; it connects to the PostgreSQL database, creates a table, and inserts its first row:</p>
+        <p>Follow the installer's instructions for adding Scriptella to your <code>PATH</code>. If it updates a startup file, start a new shell or reload that file before using <code>scriptella.sh</code>; if it says PATH was not changed automatically, add the printed export line.</p>
+        <p>Download the <a href="https://jdbc.postgresql.org/download/">PostgreSQL pgJDBC driver</a> and place the JAR in <code>${HOME}/.local/scriptella/lib</code>. Save this SQL as <code>init.sql</code>:</p>
+        <pre><code class="language-sql">CREATE TABLE message (
+  id INTEGER PRIMARY KEY,
+  text VARCHAR(100)
+);
+
+INSERT INTO message VALUES (1, 'Hello from Scriptella');</code></pre>
+        <p>Run <code>init.sql</code> with Scriptella 1.6 or newer, replacing the username and password with your PostgreSQL credentials:</p>
+        <pre><code>scriptella.sh execute-sql \
+  --url jdbc:postgresql://localhost/myapp \
+  --user YOUR_POSTGRES_USER \
+  --password YOUR_POSTGRES_PASSWORD \
+  init.sql</code></pre>
+        <p>Or save this ETL file as <code>init.etl.xml</code> alongside <code>init.sql</code>:</p>
         <pre><code class="language-xml">&lt;!DOCTYPE etl SYSTEM "http://scriptella.org/dtd/etl.dtd"&gt;
 &lt;etl&gt;
   &lt;connection
@@ -104,18 +118,13 @@ <h2>Initialize it with Scriptella</h2>
       password="YOUR_POSTGRES_PASSWORD"/&gt;
 
   &lt;script&gt;
-    CREATE TABLE message (
-      id INTEGER PRIMARY KEY,
-      text VARCHAR(100)
-    );
-
-    INSERT INTO message VALUES (1, 'Hello from Scriptella');
+    &lt;include href="init.sql"/&gt;
   &lt;/script&gt;
 &lt;/etl&gt;</code></pre>
-        <p>Run the ETL file with Scriptella:</p>
+        <p>Run the ETL file:</p>
         <pre><code>scriptella.sh init.etl.xml</code></pre>
-        <p>This creates the table and inserts the first row. The same approach works with <a href="https://mariadb.com/docs/connectors/mariadb-connector-j/">MariaDB</a> and other JDBC databases by changing the JDBC driver and connection URL.</p>
-        <p>For larger schemas, SQL can also be kept in separate files and included from the ETL file.</p>
+        <p>This creates the table and inserts the first row. See <a href="../reference/index.html#direct-sql">direct SQL execution</a> for command options, or the <a href="../tutorial.html">tutorial</a> for more ETL examples.</p>
+        <p>The same approach works with <a href="https://mariadb.com/docs/connectors/mariadb-connector-j/">MariaDB</a> and other JDBC databases by installing the appropriate JDBC driver and changing the connection URL. For MariaDB, use <code>jdbc:mariadb://localhost/myapp</code>.</p>
       </section>
 
       <section id="whats-next">