Actualiser une connexion d’entités multi-fichier (Outils GeoAnalytics Desktop)

Résumé

Actualise une connexion d’entités multi-fichier (MFC) existante et inscrit les nouveaux jeux de données ajoutés à l’emplacement source.

Utilisation

• Cet outil requiert une connexion MFC. Pour créer une connexion d’entités multi-fichier, utilisez l’outil Create Multifile Feature Connection (Créer une connexion d’entités multi-fichier).

• Cet outil permet d’ajouter un ou plusieurs nouveaux jeux de données à une connexion d’entités multi-fichier existante. De plus, il réinscrit les jeux de données qui ont été supprimés à l’aide de l’outil Remove Dataset From Multifile Feature Connection (Supprimer un jeu de données d’une connexion d’entités multi-fichier). Voici quelques exemples d’utilisation de cet outil :

  • Vous avez copié un dossier de données dans votre dossier source MFC existant et souhaitez qu’il soit représenté comme jeu de données dans votre connexion d’entités multi-fichier.

  • Vous avez utilisé l’outil Remove Dataset From Multifile Feature Connection (Supprimer un jeu de données d’une connexion d’entités multi-fichier) et voulez rajouter les jeux de données supprimés à la connexion d’entités multi-fichier.

• Cet outil n’actualise pas les propriétés d’un jeu de données existantes qui ont été mises à jour à l’aide de l’outil Update Multifile Feature Connection Dataset Properties (Mettre à jour les propriétés d’un jeu de données de connexion d’entités multi-fichier). Toutes les propriétés modifiées sont conservées. Les scénarios suivants incluent les processus recommandés :

  • You modified the schema of an existing source dataset—Utilisez l’outil Update Multifile Feature Connection Dataset Properties (Mettre à jour les propriétés d’un jeu de données de connexion d’entités multi-fichier) pour modifier les champs. Vous pouvez également utiliser l’outil Remove Dataset From Multifile Feature Connection (Supprimer un jeu de données d’une connexion d’entités multi-fichier) pour supprimer le jeu de données et l’outil Refresh Multifile Feature Connection (Actualiser une connexion d’entités multi-fichier) si vous ne voulez conserver aucune modification existante apportée au jeu de données MFC.

  • You added new files to an existing dataset—Aucune étape supplémentaire n’est requise. Lorsque vous utilisez un outil de géotraitement pour analyser vos données MFC, tous les fichiers du jeu de données de connexion d’entités multi-fichier sont inclus pour l’analyse.

  • You deleted an existing dataset—Utilisez l’outil Remove Dataset From Multifile Feature Connection (Supprimer un jeu de données d’une connexion d’entités multi-fichier) pour supprimer le jeu de données de la connexion d’entités multi-fichier.

• Les messages de l’outil incluent les informations suivantes sur les jeux de données découverts et leur statut :

  • Skipped—Tous les jeux de données existants sont ignorés lors de l’actualisation et restent inchangés.

  • Succeeded—Nouveaux jeux de données qui ont été détectés et ajoutés à la connexion d’entités multi-fichier.

  • Failed—Jeux de données qui n’ont pas été ajoutés à la connexion d’entités multi-fichier.

  Vous pouvez rencontrer un de ces deux problèmes lorsque vous examinez les jeux de données dans une connexion MFC :

  • Les jeux de données attendus sont introuvables. Dans ce cas, vérifiez que le chemin d’accès spécifié comme dossier source contenant les sous-dossiers est correct et que son type de données est pris en charge.

  • Impossible d’inscrire un ou de plusieurs jeux de données. Si vous ne parvenez pas à inscrire des jeux de données, vous rencontrez peut-être les problèmes suivants :

    Problème	Solution	Exemple
    Le jeu de données n’est pas dans le format attendu.	Ouvrez le fichier pour voir s’il possède l’aspect attendu. Si les données sont structurées de façon incorrecte, mettez le fichier à jour et réessayez.	Un fichier .csv comporte quelques lignes et un résumé des données, puis uniquement des lignes vides.
    Les structures des jeux de données dans un dossier ne concordent pas.	Tous les fichiers dans un dossier de jeux de données doivent avoir la même structure. Ouvrez les fichiers pour comparer les structures. Corrigez les structures non concordantes et réessayez d’inscrire le jeu de données.	Vous disposez d’un fichier .csv comportant 10 champs, et d’un autre qui en comporte 8.
    Les types de fichiers d’un jeu de données dans un dossier ne concordent pas.	Tous les fichiers dans un dossier de jeux de données doivent avoir la même extension (type de fichier). Vérifiez les types de fichiers de la localisation de la source de données et supprimez ou relocalisez les fichiers incorrectement positionnés.	Un jeu de données de shapefile se trouve dans le même dossier qu’un fichier Parquet.
    Vous avez un format de champ non reconnu.	Même si cette situation est peu probable, elle peut se produire si les fichiers ORC et Parquet utilisent un format inattendu. Vérifiez que vous utilisez des formats de champs valides.	Vous avez un fichier Parquet avec un format de champ inconnu.

  En savoir plus sur les raisons pour lesquelles l’ajout de jeux de données à un fichier MFC échoue

• Une fois que vous avez actualisé une connexion d’entités multi-fichier, utilisez l’outil Describe Dataset (Décrire le jeu de données) pour vérifier que le jeu de données mis à jour est conforme aux attentes.

• L’outil Refresh Multifile Feature Connection (Actualiser une connexion d’entités multi-fichier) identifie les nouveaux jeux de données. Les outils suivants peuvent également être utilisés pour modifier une connexion d’entités multi-fichier :

  • Copy Dataset From Multifile Feature Connection (Copier un jeu de données à partir d’une connexion d’entités multi-fichier) : copie un jeu de données depuis une connexion d’entités multi-fichier dans une classe d’entités.

  • Duplicate Dataset From Multifile Feature Connection (Dupliquer un jeu de données à partir d’une connexion d’entités multi-fichier) : crée une vue d’un jeu de données de connexion d’entités multi-fichier existant.

  • Remove Dataset From Multifile Feature Connection (Supprimer un jeu de données d’une connexion d’entités multi-fichier) : supprime un jeu de données de la connexion d’entités multi-fichier.

  • Update Multifile Feature Connection Dataset Properties (Mettre à jour les propriétés d’un jeu de données de connexion d’entités multi-fichier) : modifie les propriétés d’un jeu de données de connexion d’entités multi-fichier individuel.

  • Preview Dataset From Multifile Feature Connection (Aperçu d’un jeu de données à partir d’une connexion d’entités multi-fichier) : prévisualise les dix premières entités de votre jeu de données pour vérifier qu’elles sont correctement inscrites.

  • Describe Dataset (Décrire le jeu de données) : permet de vérifier que le jeu de données est conforme aux attentes.

• Cet outil de géotraitement est optimisé par Spark. Reportez-vous à la rubrique Connexions d’entités multi-fichier pour en savoir plus sur les connexions d’entités multi-fichier et leur utilisation.

Paramètres

• Dialog
• Python

Etiqueter	Explication	Type de données
Fichier de connexion d’entités multi-fichier	Fichier MFC à actualiser.	File
Champs de géométrie visibles (Facultatif)	Indique si les champs utilisés pour identifier la géométrie sont inclus (visibles) comme champs de l’analyse si le fichier MFC est utilisé dans d’autres outils de géotraitement. Si les champs de géométrie ne sont pas visibles, la géométrie est tout de même appliquée au jeu de données. Le paramètre de visibilité de la géométrie peut être modifié dans la connexion MFC. Activé—Les champs de géométrie sont inclus comme champs de l'analyse. Il s’agit de l’option par défaut. Décoché—Les champs de géométrie ne sont pas inclus comme champs de l'analyse.	Boolean
Champs de date/heure visibles (Facultatif)	Indique si les champs utilisés pour indiquer le temps sont inclus (visibles) comme champs de l’analyse si le fichier MFC est utilisé dans d’autres outils de géotraitement. Si les champs temporels ne sont pas visibles, le temps est tout de même appliqué au jeu de données. Le paramètre de visibilité de la date et de l'heure peut être modifié dans la connexion MFC. Activé—Les champs de date/heure sont inclus comme champs de l'analyse. Il s’agit de l’option par défaut. Décoché—Les champs de date/heure ne sont pas inclus comme champs de l'analyse.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Fichier MFC mis à jour	Fichier .mfc en entrée comportant les jeux de données mis à jour.	File

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Non
• Standard: Non
• Advanced: Oui

Rubriques connexes

• Vue d’ensemble du jeu d’outils Connexions d’entités multi-fichier
• Remarques sur les outils de GeoAnalytics Desktop
• Rechercher un outil de géotraitement