action Exporter vers un flux de fichiers

L\' Exporter vers un flux de fichiers action extrait des données d\'une base de données à l\'aide d\'une instruction SELECT ou d\'une Procédure stockée, puis exporte le résultat de la requête dans une variable de flux de fichiers afin d\'en faciliter la gestion et le partage entre les tâches d\'automatisation.

Vous pouvez utiliser l\'Exportation vers un flux de fichiers action aussi bien pour Robot de tâches que pour Tâche API, afin de gérer les fichiers directement depuis une base de données. Pour plus d\'informations, consultez Streaming de fichiers à l\'aide de la variable de fichier.

Pour automatiser la tâche de lecture des données à partir d\'une base de données et de leur exportation dans une variable de flux de fichiers, procédez comme suit :

Procédure

  1. Saisissez le nom de la session que vous avez utilisé pour vous connecter au serveur de base de données dans l\' Se connecter action. Pour plus d\'informations, voir Utilisation de l\'action Connecter pour la base de données.
  2. Sélectionnez l\'une des options suivantes pour lire les données à partir de la base de données.
    • Instruction SELECT
    • Procédure stockée
    Utilisation de l\'Instruction SELECT
    1. Saisissez l\'Instruction SELECT pour spécifier les noms de colonne et de tableau.
      Ce champ prend en charge la syntaxe SQL. Par exemple, SELECT CustomerName,City FROM Customers
      Remarque : Pour assurer la prise en charge de l\'ensemble CTE (Common Table Expression), utilisez le mot-clé WITH dans les bases de données SQL telles que Oracle et MySQL. Par exemple :
      WITH customers_in_usa AS (SELECT CustomerName, state FROM customers WHERE country = 'USA') 
SELECT cName FROM customers_in_usa WHERE state = 'LA' ORDER BY CustomerName
    Utilisation de la Procédure stockée
    1. Saisissez le nom de la procédure stockée.
    2. 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 :
      Options Paramètres et description Types de données pris en charge
      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 requis dans la liste.
      Par exemple, si vous exécutez l\'exemple de fonction à partir de l\' Gérer la procédure stockée action, 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
      • 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)
      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 requis dans la liste.

      Lorsque l\'automation 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\' Gérer la procédure stockée action, 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 requis dans la liste.
  3. Indiquez le nombre maximal d\'enregistrements que vous souhaitez extraire.
    Vous pouvez limiter les résultats de l\'exécution.
    Remarque : Si vous ne spécifiez pas le nombre maximal d\'enregistrements à extraire, alors cette action récupère tous les enregistrements.
  4. 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.
    Remarque : Si vous ne spécifiez pas la valeur de délai d\'attente, alors cette action attend que l\'exécution de la requête soit terminée. Sinon, elle rencontre un message d\'erreur si le délai d\'attente est dépassé.
  5. Entrez un nom de fichier valide avec l\'extension .CSV vers lequel vous souhaitez exporter le résultat de la requête.
    Remarque : Il ne s\'agit que d\'un nom de fichier de référence pour transmettre le résultat de la requête à la variable de flux de fichier.
  6. Sélectionnez l\'une des options d\'encodage de fichier CSV suivantes.
    • ANSI : Option par défaut. Utilise la page de codes par défaut du système pour l\'encodage. Convient aux langues anglaises et d\'Europe occidentale sans caractères spéciaux.
    • UNICODE : prend en charge une gamme plus étendue de caractères (UTF-16). Convient aux données contenant du texte multilingue ou des jeux de caractères étendus.
    • UTF8 : Format de transformation Unicode (8 bits). Largement pris en charge sur de nombreuses plateformes et outils (Excel, Notepad++, etc.). Fournit une taille de fichier plus petite par rapport à UNICODE.
  7. Sélectionnez si vous souhaitez inclure les en-têtes de colonne dans le résultat de la requête.

    Sans en-têtes de colonnes (Sélection par défaut)

    Manny Pittsburgh
    Kate Los Angeles
    John Boston

    Avec en-têtes de colonne

    CustomerName Ville
    Manny Pittsburgh
    Kate Los Angeles
    John Boston
  8. Spécifiez la variable de flux de fichiers pour stocker le résultat de la requête.
    Vous pouvez soit créer une variable de flux de fichiers en utilisant l\'option Créer une variable, soit sélectionner une variable de flux de fichiers existante dans la liste déroulante.
  9. Cliquez sur Enregistrer.
    Lorsque vous exécutez une tâche API avec cette action, l\'instruction SELECT ou la Procédure stockée extrait les données de la base de données et enregistre la sortie de la requête dans la variable de flux de fichiers spécifiée.