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 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 :

  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.

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 : connexion à une base de données déjà ouverte obtenue à partir des activités Connecter ou Démarrer une 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 : 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.
• 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 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

• Table de données : la sortie de la commande SQL encapsulée dans une variable DataTable .
  Remarque :

  Lorsque vous interrogez une table qui contient 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 : connexion à une base de données déjà ouverte obtenue à partir de l'activité Se connecter à la base de données.
• Type de commande : indique comment 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 : invoque le nom de la procédure spécifiée dans la commande SQL.
  • Tableau direct - 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 : 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

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