ArcMap

Обновить базу геоданных (Upgrade Geodatabase)

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

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

На компьютере, где вы запускаете инструмент или скрипт, должна быть установлена текущая версия ArcGIS Desktop или ArcGIS Server. Для обновления многопользовательской базы геоданных вам необходимо подключиться к ней помощью прямого подключения; вы не сможете подключиться через службу ArcSDE.

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

  • Инструмент Обновить базу геоданных может использовать в качестве входных данных персональную или файловую базы геоданных или подключение .sde.

  • Вы не сможете обновить настольные базы геоданных, базы геоданных рабочей группы и многопользовательские базы геоданных из ArcGIS Desktop Basic.

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

  • Чтобы определить версию базы геоданных, щелкните правой кнопкой мыши на базе геоданных в дереве Каталога и перейдите на вкладку Свойства. В разделе Статус обновления на вкладке Общие будет отображена версия ArcGIS базы геоданных, а также может ли база геоданных быть обновлена до последней версии.
  • Нужно включить по крайней мере один из параметров Выполнить предварительную проверку или Обновить базу геоданных, но вы также можете включить оба параметра. Если вы не выберите хотя бы один параметр, то будет выведена ошибка.
  • Esri рекомендует выполнять предварительную проверку перед обновлением базы геоданных, чтобы вы могли убедиться, что база геоданных готова к обновлению. Если инструмент обнаружит какие-либо проблемы, то инструмент запишет ошибку в файл журнала в окне Результаты, и база геоданных не будет обновлена. Без предварительной проверки запускать инструмент Обновить нецелесообразно. В случае обнаружения несоответствий, следует решить проблему, затем запустить инструмент Обновить еще раз.
  • Обновление с бета-версий баз геоданных не поддерживается.
  • Опция Выполнять предварительную проверку работает по-разному в зависимости от типа обновляемой базы геоданных. При использовании файловой или персональной базы геоданных происходит анализ следующих ситуаций:
    • База геоданных доступна только для чтения.
    • Больше ни один пользователь не подключен к базе геоданных.
    • Текущее подключение не редактирует данные в базе геоданных.
    • Любую информацию из системных таблиц текущей базы геоданных можно открыть.
    • При использовании настольной базы геоданных, базы геоданных рабочих групп и многопользовательских баз геоданных происходит анализ следующих ситуаций:
      • У подключенного пользователя есть соответствующие права на обновление.
      • Подключенный пользователь не редактирует данные в базе геоданных.
      • Ни один пользователь не подключен к базе геоданных.
      • В базе геоданных включена поддержка типов данных XML.
      • Любую информацию из системных таблиц текущей базы геоданных можно открыть.
      • Для баз геоданных в PostgreSQL и Oracle, она определяет, может ли база данных получить доступ к текущей версии библиотеки ST_Geometry.
      • Для баз геоданных в пользовательской схеме в Oracle она выявляет, обновлена ли основная база геоданных.

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

Синтаксис

UpgradeGDB_management (input_workspace, input_prerequisite_check, input_upgradegdb_check)
ПараметрОбъяснениеТип данных
input_workspace

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

Workspace
input_prerequisite_check

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

  • NO_PREREQUISITE_CHECK —Проверка не выполняется.
  • PREREQUISITE_CHECK —Проверка выполняется. Используется по умолчанию.
Boolean
input_upgradegdb_check

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

  • NO_UPGRADE —Обновление не выполняется.
  • UPGRADE —Обновление выполняется. Используется по умолчанию.
Boolean

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

NameОбъяснениеТип данных
out_workspace

Пример кода

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

Пример скрипта Python для выполнения функции UpgradeGDB, с запуском из окна Python в ArcGIS, которая обновляет файловую базу геоданных:

import arcpy
default_gdb = "C:/temp/Default.gdb"
arcpy.UpgradeGDB_management(default_gdb, "PREREQUISITE_CHECK", "UPGRADE")
UpgradeGeodatabase, пример 2 (автономный скрипт для файловой базы геоданных)

Пример скрипта Python для выполнения функции UpgradeGDB, в автономном режиме для файловой базы геоданных:

# Description: upgrade a geodatabase
 
# Import arcpy module
import arcpy
# Local variables:
default_gdb = "C:/temp/Default.gdb"
# Process: Upgrade Geodatabase
arcpy.UpgradeGDB_management(default_gdb, "PREREQUISITE_CHECK", "UPGRADE")
UpgradeGeodatabase, пример 3 (автономный скрипт с использованием файла подключения .sde)

Пример автономного скрипта Python для запуска функции UpgradeGDB для обновления многопользовательской базы геоданных с использованием существующего файла подключения .sde:

# Description: upgrade a geodatabase
# Import arcpy module
import arcpy
# Local variables:
default_gdb = "C:/connections/gdbconnection.sde"
# Process: Upgrade Geodatabase
arcpy.UpgradeGDB_management(default_gdb, "PREREQUISITE_CHECK", "UPGRADE")
UpgradeGeodatabase, пример 4 (автономный скрипт для многопользовательской базы геоданных)

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

"""
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)

Параметры среды

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

  • ArcGIS Desktop Basic: Да
  • ArcGIS Desktop Standard: Да
  • ArcGIS Desktop Advanced: Да

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