開発者向けのアクティビティ

最終更新日時 2025年4月7日

挿入

UiPath.Database.Activities.InsertDataTable

説明

既存のテーブルに対応する DataTable を挿入します。また、影響を受けた行の数を返します。

重要: [Insert] アクティビティは、DataAdapter を使用して、データベーススキーマに基づいて適切な挿入/更新クエリを自動的に生成します。クエリを生成するために、ODBC は標準のスキーマ呼び出しを実装します。使用しているデータベースに標準のスキーマ呼び出しが実装されていることを確認してください。そうしないと、アクティビティが正しく機能しない可能性があります。

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

Windows - レガシ、Windows での設定

デザイナーパネル

接続を構成... - 既存のデータベース接続を選択するか、接続ウィザードを使用して新しいデータベース接続を追加します。
ターゲットのテーブル名 - データを挿入する SQL テーブルです。このフィールドでは String 型の変数のみがサポートされています。
入力データテーブル - テーブルに挿入される DataTable 型変数です。DataTable の列の名前と説明は、データベーステーブルのものと一致する必要があります。

プロパティパネル

共通

エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

注: このアクティビティが [トライキャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。
表示名 - アクティビティの表示名です。このフィールドでは String 型の変数のみがサポートされています。

接続設定

接続文字列 - データベース接続の確立に使用する接続文字列です。このフィールドでは String 型の変数のみがサポートされています。
既存の接続 - [接続] または [トランザクションを開始] アクティビティから取得する、すでに開かれているデータベース接続です。この接続を指定すると、ConnectionString プロパティと SecureConnectionString プロパティは無視されます。このフィールドでは、DatabaseConnection 型の変数のみがサポートされています。
プロバイダー名 - データベースへのアクセスに使用するデータベースプロバイダーの名前です。このフィールドでは String 型の変数のみがサポートされています。
セキュリティで保護された接続文字列 - データベース接続の確立に使用する、SecureString 型の接続文字列です。このフィールドでは SecureString 型の変数のみがサポートされています。

入力

入力データテーブル - テーブルに挿入される DataTable 型変数です。DataTable の列の名前と説明は、データベーステーブルのものと一致する必要があります。
ターゲットのテーブル名 - データを挿入する SQL テーブルです。このフィールドでは String 型の変数のみがサポートされています。

その他

プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

影響を受ける行数 - 影響を受ける行の数を Int32 型変数に格納します。

クロスプラットフォームでの設定

既存の接続 - [データベースに接続] アクティビティから取得する、既に開かれているデータベース接続です。
入力データテーブル - テーブルに挿入される DataTable 型変数です。DataTable の列の名前と説明は、データベーステーブルのものと一致する必要があります。
ターゲットのテーブル名 - データの挿入先となるデータベーステーブルです。