Sql

說明

透過 JDBC 執行一系列 SQL 陳述式至資料庫。陳述式可以透過 src 屬性從文字檔讀取，或從 SQL 標籤之間讀取。

可以提供多個陳述式，並以分號 (或定義的 delimiter) 分隔。陳述式內的個別行可以在行首使用 --、// 或 REM 註解。

autocommit 屬性指定在執行陳述式時是否開啟自動提交。如果自動提交開啟 on，每個陳述式都會執行並提交。如果關閉 off，所有陳述式都會作為一個交易執行。

onerror 屬性指定在執行其中一個陳述式時發生錯誤時如何進行。可能的數值有：continue 執行，只顯示錯誤；stop 執行，記錄錯誤但不要讓任務失敗；abort 執行和交易，並讓任務失敗。

代理。某些 JDBC 驅動程式 (包括 Oracle thin 驅動程式) 使用 JVM 的代理設定將其 JDBC 作業路由至資料庫。自 Apache Ant 1.7 起，在 Java 5 或更新版本上執行的 Ant 預設為 使用作業系統的代理設定。因此，作業系統代理設定必須有效，或使用 -noproxy 選項停用 Ant 的代理支援。

參數

指定為巢狀元素的參數

transaction

使用巢狀 <transaction> 元素，以指定多個命令區塊，在同一個連線中執行，但交易不同。這在同一個架構上有許多檔案要執行時特別有用。

<transaction> 元素支援任何 資源 或單一元素資源集合，作為巢狀元素，以指定包含 SQL 陳述式的資源。

任何 資源 或資源集合

您可以透過巢狀資源集合元素來指定多個來源。集合中的每個資源都將在自己的交易中執行。在 Ant 1.7 之前，僅支援檔案集。使用排序資源集合以取得可預測的交易順序。

classpath

Sql 的 classpath 屬性是 類別路徑結構，也可以透過巢狀 classpath 元素設定。它用於載入 JDBC 類別。

connectionProperty

自 Ant 1.8.0 起

使用巢狀 <connectionProperty> 元素，以指定連線至資料庫時需要設定的其他 JDBC 屬性。

範例

使用 org.database.jdbcDriver 連線到 url 中指定的資料庫，並使用 sa 使用者身分執行 data.sql 檔案中包含的 SQL 陳述式

<sql driver="org.database.jdbcDriver"
     url="jdbc:database-url"
     userid="sa"
     password="pass"
     src="data.sql"/>

使用 org.database.jdbcDriver 連線到 url 中指定的資料庫，並使用 sa 使用者身分執行 data.sql 檔案中包含的 SQL 陳述式。同時將 internal_logon 屬性設定為 SYSDBA 值。

<sql driver="org.database.jdbcDriver"
     url="jdbc:database-url"
     userid="sa"
     password="pass"
     src="data.sql">
  <connectionProperty name="internal_logon" value="SYSDBA">
</sql>

使用 org.database.jdbcDriver 連線到 url 中指定的資料庫，並使用 sa 使用者身分執行兩個 SQL 陳述式，將資料插入 some_table 並將 some_other_table 內容清空。巢狀文字中的 Ant 屬性不會展開。

<sql driver="org.database.jdbcDriver"
     url="jdbc:database-url"
     userid="sa"
     password="pass">
insert
into table some_table
values(1,2,3,4);

truncate table some_other_table;
</sql>

請注意，您可能想要將陳述式包含在 <![CDATA[ ... ]]> 區段中，這樣就不需要跳脫 <、>、& 或其他特殊字元。例如

<sql driver="org.database.jdbcDriver"
     url="jdbc:database-url"
     userid="sa"
     password="pass"><![CDATA[

update some_table set column1 = column1 + 1 where column2 < 42;

]]></sql>

下列指令會開啟巢狀文字中的屬性展開（純粹為了向後相容性而關閉），然後使用 Ant 屬性在 HSQLDB 資料庫中建立新的使用者。

<sql driver="org.hsqldb.jdbcDriver";
     url="jdbc:hsqldb:file:${database.dir}"
     userid="sa"
     password=""
     expandProperties="true">
  <transaction>
    CREATE USER ${newuser} PASSWORD ${newpassword}
  </transaction>
</sql>

下列指令會使用 org.database.jdbcDriver 連線到 url 中指定的資料庫，並使用 sa 使用者身分執行 data1.sql、data2.sql 和 data3.sql 檔案中包含的 SQL 陳述式，然後對 some_other_table 執行清空作業。

<sql driver="org.database.jdbcDriver"
     url="jdbc:database-url"
     userid="sa"
     password="pass">
  <transaction  src="data1.sql"/>
  <transaction  src="data2.sql"/>
  <transaction  src="data3.sql"/>
  <transaction>
    truncate table some_other_table;
  </transaction>
</sql>

下列範例執行與 (相同) 的動作，而且如果有多個符合 data*.sql 模式的檔案，可能會執行其他 SQL 檔案，但無法保證 data1.sql 會在 data2.sql 之前執行。

<sql driver="org.database.jdbcDriver"
     url="jdbc:database-url"
     userid="sa"
     password="pass">
  <path>
    <fileset dir=".">
      <include name="data*.sql"/>
    </fileset>
  </path>
  <transaction>
    truncate table some_other_table;
  </transaction>
</sql>

下列指令會使用 org.database.jdbcDriver 連線到 url 中指定的資料庫，並使用 sa 使用者身分執行 data.sql 檔案中包含的 SQL 陳述式，並將輸出導向 outputfile.txt，同時在系統類別路徑中搜尋驅動程式類別 /some/jdbc.jar。

<sql driver="org.database.jdbcDriver"
     url="jdbc:database-url"
     userid="sa"
     password="pass"
     src="data.sql"
     print="yes"
     output="outputfile.txt">
  <classpath>
    <pathelement location="/some/jdbc.jar"/>
  </classpath>
</sql>

下列指令僅在 RDBMS 為 oracle 且版本以 8.1. 開頭時才會執行。

<sql driver="org.database.jdbcDriver"
     url="jdbc:database-url"
     userid="sa"
     password="pass"
     src="data.sql"
     rdbms="oracle"
     version="8.1.">
insert
into table some_table
values(1,2,3,4);

truncate table some_other_table;
</sql>