Создать реплику (Управление данными)

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

Создает реплику в базе геоданных из указанного списка классов объектов, слоев, наборов данных и таблиц из многопользовательской базы геоданных.

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

  • Все наборы данных должны быть из одной исходной (родительской) многопользовательской базы геоданных.

  • Убедитесь, что имена полей в исходной (родительской) базе геоданных не превышают максимальную длину имени поля, поддерживаемую в базе данных, где хранится целевая (дочерняя) база геоданных. Если целевая база геоданных не может хранить все символы, имена полей будут усечены. Это приведет к тому, что имена полей не будут совпадать. Последующие синхронизации реплик не будут передавать изменения между этими полями из-за несовпадающих имен полей.

  • Данные, которые будут реплицированы, должны быть зарегистрированы как традиционные версионные, но не с опцией переноса редактирования в базу.

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

  • Для двусторонних и двух типов односторонних реплик все наборы данных должны содержать столбец GlobalId.

  • Для реплик открепления и односторонних реплик в качестве базы геоданных дочерней реплики может использоваться многопользовательская или файловая.

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

  • Чтобы использовать архивирование для односторонних реплик, родительская рабочая область должна быть подключена к версии Default. Для односторонних реплик из дочерней в родительскую базу дочерняя рабочая область должна быть подключена к версии Default.

  • Вы можете реплицировать все данные в наборах данных или реплицировать подмножества данных. Вы можете задать поднаборы данных для репликации следующими способами:

    • Используйте определяющие запросы к данным.
    • Укажите экстент, используя параметр среды Экстент геообработки.
    • Используйте параметр Объекты геометрии реплики в этом инструменте.

  • Для таблиц фильтр по умолчанию – только схема; для таблицы будет реплицирована только схема. Чтобы применить фильтр к таблице, сначала создайте представление таблицы с соответствующими фильтрами. Затем используйте этот результат в качестве входных данных для этого инструмента. Более подробно см. Создать представление таблицы. Более подробно о фильтрах и репликации см. в разделе Подготовка данных для репликации.

  • Вы можете использовать параметр Объекты геометрии реплики или параметр среды Экстент для определения геометрии реплики.

    • Если для параметра Объекты геометрии реплики задано значение, оно будет использовано как геометрия реплики.
    • Если значение параметра Объекты геометрии реплики не задано, в качестве геометрии реплики будет использоваться параметр среды Экстент.
    • Если отсутствуют значение параметра Объекты геометрии реплики и параметр среды Экстент, используется полный экстент данных.

  • В геометрии объектов реплик могут использоваться точки, линии или полигоны.

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

  • Если в геометрии объектов реплики были определены фильтры (например, определяющий запрос или выборка), то для определения геометрии реплики будут использоваться только те объекты, которые соответствуют этим фильтрам. Более подробно см. в разделе Подготовка данных для репликации.

  • Опции параметра Повторное использование схемы доступны только с репликами открепления.

Параметры

ПодписьОписаниеТип данных
Источники данных для реплики

Данные, которые будут реплицированы. Этот список содержит слои и таблицы, ссылающиеся на версионные, редактируемые данные из многопользовательской базы геоданных.

Table View; Dataset
Тип реплики

Задайте тип реплики для создания.

  • Двухсторонняя реплика—Изменения могут отправляться между дочерней и родительской репликами в обоих направлениях.
  • Односторонняя реплика—Изменения отправляются только из родительской реплики в дочернюю.
  • Открепленная реплика—Данные реплицируются, редактируются и помещаются обратно одновременно.
  • Односторонняя реплика от дочерней к родительской—Изменения отправляются только из дочерней реплики в родительскую.
String
База геоданных, в которой будет создана реплика данных
(Дополнительный)

База геоданных, которая будет хранить дочернюю реплику. Сервисы геоданных используются для представления удаленных баз геоданных. Это может быть многопользовательская или файловая база геоданных. Для двусторонних и односторонних реплик из дочерней в родительскую базу, дочерней базой геоданных должна быть многопользовательская. Для односторонних реплик и реплик открепления, базой геоданных может быть файловая или многопользовательская.

Этот параметр необходим, если для параметра Выходной тип задано База геоданных.

Workspace; GeoDataServer
Имя реплики

Имя, идентифицирующее реплику.

String
Тип доступа к реплике
(Дополнительный)

Задает тип доступа к реплике.

  • Полностью—Сложные типы, например топологии, поддерживаются и данные должны быть версионными. Это значение по умолчанию
  • Простое—Данные в дочерней реплике не версионные и должны быть упрощены. Позволяет репликам взаимодействовать. Непростые объекты (например, пространственные объекты топологии) родительской базы геоданных конвертируются в простые объекты (например, классы объектов точек, линий и полигонов).
String
Начальный отправитель данных
(Дополнительный)

Задает, какая реплика может отправлять изменения в автономном режиме. Если вы работаете в режиме подключения, этот параметр является несущественным. Это гарантирует, что связанная реплика не отправляет обновления, пока изменения в первый раз не будут получены от исходного отправителя данных.

  • Дочерний отправитель данных—Дочерняя реплика является исходным отправителем данных. Это значение по умолчанию
  • Родительский отправитель данных—Родительская реплика является исходным отправителем данных.
String
Расширить классы объектов и таблицы
(Дополнительный)

Указывает, будут ли добавлены расширенные классы пространственных объектов и таблицы, например в сетях, топологиях или классах отношений.

  • Использовать значения по умолчанию—Расширенные классы пространственных объектов и таблицы, связанные с классами пространственных объектов или таблицами в реплике, будут добавлены. По умолчанию для классов пространственных объектов реплицируются все объекты, пересекающие пространственный фильтр. Если пространственный фильтр не задан, будут включены все объекты. По умолчанию для таблиц используется только репликация схемы. Это значение по умолчанию
  • Добавить только со схемой—Будет добавлена только схема расширенных классов пространственных объектов и таблиц.
  • Все строки—Будут добавлены все строки расширенных классов пространственных объектов и таблиц.
  • Не добавлять—Будут добавлены не расширенные классы пространственных объектов и таблицы.
String
Повторное использование схемы
(Дополнительный)

Определяет, будет ли повторно использоваться база геоданных, содержащая схему реплицируемых данных. Это сокращает количество времени, требующееся для репликации данных. Этот параметр доступен только с репликами открепления.

  • Не использовать повторно—Схема не будет использоваться повторно. Это значение по умолчанию
  • Использовать повторно—Схема будет использоваться.
String
Реплицировать связанные данные
(Дополнительный)

Указывает, реплицировать ли строки, связанные со строками, которые уже существуют в реплике. Например, пространственный объект (f1) внутри фильтра реплики и связанный объект (f2) из другого класса вне фильтра. Пространственный объект f2 будет включен в реплику, если вы указали получать связанные данные.

  • Не получать связанные—Связанные данные не будут реплицироваться.
  • Получать связанные—Связанные данные будут реплицироваться. Это значение по умолчанию
String
Геометрия объектов реплик
(Дополнительный)

Объект, используемый для определения области для репликации.

Feature Layer
Использовать архивирование для отслеживания изменений для односторонней репликации
(Дополнительный)

Указывает, использовать ли класс архивов для перенесения изменений вместо использования версионных дельта-таблиц. Доступно только для однонаправленных реплик.

  • Архивирование—Архивирование будет использоваться для отслеживания изменений.
  • Не использовать архивирование—Архивирование не будет использоваться для отслеживания изменений. Это значение по умолчанию
Boolean
Зарегистрировать только существующие данные
(Дополнительный)

Указывает, будут ли существующие данные в дочерней базе геоданных использоваться для регистрации наборов данных реплик. Наборы данных в дочерней базе геоданных должны иметь те же имена, что и наборы данных в родительской базе данных, и принадлежать пользователю, подключенному к дочерней базе геоданных.

  • Отмечено – существующие данные в дочерней базе геоданных будут использоваться для регистрации реплики.
  • Не отмечено – данные в родительской базе геоданных, будут скопированы в дочернюю базу геоданных. Это значение по умолчанию

Boolean
Тип выходных данных
(Дополнительный)

Указывает тип выходных данных, которые будут реплицированы.

  • База геоданных—Данные будут реплицированы в существующую базу геоданных. Это значение по умолчанию
  • Файл XML—Данные будут реплицированы в XML-документ рабочей области.
  • Новая файловая база геоданных—Данные будут реплицированы в новую файловую базу геоданных, которая будет создана при запуске инструмента. Укажите местоположение и имя новой файловой базы геоданных в параметре Местоположение файловой базы геоданных. Этот параметр действителен только для односторонних и открепленных реплик.
String
Файл XML для репликации данных в
(Дополнительный)

Укажите имя и местоположение создаваемого файла .xml.

Этот параметр необходим, если для параметра Выходной тип задано Файл XML.

File
Все записи для таблиц
(Дополнительный)

Указывает, будут ли скопированы все записи или только схема в дочернюю базу геоданных для таблиц, к которым не применены фильтры (например, выборки или определяющие запросы).

Таблицы с примененными фильтрами будут учтены.

  • Отмечено — для таблиц без примененных фильтров все записи будут скопированы в таблицы дочерней базы геоданных. Эта опция переопределит значение параметра Расширить классы объектов и таблицы.
  • Не отмечено — для таблиц без примененных фильтров в дочернюю базу геоданных будет скопирована только схема таблиц. Таблицы с примененными фильтрами будут учтены. Это значение по умолчанию

Boolean
Местоположение файловой базы геоданных
(Дополнительный)

Местоположение файловой база геоданных, которая будет создана для размещения дочерней реплики. Этот параметр необходим, если для параметра Выходной тип задано Новая файловая база геоданных, и действителен только для односторонних и открепленных реплик.

Folder
Имя файловой базы геоданных
(Дополнительный)

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

String

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

ПодписьОписаниеТип данных
Выходная дочерняя рабочая область

Выходная дочерняя база геоданных.

Workspace
Имя выходной реплики

Имя выходной реплики.

String

arcpy.management.CreateReplica(in_data, in_type, {out_geodatabase}, out_name, {access_type}, {initial_data_sender}, {expand_feature_classes_and_tables}, {reuse_schema}, {get_related_data}, {geometry_features}, {archiving}, {register_existing_data}, {out_type}, {out_xml}, {all_records_for_tables}, {out_filegdb_folder_path}, {out_filegdb_name})
ИмяОписаниеТип данных
in_data
[in_data,...]

Данные, которые будут реплицированы. Этот список содержит слои и таблицы, ссылающиеся на версионные, редактируемые данные из многопользовательской базы геоданных.

Table View; Dataset
in_type

Задайте тип реплики для создания.

  • TWO_WAY_REPLICA—Изменения могут отправляться между дочерней и родительской репликами в обоих направлениях.
  • ONE_WAY_REPLICA—Изменения отправляются только из родительской реплики в дочернюю.
  • CHECK_OUT—Данные реплицируются, редактируются и помещаются обратно одновременно.
  • ONE_WAY_CHILD_TO_PARENT_REPLICA—Изменения отправляются только из дочерней реплики в родительскую.
String
out_geodatabase
(Дополнительный)

База геоданных, которая будет хранить дочернюю реплику. Сервисы геоданных используются для представления удаленных баз геоданных. Это может быть многопользовательская или файловая база геоданных. Для двусторонних и односторонних реплик из дочерней в родительскую базу, дочерней базой геоданных должна быть многопользовательская. Для односторонних реплик и реплик открепления, базой геоданных может быть файловая или многопользовательская.

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

Workspace; GeoDataServer
out_name

Имя, идентифицирующее реплику.

String
access_type
(Дополнительный)

Задает тип доступа к реплике.

  • FULL—Сложные типы, например топологии, поддерживаются и данные должны быть версионными. Это значение по умолчанию
  • SIMPLE—Данные в дочерней реплике не версионные и должны быть упрощены. Позволяет репликам взаимодействовать. Непростые объекты (например, пространственные объекты топологии) родительской базы геоданных конвертируются в простые объекты (например, классы объектов точек, линий и полигонов).
String
initial_data_sender
(Дополнительный)

Задает, какая реплика может отправлять изменения в автономном режиме. Если вы работаете в режиме подключения, этот параметр является несущественным. Это гарантирует, что связанная реплика не отправляет обновления, пока изменения в первый раз не будут получены от исходного отправителя данных.

  • CHILD_DATA_SENDER—Дочерняя реплика является исходным отправителем данных. Это значение по умолчанию
  • PARENT_DATA_SENDER—Родительская реплика является исходным отправителем данных.
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
geometry_features
(Дополнительный)

Объект, используемый для определения области для репликации.

Feature Layer
archiving
(Дополнительный)

Указывает, использовать ли класс архивов для перенесения изменений вместо использования версионных дельта-таблиц. Доступно только для однонаправленных реплик.

  • ARCHIVING—Архивирование будет использоваться для отслеживания изменений.
  • DO_NOT_USE_ARCHIVING—Архивирование не будет использоваться для отслеживания изменений. Это значение по умолчанию
Boolean
register_existing_data
(Дополнительный)

Указывает, будут ли существующие данные в дочерней базе геоданных использоваться для регистрации наборов данных реплик. Наборы данных в дочерней базе геоданных должны иметь те же имена, что и наборы данных в родительской базе геоданных.

  • REGISTER_EXISTING_DATA—Существующие данные в дочерней базе геоданных будут использоваться для регистрации реплики.
  • DO_NOT_USE_REGISTER_EXISTING_DATA—Данные в родительской базе геоданных, будут скопированы в дочернюю базу геоданных. Это значение по умолчанию
Boolean
out_type
(Дополнительный)

Указывает тип выходных данных, которые будут реплицированы.

  • GEODATABASE—Данные будут реплицированы в существующую базу геоданных. Это значение по умолчанию
  • XML_FILE—Данные будут реплицированы в XML-документ рабочей области.
  • NEW_FILE_GEODATABASE—Данные будут реплицированы в новую файловую базу геоданных, которая будет создана при запуске инструмента. Укажите местоположение и имя новой файловой базы геоданных в параметре out_filegdb_folder_path. Этот параметр действителен только для односторонних и открепленных реплик.
String
out_xml
(Дополнительный)

Укажите имя и местоположение создаваемого файла .xml.

Этот параметр является обязательным, если для параметра out_type установлено значение XML_FILE.

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

Указывает, будут ли скопированы все записи или только схема в дочернюю базу геоданных для таблиц, к которым не применены фильтры (например, выборки или определяющие запросы).

Таблицы с примененными фильтрами будут учтены.

  • ALL_RECORDS_FOR_TABLES—Для таблиц без примененных фильтров все записи будут скопированы в дочернюю базу геоданных. Эта опция переопределит значение параметра expand_feature_classes_and_tables.
  • SCHEMA_ONLY_FOR_TABLES—Для таблиц без примененных фильтров в дочернюю базу геоданных будет скопирована только схема. Таблицы с примененными фильтрами будут учтены. Это значение по умолчанию
Boolean
out_filegdb_folder_path
(Дополнительный)

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

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

Имя файловой база геоданных, которая будет создана для размещения дочерней реплики. Этот параметр необходим, если для параметра out_type задано NEW_FILE_GEODATABASE, и действителен только для односторонних и открепленных реплик.

String

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

ИмяОписаниеТип данных
out_child_geodatabase

Выходная дочерняя база геоданных.

Workspace
output_replica_name

Имя выходной реплики.

String

Пример кода

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

Следующий скрипт окна Python, показывает использование функции CreateReplica в окне Python.

import arcpy
arcpy.env.workspace = "C:/Data/MyData.sde"
arcpy.management.CreateReplica("roads", "ONE_WAY_REPLICA", 
                               "C:\Data\MyTargetGDB.gdb", "MyReplica", "FULL", 
                               "PARENT_DATA_SENDER", "USE_DEFAULTS", 
                               "DO_NOT_REUSE", "GET_RELATED")
CreateReplica, пример 2 (автономный скрипт)

Следующий скрипт Python показывает пример использования функции CreateReplica в виде автономного скрипта Python.

# Name: CreateReplica_Example2.py
# Description: Create a one-way replica of a Feature Dataset to a file geodatabase. 

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/MyData.sde"

# Set local variables
in_data = "Parks" # a feature dataset
replica_type = "ONE_WAY_REPLICA"
output_workspace = "C:\Data\MyTargetGDB.gdb"
replica_name = "MyReplica"
access_type = "FULL"
initial_sender = "PARENT_DATA_SENDER"
expand = "USE_DEFAULTS"
reuse_schema = "DO_NOT_REUSE"
get_related = "GET_RELATED"
replica_geometry = "LA_County"
archiving = "DO_NOT_USE_ARCHIVING"

# Run CreateReplica
arcpy.management.CreateReplica(in_data, replica_type, output_workspace, 
                               replica_name, access_type, initial_sender, 
                               expand, reuse_schema, get_related, 
                               replica_geometry, archiving)

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

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

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