Exécuter une requête

UiPath.Database.Activities.ExecuteQuery

Description

Exécute une requête sur une base de données et renvoie le résultat de la requête en tant qu’objet DataTable.

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.
• Requête SQL (SQL query) : 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 la durée totale d'exécution de l'activité peut être supérieure à la durée réelle d'exécution de la requête, à laquelle 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 obtenue à partir des activités Connecter (Connect) ou Démarrer une transaction (Start Transaction). Si une telle connexion est fournie, les propriétés ConnectionString 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 du runtime, l’objet NomParamètre (parameterName) sera remplacé par sa valeur dans le dictionnaire.
• Requête SQL (SQL query) : 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 - Exécute la requête indiquée dans le paramètre SQL.
  • StoredProcedure : invoque le nom de la procédure spécifié dans le paramètre SQL.
  • TableDirect : invoque 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

• Table de données ( Data table) : la sortie de la commande SQL encapsulée dans une variable DataTable.
  Remarque : Lorsque vous interrogez une table comportant des colonnes avec le type de données Date , les colonnes correspondantes dans la sortie DataTable seront de type de données DateTime .

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 requête 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.
• Requête SQL (SQL query) : 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

• Table de données ( Data table) : la sortie de la commande SQL encapsulée dans une variable DataTable.