Extraire des données d’une géodatabase (Outils de gestion des données)

Résumé

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 d’une géodatabase

Utilisation

Cet outil propose des fonctions similaires à la copie de données d’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 Extent (Étendue), en spécifiant une valeur pour le paramètre Extract Using Geometry Features (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 également extraire la structure seulement pour une référence spatiale spécifiée à l’aide de l’environnement Output Coordinate System (Système de coordonnées en sortie). Une fois que la structure a été obtenue dans la référence spatiale de votre choix, vous pouvez utiliser l’option Reuse (Réutiliser) du paramètre Reuse Schema (Réutiliser la structure) pour extraire les données dans la nouvelle structure.

Remarque :

Le système de coordonnées en sortie est ignoré dans les scénarios suivants :

Le paramètre Extract (Extraire) est défini sur Data (Données).

Le paramètre Output Type (Type en sortie) est défini sur XML File (Fichier XML).

Etiqueter	Explication	Type 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ées—La structure et les lignes seront extraites. Il s’agit de l’option par défaut. Structure uniquement—Seule la structure sera extraite.	String
Type en sortie (Facultatif)	Spécifie le type en sortie dans lequel les données seront extraites. Géodatabase—Les données seront extraites dans une géodatabase existante. Il s’agit de l’option par défaut. Fichier XML—Les données seront extraites dans un document d’espace de travail XML. Nouvelle géodatabase fichier—Les 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 Geodatabase Location (Emplacement de la géodatabase) et Geodatabase Name (Nom de la géodatabase). Nouvelle géodatabase mobile—Les données seront extraites dans une nouvelle géodatabase mobile. Indiquez l’emplacement et le nom de la nouvelle géodatabase mobile à l’aide des paramètres Geodatabase Location (Emplacement de la géodatabase) et Geodatabase Name (Nom de la géodatabase).	String
Géodatabase dans laquelle extraire les données (Facultatif)	La géodatabase contient les données extraites si le paramètre Output Type (Type en sortie) est défini sur Geodatabase (Géodatabase).	Workspace
Fichier XML dans lequel extraire les données (Facultatif)	Nom et emplacement du fichier `.xml` créé si le paramètre Output Type (Type en sortie) est défini sur XML file (Fichier XML).	File
Emplacement de la géodatabase (Facultatif)	Emplacement de la géodatabase fichier ou mobile à créer pour les données extraites. Ce paramètre est requis si le paramètre Output Type (Type en sortie) est défini sur New file geodatabase (Nouvelle géodatabase fichier) ou New mobile geodatabase (Nouvelle géodatabase mobile).	Folder
Nom de la géodatabase (Facultatif)	Nom de la géodatabase fichier ou mobile à créer pour les données extraites. Ce paramètre est requis si le paramètre Output Type (Type en sortie) est défini sur New file geodatabase (Nouvelle géodatabase fichier) ou New mobile geodatabase (Nouvelle géodatabase mobile).	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éfaut—Les 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. L’option par défaut pour les classes d’entités est d’extraire toutes les entités qui intersectent le filtre spatial. Si aucun filtre spatial n’a été défini, toutes les entités sont incluses. L’option par défaut pour les tables est d’extraire uniquement la structure. Il s’agit de l’option par défaut. Ajouter avec la structure uniquement—Seule la structure pour les classes d’entités et les tables développées sera ajoutée. Toutes les lignes—Toutes les lignes pour les tables et les classes d’entités développées seront ajoutées. Ne pas ajouter—Aucune 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éutiliser—La structure ne sera pas réutilisée. Il s’agit de l’option par défaut. Réutiliser—La 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 relier—Les données associées ne seront pas extraites. Relier—Les 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 Extract Using Geometry Features (Extraire à l’aide d’entités de géométrie) et Input Datasets (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 (AOI) spécifiée dans le paramètre Extract Using Geometry Features (Extraire à l’aide d’entités de géométrie). Intersecte—Les entités dans la valeur de paramètre Input Datasets (Jeux de données en entrée) qui intersectent des entités dans la valeur de paramètre Extract Using Geometry Features (Extraire à l’aide d’entités de géométrie) sont extraites. Il s’agit de l’option par défaut. Contient—Les entités dans la valeur de paramètre Input Datasets (Jeux de données en entrée) qui se trouvent dans l’entité sélectionnée dans la valeur de paramètre Extract Using Geometry Features (Extraire à l’aide d’entités de géométrie) sont 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 auxquelles des filtres sont appliqués sont respectées. Activé—Tous les enregistrements seront extraits dans la géodatabase. Cette option remplace la valeur du paramètre Expand Feature Classes and Tables (Développer les classes d’entités et les tables). Décoché—Seule la structure sera extraite dans la géodatabase. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Géodatabase en sortie	Espace de travail en sortie si le paramètre Output Type (Type en sortie) est défini sur Geodatabase (Géodatabase), New file geodatabase (Nouvelle géodatabase fichier) ou New mobile geodatabase (Nouvelle géodatabase mobile).	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})

Nom	Explication	Type 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. `DATA`—La structure et les lignes seront extraites. Il s’agit de l’option par défaut. `SCHEMA_ONLY`—Seule la structure sera extraite.	String
out_type (Facultatif)	Spécifie le type en sortie dans lequel les données seront extraites. `GEODATABASE`—Les données seront extraites dans une géodatabase existante. Il s’agit de l’option par défaut. `XML_FILE`—Les données seront extraites dans un document d’espace de travail XML. `NEW_FILE_GEODATABASE`—Les 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`. `NEW_MOBILE_GEODATABASE`—Les données seront extraites dans une nouvelle géodatabase mobile. Indiquez l’emplacement et le nom de la nouvelle géodatabase mobile à l’aide des paramètres `out_folder_path` et `out_name`.	String
out_geodatabase (Facultatif)	Géodatabase contenant les données extraites si le paramètre `out_type` est défini sur `GEODATABASE`.	Workspace
out_xml (Facultatif)	Nom et emplacement du fichier `.xml` créé si le paramètre `out_type` est défini sur `XML_FILE`.	File
out_folder_path (Facultatif)	Emplacement de la géodatabase fichier ou mobile à créer pour les données extraites. Ce paramètre est obligatoire si le paramètre `out_type` est défini sur `NEW_FILE_GEODATABASE` ou `NEW_MOBILE_GEODATABASE`.	Folder
out_name (Facultatif)	Nom de la géodatabase fichier ou mobile à créer pour les données extraites. Ce paramètre est obligatoire si le paramètre `out_type` est défini sur `NEW_FILE_GEODATABASE` ou `NEW_MOBILE_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_DEFAULTS`—Les 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. L’option par défaut pour les classes d’entités est d’extraire toutes les entités qui intersectent le filtre spatial. Si aucun filtre spatial n’a été défini, toutes les entités sont incluses. L’option par défaut pour les tables est d’extraire uniquement la structure. Il s’agit de l’option par défaut. `ADD_WITH_SCHEMA_ONLY`—Seule la structure pour les classes d’entités et les tables développées sera ajoutée. `ALL_ROWS`—Toutes les lignes pour les tables et les classes d’entités développées seront ajoutées. `DO_NOT_ADD`—Aucune 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_REUSE`—La structure ne sera pas réutilisée. Il s’agit de l’option par défaut. `REUSE`—La 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_RELATED`—Les données associées ne seront pas extraites. `GET_RELATED`—Les 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`. `INTERSECTS`—Les entités dans la valeur du paramètre `in_data` qui intersectent des entités dans la valeur du paramètre `extract_using_geometry_features` sont extraites. Il s’agit de l’option par défaut. `CONTAINS`—Les entités dans la valeur du paramètre `in_data` qui se trouvent dans l’entité sélectionnée dans la valeur du paramètre `extract_using_geometry_features` sont 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 auxquelles des filtres sont appliqués sont respectées. `ALL_RECORDS_FOR_TABLES`—Tous les enregistrements seront extraits dans la géodatabase. Cette option remplace la valeur du paramètre `expand_feature_classes_and_tables`. `SCHEMA_ONLY_FOR_TABLES`—Seule la structure sera extraite dans la géodatabase. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Nom	Explication	Type de données
out_workspace	Espace de travail en sortie si le paramètre `out_type` est défini sur `GEODATABASE`, `NEW_FILE_GEODATABASE` ou `NEW_MOBILE_GEODATABASE`.	Workspace

Exemple de code

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

Le script de fenêtre Python ci-après 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 ci-après 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 ci-après montre comment utiliser la fonction ExtractDataFromGeodatabase avec plusieurs jeux de données en entrée dans une géodatabase existante à l’aide de l’environnement Extent (É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_xml = ""
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 ci-après 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 à l’aide de l’environnement Output Coordinate System (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)

Exemple 5 d’utilisation de la fonction ExtractDataFromGeodatabase (script autonome)

Le script Python autonome ci-après illustre l’utilisation de l’outil ExtractDataFromGeodatabase et de la structure d’extraction dans un fichier XML, puis le chargement des données à l’aide de l’outil ImportXMLWorkspaceDocument.

# Name: ExtractDataFromGeodatabase_Example5.py
# Description: Extract schema of multiple feature classes and import the
#              schema into an enterprise geodatabase

# 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"

# Export the schema as an XML file from a feature class
result = arcpy.management.ExtractDataFromGeodatabase(
    ["FC1", "FC2"], "SCHEMA_ONLY", "XML_FILE", "",
    "C:/MyProject/MyXMLWkspDoc.xml")

# Get the path to the output XML file
out_xml = result[0]

# Pass the output XML into the Import XML Workspace Document tool
arcpy.management.ImportXMLWorkspaceDocument("C:/MyProject/mySDEConnection.sde",
                                            out_xml,
                                            "SCHEMA_ONLY", "DEFAULTS")

Exemple 6 d’utilisation de la fonction ExtractDataFromGeodatabase (script autonome)

Le script Python autonome ci-après illustre l’utilisation de l’outil ExtractDataFromGeodatabase pour extraire des données dans une nouvelle géodatabase mobile et créer un domaine pour la nouvelle géodatabase en sortie.

# Name: ExtractDataFromGeodatabase_Example6.py
# Description: Extract data and create a domain on output workspace

# Import system modules
import arcpy

# Export data to a new mobile geodatabase
result = arcpy.management.ExtractDataFromGeodatabase(
    "C:/MyProject/mySDEConnection.sde/myGDB.USER1.FC1", "DATA", "NEW_MOBILE_GEODATABASE", "", "",
    "C:/MyProject", "newMobileGDB")

# Get the path to the output mobile geodatabase
out_mobile_gdb = result[1]

# Pass the output geodatbase to the CreateDomain tool
arcpy.management.CreateDomain(out_mobile_gdb, "MyDomain", "My domain description", "SHORT", "CODED")

Environnements

Etendue, Système de coordonnées en sortie, Mot-clé CONFIG en sortie, Transformations géographiques

Informations de licence

Basic: Non
Standard: Oui
Advanced: Oui

Extraire des données d’une géodatabase (Outils de gestion des données)

Résumé

Utilisation

Remarque :

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes