Extraire des données d’une géodatabase (Gestion des données)

Synthèse

Extrait un sous-ensemble de données depuis une géodatabase dans une autre géodatabase ou dans un fichier .xml.

En savoir plus sur l’extraction de données depuis une géodatabase

Utilisation

  • Cet outil propose des fonctionnalités similaires à la copie de données depuis une géodatabase dans une autre mais prend également en charge la copie d’un sous-ensemble de données en définissant l’environnement Étendue, en spécifiant une valeur de paramètre Extraire à l’aide d’entités de géométrie ou en utilisant une sélection. Vous pouvez également extraire la structure et les données, ou la structure seulement.

  • Cet outil peut aussi être utilisé pour extraire la structure seulement pour une référence spatiale spécifiée en utilisant l’environnement Système de coordonnées en sortie. Une fois la structure obtenue dans la référence spatiale de votre choix, vous pouvez utiliser l’option Réutiliser du paramètre Réutiliser la structure pour extraire les données dans la nouvelle structure. L’environnement Système de coordonnées en sortie est ignoré lorsque le type d’extraction de données est utilisé.

Paramètres

ÉtiquetteExplicationType de données
Jeux de données à extraire

Données qui seront extraites.

Table View; Dataset
Extraire
(Facultatif)

Indique si la structure et les lignes des données seront extraites ou si seule la structure sera extraite.

  • DonnéesLa structure et les lignes seront extraites. Il s’agit de l’option par défaut.
  • Structure uniquementSeule la structure sera extraite.
String
Type en sortie
(Facultatif)

Spécifie le type en sortie dans lequel les données seront extraites.

  • GéodatabaseLes données seront extraites dans une géodatabase existante. Il s’agit de l’option par défaut.
  • Fichier XMLLes données seront extraites dans un document d’espace de travail XML.
  • Nouvelle géodatabase fichierLes données seront extraites dans une nouvelle géodatabase fichier. Spécifiez l’emplacement et le nom de la nouvelle géodatabase fichier à l’aide des paramètres Emplacement de la géodatabase et Nom de la géodatabase.
String
Géodatabase dans laquelle extraire les données
(Facultatif)

La géodatabase contiendra les données extraites lorsque le paramètre Type en sortie a pour valeur Géodatabase.

Workspace
Fichier XML dans lequel extraire les données
(Facultatif)

Nom et emplacement du fichier .xml qui est créé lorsque le paramètre Type en sortie a pour valeur Fichier XML.

File
Emplacement de la géodatabase
(Facultatif)

Emplacement de la géodatabase fichier qui sera créée pour les données extraites. Ce paramètre est requis lorsque le paramètre Type en sortie a pour valeur Nouvelle géodatabase fichier.

Folder
Nom de la géodatabase
(Facultatif)

Nom de la géodatabase fichier qui sera créée pour les données extraites. Ce paramètre est requis lorsque le paramètre Type en sortie a pour valeur Nouvelle géodatabase fichier.

String
Développer les classes d’entités et les tables
(Facultatif)

Indique si des tables et des classes d’entités développées, telles que celles qui se trouvent dans les réseaux, les topologies ou les classes de relations, seront ajoutées.

  • Utiliser les options par défautLes tables et les classes d’entités développées associées aux tables et aux classes d’entités dans les jeux de données en entrée seront ajoutées. Par défaut, pour les classes d’entités, toutes les entités qui intersectent le filtre spatial sont extraites. Si aucun filtre spatial n’a été défini, toutes les entités sont incluses. Par défaut, pour les tables, seule la structure est extraite. Il s’agit de l’option par défaut.
  • Ajouter avec la structure uniquementSeule la structure pour les classes d’entités et les tables développées sera ajoutée.
  • Toutes les lignesToutes les lignes pour les tables et les classes d’entités développées seront ajoutées.
  • Ne pas ajouterAucune table ou classe d’entités développée n’est ajoutée.
String
Réutiliser la structure
(Facultatif)

Indique si une géodatabase qui contient la structure des données à extraire sera réutilisée. La réutilisation de la structure réduit le temps nécessaire à l’extraction des données.

  • Ne pas réutiliserLa structure ne sera pas réutilisée. Il s’agit de l’option par défaut.
  • RéutiliserLa structure sera réutilisée.
String
Extraire les données associées
(Facultatif)

Indique si les lignes associées aux lignes existantes dans les données seront extraites. Par exemple, une entité (f1) se trouve à l’intérieur du filtre de géométrie et une entité associée (f2) issue d’une autre classe se trouve à l’extérieur du filtre. L’entité f2 sera incluse dans les données extraites si vous choisissez d’obtenir les données associées.

  • Ne pas relierLes données associées ne seront pas extraites.
  • RelierLes données associées seront extraites. Il s’agit de l’option par défaut.
String
Extraire à l’aide d’entités de géométrie
(Facultatif)

Entités qui seront utilisées pour définir la zone à extraire.

Feature Layer
Type de filtre de géométrie
(Facultatif)

Spécifie la relation spatiale entre les valeurs de paramètre Extraire à l’aide d’entités de géométrie et Jeux de données en entrée et le mode de filtrage de cette relation. La relation spatiale est appliquée aux données dans une étendue définie par la zone d’intérêt spécifiée dans le paramètre Extraire à l’aide d’entités de géométrie.

  • IntersecteLes entités dans la valeur de paramètre Jeux de données en entrée qui intersectent avec les entités dans la valeur de paramètre Extraire à l’aide d’entités de géométrie seront extraites.
  • ContientLes entités dans la valeur de paramètre Jeux de données en entrée qui se trouvent dans l’entité sélectionnée dans la valeur de paramètre Extraire à l’aide d’entités de géométrie seront extraites.
String
Tous les enregistrements des tables
(Facultatif)

Indique si tous les enregistrements ou la structure seulement seront extraits pour les tables auxquelles aucun filtre n’est appliqué (comme les sélections ou les ensembles de définition).

Les tables comportant des filtres appliqués sont traitées.

  • Option sélectionnée : tous les enregistrements seront extraits dans la géodatabase. Cette option remplace la valeur du paramètre Développer les classes d’entités et les tables.
  • Option désélectionnée : seule la structure sera extraite dans la géodatabase pour les tables. Il s’agit de l’option par défaut.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Géodatabase en sortie

Espace de travail en sortie.

Workspace

arcpy.management.ExtractDataFromGeodatabase(in_data, {extract_type}, {out_type}, {out_geodatabase}, {out_xml}, {out_folder_path}, {out_name}, {expand_feature_classes_and_tables}, {reuse_schema}, {get_related_data}, {extract_using_geometry_features}, {geometry_filter_type}, {all_records_for_tables})
NomExplicationType de données
in_data
[in_data,...]

Données qui seront extraites.

Table View; Dataset
extract_type
(Facultatif)

Indique si la structure et les lignes des données seront extraites ou si seule la structure sera extraite.

  • DATALa structure et les lignes seront extraites. Il s’agit de l’option par défaut.
  • SCHEMA_ONLYSeule la structure sera extraite.
String
out_type
(Facultatif)

Spécifie le type en sortie dans lequel les données seront extraites.

  • GEODATABASELes données seront extraites dans une géodatabase existante. Il s’agit de l’option par défaut.
  • XML_FILELes données seront extraites dans un document d’espace de travail XML.
  • NEW_FILE_GEODATABASELes données seront extraites dans une nouvelle géodatabase fichier. Spécifiez l’emplacement et le nom de la nouvelle géodatabase fichier à l’aide des paramètres out_folder_path et out_name.
String
out_geodatabase
(Facultatif)

Géodatabase qui contiendra les données extraites lorsque le paramètre out_type a pour valeur GEODATABASE.

Workspace
out_xml
(Facultatif)

Nom et emplacement du fichier .xml qui est créé lorsque le paramètre out_type a pour valeur XML_FILE.

File
out_folder_path
(Facultatif)

Emplacement de la géodatabase fichier qui sera créée pour les données extraites. Ce paramètre est requis lorsque le paramètre out_type est défini sur NEW_FILE_GEODATABASE.

Folder
out_name
(Facultatif)

Nom de la géodatabase fichier qui sera créée pour les données extraites. Ce paramètre est requis lorsque le paramètre out_type est défini sur NEW_FILE_GEODATABASE.

String
expand_feature_classes_and_tables
(Facultatif)

Indique si des tables et des classes d’entités développées, telles que celles qui se trouvent dans les réseaux, les topologies ou les classes de relations, seront ajoutées.

  • USE_DEFAULTSLes tables et les classes d’entités développées associées aux tables et aux classes d’entités dans les jeux de données en entrée seront ajoutées. Par défaut, pour les classes d’entités, toutes les entités qui intersectent le filtre spatial sont extraites. Si aucun filtre spatial n’a été défini, toutes les entités sont incluses. Par défaut, pour les tables, seule la structure est extraite. Il s’agit de l’option par défaut.
  • ADD_WITH_SCHEMA_ONLYSeule la structure pour les classes d’entités et les tables développées sera ajoutée.
  • ALL_ROWSToutes les lignes pour les tables et les classes d’entités développées seront ajoutées.
  • DO_NOT_ADDAucune table ou classe d’entités développée n’est ajoutée.
String
reuse_schema
(Facultatif)

Indique si une géodatabase qui contient la structure des données à extraire sera réutilisée. La réutilisation de la structure réduit le temps nécessaire à l’extraction des données.

  • DO_NOT_REUSELa structure ne sera pas réutilisée. Il s’agit de l’option par défaut.
  • REUSELa structure sera réutilisée.
String
get_related_data
(Facultatif)

Indique si les lignes associées aux lignes existantes dans les données seront extraites. Par exemple, une entité (f1) se trouve à l’intérieur du filtre de géométrie et une entité associée (f2) issue d’une autre classe se trouve à l’extérieur du filtre. L’entité f2 sera incluse dans les données extraites si vous choisissez d’obtenir les données associées.

  • DO_NOT_GET_RELATEDLes données associées ne seront pas extraites.
  • GET_RELATEDLes données associées seront extraites. Il s’agit de l’option par défaut.
String
extract_using_geometry_features
(Facultatif)

Entités qui seront utilisées pour définir la zone à extraire.

Feature Layer
geometry_filter_type
(Facultatif)

Spécifie la relation spatiale entre les valeurs de paramètre extract_using_geometry_features et in_data et le mode de filtrage de cette relation. La relation spatiale est appliquée aux données dans une étendue définie par la zone d’intérêt spécifiée dans le paramètre extract_using_geometry_features.

  • INTERSECTSLes entités dans la valeur de paramètre in_data qui intersectent avec les entités dans la valeur de paramètre extract_using_geometry_features seront extraites.
  • CONTAINSLes entités dans la valeur de paramètre in_data qui se trouvent dans l’entité sélectionnée dans la valeur de paramètre extract_using_geometry_features seront extraites.
String
all_records_for_tables
(Facultatif)

Indique si tous les enregistrements ou la structure seulement seront extraits pour les tables auxquelles aucun filtre n’est appliqué (comme les sélections ou les ensembles de définition).

Les tables comportant des filtres appliqués sont traitées.

  • ALL_RECORDS_FOR_TABLESTous les enregistrements seront extraits dans la géodatabase. Cette option remplace la valeur du paramètre expand_feature_classes_and_tables.
  • SCHEMA_ONLY_FOR_TABLESSeule la structure sera extraite dans la géodatabase. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_workspace

Espace de travail en sortie.

Workspace

Exemple de code

Exemple 1 d’utilisation de la fonction ExtractDataFromGeodatabase (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser la fonction ExtractDataFromGeodatabase avec une classe d’entités en entrée unique et une nouvelle géodatabase fichier en sortie.

import arcpy
arcpy.management.ExtractDataFromGeodatabase(
    r"C:\MyProject\MyGDB.gdb\Bridges", "DATA", "NEW_FILE_GEODATABASE", "", "",
   r"C:\MyProject", "MyNewGDB")
Exemple 2 d’utilisation de la fonction ExtractDataFromGeodatabase (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser la fonction ExtractDataFromGeodatabase avec plusieurs couches et extraire la structure seulement dans un document d’espace de travail XML.

import arcpy
arcpy.management.ExtractDataFromGeodatabase(
    ["Layer1", "Layer2"], "SCHEMA_ONLY", "XML_FILE", "",
    r"C:\MyProject\MyXMLWkspDoc.xml")
Exemple 3 d’utilisation de la fonction ExtractDataFromGeodatabase (script autonome)

Le script Python autonome suivant montre comment utiliser la fonction ExtractDataFromGeodatabase avec plusieurs jeux de données en entrée dans une géodatabase existante en utilisant l’environnement Étendue.

# Name: ExtractDataFromGeodatabase_Example3.py
# Description: Extract a subset of data by providing an extent using the Extent
#              environment setting.

# Import system modules
import arcpy

# Set the current workspace (to avoid having to specify the full path to each 
# input dataset)
arcpy.env.workspace = "C:\MyProject\MyData.gdb"

# Set the extent environment using the Extent class
arcpy.env.extent = arcpy.Extent(-107.0, 38.0, -104.0, 40.0)

# Set local variables
in_data = ["FC1", "FC2", "FC3"]
extract_type = "DATA"
out_type = "GEODATABASE"
out_geodatabase = "C:\MyProject\MyGDB.gdb"
out_folder_path = ""
out_name = ""
expand_fcs = "USE_DEFAULTS"
reuse_schema = "DO_NOT_REUSE"
get_related_data = "GET_RELATED"
extract_using_geom = ""
geom_filter = ""
all_records = "ALL_RECORDS_FOR_TABLES"

# Run ExtractDataFromGeodatabase
arcpy.management.ExtractDataFromGeodatabase(in_data,
                                            extract_type,
                                            out_type,
                                            out_geodatabase,
                                            out_xml,
                                            out_folder_path,
                                            out_name,
                                            expand_fcs,
                                            reuse_schema,
                                            get_related_data,
                                            extract_using_geom,
                                            geom_filter,
                                            all_records)
Exemple 4 d’utilisation de la fonction ExtractDataFromGeodatabase (script autonome)

Le script Python autonome suivant montre comment utiliser la fonction ExtractDataFromGeodatabase pour extraire des données dans une nouvelle géodatabase fichier avec un nouveau système de coordonnées en utilisant l’environnement Système de coordonnées en sortie.

# Name: ExtractDataFromGeodatabase_Example4.py
# Description: Extract data to use a new coordinate system by using the
#              Output Coordinate System environment setting. Then run the tool a second
#              time to load the data using the reuse_schema option

# Import system modules
import arcpy

# Set the Output Coordinate System environment
arcpy.env.outputCoordinateSystem = arcpy.SpatialReference("GCS_North_American_1983_HARN")
arcpy.env.geographicTransformations = "NAD_1983_HARN_To_WGS_1984_2"

# Set local variables
in_data = "C:/MyProject/MyGDB.gdb/FC1"
extract_type = "SCHEMA_ONLY"
out_type = "NEW_FILE_GEODATABASE"
out_geodatabase = ""
out_xml = ""
out_folder_path = "C:\MyProject"
out_name = "MyOutputGDB.gdb"
expand_fcs = "USE_DEFAULTS"
reuse_schema = "DO_NOT_REUSE"
get_related_data = "GET_RELATED"
extract_using_geom = ""
geom_filter = ""
all_records = "SCHEMA_ONLY_FOR_TABLES"

# Run ExtractDataFromGeodatabase with the schema only option
arcpy.management.ExtractDataFromGeodatabase(in_data,
                                            extract_type,
                                            out_type,
                                            out_geodatabase,
                                            out_xml,
                                            out_folder_path,
                                            out_name,
                                            expand_fcs,
                                            reuse_schema,
                                            get_related_data,
                                            extract_using_geom,
                                            geom_filter,
                                            all_records)

# Rest the Output Coordinate System environment
arcpy.ClearEnvironment("outputCoordinateSystem")
arcpy.ClearEnvironment("geographicTransformations")

# Set variables that we are changing to load the data into the newly created schema in 
# the different coordinate system.
extract_type = "DATA"
out_type = "GEODATABASE"
out_geodatabase = "C:\MyProject\MyOutputGDB.gdb"
out_folder_path = ""
out_name = ""
reuse_schema = "REUSE"
all_records = "ALL_RECORDS_FOR_TABLES"

# Run ExtractDataFromGeodatabase with the data and reuse schema option
arcpy.management.ExtractDataFromGeodatabase(in_data,
                                            extract_type,
                                            out_type,
                                            out_geodatabase,
                                            out_xml,
                                            out_folder_path,
                                            out_name,
                                            expand_fcs,
                                            reuse_schema,
                                            get_related_data,
                                            extract_using_geom,
                                            geom_filter,
                                            all_records)

Rubriques connexes