Импорт сообщения (Управление данными)

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

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

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

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

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

  • Инструмент принимает подтверждающие сообщения или сообщения об изменении данных. Файлы подтверждения - файлы .xml. Сообщения об изменениях данных могут быть базой геоданных дельта-файла (.gdb) или дельта-файл XML (.xml).

  • После импорта сообщения об изменении данных можно сразу же выполнить экспорт сообщения подтверждения. Выходной файл подтверждения должно быть файлом XML (.xml).

  • Для синхронизации реплик в подключенном режиме см. инструмент Синхронизировать изменения.

Параметры

ПодписьОписаниеТип данных
Импорт в базу геоданных реплики

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

Workspace; GeoDataServer
Импорт из дельта-файла

Файл, из которого будут импортированы сообщения.

Workspace ; File
Выходной файл подтверждения
(Дополнительный)

Файл, который будет содержать сообщение подтверждения. При импорте изменений данных вы можете также экспортировать сообщение подтверждения импорта сообщения об изменении данных. Параметр поддерживается только для сообщения об изменении данных.

File
Правила разрешения конфликтов
(Дополнительный)

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

  • Разрешение конфликтов вручнуюКонфликты будут разрешаться вручную в среде согласования версий.
  • В пользу базы данныхКонфликты будут автоматически разрешены в пользу базы геоданных, получающий изменения.
  • В пользу импортированных измененийКонфликты будут автоматически разрешены в пользу импортированных изменений.
String
Выявление конфликтов
(Дополнительный)

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

  • По объектуКонфликты будут выявляться строкой
  • По атрибутуКонфликты будут выявляться столбцом
String
Согласовать с родительской версией (Открепленные реплики).
(Дополнительный)

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

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

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

ПодписьОписаниеТип данных
Выходная реплика базы геоданных

Обновленная реплика базы геоданных

Workspace; GeoDataServer

arcpy.management.ImportMessage(in_geodatabase, source_delta_file, {output_acknowledgement_file}, {conflict_policy}, {conflict_definition}, {reconcile_with_parent_version})
ИмяОписаниеТип данных
in_geodatabase

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

Workspace; GeoDataServer
source_delta_file

Файл, из которого будут импортированы сообщения.

Workspace ; File
output_acknowledgement_file
(Дополнительный)

Файл, который будет содержать сообщение подтверждения. При импорте изменений данных вы можете также экспортировать сообщение подтверждения импорта сообщения об изменении данных. Параметр поддерживается только для сообщения об изменении данных.

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

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

  • MANUALКонфликты будут разрешаться вручную в среде согласования версий.
  • IN_FAVOR_OF_DATABASEКонфликты будут автоматически разрешены в пользу базы геоданных, получающий изменения.
  • IN_FAVOR_OF_IMPORTED_CHANGESКонфликты будут автоматически разрешены в пользу импортированных изменений.
String
conflict_definition
(Дополнительный)

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

  • BY_OBJECTКонфликты будут выявляться строкой
  • BY_ATTRIBUTEКонфликты будут выявляться столбцом
String
reconcile_with_parent_version
(Дополнительный)

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

  • DO_NOT_RECONCILEИзменения не будут согласованы с родительской версией. Это значение по умолчанию
  • RECONCILEИзменения будут согласованы с родительской версией.
Boolean

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

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

Обновленная реплика базы геоданных

Workspace; GeoDataServer

Пример кода

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

В следующем примере показано, как использовать функцию ImportMessage в окне Python.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.ImportMessage_management("MySDEdata.sde", "DataChanges.gdb", 
                               "acknowledgement.xml", 
                               "IN_FAVOR_OF_IMPORTED_CHANGES", "BY_OBJECT")
ImportMessage, пример 2 (автономный скрипт)

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

# Name: ImportMessage_Example2.py
# Description: Import a data change message (from a delta gdb) into a replica workspace.   

# Import system modules
import arcpy

# Set workspace
arcpy.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)
ImportMessage, пример 3 (автономный скрипт)

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

# Name: ImportMessage_Example3.py
# Description: Import an acknowledgement message into a replica workspace.  

# Import system modules
import arcpy

# Set workspace
arcpy.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)

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

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

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