DB Execute
「DB Execute」(DB実行)ワークフローブロックは、ワークフローが指定されたデータベース上でSQL文を実行するための機能を提供します。このブロックを使用することで、ワークフロー間でデータを共有することができます。
条件付き終了
DB Execute ブロックは、次の条件付き終了のいずれかを取ることがあります:「失敗」または「データなし」。
データなし
SELECT文は正常に実行されましたが、レコードは返されませんでした。
失敗
SQL文の実行中にエラーが発生しました。エラーの詳細は提供されません。
設定
タイトルテキスト
「タイトルテキスト」は、ブロックのインスタンス名です。テキストフィールドに名前を入力すると、フローチャートにブロックの新規の名前が表示されます。
DB接続
DB接続は、希望するデータベース接続を表します。詳細については、その他の設定をご覧ください。
名前
これは、データベース接続の名前です。この名前は、DB Execute ブロックの接続選択メニューに表示されます。オプションが表示されない場合は、「DB接続の管理」をクリックして、新規のDB接続を追加してください。
JDBC ドライバーおよび接続文字列
このデータベースへのアクセスに使用するJDBCドライバーおよび接続文字列を指定してください。なお、広く使用されている一部のDBMSシステムについては、テンプレートが用意されています。
データベースのユーザー名とパスワード
データベースへのアクセス認証情報を指定してください。
データベース接続セレクターでは、以下の操作が可能です:
- 新しい接続を追加する([新規追加]ボタン)。
- 選択済みの接続を編集して保存する([保存]ボタン)。
- 選択済みの接続を削除する([削除]ボタン)。
- DB Execute ブロックで使用する接続を選択する([選択]ボタン)。
- DB Execute ブロックで選択済みの接続を消去する([選択なし]ボタン)。
- DB Execute ブロックの接続を変更せずにウィンドウを閉じる([閉じる]ボタン)。
SQLステートメント
これは、実行されるSQL文です。SQL文では、ワークフロー変数を使用することができます。例:SELECT id, name FROM customers WHERE phone=’$(item.from)’
レコードセットの名前
SELECT ステートメントでは、取得されたレコードセットの名前を指定する必要があります。これにより、ワークフローで複数のレコードセットを扱い、反復処理を行うレコードセットを選択できるようになります。
- 最初に取得されたレコード(存在する場合)の列は、ワークフロー変数 <recordset_name>.<column_name>(例:RS.id)に格納されます。
- 返されたレコードの数は、変数 <recordset_name>.__count__(例:RS.__count__)に格納されます。count の前後に二重アンダースコアが付いている点にご注意ください。これは、この変数名をレコードセット内の列名と混同する可能性を減らすために使用されています。
- レコードセットを反復処理するには、次のレコードを取得ブロックを使用します。
- 取得されたレコードセット内のレコード数は 25 件に制限されています。
データベース接続は、接続のリストから選択します。「DB 接続の管理」ボタンをクリックしてください。ポップアップウィンドウに、このワークフローで定義されているすべてのデータベース接続が表示されます。各接続について、以下のデータを定義する必要があります:
