Actividades
Más reciente
False
- Información general
- Criptografía
- Base de datos
- Java
- Python
- WebAPI
Ejecutar comando
Actividades para desarrolladores
Última actualización 23 de abr. de 2024
Ejecutar comando
UiPath.Database.Activities.ExecuteNonQuery
Ejecuta una instrucción SQL en una base de datos. Para las declaraciones
UPDATE
, INSERT
y DELETE
, el valor devuelto es el número de filas afectadas por el comando. Para todos los demás tipos de declaraciones, el valor devuelto es -1.
Nota: El paquete de actividades de base de datos ahora es compatible con .NET 6 Windows.
- Conexión existente : una conexión de base de datos ya abierta obtenida de la actividad Conectar a la base de datos.
- Tipo de comando : especifica cómo se interpreta una cadena de comando. Las siguientes opciones están disponibles:
- Texto : ejecuta el comando SQL.
- Procedimiento almacenado : invoca el nombre del procedimiento especificado en el comando SQL.
- Directo a la tabla : invoca todos los registros de una tabla.
- Comando SQL : un comando SQL que se ejecutará. Esta propiedad debe completarse de acuerdo con la selección de la propiedad Tipo de comando.
Opciones avanzadas
Otro
- Parámetros : un diccionario de parámetros con nombre que están vinculados al comando SQL. La vinculación se realiza especificando la instrucción
@parameterName
en el comando SQL. En tiempo de ejecución, el nombre del parámetro se reemplazará con su valor del diccionario. - Tiempo de espera: especifica la cantidad de tiempo (en milisegundos) que se debe esperar para que la actividad realice la tarea antes de que se produzca un error. El valor predeterminado es 30 000 milisegundos (30 segundos). El valor del tiempo de espera debe ser mayor o igual a 0.
- Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error.
Salida
- Recuento de filas afectadas : el resultado de la ejecución del comando SQL.
Panel de propiedades
Común
-
ContinuarEnCasoDeError: especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.
Nota: si se incluye esta actividad en Intentar capturar y el valor de la propiedad Continuar en caso de error es Verdadero, no se detectará error cuando el proyecto se ejecute. - NombreParaMostrar: el nombre de la actividad para ser mostrado.Este campo solo admite variables
String
. -
Tiempo de espera: especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute el comando SQL antes de que se produzca un error. El valor predeterminado es 30 000 milisegundos (30 segundos) y debe ser mayor o igual a 0. Este campo solo admite variables
Int32
.Nota: La cantidad de tiempo especificada en este campo no incluye el tiempo de respuesta para la recuperación de los resultados de la consulta. Esto significa que el tiempo total de ejecución de la actividad puede ser mayor que el tiempo real de ejecución de la consulta, al que se aplica la propiedad TimeoutMS .
Configuración de conexión
- Cadena de conexión: la cadena de conexión utilizada para establecer una conexión de base de datos. Este campo solo admite variables
String
. - Conexión existente : una conexión de base de datos ya abierta. Si se proporciona una conexión de este tipo, se ignoran las propiedades CadenaDeConexión y CadenaDeConexiónSegura . Este campo solo admite variables
DatabaseConnection
. - Nombre del proveedor : el nombre del proveedor de la base de datos utilizado para acceder a la base de datos. Este campo solo admite variables
String
. - Cadena de conexión segura: la cadena de conexión utilizada para establecer una conexión de base de datos como Cadena segura. Este campo solo admite variables
SecureString
.
Entrada
- Parámetros : un diccionario de parámetros con nombre que están vinculados al comando SQL. La vinculación se realiza especificando la instrucción
@parameterName
en el comando SQL. En el tiempo de ejecución, el nombre del parámetro se reemplazará con su valor del diccionario. - Comando SQL : un comando SQL que se ejecutará. Este campo debe completarse de acuerdo con la selección de la propiedad TipoDeComando. Este campo solo admite variables
String
.
Otros
-
Tipo de comando : especifica cómo se interpreta una cadena de comando. Las siguientes opciones están disponibles:
- Texto : ejecuta la consulta dada en el parámetro SQL.
- ProcedimientoAlmacenado : invoca el nombre de procedimiento especificado en el parámetro SQL.
- DirectoDeTabla : invoca todos los registros de una tabla.
- Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.
Salida
- Registros afectados : el resultado de la ejecución del comando SQL. Para las declaraciones
UPDATE
,INSERT
yDELETE
, el valor devuelto es el número de filas afectadas por el comando. Para todos los demás tipos de declaraciones, el valor devuelto es -1. Este campo solo admite variablesInt32
.