Créer un espace de travail de chargement des données (Gestion des données)

Synthèse

Crée un espace de travail de chargement des données qui peut être utilisé pour charger des données. L’espace de travail en sortie contient une collection de classeurs Microsoft Excel. Ces classeurs peuvent être utilisés pour configurer l’appariement des structures source et cible.

Utilisation

  • La géométrie des données source est déterminée par les types de dossiers d’appariement de données générés. Par exemple, si vous n’incluez que des entités ponctuelles, seul un dossier de points est généré. Cet outil prend en charge les tables et les classes d’entités en tant qu’entrées.

  • Chaque fois que l’outil est exécuté, un nouvel espace de travail est généré.

  • Créez ou spécifiez une table d’appariement à utiliser pour apparier les jeux de données, champs et descriptions des valeurs précodées de domaine attributaire d’une structure source et d’une structure cible. Cette table étant utilisée pour apparier les sous-chaînes de manière bidirectionnelle, l’ordre n’est pas important. Vous pouvez utiliser la table pour créer des appariements ou les bloquer.

  • L’appariement de champ prédictif utilise un algorithme de distance pour apparier les jeux de données, champs et descriptions des valeurs précodées d’une structure source et d’une structure cible.

  • Cet outil prend en charge les types de données sources et cibles suivants :

    • Espaces de travail
      • Géodatabases fichier
      • Géodatabases mobiles
      • Géodatabase d'entreprise
      • Jeux de classes d’entités
      • Services d’entités
      • Jeu de données DAO (.dgn, .dwg, .dxf)
    • Jeu de données tabulaires
      • Classes d’entités
      • Tables
      • Couches et tables de services d’entités
      • Fichier de formes
      • Fichiers .csv et de texte délimité
      • Feuilles de calcul Excel
      • Couches DAO
      • Fichiers dBase

Paramètres

ÉtiquetteExplicationType de données
Appariement source à cible

Définit la façon dont les données source sont appariées à la structure cible. Les espaces de travail et les classes individuelles sont tous acceptés comme entrées source ou cible. Dans le cas des espaces de travail, la similarité de nom est utilisée pour apparier les objets dans les structures source et cible.

Value Table
Dossier en sortie

Dossier en sortie où l’espace de travail de chargement des données est créé.

Folder
Options d’appariement de champ prédictif
(Facultatif)

Indique si les noms de champ ou les descriptions de valeurs de domaine vont être appariés.

  • Similarité de noms de champLes noms de champ sont appariés en fonction de la similarité entre les champs source et cible.
  • Similarité de descriptions de valeurs précodées de domaineLes descriptions de valeurs de domaine attributaire sont appariées en fonction de la similarité entre les champs source et cible. Lorsque cette option est spécifiée, les champs ne sont pas appariés par nom si le champ source ou cible comporte un domaine.
String
Table d’appariement
(Facultatif)

Table utilisée pour effectuer l’appariement des sous-chaînes de jeux de données, valeurs et descriptions de valeurs précodées de domaine attributaire. Utilisez la table pour créer des appariements ou les bloquer.

Record Set
Calculer les statistiques de nombres de lignes
(Facultatif)

Spécifie si le nombre et le pourcentage de valeurs renseignées va être calculé pour les champs de la structure source.

  • Activé : le nombre et le pourcentage de valeurs renseignées est calculé.
  • Désactivé : aucun calcul n’est effectué sur les valeurs de champ. Il s’agit de l’option par défaut.
Boolean
Créer des appariements par sous-type
(Facultatif)

Spécifie si des classeurs d’appariement de données distincts vont être créés par sous-type s’il en existe.

  • Activé : des classeurs d’appariement de données distincts sont créés pour chaque appariement le cas échéant. Le nom de la classe n’est pas utilisé pour apparier les candidats si des sous-types existent. Il s’agit de l’option par défaut.
  • Désactivé : l’appariement de jeux de données n’est tenté qu’au niveau de la classe. Si la classe contient des sous-types, une feuille de sous-types est créée dans le classeur d’appariement des données.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Espace de travail de chargement des données

Chemin vers le dossier de l’espace de travail de chargement des données

Workspace

arcpy.management.CreateDataLoadingWorkspace(source_target_mapping, out_folder, {match_options}, {mapping_table}, {calc_stats}, {match_subtypes})
NomExplicationType de données
source_target_mapping
[source_target_mapping,...]

Définit la façon dont les données source sont appariées à la structure cible. Les espaces de travail et les classes individuelles sont tous acceptés comme entrées source ou cible. Dans le cas des espaces de travail, la similarité de nom est utilisée pour apparier les objets dans les structures source et cible.

Value Table
out_folder

Dossier en sortie où l’espace de travail de chargement des données est créé.

Folder
match_options
[match_options,...]
(Facultatif)

Indique si les noms de champ ou les descriptions de valeurs de domaine vont être appariés.

  • MATCH_FIELDSLes noms de champ sont appariés en fonction de la similarité entre les champs source et cible.
  • MATCH_VALUESLes descriptions de valeurs de domaine attributaire sont appariées en fonction de la similarité entre les champs source et cible. Lorsque cette option est spécifiée, les champs ne sont pas appariés par nom si le champ source ou cible comporte un domaine.
String
mapping_table
(Facultatif)

Table utilisée pour effectuer l’appariement des sous-chaînes de jeux de données, valeurs et descriptions de valeurs précodées de domaine attributaire. Utilisez la table pour créer des appariements ou les bloquer.

Record Set
calc_stats
(Facultatif)

Spécifie si le nombre et le pourcentage de valeurs renseignées va être calculé pour les champs de la structure source.

  • CALC_STATSLe nombre et le pourcentage de valeurs renseignées est calculé.
  • NO_STATSAucun calcul n’est effectué sur les valeurs de champ. Il s’agit de l’option par défaut.
Boolean
match_subtypes
(Facultatif)

Spécifie si des classeurs d’appariement de données distincts vont être créés par sous-type s’il en existe.

  • MATCH_SUBTYPESDes classeurs d’appariement de données distincts sont créés pour chaque appariement le cas échéant. Le nom de la classe n’est pas utilisé pour apparier les candidats si des sous-types existent. Il s’agit de l’option par défaut.
  • NO_MATCH_SUBTYPESL’appariement de jeux de données n’est tenté qu’au niveau de la classe. Si la classe contient des sous-types, une feuille de sous-types est créée dans le classeur d’appariement des données.
Boolean

Sortie obtenue

NomExplicationType de données
out_loading_workspace

Chemin vers le dossier de l’espace de travail de chargement des données

Workspace

Exemple de code

Exemple d’utilisation de l’outil CreateDataLoadingWorkspace (fenêtre Python)

Le script autonome ci-dessous illustre l’utilisation de la fonction CreateDataLoadingWorkspace.

import arcpy

arcpy.management.CreateDataLoadingWorkspace(
    [["C:/data/WaterUtilities.gdb/wControlValue", "C:/data/Water_AssetPackage.gdb/WaterDevice"]],
    "C:/data",
    "MATCH_FIELDS;MATCH_VALUES",
    None,
    "CALC_STATS",
    "MATCH_SUBTYPES",
)
Exemple d’utilisation du script CreateDataLoadingWorkspace (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction CreateDataLoadingWorkspace.

# Name: CreateDataLoadingWorkspace.py
# Description: Create a new Data Loading Workspace

# Import required modules
import os
import arcpy

# Source and target workspaces with the mapping of table name to table name.
source_workspace = "C:/data/WaterUtilities.gdb/WaterDistribution"
target_workspace = "C:/data/Water_AssetPackage.gdb/UtilityNetwork"
mapping = [
    ("wControlValve", "WaterDevice"),
    ("wHydrant", "WaterJunction"),
    ("wFitting", "WaterJunction"),
    ("wMain", "WaterLine"),
]

# Fully qualify the table names.
source_target = [(os.path.join(source_workspace, a), os.path.join(target_workspace, b)) for a, b in mapping]

# Set local variables.
output_folder = "C:/data"
mapping_table = "C:/temp/Default.gdb/DataReference_GenerateMappingTable"

arcpy.management.CreateDataLoadingWorkspace(
    source_target_mapping=source_target,
    out_folder=output_folder,
    match_options="MATCH_FIELDS;MATCH_VALUES",
    mapping_table=mapping_table,
    calc_stats=True,
    match_subtypes=True,
)

Environnements

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

Rubriques connexes