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

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

Извлекает поднабор данных из одной базы геоданных в другую базу геоданных или файл .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

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.
String
out_geodatabase
(Дополнительный)

База геоданных, которая будет содержать извлеченные данные, если для параметра out_type задано GEODATABASE.

Workspace
out_xml
(Дополнительный)

Имя и местоположение файла .xml, который будет создан, если для параметра out_type задано XML_FILE.

File
out_folder_path
(Дополнительный)

Местоположение базы геоданных, которая будет создана для извлеченных данных. Этот параметр необходим, если для параметра out_type задано NEW_FILE_GEODATABASE.

Folder
out_name
(Дополнительный)

Имя базы геоданных, которая будет создана для извлеченных данных. Этот параметр необходим, если для параметра out_type задано NEW_FILE_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

Выходная рабочая область.

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)

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

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

Связанные разделы