データベースに対してクエリを実行します。

必要なパラメータ

• driver:Java 版ではJDBC ドライバーのクラス名、.NET 版ではADO.NET プロバイダー名。
• conn:接続文字列、またはデータベースURL。
• query:SQL クエリ文字列。

オプションのパラメータ

• commandtimeout:オペレーションが完了するまでのCommandTimeout（秒）。ゼロ（0）はタイムアウトなしを意味します。この属性のデフォルトは60です。デフォルト値は60です。
• fromrow:開始からスキップする行数。デフォルト値は’0’です。
• maxrows:データベースから返される行の最大数。-1 を設定すると、すべての結果が得られます。デフォルト値は-1です。
• paramname#:パラメータ名。
• paramvalue#:パラメータ値。
• paramtype#:パラメータの種類。
• transactionid:トランザクションのId。
• querypassthrough:クライアント側で検証や構文修正を行うのではなく、クエリをas-is でオペレーションに渡します。

アトリビュートのアウトプット

• db:\:クエリによりアウトプットは異なります。

例

The ArcScript sample below uses a Script Connector to execute a query against a SQLite database:

<arc:set attr="db.driver" value="System.Data.SQLite" />
<arc:set attr="db.conn" value="Data Source=C:\\Users\\JoeUser\\Documents\\SecretSanta_2021.db" />
<arc:set attr="db.query" value="SELECT * FROM Participants WHERE Name=@Name AND Email=@Email" />

<arc:set attr="db.paramname#1" value="Name" />
<arc:set attr="db.paramname#2" value="Email"/>
<arc:set attr="db.paramvalue#1" value="Joe" />
<arc:set attr="db.paramvalue#2" value="joeuser@cdata.com" />

<arc:call op="dbQuery" in="db" out="record">
  <arc:enum item="record">
    <arc:set attr="output.filename" value="[_attr] is [_value]" />
    <arc:push item="output" />
  </arc:enum>
</arc:call>

Once executed, the script outputs files indicating the values of each column for the matching records.