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 :

  • 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èmeSolutionExemple

      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 :

  • 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

ÉtiquetteExplicationType 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

ÉtiquetteExplicationType de données
Fichier MFC mis à jour

Fichier .mfc en entrée avec les jeux de données mis à jour.

File

arcpy.geoanalytics.RefreshBDC(bdc_file, {visible_geometry}, {visible_time})
NomExplicationType 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_VISIBLELes champs de géométrie sont inclus comme champs de l’analyse. Il s’agit de l’option par défaut.
  • GEOMETRY_NOT_VISIBLELes 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_VISIBLELes champs temporels sont inclus comme champs de l’analyse. Il s’agit de l’option par défaut.
  • TIME_NOT_VISIBLELes champs temporels ne sont pas inclus comme champs de l’analyse.
Boolean

Sortie obtenue

NomExplicationType 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.