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

Résumé

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.

En savoir plus sur les concepts liés à l’espace de travail de chargement des données

Utilisation

La géométrie des données source est déterminée par les types de dossiers d’appariement de données qui sont générés. Par exemple, si vous n’incluez que des entités ponctuelles, seul un dossier de points est généré.
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. Utilisez la table pour créer des appariements ou les bloquer.
Si une table d’appariement est fournie, elle est utilisée quelle que soit la valeur indiquée pour le paramètre Predictive Field Matching Options (Options d’appariement de champ prédictif).
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.
La sortie de cet outil peut servir d’entrée dans les outils Load Data Using Workspace (Charger des données à l’aide de l’espace de travail) et Load Data To Preview (Charger des données dans l’aperçu).
Cet outil prend en charge les types de données sources et cibles suivants :
- Espaces de travail
  - Géodatabases fichier
  - Géodatabases mobiles
  - Géodatabases d’entreprise
  - Jeux de classes d’entités
  - Services d’entités
  - Jeu de données DAO (fichiers .dgn, .dwg et.dxf)
- Jeu de données tabulaires
  - Classes d’entités
  - Tables
  - Couches et tables de services d’entités
  - Fichier de formes
  - .csv et de texte délimité
  - Feuilles de calcul Excel
  - Couches DAO
  - Fichiers dBase

Etiqueter	Explication	Type 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. Colonnes de la table de valeurs : Source—The source data that will be mapped to the target schema. Target—The target data.	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 champ—Les 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 domaine—Les 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écoché—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)	Indique 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écoché—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 dérivée

Etiqueter	Explication	Type 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})

Nom	Explication	Type 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. Colonnes de la table de valeurs : `Source`—The source data that will be mapped to the target schema. `Target`—The target data.	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_FIELDS`—Les noms de champ sont appariés en fonction de la similarité entre les champs source et cible. `MATCH_VALUES`—Les 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_STATS`—Le nombre et le pourcentage de valeurs renseignées est calculé. `NO_STATS`—Aucun calcul n’est effectué sur les valeurs de champ. Il s’agit de l’option par défaut.	Boolean
match_subtypes (Facultatif)	Indique si des classeurs d’appariement de données distincts vont être créés par sous-type s’il en existe. `MATCH_SUBTYPES`—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. `NO_MATCH_SUBTYPES`—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 dérivée

Nom	Explication	Type 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 la fonction CreateDataLoadingWorkspace (fenêtre Python)

Le script autonome ci-après 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 de la fonction CreateDataLoadingWorkspace (script autonome)

Le script autonome ci-après 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.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

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

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes