Извлечь данные из базы геоданных (Управление данными)

Краткая информация

Извлекает поднабор данных из одной базы геоданных в другую базу геоданных или файл .xml.

Более подробно об извлечении данных из базы геоданных

Использование

• Этот инструмент обеспечивает функциональность, аналогичную копированию данных из одной базы геоданных в другую, но поддерживает копирование поднабора данных путем установки среды Экстент, указания значения параметра Извлечь с использованием объектов геометрии или использования выборки. Вы также можете извлечь схему и данные или только схему.

• Этот инструмент также может использоваться для извлечения схемы только для указанной пространственной привязки с помощью параметра среды Выходная система координат. После получения схемы в нужной пространственной привязке можно использовать опцию Использовать повторно параметра Использовать схему повторно для извлечения данных в новую схему.

  Примечание:

  Параметр среды Выходная система координат будет игнорироваться в следующих сценариях:

  • Параметр Извлечь установлен на Данные.
  • Для параметра Выходной тип задано Файл XML.

Параметры

Диалог

Подпись	Описание	Тип данных
Наборы данных для извлечения	Данные, которые будут извлечены.	Table View; Dataset
Извлечение (Дополнительный)	Определяет, будет ли извлекаться схема и строки данных или только схема. Данные—Будет извлечена схема и строки. Это значение по умолчанию Только схема—Будет извлечена только схема.	String
Тип выходных данных (Дополнительный)	Указывает тип выходных данных, в который будут извлечены данные. База геоданных—Данные будут извлечены в существующую базу геоданных. Это значение по умолчанию Файл XML—Данные будут извлечены в XML-документ рабочей области. Новая файловая база геоданных—Данные будут извлечены в новую файловую базу геоданных. Укажите местоположение и имя новой файловой базы геоданных, используя параметры Местоположение базы геоданных и Имя базы геоданных. Новая мобильная база геоданных—Данные будут извлечены в новую мобильную базу геоданных. Укажите местоположение и имя новой мобильной базы геоданных, используя параметры Местоположение базы геоданных и Имя базы геоданных.	String
База геоданных, в которую извлекаются данные (Дополнительный)	База геоданных, которая будет содержать извлеченные данные, если для параметра Выходной тип задано База геоданных.	Workspace
XML-файл, в который извлекаются данные (Дополнительный)	Имя и местоположение файла .xml, который будет создан, если для параметра Выходной тип задано Файл XML.	File
Местоположение базы геоданных (Дополнительный)	Местоположение файловой или мобильной базы геоданных, которая будет создана для извлеченных данных. Этот параметр необходим, когда для параметра Выходной тип задано Новая файловая база геоданных или Новая мобильная база геоданных.	Folder
Имя базы геоданных (Дополнительный)	Имя файловой или мобильной базы геоданных, которая будет создана для извлеченных данных. Этот параметр необходим, когда для параметра Выходной тип задано Новая файловая база геоданных или Новая мобильная база геоданных.	String
Расширить классы объектов и таблицы (Дополнительный)	Указывает, будут ли добавлены расширенные классы пространственных объектов и таблицы, например в сетях, топологиях или классах отношений. Использовать значения по умолчанию—Расширенные классы пространственных объектов и таблицы, связанные с классами пространственных объектов или таблицами во входных наборах данных, будут добавлены. По умолчанию для классов пространственных объектов извлекаются все объекты, пересекающие пространственный фильтр. Если пространственный фильтр не задан, будут включены все объекты. По умолчанию для таблиц используется только извлечение схемы. Это значение по умолчанию Добавить только со схемой—Будет добавлена только схема расширенных классов пространственных объектов и таблиц. Все строки—Будут добавлены все строки расширенных классов пространственных объектов и таблиц. Не добавлять—Расширенные классы пространственных объектов и таблицы не будут добавлены.	String
Использовать схему повторно (Дополнительный)	Определяет, будет ли повторно использоваться база геоданных, содержащая схему извлекаемых данных. Повторное использование схемы сокращает время, требующееся для извлечения данных. Не использовать повторно—Схема не будет использоваться повторно. Это значение по умолчанию Использовать повторно—Схема будет использоваться повторно.	String
Извлечь связанные данные (Дополнительный)	Указывает, извлекать ли строки, связанные со строками, которые уже существуют в данных. Например, пространственный объект (f1) находится внутри фильтра геометрии, а связанный объект (f2) из другого класса находится вне фильтра. Пространственный объект f2 будет включен в извлеченные данные, если вы указали получать связанные данные. Не получать связанные—Связанные данные не будут извлечены. Получать связанные—Связанные данные будут извлечены. Это значение по умолчанию	String
Извлечь с использованием объектов геометрии (Дополнительный)	Объекты, которые будут использованы для определения области извлечения.	Feature Layer
Тип фильтра геометрии (Дополнительный)	Определяет пространственные отношения между значениями параметра Извлечь с использованием объектов геометрии и Входные наборы данных, и как эти отношения будут отфильтровываться. Пространственные отношения применяются к данным в экстенте, определяемом областью интереса (AOI), указанной в параметре Извлечь с использованием объектов геометрии. Пересекает—Будут извлечены объекты в значении параметра Входные наборы данных, которые пересекаются с объектами в значении параметра Извлечь с использованием объектов геометрии. Содержит—Будут извлечены объекты в значении параметра Входные наборы данных, которые содержатся в выбранном объекте в значении параметра Извлечь с использованием объектов геометрии.	String
Все записи для таблиц (Дополнительный)	Указывает, будут ли извлечены все записи или только схема для таблиц, к которым не применяются фильтры (например, выборки или определяющие запросы). Таблицы с примененными фильтрами будут учтены. Отмечено – все записи будут извлечены в базу геоданных. Эта опция переопределит значение параметра Расширить классы объектов и таблицы. Не отмечено — в базу геоданных для таблиц будет извлечена только схема. Это значение по умолчанию	Boolean

Производные выходные данные

Подпись	Описание	Тип данных
Выходная база геоданных	Выходная рабочая область, когда параметр Выходной тип задан как База геоданных, Новая файловая база геоданных или Новая мобильная база геоданных.	Workspace

Python

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 (Дополнительный)	Определяет, будет ли извлекаться схема и строки данных или только схема. DATA—Будет извлечена схема и строки. Это значение по умолчанию SCHEMA_ONLY—Будет извлечена только схема.	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 (Дополнительный)	Определяет, будет ли повторно использоваться база геоданных, содержащая схему извлекаемых данных. Повторное использование схемы сокращает время, требующееся для извлечения данных. DO_NOT_REUSE—Схема не будет использоваться повторно. Это значение по умолчанию REUSE—Схема будет использоваться повторно.	String
get_related_data (Дополнительный)	Указывает, извлекать ли строки, связанные со строками, которые уже существуют в данных. Например, пространственный объект (f1) находится внутри фильтра геометрии, а связанный объект (f2) из другого класса находится вне фильтра. Пространственный объект f2 будет включен в извлеченные данные, если вы указали получать связанные данные. DO_NOT_GET_RELATED—Связанные данные не будут извлечены. GET_RELATED—Связанные данные будут извлечены. Это значение по умолчанию	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

Пример кода

ExtractDataFromGeodatabase, пример 1 (окно Python)

В следующем окне скрипта Python показано, как используется функция ExtractDataFromGeodatabase с одним входным классом объектов и новой выходной файловой базой геоданных.

import arcpy
arcpy.management.ExtractDataFromGeodatabase(
    r"C:\MyProject\MyGDB.gdb\Bridges", "DATA", "NEW_FILE_GEODATABASE", "", "",
   r"C:\MyProject", "MyNewGDB")

ExtractDataFromGeodatabase, пример 2 (окно Python)

Скрипт окна Python, демонстрирующий использование функции ExtractDataFromGeodatabase с несколькими слоями и извлечением схемы только в XML-документ рабочей области.

import arcpy
arcpy.management.ExtractDataFromGeodatabase(
    ["Layer1", "Layer2"], "SCHEMA_ONLY", "XML_FILE", "",
    r"C:\MyProject\MyXMLWkspDoc.xml")

ExtractDataFromGeodatabase, пример 3 (автономный скрипт)

Следующий автономный скрипт 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_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)

ExtractDataFromGeodatabase, пример 4 (автономный скрипт)

Следующий автономный скрипт 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)

ExtractDataFromGeodatabase, пример 5 (автономный скрипт)

Следующий автономный скрипт 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")

ExtractDataFromGeodatabase, пример 6 (автономный скрипт)

Следующий автономный скрипт 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")

Параметры среды

Экстент, Выходная система координат, Выходное ключевое слово CONFIG, Географические преобразования

Информация о лицензиях

• Basic: Нет
• Standard: Да
• Advanced: Да