Utilisation de l'action Exécuter une procédure stockée

Les procédures stockées sont un ensemble d'instructions SQL créées et stockées dans la base de données. Ces instructions SQL peuvent s'avérer complexes et il est possible que vous deviez les exécuter à plusieurs reprises. Utilisez l'action Exécuter une procédure stockée pour exécuter les procédures stockées existantes.

Remarque :
  • Cette action ne prend pas en charge les bases de données de type Microsoft Access ou SQLite.
  • À partir de Automation 360 v.22 (Build 10526), la limite de 32 caractères pour les paramètres d'entrée et de sortie des procédures stockées a été supprimée.

Procédure

Pour automatiser une tâche d'exécution d'une procédure stockée, procédez comme suit :

  1. Saisissez le nom de la session que vous avez utilisé pour vous connecter au serveur de base de données dans l'action Se connecter.
    Vous n'avez pas à fournir les détails relatifs au serveur de base de données ici étant donné que vous les avez déjà associés au nom de session lors de l'utilisation de l'action Se connecter.
  2. Saisissez le nom de la procédure stockée.
  3. Facultatif : Cliquez sur Ajouter un paramètre pour configurer un paramètre d'entrée ou de sortie.
    Sélectionnez l'une des options de paramètre suivantes :
    OptionÉtapes
    Entrée Le paramètre est transmis du robot à la procédure stockée.
    • Nom : saisissez le nom du paramètre de la procédure stockée.
    • Valeur (facultatif) : saisissez une valeur ou sélectionnez une variable.
    • Type : sélectionnez le type de données parmi les options suivantes.
      • BIGINT (nombre)
      • BINARY (valeur booléenne)
      • BIT (nombre)
      • CHAR (chaîne)
      • DATE (date et heure)

        Format pris en charge : aaaa-mm-jj

      • DECIMAL (nombre)
      • DOUBLE (nombre)

        Choix par défaut pour les valeurs décimales.

      • FLOAT (nombre)
      • INTEGER (nombre)

        Utilise 4 octets pour stocker un nombre entier avec une valeur comprise entre -2 147 483 648 et 2 147 483 647.

      • LONGVARBINARY (valeur booléenne)
      • LONGVARCHAR (chaîne)
      • NUMERIC (nombre)
      • REAL (nombre)
      • SMALLINT (nombre)

        Utilise 2 octets pour stocker un nombre entier avec une valeur comprise entre -32 768 et 32 767.

      • TIME (date et heure)

        Format pris en charge : hh:mm:ss

      • TIMESTAMP (date et heure)

        Format pris en charge : aaaa-mm-jj hh:mm:ss.f, où f représente les fractions de seconde

      • TINYINT (nombre)

        Utilise 1 octet pour stocker un nombre entier avec une valeur comprise entre 0 et 255.

      • VARBINARY (valeur booléenne)
      • VARCHAR (chaîne)
    Par exemple, si vous exécutez l'exemple de fonction à partir de l'action Gérer la procédure stockée, configurez les paramètres et valeurs d'entrée suivants pour la fonction sum_of_two à ajouter :
    • Paramètre 1 : num1, 5, TINYINT
    • Paramètre 2 : num2, 10, TINYINT
    Sortie Le paramètre est transmis de la procédure stockée au robot.
    • Nom : saisissez le nom du paramètre de la procédure stockée.
    • Type : sélectionnez le type de données parmi les options suivantes.
      • BIGINT (nombre)
      • BINARY (valeur booléenne)
      • BIT (nombre)
      • CHAR (chaîne)
      • DATE (date et heure)

        Format pris en charge : aaaa-mm-jj

      • DECIMAL (nombre)
      • DOUBLE (nombre)

        Choix par défaut pour les valeurs décimales.

      • FLOAT (nombre)
      • INTEGER (nombre)

        Utilise 4 octets pour stocker un nombre entier avec une valeur comprise entre -2 147 483 648 et 2 147 483 647.

      • LONGVARBINARY (valeur booléenne)
      • LONGVARCHAR (chaîne)
      • NUMERIC (nombre)
      • REAL (nombre)
      • SMALLINT (nombre)

        Utilise 2 octets pour stocker un nombre entier avec une valeur comprise entre -32 768 et 32 767.

      • TIME (date et heure)

        Format pris en charge : hh:mm:ss

      • TIMESTAMP (date et heure)

        Format pris en charge : aaaa-mm-jj hh:mm:ss.f, où f représente les fractions de seconde

      • TINYINT (nombre)

        Utilise 1 octet pour stocker un nombre entier avec une valeur comprise entre 0 et 255.

      • VARBINARY (valeur booléenne)
      • VARCHAR (chaîne)

    Lorsque le robot s'exécute, l'action convertit le type de données de la base de données en un type de données pris en charge par Automation 360.

    Par exemple, si vous exécutez l'exemple de fonction sum_of_two à partir de l'action Gérer la procédure stockée, configurez le paramètre de sortie : sum, TINYINT.
    Entrée/Sortie Ce paramètre peut être utilisé comme paramètre d'entrée et de sortie.
    • Nom : saisissez le nom du paramètre de la procédure stockée.
    • Valeur (facultatif) : saisissez une valeur ou sélectionnez une variable.
    • Type : sélectionnez le type de données parmi les options suivantes.
      • BIGINT (nombre)
      • BINARY (valeur booléenne)
      • BIT (nombre)
      • CHAR (chaîne)
      • DATE (date et heure)

        Format pris en charge : aaaa-mm-jj

      • DECIMAL (nombre)
      • DOUBLE (nombre)

        Choix par défaut pour les valeurs décimales.

      • FLOAT (nombre)
      • INTEGER (nombre)

        Utilise 4 octets pour stocker un nombre entier avec une valeur comprise entre -2 147 483 648 et 2 147 483 647.

      • LONGVARBINARY (valeur booléenne)
      • LONGVARCHAR (chaîne)
      • NUMERIC (nombre)
      • REAL (nombre)
      • SMALLINT (nombre)

        Utilise 2 octets pour stocker un nombre entier avec une valeur comprise entre -32 768 et 32 767.

      • TIME (date et heure)

        Format pris en charge : hh:mm:ss

      • TIMESTAMP (date et heure)

        Format pris en charge : aaaa-mm-jj hh:mm:ss.f, où f représente les fractions de seconde

      • TINYINT (nombre)

        Utilise 1 octet pour stocker un nombre entier avec une valeur comprise entre 0 et 255.

      • VARBINARY (valeur booléenne)
      • VARCHAR (chaîne)
  4. Indiquez le nombre maximal d'enregistrements à extraire.
    Vous pouvez limiter les résultats de l'exécution.
  5. Facultatif : Saisissez une valeur de délai d'expiration.
    Une fois le délai spécifié expiré, l'exécution de l'instruction s'arrête même si elle n'est pas terminée.
  6. Facultatif : Sélectionnez Exporter les données au format CSV pour enregistrer les données récupérées.
    Remarque : L'option Exporter les données au format CSV ne prend pas en charge les bases de données de type Oracle Database ou serveur PostgreSQL. Utilisez les paramètres de sortie pour récupérer les valeurs.
    1. Sélectionnez le chemin de fichier à partir du dossier Robots, du périphérique local ou d'une variable de fichier existante.
    2. Sélectionnez l'une des options suivantes pour le codage du fichier CSV : ANSI, UNICODE ou UTF8.
    3. Indiquez si le fichier CSV doit être exporté avec ou sans les en-têtes de colonnes.

      Avec en-têtes de colonne

      CustomerName Ville
      Manny Pittsburgh
      Kate Los Angeles
      John Boston

      Sans en-têtes de colonne

      Manny Pittsburgh
      Kate Los Angeles
      John Boston
    4. Si un fichier CSV portant le même nom existe déjà, indiquez s'il convient de le remplacer ou de lui ajouter les données.
  7. Facultatif : Sélectionnez une variable de dictionnaire pour contenir la sortie si la procédure stockée renvoie une valeur.
    Chaque nom de paramètre de sortie est une clé de dictionnaire qui contient la valeur de paramètre correspondante.
    Par exemple, si vous attribuez le paramètre sum_of_two à la sortie de la fonction $Output$, lorsque le robot appelle $Output{sum}$, la variable renvoie 15.
    Remarque : Si vous ne connaissez pas le nom du paramètre de sortie, utilisez la clé par défaut Output et ajoutez-y le numéro d'index du paramètre.
  8. Cliquez sur Enregistrer.