Créer une source de données de type de fichier

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture
  • Créez un enregistrement de source de données de type fichier pour définir les données qu’un jeu d’importation doit importer.

    Avant de commencer

    Rôle requis : import_admin

    Pourquoi et quand exécuter cette tâche

    Pour en savoir plus, consultez Sources de données du type de fichier.

    Procédure

    1. Accédez à la Tous > Ensembles d'importation système > Administration > Sources de données.
    2. Cliquez sur Nouveau.
    3. Complétez le formulaire.
      Champ Description
      Nom Nom unique pour cette source de données.
      Étiquette de la table de jeux d'importation Étiquette pour la table intermédiaire de jeu d’importation à utiliser.
      Nom de la table des jeux d'importation utilise Now Platform l’étiquette que vous avez saisie pour construire un nom de table unique. Cela permet d’éviter toute collision d’espace de noms avec une table déjà existante.
      Type Fichier.
      Format Seul le format de fichier XML par défaut (.xlsx) est pris en charge, sauf s’il est enregistré en tant que « Document XML ouvert strict ».
      Compressé (zippé) Sélectionné si le fichier d’importation est compressé.
      Utiliser l'importation par lots Si cette option est sélectionnée, le chargement des données doit être effectué par lots lorsque vous cliquez sur Charger des données ou Tester le chargement de 20 enregistrements.
      Taille du lot Spécifie la taille des lots. Apparaît uniquement lorsque le champ Utiliser l’importation par lots est sélectionné.
      Les glide.import_set_load_usebatch propriétés and glide.import_set_load_batch_size affectent ces champs. L’ordre de priorité des propriétés et des champs est le suivant : Si la propriété est définie, utilisez la valeur de la propriété. Si ce n’est pas le cas, utilisez la valeur du champ. Si aucune des deux propriétés n’est définie, utilisez la taille de lot par défaut de 1 000.
      • Par exemple, si glide.import_set_load_usebatch= true et glide.import_set_load_batch_size = 200, utilisez 200 comme taille de lot, quelles que soient les valeurs de champ.
      • Par exemple, si glide.import_set_load_usebatch = vrai et que la propriété n’est glide.import_set_load_batch_size pas définie, utilisez la taille de lot par défaut de 1 000.
      • Par exemple, si la propriété n’est glide.import_set_load_usebatch pas définie et que le champ Utiliser l’importation par lots = vrai, utilisez la valeur du champ Taille du lot (ou la valeur par défaut de 1 000 si la valeur du champ Taille du lot n’est pas définie)
      • Par exemple, si la glide.import_set_load_usebatch propriété = faux et le champ Utiliser l’importation par lots = vrai, n’utilisez pas l’importation par lots, car la propriété est définie sur faux.
      Méthode de récupération de fichier Méthode de récupération de ce fichier.
      Chemin d'accès au fichier Chemin d’accès au fichier à importer.
      Vous pouvez inclure une valeur de propriété système dans ce champ en utilisant le format ${system.property.name}. Lorsque la connexion est établie, la variable est remplacée par la valeur de la propriété spécifiée.
      Remarque :
      Pour les fichiers récupérés à l’aide de HTTP ou HTTPS, la propriété doit être définie sur true pour utiliser l’extension glide.ds.file.http.variable_replacement de propriété système.

      Par exemple, vous pouvez spécifier la valeur du chemin d’accès au fichier/countries.csv ?key=${datasource.apikey}. Lorsque la connexion est établie, la valeur de la datasource.apikey propriété système est transmise comme valeur du key paramètre.

      Remarque :
      Pour les protocoles HTTP et HTTPS, le chemin d’accès au fichier est automatiquement codé URL. Ne spécifiez pas de chemin d’accès de fichier codé par URL lors de l’utilisation de l’un ou l’autre de ces protocoles.
      Délimiteur CSV Caractère de délimitation du fichier CSV.
      Script d'analyse Script utilisé pour analyser une seule ligne d’entrée. Au fur et à mesure que vous tapez le script, la saisie semi-automatique du script présente les choix disponibles. Pour plus d'informations, consultez Sources de données du type de fichier.
      Numéro de feuille Numéro de feuille Excel dans laquelle charger les données.
      Ligne d'en-tête Numéro de ligne Excel pour charger les étiquettes de colonne.
      Chemin d'accès de chaque ligne Expression de chemin d’accès utilisée pour sélectionner des objets JSON, qui deviendront des lignes dans la table de jeu d’importations. Le chemin d’accès doit être // pour les objets JSON.
      Ignorer les tableaux Sélectionné pour ignorer les tableaux JSON en tant que valeur. Non sélectionné pour sérialiser les tableaux JSON en tant que valeur.
      Étendre l'enfant de nœud Sélectionnez cette option si les éléments enfants du nœud XML ou de l’objet JSON doivent être convertis en colonnes supplémentaires. Non sélectionné si la valeur de colonne parente doit être un fragment XML ou JSON. Pour JSON, notez que la sélection de cette option développe uniquement les objets, et non les tableaux. Pour en savoir plus sur la prise en charge des tableaux imbriqués, reportez-vous à la section Exemples d’importation de fichiers JSON.
      Données dans une colonne unique Sélectionnée pour stocker les données dans une seule colonne.
      XPath pour chaque ligne Expression XPath qui sélectionne les nœuds qui deviennent des lignes dans la table d’importation. Les enfants des nœuds sélectionnés deviennent les colonnes des lignes.
      Méthode d'authentification de SCP Choix d’authentification à l’aide d’un nom d’utilisateur et d’un mot de passe ou d’une clé publique.
      Remarque :
      Vous ne pouvez pas vous authentifier auprès de sources de données avec une paire de clés publique-privée. Utilisez plutôt une authentification par nom d’utilisateur et mot de passe.
      Serveur Nom du serveur à partir duquel les tables seront importées.
      Port Port à utiliser pour se connecter au serveur spécifié. Ce champ s’affiche si vous sélectionnez HTTP ou HTTPS comme méthode de récupération de fichier.
      Nom d\'utilisateur Nom d’utilisateur pour l’authentification sur le serveur JDBC.
      Mot de passe Mot de passe pour l’authentification sur le serveur JDBC.
      Fichier de clés privées Keyfile lors de l’utilisation de fichiers de clés publique-privée SCP hérités.
      Remarque :
      • Vous ne pouvez pas vous authentifier auprès de sources de données avec une paire de clés publique-privée. Utilisez plutôt l’authentification par nom d’utilisateur et mot de passe.
      • N’utilisez pas cette option héritée. Bien qu’il soit disponible, il n’est pas pris en charge.
      Magasin de clés système Sélectionné pour valider le certificat à partir du serveur FTPS par rapport à tous les certificats enregistrés. Ce certificat peut être de n’importe quel type pris en charge par l’instance. Si elle n’est pas sélectionnée, l’instance utilise le certificat Java par défaut pour valider le serveur FTPS. Ce champ n’est disponible que pour les sources de données dont la valeur de méthode de récupération de fichier est FTPS. Toutes les méthodes de récupération de fichiers FTPS sont prises en charge, y compris le TLS authentifié, le SSL authentifié, le SSL implicite et le TLS implicite.
    4. Cliquez sur Envoyer.

    Que faire ensuite

    Définissez une carte de transformation pour la nouvelle source de données et exécutez une importation.