Наверх

Обновление базы геоданных в PostgreSQL

В этом разделе

  1. До начала обновления
  2. Обновление базы геоданных

Доступно с лицензией Standard или Advanced.

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

Установите новую версию ArcGIS Pro или ArcGIS Server или примените пакет обновлений, патч или пакет исправлений к существующей версии и обновите базу геоданных до более поздней версии.

Примечание:

Даже если вы не обновите базу геоданных, используемая вами версия базы данных может больше не поддерживаться текущей версией программного обеспечения ArcGIS. Всегда проверяйте системные требования, чтобы убедиться, что вы по-прежнему используете поддерживаемую версию базы данных. Если версия базы данных больше не поддерживается, возможно, потребуется обновить базу геоданных. Чем больше времени проходит между обновлениями, тем более сложным становится процесс обновления.

Если вы обновите базу геоданных с помощью ArcGIS Pro версии 3.4, версия обновленной базы геоданных будет 11.4.0.x.

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

До начала обновления

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

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

Имейте в виду следующее:

  • Обновления с бета-или предварительных версий программного обеспечения не поддерживаются.
  • Вы можете выполнить обновление непосредственно из базы геоданных 10.9.x или 11.x, если версия базы данных PostgreSQL поддерживается текущей версией ArcGIS.

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

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

    Обновление с гораздо более старой версии базы геоданных требует многоэтапного обновления базы геоданных и базы данных.

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

  • Не существует формального механизма для перехода на более раннюю версию базы геоданных. Если после обновления на более новую версию вы хотите вернуться на старую версию базы геоданных, вы можете восстановить базу данных из файла резервной копии, которая содержит предыдущую версию базы геоданных.
  • При обновлении базы геоданных версии 11.2.0, использующей пространственный тип ST_Geometry, в процессе обновления будут удалены и заново созданы пространственные индексы, определенные вами в столбцах ST_Geometry.

Ниже приводится перечень необходимых шагов перед обновлением базы геоданных:

  1. Прочитайте Требования ArcGIS для PostgreSQL, чтобы убедиться, что Esri поддерживает PostgreSQL и комбинацию версий ArcGIS, которые вы хотите использовать.

    Если вам необходимо обновить базу данных PostgreSQL, см. документацию PostgreSQL для получения информации о новых функциях в системе управления базами данных и о том, как ее обновить. Помните, что обновленные базы данных имеют те же имена и владельцев, что и раньше. Кроме того, задайте переменную search_path в создаваемой базе данных "$user", public и sde.

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

    Чтобы сделать это, установите версию клиента ArcGIS, на которую вы хотите перейти, на одной машине. Если вы установите ArcGIS Pro, используйте подключение, созданное на предыдущем шаге, чтобы подключиться к базе геоданных, и откройте диалоговое окно Свойства базы данных, чтобы определить, возможно ли обновление этой базы геоданных. Если вы установите ArcGIS Server (многопользовательская версия), вы можете использовать файл подключения, созданный на предыдущем шаге, и функцию ArcPy Describe, чтобы определить, можно ли обновить базу геоданных, как показано ниже.

    # Open Python.
cd /arcgis/server/tools
./python

# Create a connection to the geodatabase.
arcpy.CreateDatabaseConnection_management("/tmp/",
                                          "egdb_connection.sde",
                                          "POSTGRESQL",
                                          "mypgdbcluster",
                                          "DATABASE_AUTH",
                                          "sde",
                                          "mysdepassword",
                                          "SAVE_USERNAME",
                                          "mypgdb")

# Import ArcPy and check the geodatabase release.
import arcpy

isCurrent = arcpy.Describe('/tmp/egdb_connection.sde').currentRelease

print isCurrent

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

  4. Создайте резервную копию базы данных.
  5. Удалите все пользовательские функции, которые вы добавили в системные таблицы базы геоданных за пределами ArcGIS, такие как триггеры или дополнительные индексы.

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

  6. Администратор базы данных должен предоставить пользователю sde права доступа, необходимые для обновления базы геоданных.

    Необходимые права см. в разделе Права доступа к базам геоданных в PostgreSQL.

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

    Чтобы увидеть список пользователей, подключенных к базе геоданных, откройте диалоговое окно Администрирование базы геоданных в ArcGIS Pro.

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

    Если вы не уверены, использует ли база геоданных тип ST_Geometry, подключитесь к базе данных из клиента SQL как пользователь sde или суперпользователь и проверьте наличие функций ST_Geometry в схеме пользователя sde.

  9. Загрузите файл st_geometry с My Esri и поместите его в директорию %PostgreSQL%\lib (Microsoft Windows) или директорию PostgreSQL lib (Linux) на сервере PostgreSQL.

    Можно задать точное местоположение папки lib вашей установки PostgreSQL на Linux, запустив утилиту pg_config от имени пользователя postgres. Местоположение lib обозначается параметром PGPKGLIBDIR.

    Используйте библиотеку, которая соответствует версии PostgreSQL и операционной системе сервера. Папки обозначены версиями библиотек PostgreSQL.

    • Если сервер PostgreSQL работает на Linux, войдите на сервер как пользователь root и используйте FTP для передачи файла st_geometry.so в директорию PostgreSQL lib.
    • Если сервер PostgreSQL работает на Windows, скопируйте файл st_geometry.dll в папку lib директории установки PostgreSQL.

Теперь вы можете обновить базу геоданных.

Обновление базы геоданных

Для обновления вашей базы геоданных можно использовать инструмент Обновить базу геоданных в ArcGIS Pro или скрипт Python на компьютере, где установлен ArcGIS Pro или ArcGIS Server.

Примечание:

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

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

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

  • Группа инструментов Администрирование базы геоданных в наборе Управление данными
  • Кнопка Запуск обновления на вкладке Общие в диалоговом окне Свойства базы данных в ArcGIS Pro

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

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

Проверка предварительных условий определяет наличие других активных подключений к базе геоданных, имеет ли подключенный пользователь права, достаточные для обновления базы геоданных, и может ли база данных поддерживать работу с XML-столбцами. Такая проверка также позволяет убедиться, что все наборы данных могут быть открыты и что используемые база данных и библиотеки одинаковой версии. Если какое-либо из предварительных условий не выполнено, работа инструмента завершается. Перед повторным запуском процедуры обновления вы должны исправить все проблемы.

Результаты этой проверки отображаются в диалоговом окне инструмента геообработки. Если проверка не удалась, результаты также записываются в файл GDBUpgrade.log в папке c:\Users\<user name>\AppData\Local\ESRI\<ArcGIS product>.

Если все этапы проверки проходят успешно, инструмент запустит процесс обновления. Статус проверки предварительных условий и обновления отображается в диалоговом окне инструмента геообработки. Если обновление заканчивается сбоем, информация об этом записывается в файл GDBUpgrade.log. Дополнительная информация записывается в файл sde_setup.log, который находится в пользовательской директории TEMP. Если у пользователя не настроена временная директория, используется системная директория TEMP.

Запуск скрипта

Для обновления базы геоданных используя скрипт Python, скопируйте один из этих примеров скриптов в текстовой редактор. Измените значения переменных, чтобы они соответствовали информации на вашем сайте.

  • Если у вас есть файл существующего подключения к базе данных, который подключается как пользователь sde, скопируйте скрипт, применимый к вашей операционной системе, вставьте его в текстовый редактор, измените его, чтобы использовать информацию, специфичную для вашего сайта, сохраните и закройте файл и запустите скрипт:
    # Name: upgradesdegdb_example.py
# Description: Connect from a Windows computer 
# with an existing database connection file 
# and upgrade an enterprise geodatabase in PostgreSQL

# Import arcpy module
import arcpy
 
# Local variables:
Output_Workspace = "C:\\ArcGIS\connection_files\<Connection file>"
Default_gdb = "C:\\ArcGIS\connection_files\<Connection file>"

# Process: Upgrade Geodatabase
arcpy.UpgradeGDB_management(Default_gdb, "PREREQUISITE_CHECK", "UPGRADE")
    # Name: upgradesdegdb_example.py
# Description: Connect from a Linux computer 
# with an existing database connection file 
# and upgrade an enterprise geodatabase in PostgreSQL

# Import arcpy module
import arcpy
 
# Local variables:
Output_Workspace = "<user>/connections/<Connection_file>"
Default_gdb = "<user>/connections/<Connection_file>"

# Process: Upgrade Geodatabase
arcpy.UpgradeGDB_management(Default_gdb, "PREREQUISITE_CHECK", "UPGRADE")
  • Если у вас нет файла подключения к базе данных на компьютере, на котором создается скрипт обновления, то вы можете скопировать следующий скрипт и предоставить специфичную для вашего сайта информацию в командной строке:
    """
Name: upgrade_gdb.py
Description: Provide connection information to an Enterprise geodatabase 
and upgrade the geodatabase
Type upgrade_gdb.py -h or upgrade_gdb.py --help for usage
"""

# Import system modules
import arcpy
import os
import optparse
import sys


# Define usage and version
parser = optparse.OptionParser(usage = "usage: %prog [Options]", version="%prog 2.0; valid for 10.1 only")

#Define help and options
parser.add_option ("--DBMS", dest="Database_type", type="choice", choices=['SQLSERVER', 'ORACLE', 'POSTGRESQL', 'DB2','INFORMIX','DB2ZOS',''], default="", help="Type of enterprise DBMS:  SQLSERVER, ORACLE, or POSTGRESQL.")
parser.add_option ("-i", dest="Instance", type="string", default="", help="DBMS instance name")
parser.add_option ("--auth", dest="account_authentication", type ="choice", choices=['DATABASE_AUTH', 'OPERATING_SYSTEM_AUTH'], default='DATABASE_AUTH', help="Authentication type options (case-sensitive):  DATABASE_AUTH, OPERATING_SYSTEM_AUTH.  Default=DATABASE_AUTH")
parser.add_option ("-u", dest="User", type="string", default="", help="Geodatabase administrator user name")
parser.add_option ("-p", dest="Password", type="string", default="", help="Geodatabase administrator password")
parser.add_option ("--upgrade", dest="Upgrade", type="choice", choices=['TRUE', 'FALSE'], default="FALSE", help="Upgrade Options (case-sensitive):  TRUE=Perform Pre-requisite check and upgrade geodatabase, FALSE=Perform Pre-requisite check only.  Default=FALSE")                   
parser.add_option ("-D", dest="Database", type="string", default="none", help="Database name:  Not required for Oracle")


# Check if value entered for option
try:
	(options, args) = parser.parse_args()

	
#Check if no system arguments (options) entered
	if len(sys.argv) == 1:
		print("%s: error: %s\n" % (sys.argv[0], "No command options given"))
		parser.print_help()
		sys.exit(3)

	#Usage parameters for spatial database connection to upgrade
	account_authentication = options.account_authentication.upper()
	username = options.User.lower() 
	password = options.Password	
	do_upgrade = options.Upgrade
	database = options.Database.lower()
	database_type = options.Database_type.upper()
	instance = options.Instance
	
	if (database_type == ""):
		print("\nDatabase type must be specified!\n")
		parser.print_help()
		sys.exit(3)
	
	if (database_type == "SQLSERVER"):
		database_type = "SQL_SERVER"
	
	# Get the current product license
	product_license=arcpy.ProductInfo()
	
	# Checks required license level to upgrade
	if product_license.upper() == "ARCVIEW" or product_license.upper() == 'ENGINE':
		print("\n" + product_license + " license found!" + "  Enterprise geodatabase upgrade requires an ArcGIS Desktop Standard or Advanced, ArcGIS Engine with the Geodatabase Update extension, or ArcGIS Server license.")
		sys.exit("Re-authorize ArcGIS before upgrading.")
	else:
		print("\n" + product_license + " license available!  Continuing to upgrade...")
		arcpy.AddMessage("+++++++++")
	
	# Local variables
	instance_temp = instance.replace("\\","_")
	instance_temp = instance_temp.replace("/","_")
	instance_temp = instance_temp.replace(":","_")
	Conn_File_NameT = instance_temp + "_" + database + "_" + username     
	
	if os.environ.get("TEMP") == None:
		temp = "c:\\temp"	
	else:
		temp = os.environ.get("TEMP")
	
	if os.environ.get("TMP") == None:
		temp = "/usr/tmp"		
	else:
		temp = os.environ.get("TMP")  
	
	Connection_File_Name = Conn_File_NameT + ".sde"
	Connection_File_Name_full_path = temp + os.sep + Conn_File_NameT + ".sde"
	
	# Check for the .sde file and delete it if present
	arcpy.env.overwriteOutput=True
	if os.path.exists(Connection_File_Name_full_path):
		os.remove(Connection_File_Name_full_path)
	
	print("\nCreating Database Connection File...\n")
	# Process: Create Database Connection File...
	# Usage:  out_file_location, out_file_name, DBMS_TYPE, instnace, database, account_authentication, username, password, save_username_password(must be true)
	arcpy.CreateDatabaseConnection_management(out_folder_path=temp, out_name=Connection_File_Name, database_platform=database_type, instance=instance, database=database, account_authentication=account_authentication, username=username, password=password, save_user_pass="TRUE")
        for i in range(arcpy.GetMessageCount()):
		if "000565" in arcpy.GetMessage(i):   #Check if database connection was successful
			arcpy.AddReturnMessage(i)
			arcpy.AddMessage("\n+++++++++")
			arcpy.AddMessage("Exiting!!")
			arcpy.AddMessage("+++++++++\n")
			sys.exit(3)            
		else:
			arcpy.AddReturnMessage(i)
			arcpy.AddMessage("+++++++++\n")
			
	# Check whether geodatabase needs upgrade
	isCurrent = arcpy.Describe(Connection_File_Name_full_path).currentRelease
	
	if isCurrent == True:
		print("The geodatabase is already at the current release and cannot be upgraded!")
		sys.exit("Upgrade did not run.")
	
	
	# Process: Upgrade geodatabase...
	try:
		if do_upgrade.lower() == "true":
			print("Upgrading Geodatabase...\n")
			arcpy.UpgradeGDB_management(input_workspace=Connection_File_Name_full_path, input_prerequisite_check="PREREQUISITE_CHECK", input_upgradegdb_check="UPGRADE")
			for i in range(arcpy.GetMessageCount()):
				arcpy.AddReturnMessage(i)
			arcpy.AddMessage("+++++++++\n")
	
		else:
			print("Running Pre-Requisite Check...\n")
			arcpy.UpgradeGDB_management(input_workspace=Connection_File_Name_full_path, input_prerequisite_check="PREREQUISITE_CHECK", input_upgradegdb_check="NO_UPGRADE")
			for i in range(arcpy.GetMessageCount()):
				arcpy.AddReturnMessage(i)
			arcpy.AddMessage("+++++++++\n")
		
	        
	except:
		for i in range(arcpy.GetMessageCount()):
			arcpy.AddReturnMessage(i)
		
	if os.path.exists(Connection_File_Name_full_path):
		os.remove(Connection_File_Name_full_path)
	
#Check if no value entered for option	
except SystemExit as e:
	if e.code == 2:
		parser.usage = ""
		print("\n")
		parser.print_help()
		parser.exit(2)
    Например, если вы сохранили текстовый файл как gdbupgrade, кластер базы данных - mypgdbcluster, а база данных - mypgdb, введите в командной строке следующее:

    gdbupgrade --DBMS POSTGRESQL -i mypgdbcluster --auth DATABASE_AUTH -u sde -p mysdepassword --upgrade TRUE -D mypgdb

Отзыв по этому разделу?

В этом разделе
  1. До начала обновления
  2. Обновление базы геоданных