アクティビティ
最新
偽
- 概要
- 暗号化
- データベース
- Java
- Python
- Web API
開発者向けのアクティビティ
最終更新日 2024年3月15日
クエリを実行
UiPath.Database.Activities.ExecuteQuery
データベースに対してクエリを実行し、クエリの結果を DataTable 変数として返します。
注: データベース アクティビティ パッケージが .NET 5 Windows に対応しました。
共通
-
エラー発生時に実行を継続 - アクティビティが例外をスローした場合でも、ワークフローを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白で例外がスローされると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
注: このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。 - 表示名 - アクティビティの表示名です。 このフィールドでは
String
型の変数のみがサポートされています。 -
タイムアウト - SQL コマンドの実行まで待機する時間をミリ秒で指定します。指定した時間が経過しても実行が完了しない場合には例外をスローします。既定値は 30000 ミリ秒 (30 秒) で、0 以上の値を設定する必要があります。このフィールドでは
Int32
型の変数のみがサポートされています。注: このフィールドに指定する時間には、クエリ結果の取得に要する応答時間は含まれません。これは、アクティビティの合計実行時間が、[タイムアウト (ミリ秒)] プロパティの適用対象である、実際のクエリ実行時間よりも長くなる可能性があることを意味します。
接続設定
- プロバイダー名 - データベースへのアクセスに使用するデータベース プロバイダーの名前です。 このフィールドでは
String
型の変数のみがサポートされています。 - 接続文字列 - データベース接続の確立に使用する接続文字列です。 このフィールドでは
String
型の変数のみがサポートされています。 - 既存の接続 - [接続] または [トランザクションを開始] アクティビティから取得する、既に開かれているデータベース接続です。このプロパティを指定すると、[接続文字列] と [セキュリティで保護された接続文字列] プロパティは無視されます。このフィールドでは、
DatabaseConnection
型の変数のみがサポートされています。 - セキュリティで保護された接続文字列 - データベース接続の確立に使用する、SecureString 型の接続文字列です。このフィールドでは
SecureString
型の変数のみがサポートされています。
入力
- パラメーター - SQL コマンドにバインドする、名前付きパラメーターのディクショナリです。バインドするには、SQL コマンドで
@parameterName
ステートメントを指定します。実行時に、parameterName がディクショナリからの値に置き換えられます。 - Sql - 実行する SQL コマンドです。このフィールドは、[コマンドの種類] プロパティで選択したオプションに従って設定する必要があります。このフィールドでは
String
型の変数のみがサポートされています。
その他
-
コマンドの種類 - コマンド文字列の解釈方法を指定します。次のオプションが利用可能です。
- Text - SQL パラメーターで指定するクエリを実行します。
- ストアド プロシージャ - SQL パラメーターで指定するプロシージャ名を呼び出します。
- TableDirect - テーブルからすべてのレコードを呼び出します。
- プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。
出力
- データ テーブル - DataTable 型変数にラップされた SQL コマンドの出力です。