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})
|
Имя
|
Объяснение
|
Тип данных
|
|
in_data
[in_data,...]
|
Данные, которые будут извлечены.
|
Table View; Dataset
|
|
extract_type
(Дополнительный)
|
Определяет, будет ли извлекаться схема и строки данных или только схема.
|
String
|
|
out_type
(Дополнительный)
|
Указывает тип выходных данных, в который будут извлечены данные.
GEODATABASE–Данные будут извлечены в существующую базу геоданных. Используется по умолчанию.
XML_FILE–Данные будут извлечены в XML-документ рабочей области.
NEW_FILE_GEODATABASE–Данные будут извлечены в новую файловую базу геоданных. Укажите местоположение и имя новой файловой базы геоданных, используя параметры out_folder_path и out_name.
NEW_MOBILE_GEODATABASE–Данные будут извлечены в новую мобильную базу геоданных. Укажите местоположение и имя новой мобильной базы геоданных, используя параметры out_folder_path и out_name.
|
String
|
|
out_geodatabase
(Дополнительный)
|
База геоданных, которая будет содержать извлеченные данные, если для параметра out_type задано GEODATABASE.
|
Workspace
|
|
out_xml
(Дополнительный)
|
Имя и местоположение файла .xml, который будет создан, если для параметра out_type задано XML_FILE.
|
File
|
|
out_folder_path
(Дополнительный)
|
Местоположение файловой или мобильной базы геоданных, которая будет создана для извлеченных данных. Этот параметр необходим, если для параметра out_type задано NEW_FILE_GEODATABASE или NEW_MOBILE_GEODATABASE.
|
Folder
|
|
out_name
(Дополнительный)
|
Имя файловой или мобильной базы геоданных, которая будет создана для извлеченных данных. Этот параметр необходим, если для параметра out_type задано NEW_FILE_GEODATABASE или NEW_MOBILE_GEODATABASE.
|
String
|
|
expand_feature_classes_and_tables
(Дополнительный)
|
Указывает, будут ли добавлены расширенные классы пространственных объектов и таблицы, например в сетях, топологиях или классах отношений.
USE_DEFAULTS–Расширенные классы пространственных объектов и таблицы, связанные с классами пространственных объектов или таблицами во входных наборах данных, будут добавлены. По умолчанию для классов пространственных объектов извлекаются все объекты, пересекающие пространственный фильтр. Если пространственный фильтр не задан, будут включаютсяены все объекты. По умолчанию для таблиц извлекается только схема. Используется по умолчанию.
ADD_WITH_SCHEMA_ONLY–Будет добавлена только схема расширенных классов пространственных объектов и таблиц.
ALL_ROWS–Будут добавлены все строки расширенных классов пространственных объектов и таблиц.
DO_NOT_ADD–Расширенные классы пространственных объектов и таблицы не будут добавлены.
|
String
|
|
reuse_schema
(Дополнительный)
|
Определяет, будет ли повторно использоваться база геоданных, содержащая схему извлекаемых данных. Повторное использование схемы сокращает время, необходимое для извлечения данных.
|
String
|
|
get_related_data
(Дополнительный)
|
Указывает, извлекать ли строки, связанные со строками, которые уже существуют в данных. Например, пространственный объект (f1) находится внутри фильтра геометрии, а связанный объект (f2) из другого класса находится вне фильтра. Пространственный объект f2 будет включен в извлеченные данные, если вы указали получать связанные данные.
|
String
|
|
extract_using_geometry_features
(Дополнительный)
|
Объекты, которые будут использованы для определения области извлечения.
|
Feature Layer
|
|
geometry_filter_type
(Дополнительный)
|
Определяет пространственные отношения между значениями параметра extract_using_geometry_features и in_data, и как эти отношения будут отфильтровываться. Пространственные отношения применяются к данным в экстенте, определяемом областью интереса (AOI), указанной в параметре extract_using_geometry_features.
INTERSECTS–Будут извлечены объекты в значении параметра in_data, которые пересекаются с объектами в значении параметра extract_using_geometry_features. Используется по умолчанию.
CONTAINS–Будут извлечены объекты в значении параметра in_data, которые содержатся в выбранном объекте в значении параметра extract_using_geometry_features.
|
String
|
|
all_records_for_tables
(Дополнительный)
|
Указывает, будут ли извлечены все записи или только схема для таблиц, к которым не применяются фильтры (например, выборки или определяющие запросы).
Таблицы с примененными фильтрами будут учтены.
ALL_RECORDS_FOR_TABLES–Все записи будут извлечены в базу геоданных. Эта опция переопределит значение параметра expand_feature_classes_and_tables.
SCHEMA_ONLY_FOR_TABLES–В базу геоданных будет извлечена только схема. Используется по умолчанию.
|
Boolean
|
Производные выходные данные
|
Имя
|
Объяснение
|
Тип данных
|
|
out_workspace
|
Выходная рабочая область, когда параметр out_type задан как GEODATABASE, NEW_FILE_GEODATABASE или NEW_MOBILE_GEODATABASE.
|
Workspace
|
Пример кода
Пример 2 ExtractDataFromGeodatabase (окно Python)
В следующем окне скрипта Python показано, как используется функция ExtractDataFromGeodatabase с одним входным классом объектов и новой выходной файловой базой геоданных.
import arcpy
arcpy.management.ExtractDataFromGeodatabase(
r"C:\MyProject\MyGDB.gdb\Bridges", "DATA", "NEW_FILE_GEODATABASE", "", "",
r"C:\MyProject", "MyNewGDB")
Пример 2 ExtractDataFromGeodatabase (окно Python)
Скрипт окна Python, демонстрирующий использование функции ExtractDataFromGeodatabase с несколькими слоями и извлечением схемы только в XML-документ рабочей области.
import arcpy
arcpy.management.ExtractDataFromGeodatabase(
["Layer1", "Layer2"], "SCHEMA_ONLY", "XML_FILE", "",
r"C:\MyProject\MyXMLWkspDoc.xml")
Пример 3 ExtractDataFromGeodatabase (автономный скрипт)
Следующий автономный скрипт Python демонстрирует пример использования функции ExtractDataFromGeodatabase с несколькими входными наборами данных в существующую базу геоданных с помощью среды Экстент.
# 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)
Пример 4 ExtractDataFromGeodatabase (автономный скрипт)
Следующий автономный скрипт Python демонстрирует порядок использования функции ExtractDataFromGeodatabase для извлечения данных в новую файловую базу геоданных с новой системой координат с помощью среды Выходная система координат.
# 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)
Пример 5 ExtractDataFromGeodatabase (автономный скрипт)
Следующий автономный скрипт Python демонстрирует, как использовать инструмент ExtractDataFromGeodatabase и извлекать схему в XML-файл, а затем загружать данные с помощью инструмента 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")
Пример 6 ExtractDataFromGeodatabase (автономный скрипт)
Следующий автономный скрипт Python демонстрирует, как использовать инструмент ExtractDataFromGeodatabase для извлечения данных в новую мобильную базу геоданных и создания домена для новой выходной базы геоданных.
# 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")