Ejecutar consulta

UiPath.Database.Activities.ExecuteQuery

Descripción

Ejecuta una consulta en una base de datos y devuelve el resultado de la consulta como DataTable.

Compatibilidad de proyectos

Windows - Heredado | Windows | Multiplataforma

Windows (heredado), configuración de Windows

Panel del Diseñador

• Configurar conexión... : selecciona una conexión de base de datos existente o añade una nueva utilizando el Asistente de conexión.
• Consulta SQL : un comando SQL que se ejecutará. Este campo debe completarse según la selección de la propiedad Tipo de comando . Este campo solo admite variables String .

Panel de propiedades

Común

• Continuar en caso de error : 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. Como resultado, si el campo está vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.
  Nota:

  Si esta actividad se incluye en Intentar capturar y el valor de la propiedad Continuar en caso de error es Verdadero, no se captura ningún error cuando se ejecuta el proyecto.

• DisplayName - The display name of the activity. This field supports only String variables.
• Tiempo de espera : especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute el comando SQL antes de arrojar un error. El valor predeterminado es 30 000 milisegundos (30 segundos) y debe ser mayor o igual a 0. Si estableces esta propiedad en 0 o la dejas vacía, se utiliza el tiempo de espera predeterminado del proveedor de la base de datos. Este campo solo admite variables Int32 .
  Nota:

  The amount of time specified in this field does not include the response time for the query result retrieval. This means that the total execution time of the activity may be greater than the actual query execution time, to which the TimeoutMS property applies.

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 obtenida de las actividades Conectar o Iniciar transacción. Si se proporciona una conexión de este tipo, se ignoran las propiedades ConnectionString y SecureConnectionString . 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 tiempo de ejecución, el nombre del parámetro se reemplaza por su valor del diccionario.
• Consulta SQL : un comando SQL que se ejecutará. Este campo debe completarse según la selección de la propiedad Tipo de comando . Este campo solo admite variables String .

Otros

• Tipo de comando : especifica cómo se interpreta una cadena de comandos. Las siguientes opciones están disponibles:
  • Text - Executes the query given in the SQL parameter.
  • StoredProcedure - Invokes the procedure name specified in the SQL parameter.
  • TableDirect - Invokes all records from a table.
• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Salida

• Conjunto de datos : la salida del comando SQL envuelto en una variable DataSet . Cuando el comando SQL devuelve varios conjuntos de resultados, cada uno de ellos está disponible como DataTable en la salida DataSet, hasta un máximo de 100 tablas. La salida de la tabla de datos solo contiene el primer conjunto de resultados.
• Tabla de datos : la salida del comando SQL envuelto en una variable DataTable .
  Nota:

  Al consultar una tabla que tiene columnas con el tipo de datos Date , las columnas correspondientes en la salida DataTable van a ser del tipo de datos DateTime .

Configuración multiplataforma

• Conexión existente : una conexión de base de datos ya abierta obtenida de la actividad Conectar a base de datos.
• Tipo de comando : especifica cómo se interpreta una cadena de consulta. 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.
• Consulta SQL : un comando SQL que se ejecutará. Esta propiedad debe completarse según 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 NombreDelParámetro se reemplaza por 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 arrojar un error. El valor predeterminado es 30 000 milisegundos (30 segundos). El valor de tiempo de espera debe ser mayor o igual a 0. Si estableces esta propiedad en 0 o la dejas vacía, se utiliza el tiempo de espera predeterminado del proveedor de la base de datos.
• Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error.

Salida

• Conjunto de datos : la salida del comando SQL envuelto en una variable DataSet . Cuando el comando SQL devuelve varios conjuntos de resultados, cada uno de ellos está disponible como DataTable en la salida DataSet, hasta un máximo de 100 tablas. La salida de la tabla de datos solo contiene el primer conjunto de resultados.
• Tabla de datos : la salida del comando SQL envuelto en una variable DataTable .