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.

Remarque : le module d'activités Database est désormais compatible avec .NET 6 Windows.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

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 commande ) : 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.

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 de l’exécution, 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.

Windows, Windows - Configuration héritée

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 ne prend en charge que des valeurs booléennes (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 la valeur est définie sur True, l'exécution du projet se poursuit indépendamment de toute 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 ) : une connexion à une base de données déjà ouverte. Si une telle connexion est fournie, les propriétés ChaîneConnexion et 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 de l’exécution, parameterName sera remplacé par sa valeur dans le dictionnaire.
• Commande SQL ( SQL commande ) : commande SQL à exécuter. Ce champ doit être rempli en fonction de la sélection effectuée dans la propriété TypeCommande. Ce champ prend uniquement en charge 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

• Affected Records : 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 de -1. Ce champ prend uniquement en charge les variables Int32 .