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 ne prend en charge que les variables String.

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue on error ) : spécifie 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 (True, False). 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'erreur.
  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur (Continue On Error) est vraie, aucune erreur ne sera détectée lors de l'exécution du projet.
• NomAffichage (DisplayName) - Nom affiché de l'activité. Ce champ prend uniquement en charge les variables String.
• Délai d'attente : indique le délai d'attente (en millisecondes) 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 le temps d'exécution total de l'activité peut être supérieur au temps d'exécution réel de la requête, auquel la propriété TimeoutMS s'applique.

Configuration des connexions

• Chaîne de connexion (ConnectionString) - 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 ( Secure connection string ) : 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 prend uniquement en charge les variables SecureString .

Entrée

• Paramètres (Parameters) : 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 (parameterName) 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 ne prend en charge que les variables String.

Divers

• Type de commande : spécifie la façon dont une chaîne de commande est interprétée. Les options suivantes sont disponibles :

  • Texte ( Text ) - Exécute la requête donnée dans le paramètre SQL.
  • StoredProcedure : invoque le nom de la procédure spécifié dans le paramètre SQL.
  • TableDirect – Appelle tous les enregistrements d’une 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 (Affected rows count) : 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 ( Existing connection ) : une connexion à une base de données déjà ouverte obtenue à partir de l'activité Se connecter à la base de données (Connect to database).
• Type de commande : spécifie la façon dont une chaîne de commande est interprétée. Les options suivantes sont disponibles :
  • Texte : exécute la commande SQL.
  • Procédure enregistrée ( Stored Procedure) - Invoque le nom de la procédure spécifiée dans la commande SQL.
  • Direct de table - 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 (Parameters) : 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 (parameterName) sera remplacé par sa valeur dans le dictionnaire.
• Délai d'attente - indique le délai d'attente (en millisecondes) de l'exécution de l'activité 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'attente 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 : résultat de l'exécution de la commande SQL.