Run command

UiPath.Database.Activities.ExecuteNonQuery

Description

Exécute une instruction SQL sur une base de données. Pour les instructions UPDATE, INSERT et DELETE , la valeur renvoyée est le nombre de lignes affectées par la commande. Pour tous les autres types d’instructions, la valeur renvoyée est de -1.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows - Héritage, configuration Windows

Module Designer

• Configurer la connexion... (Configure Connection...) : sélectionnez une connexion de base de données existante ou ajoutez-en une nouvelle à l’aide de l’assistant de connexion.
• Commande SQL (SQL command) : commande SQL à exécuter. Ce champ doit être rempli en fonction de la sélection effectuée dans la propriété Type de commande (Command type). Ce champ prend uniquement en charge les variables String.

Panneau propriétés

Commun

• Continue On Error : indique si l'automatisation doit se poursuivre, même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (Vrai, Faux , Faux). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreurs.
  Remarque :

  Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• DisplayName - The display name of the activity. This field supports only String variables.
• Délai d'attente - indique le délai d'attente de l'exécution de la commande SQL avant qu'une erreur soit générée. La valeur par défaut est de 30 000 millisecondes (30 secondes) et doit être supérieure ou égale à 0. Ce champ ne prend en charge que les variables Int32 .
  Remarque :

  La durée spécifiée dans ce champ n'inclut pas le temps de réponse pour la récupération des résultats de la requête. Cela signifie que la durée totale d'exécution de l'activité peut être supérieure à l'heure d'exécution réelle de la requête, à laquelle s'applique la propriété TimeoutMS.

Configuration des connexions

• Chaîne de connexion ( Connection string) : la chaîne de connexion utilisée pour établir une connexion à la base de données. Ce champ prend uniquement en charge les variables String.
• Connexion existante (Existing connection) : connexion à une base de données déjà ouverte. Si une telle connexion est fournie, les propriétés ChaîneConnexion (ConnectionString) et ChaîneConnexionSécurisée (SecureConnectionString) sont ignorées. Ce champ prend uniquement en charge les variables DatabaseConnection.
• Nom du fournisseur (ProviderName) - Nom du fournisseur de base de données utilisé pour accéder à la base de données. Ce champ prend uniquement en charge les variables String.
• Chaîne de connexion sécurisée : la chaîne de connexion utilisée pour établir une connexion à la base de données en tant que chaîne sécurisée. Ce champ ne prend en charge que les variables SecureString .

Entrée

• Paramètres : dictionnaire de paramètres nommés liés à la commande SQL. La liaison s’effectue en spécifiant l’instruction @parameterName dans la commande SQL. Lors du runtime, l’objet NomParamètre sera remplacé par sa valeur dans le dictionnaire.
• Commande SQL (SQL command) : commande SQL à exécuter. Ce champ doit être rempli en fonction de la sélection effectuée dans la propriété Type de commande (Command type). Ce champ prend uniquement en charge les variables String.

Divers

• Type de commande : spécifie comment une chaîne de commande est interprétée. Les options suivantes sont 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.
• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

• Nombre de lignes affectées : résultat de l’exécution de la commande SQL. Pour les instructions UPDATE, INSERT et DELETE , la valeur renvoyée est le nombre de lignes affectées par la commande. Pour tous les autres types d’instructions, la valeur renvoyée est -1. Ce champ prend uniquement en charge les variables Int32 .

Configuration multiplateforme

• Connexion existante : connexion à une base de données déjà ouverte obtenue à partir de l'activité Se connecter à la base de données.
• Type de commande : spécifie comment une chaîne de commande est interprétée. Les options suivantes sont disponibles :
  • Texte : exécute la commande SQL.
  • Procédure enregistrée : invoque le nom de la procédure spécifiée dans la commande SQL.
  • Tableau direct - Appelle tous les enregistrements d’une table.
• Commande SQL (SQL command) : commande SQL à exécuter. Cette propriété doit être remplie en fonction de la sélection effectuée dans la propriété Type de commande (Command type).

Options avancées

Autre

• Paramètres : dictionnaire de paramètres nommés liés à la commande SQL. La liaison s’effectue en spécifiant l’instruction @parameterName dans la commande SQL. Lors du runtime, l’objet NomParamètre sera remplacé par sa valeur dans le dictionnaire.
• Délai d'attente - indique le délai d'attente de l'activité pour effectuer la tâche avant qu'une erreur soit générée. La valeur par défaut est de 30 000 millisecondes (30 secondes). La valeur du délai d'expiration doit être supérieure ou égale à 0.
• Continuer en cas d'erreur (Continue on error) : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur.

Sortie

• Nombre de lignes affectées (Affected rows count) : résultat de l’exécution de la commande SQL.