Импорт сообщения (Управление данными)
Резюме
Импортирует изменения из дельта-файла в базу геоданных реплики, или импортирует подтверждающее сообщение в базу геоданных реплики.
Использование
-
Этот инструмент используется для синхронизации при подключении. Это делается путем первого запуска инструмента Экспорт сообщения об изменении данных (Export Data Change Message), который создает дельта-файл с изменениями для синхронизации. Дельта-файл затем копируется в связанную реплику и импортируется с помощью инструмента Импортировать сообщение (Import Message). Если дельта-файл теряется и вы хотите повторно отправить, вы можете использовать инструмент Ре-экспорт неподтвержденного сообщения (Re-Export Unacknowledged Messages), чтобы заново создать дельта-файл. После импортирования изменений относительная реплика может экспортировать файл подтверждения при помощи инструмента Экспорт подтвержденного сообщения (Export Acknowledgement Message). Файл подтверждения копируется в реплику и импортируется с помощью инструмента Импортировать сообщение (Import Message). Если подтверждение не получено, в следующий раз, когда отправляются изменения, они включают новые, а также ранее отправленные изменения.
-
База геоданных может быть локальной базой геоданных или сервисом геоданных.
-
Принимает либо подтвержденные сообщения, либо сообщения об изменении данных. Файлы подтверждения — это XML-файлы (.xml). Сообщениями об изменении данных могут быть файловая дельта-база геоданных (.gdb), персональная дельта-база геоданных (.mdb) или дельта-файлы XML (.xml).
-
После импорта сообщения об изменении данных, у вас есть опция для непосредственного экспорта подтвержденного сообщения. Выходной файл подтверждения должен быть формата XML.
-
Чтобы синхронизировать реплики в режиме подключения, см. инструмент Синхронизировать изменения (Synchronize Changes).
Синтаксис
| Параметр | Объяснение | Тип данных |
in_geodatabase |
Указывает реплику базы геоданных для получения импортированного сообщения. База геоданных может быть локальной или удаленной. | Workspace ; GeoDataServer |
source_delta_file |
Указывает файл, из которого будет импортировано сообщение. | Workspace ; File |
output_acknowledgement_file (дополнительно) |
При импорте изменений данных это позволяет вам дополнительно экспортировать сообщение в предупреждение об импорте изменений данных. Эта опция игнорируется везде, кроме сообщений об изменении данных. | File |
conflict_policy (дополнительно) |
Указывает, как разрешаются конфликты, если они встречаются, в процессе импорта сообщения об изменении данных.
| String |
conflict_definition (дополнительно) |
Задает, как вы предпочитаете определять конфликты:
| String |
reconcile_with_parent_version (дополнительно) |
Означает автоматическое согласование как только изменения данных отправляются в родительскую реплику в случае наличия конфликтов. Эта опция доступна только для реплик открепления/прикрепления.
| Boolean |
Пример кода
На следующем примере демонстрируется, как использовать функцию Импорт сообщения (Import Message) в окне Python.
import arcpy
from arcpy import env
env.workspace = "C:/Data"
arcpy.ImportMessage_management("MySDEdata.sde", "DataChanges.gdb", "acknowledgement.xml", "IN_FAVOR_OF_IMPORTED_CHANGES", "BY_OBJECT")
Демонстрируется, как используется функция Импорт сообщения (Import Message) для импорта файла изменений данных в автономном скрипте Python.
# Name: ImportMessage_Example2.py
# Description: Imports a data change message (from a delta gdb) into a replica workspace.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data"
# Set local variables
replica_workspace = "MySDEdata.sde"
in_message = "DataChanges.gdb" # data changes file (delta gdb)
output_acknowledgement = "acknowledgement.xml" # optional
conflict_policy = "IN_FAVOR_OF_IMPORTED_CHANGES"
conflict_detection = "BY_OBJECT"
reconcile = "" # Only applicable for checkout replicas
# Execute Import Message
arcpy.ImportMessage_management(replica_workspace, in_message, output_acknowledgement, conflict_policy, conflict_detection, reconcile)
Демонстрируется, как используется функция Импорт сообщения (Import Message) для импорта файла изменений данных в автономном скрипте Python.
# Name: ImportMessage_Example3.py
# Description: Imports an acknowledgement message into a replica workspace.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data"
# Set local variables
replica_workspace = "MySDEdata.sde"
in_message = "acknowledgement.xml" # Acknowledgement file
output_acknowledgement = "" # not applicable when importing an acknowledgement file
conflict_policy = "" # not applicable when importing an acknowledgement file
conflict_detection = "" # not applicable when importing an acknowledgement file
reconcile = "" # not applicable when importing an acknowledgement file
# Execute Import Message
arcpy.ImportMessage_management(replica_workspace, dc_Message, output_acknowledgement, conflict_policy, conflict_detection, reconcile)