升级 Oracle 中的地理数据库

在 Standard 或 Advanced 许可等级下可用。

升级企业级地理数据库的目的是更新地理数据库系统表、存储过程、类型和函数以利用新功能并修复缺陷。

安装新版本的 ArcGIS 客户端或应用现有安装的补丁包、修补程序或热修复程序，然后升级地理数据库。

完成升级前所需的步骤，然后使用升级地理数据库地理处理工具或 Python 脚本升级地理数据库。

在升级之前

在升级包括地理数据库在内的任何企业系统时，必须事前进行规划。在开发服务器或测试服务器上对新版本进行测试，以确保其适用于所有的客户端应用程序。

在确定了新系统会按预期进行工作后，请计划升级；确保必要的工作人员均可执行升级并且他们拥有完成指派的任务所必需的权限。

注意如下事项：

• 如果您要从 10.2.x 升级，需要确保对地图或服务中使用的所有 ArcSDE 应用程序服务器连接进行迁移以便直接连接至地理数据库。
• 升级任何用户方案地理数据库之前，必须先升级主 sde 地理数据库。
• 不支持对软件的测试版本进行升级。
• 如果您的数据库是支持的版本，则可从 10.2.x、10.3.x、10.4.x、10.5.x 或 10.6.x 版本的地理数据库直接升级。
• 如果您的地理数据库为 10 版或更早的版本，则必须先升级到支持的地理数据库版本，然后再升级到当前的 ArcGIS 版本。
• 如果地理数据库已经升级到当前版本，则 ArcGIS 10 和较早版本的客户端将无法连接至该数据库。
• 不提供将地理数据库降级到先前版本的正式机制。如果升级到较新版本后想要降级该地理数据库，则必须从备份文件中恢复旧数据库。
• ST_Raster 格式不再受支持。您必须在升级之前将现有 ST_Raster 数据转换为其他格式。
• 如果您的地理数据库位于 Oracle 11.x 或 12.1.0.1 中，且您希望使用分支版本化，则必须在升级地理数据库之前改用支持分支版本化的 Oracle 版本。这将在地理数据库中创建分支版本化系统表。

以下为升级地理数据库之前应完成的步骤一览表：

1. 请阅读 ArcGIS 的 Oracle 数据库要求以确认 Esri 支持要使用的 Oracle 和 ArcGIS 版本组合。
2. 执行检查以查看地理数据库是否可以升级。要执行此操作，需将要移动到的 ArcGIS 客户端版本安装到计算机上。如果安装 ArcGIS Desktop，可连接至地理数据库并打开数据库属性对话框以查看该数据库是否可以升级。如果安装 ArcGIS Server（企业版）或 ArcGIS Engine Geodatabase Update 扩展模块，可使用 ArcPy Describe 函数来确定该地理数据库是否可以升级。

   # Open Python.
   cd /arcgis/server/tools
   ./python
   # Create a connection to the geodatabase.
   arcpy.CreateDatabaseConnection_management("/tmp/",
                                             "egdb_connection.sde",
                                             "ORACLE",
                                             "myogdb",
                                             "DATABASE_AUTH",
                                             "sde",
                                             "mysdepassword",
                                             "SAVE_USERNAME")
   # Import ArcPy and check the geodatabase release.
   import arcpy
   isCurrent = arcpy.Describe('/tmp/egdb_connection.sde').currentRelease
   print isCurrent
   

   如果返回 false，则可升级地理数据库。如果返回 true，则无需升级地理数据库。请勿继续执行后续步骤。

3. 确保已安装 Oracle Text 组件。

   在 Oracle 中会默认安装 Text 组件；然而，如果您没有选择默认安装，则有可能未安装 Text 组件。

   要查看是否已安装该组件，请在作为 SYSTEM 或拥有 DBA 权限的用户登录到数据库时执行以下 SQL 语句：

   SELECT owner, object_name FROM all_objects WHERE object_type = 'PACKAGE'
     AND object_name = 'CTX_DDL';
   

   如果没有返回记录，则 Text 组件没有安装。请运行 Oracle 安装程序以安装 Text 组件。

4. 将现有地图或服务中使用的所有应用程序服务器连接转换为直连。
5. 创建数据库的备份。
6. 移除任何您可能已添加到 ArcGIS 外部的地理数据库系统表中的自定义功能，例如触发器或其他索引。

   升级程序无法将对系统表的自定义修改纳入考虑。如果类似的自定义修改禁止更改系统表方案，升级将会失败。

7. 向地理数据库管理员授予升级地理数据库所需的权限。

   有关所需权限的列表，请参阅 Oracle 地理数据库的权限。

8. 如果直接从 SQL 访问数据，则将 Oracle 服务器上的现有 st_shapelib 替换为新版本的库。您可以复制 10.6.1 ArcMap 或 ArcGIS Server 安装的 DatabaseSupport 文件夹中的新 st_shapelib 文件。

   确保使用适合 Oracle 服务器操作系统的库。

   如果将该库放置到 Oracle 服务器上与以前不同的目录中，则必须将 extproc 重新配置为指向新库位置，然后重新启动 Oracle 监听器。有关详细信息，请参阅配置 Oracle extproc 以使用 SQL 访问地理数据库。

9. 确保没有任何用户连接到正在升级的地理数据库。如果您正在升级 sde 主地理数据库，也请确保没有任何用户连接到 Oracle 数据库中的任何用户方案地理数据库。

   要查看当前连接到地理数据库的用户列表，可以转到 ArcGIS Desktop 客户端的地理数据库管理对话框。

此时，您可以升级地理数据库。

升级地理数据库

可以使用 ArcMap 或 ArcGIS Pro 中的升级地理数据库工具或使用在 ArcGIS 客户端计算机上运行的 Python 脚本升级地理数据库。

注：

连接到地理数据库以对其进行升级时，必须使用当前的连接语法。如果使用较旧的连接语法，则升级过程将失败。有关连接语法的信息，请参阅从 ArcGIS 连接到 Oracle。

使用升级地理数据库工具

可通过以下任一方式打开升级地理数据库地理处理工具：

• 数据管理工具箱中的地理数据库管理工具集
• ArcMap 或 ArcCatalog 中数据库属性对话框常规选项卡上的升级地理数据库按钮。
• ArcGIS Pro 中数据库属性对话框内常规选项卡上的运行升级按钮

如果打开了数据库属性中的工具，则将使用地理数据库连接信息预填充输入地理数据库文本框。

Esri 建议选中先行检查和升级地理数据库选项。这样，该工具将在继续升级地理数据库之前检查是否已满足升级的先决条件。

先行检查将检测到地理数据库的其他活动连接、确定连接用户是否具有升级地理数据库所需的足够权限、确保数据库可支持 XML 列、确保所有数据集均可打开，以及保证数据库与库的版本相同。如果未满足任意先决条件，则工具将终止。重新运行升级程序之前，必须修正所有问题。

此检查的结果在地理处理工具对话框中报告。如果检查（或升级）失败，其结果还将写入 c:\Users\<user name>\AppData\Local\ESRI\<ArcGIS product> 文件夹的 GDBUpgrade.log 文件中。

如果通过了所有检查，该工具将继续进行升级。先行检查和升级的状态将在地理处理工具进度对话框中显示。如果升级失败，则信息将写入 GDBUpgrade.log 文件。其他信息将写入系统 TEMP 目录的 sde_setup.log 文件中。

运行脚本

要想升级地理数据库，请将这些示例脚本中的一个脚本复制到文本编辑器中。更改任何变量值来与您的站点信息相匹配。

• 如果具有使用直连并作为 sde 用户身份进行连接的现有数据库连接文件，则应复制适用于您的操作系统的脚本，将其粘贴到文本编辑器中，并根据站点的具体信息来更改脚本，保存并关闭该文件，然后再运行：

  # Name: upgradesdegdb_example.py
  # Description: Connect from a Windows computer 
  # with an existing database connection file 
  # and upgrade an enterprise geodatabase
  # 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 or UNIX computer 
  # with an existing database connection file 
  # and upgrade an enterprise geodatabase
  # 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，数据库为 myogdb，且正在升级 sde 主地理数据库，则应在命令提示符处输入以下内容：

  gdbupgrade --DBMS ORACLE -i myogdb --auth DATABASE_AUTH -u sde -p mysdepassword --upgrade TRUE

Oracle 版本和分支版本

只有在 ArcGIS 支持分支版本的 Oracle 版本中创建或升级地理数据库时，才可创建分支版本系统表。也就是说，如果地理数据库所在的 Oracle 版本不支持分支版本化，则不能使用分支版本化。

即使您的地理数据库版本支持分支版本化，但是由于地理数据库位于 Oracle 11.x 或 12.1.0.1 数据库中（例如您在 Oracle 11.x 中具有 10.6.1.2.2 地理数据库），所以升级 Oracle 或将地理数据库还原到受支持的 Oracle 版本也不会实现分支版本化。在转至支持的新 Oracle 版本之后，必须升级地理数据库。