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

Synthèse

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 d’entités multi-fichier. Pour créer une connexion MFC, utilisez l'outil Create Multifile Feature Connection (Créer une connexion MFC (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. En outre, il réinscrit les jeux de données qui ont été supprimés à l’aide de l’outil 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 Supprimer un jeu de données d’une connexion d’entités multi-fichier et souhaitez rajouter les jeux de données supprimés à la connexion d’entités multi-fichier.

• Cet outil n’actualise pas les propriétés de jeu de données existantes qui ont été mises à jour à l’aide de l’outil Mettre à jour les propriétés d’un jeu de données MFC (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 :

  • Vous avez modifié la structure d’un jeu de données source existant : utilisez l’outil Mettre à jour les propriétés d’un jeu de données MFC (connexion d'entités multi-fichier) pour modifier les champs. Vous pouvez également utiliser l’outil Supprimer un jeu de données d’une connexion d’entités multi-fichier pour supprimer le jeu de données et l’outil Actualiser une connexion d’entités multi-fichier si le jeu de données MFC que vous souhaitez conserver n’a fait l’objet d’aucune modification.
  • Vous avez ajouté de nouveaux fichiers à un jeu de données existant : 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.
  • Vous avez supprimé un jeu de données existant : utilisez l’outil 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 (Ignoré(s)) : tous les jeux de données existants sont ignorés lors de l’actualisation et restent tels quels.
  • Réussite : de nouveaux jeux de données ont été découverts et ajoutés à la connexion d’entités multi-fichier.
  • Échec : jeux de données non 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 avec 10 champs, et d’un autre avec 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 motifs des échecs d’ajout de jeux de données à un fichier MFC

• Une fois que vous avez actualisé une connexion d’entités multi-fichier, utilisez l’outil Décrire le jeu de données pour vérifier que le jeu de données mis à jour possède l’aspect attendu.

• L'outil 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 :

  • Copier un jeu de données à partir d’une connexion d’entités multi-fichier : copie un jeu de données d’une connexion d’entités multi-fichier dans une classe d’entités.
  • 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 MFC existant.
  • 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.
  • 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 MFC individuel.
  • Prévisualiser 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.
  • Décrire le jeu de données : permet de vérifier que le jeu de données possède l’aspect attendu.

• Cet outil de géotraitement est mis en œuvre par Spark. Pour en savoir plus sur les connexions d'entités multi-fichier et leur utilisation, reportez-vous à la rubrique Connexions MFC (connexion d'entités multi-fichier).

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Fichier de connexion d’entités multi-fichier	Fichier MFC à actualiser.	File
Champ 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. Cochée : les champs de géométrie sont inclus comme champs de l’analyse. Il s’agit de l’option par défaut. Non cochée : les champs de géométrie ne sont pas inclus comme champs de l’analyse.	Boolean
Champs temporels 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. Cochée : les champs temporels sont inclus comme champs de l’analyse. Il s’agit de l’option par défaut. Non cochée : les champs temporels ne sont pas inclus comme champs de l’analyse.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Fichier MFC mis à jour	Fichier .mfc en entrée avec les jeux de données mis à jour.	File

Python

arcpy.geoanalytics.RefreshBDC(bdc_file, {visible_geometry}, {visible_time})

Nom	Explication	Type de données
bdc_file	Fichier MFC à actualiser.	File
visible_geometry (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. GEOMETRY_VISIBLE—Les champs de géométrie sont inclus comme champs de l’analyse. Il s’agit de l’option par défaut. GEOMETRY_NOT_VISIBLE—Les champs de géométrie ne sont pas inclus comme champs de l’analyse.	Boolean
visible_time (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. TIME_VISIBLE—Les champs temporels sont inclus comme champs de l’analyse. Il s’agit de l’option par défaut. TIME_NOT_VISIBLE—Les champs temporels ne sont pas inclus comme champs de l’analyse.	Boolean

Sortie obtenue

Nom	Explication	Type de données
updated_bdc	Fichier .mfc en entrée avec les jeux de données mis à jour.	File

Exemple de code

RefreshBDC (script autonome)

Le script Python ci-dessous montre comment utiliser la fonction RefreshBDC.

# Name: RefreshBDC.py
# Description: Refreshes a multifile feature connection to automatically discover datasets that 
#              have been added.
#
# Requirements: ArcGIS Pro Advanced License

# Import system modules
import arcpy

# Set local variables
mfcFile = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc"

# Run Refresh Multifile Feature Connection
arcpy.gapro.RefreshBDC(mfcFile)

Environnements

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