Sql

説明

JDBC を介してデータベースに対して一連の SQL 文を実行します。文は、src 属性を使用してテキストファイルから読み込むか、囲んでいる SQL タグの間から読み込むことができます。

複数の文をセミコロン（または定義された delimiter）で区切って指定できます。文内の個々の行は、行の先頭に --、//、または REM を使用してコメントアウトできます。

autocommit 属性は、文の実行中に自動コミットをオンにするかオフにするかを指定します。自動コミットが on の場合、各文は実行およびコミットされます。 off の場合、文はすべて 1 つのトランザクションとして実行されます。

onerror 属性は、文のいずれかの実行中にエラーが発生した場合の処理方法を指定します。可能な値は、continue 実行を継続し、エラーのみを表示します。 stop 実行を停止し、エラーをログに記録しますが、タスクは失敗しません。 abort 実行とトランザクションを中止し、タスクを失敗させます。

プロキシ。一部の JDBC ドライバー（Oracle Thin ドライバーを含む）は、JVM のプロキシ設定を使用して JDBC 操作をデータベースにルーティングします。 Apache Ant 1.7 以降、Java 5 以降で実行されている Ant は、オペレーティングシステムのプロキシ設定を使用する ようにデフォルト設定されています。したがって、OS のプロキシ設定が有効であるか、-noproxy オプションを使用して Ant のプロキシサポートを無効にする必要があります。

パラメータ

ネストされた要素として指定されたパラメータ

transaction

ネストされた <transaction> 要素を使用して、同じ接続で実行されるが、異なるトランザクションで実行される複数のコマンドブロックを指定します。これは、同じスキーマで実行するファイルが複数ある場合に特に便利です。

<transaction> 要素は、SQL 文を含むリソースを指定するために、ネストされた要素として任意の リソース または単一要素リソースコレクションをサポートします。

任意の リソース またはリソースコレクション

ネストされたリソースコレクション要素を介して複数のソースを指定できます。コレクションの各リソースは、独自のトランザクションで実行されます。Ant 1.7 より前は、ファイルセットのみがサポートされていました。トランザクションの順序を予測可能にするには、ソートリソースコレクションを使用します。

classpath

Sql の classpath 属性は、パスのような構造 であり、ネストされた classpath 要素を介して設定することもできます。JDBC クラスをロードするために使用されます。

connectionProperty

Ant 1.8.0 以降

ネストされた <connectionProperty> 要素を使用して、データベースに接続するときに設定する必要がある追加の JDBC プロパティを指定します。

例

org.database.jdbcDriver を使用して sa ユーザーとして url で指定されたデータベースに接続し、data.sql ファイルに含まれる SQL 文を実行します

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

org.database.jdbcDriver を使用して sa ユーザーとして url で指定されたデータベースに接続し、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 を使用して sa ユーザーとして url で指定されたデータベースに接続し、some_table にデータを挿入し、some_other_table を切り捨てる 2 つの SQL 文を実行します。ネストされたテキスト内の 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 を使用して sa ユーザーとして url で指定されたデータベースに接続し、data1.sql、data2.sql、および data3.sql ファイルに含まれる SQL 文を実行し、some_other_table に対して truncate 操作を実行します。

<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>

次の例は（123）と同じことを行いますが（パターン 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 を使用して sa ユーザーとして url で指定されたデータベースに接続し、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>