| 标注 | 说明 | 数据类型 |
输入地理数据库 | 将升级的地理数据库。 当升级企业级地理数据库时，指定以地理数据库管理员身份连接到地理数据库的数据库连接文件 (.sde)。 | Workspace |
执行必要的先行检查 | 指定是否会在升级地理数据库之前执行先决条件检查。
| Boolean |
升级地理数据库 | 指定是否会对输入地理数据库进行升级以与正在运行该工具的 ArcGIS 客户端版本相匹配。
| Boolean |
派生输出
| 标注 | 说明 | 数据类型 |
| 更新的输入地理数据库 | 升级的地理数据库。 | Workspace |
摘要
将地理数据库升级至最新的 ArcGIS 版本以使用新功能。
使用情况
工具接受文件地理数据库或企业级地理数据库连接文件作为输入。
您不能从具有基本许可的 ArcGIS AllSource 升级企业级地理数据库。
在升级企业级地理数据库之前，您必须对正在使用的数据库管理系统执行所需的准备步骤，包括创建数据库的备份。 对于 Oracle 以及使用 ST_Geometry 类型的 PostgreSQL 中的地理数据库，您必须从 My Esri 下载 DatabaseSupport 文件夹以获取新的 ST_Geometry 库。 有关其他准备步骤，请参阅以下主题：
您必须选中执行必要的先行检查参数或升级地理数据库参数，或者同时选中这两个参数。 必须至少先选中其中一个参数，您才可以运行该工具。
在升级地理数据库之前，请使用先决条件检查来确定其是否已准备好进行升级。 如果不满足任何先决条件，则会在地理处理历史记录中记录一条错误。 这可以使您不会在升级过程中仅因为某个先决条件未得到满足而使其失败。 如果任意检查失败，您必须纠正问题并重新启动升级流程。
不支持从地理数据库的测试版本进行升级。
执行必要的先行检查参数针对每个类型的地理数据库执行不同检查。
- 对于文件地理数据库，确定以下情况：
- 地理数据库是否为只读。
- 是否有其他用户连接到此地理数据库。
- 当前连接是否未在地理数据库中编辑数据。
- 当前地理数据库系统表中的所有信息是否可以打开。
- 对于企业级地理数据库，确定是否满足以下条件：
- 连接的用户具有升级地理数据库所需的适当权限。
- 连接的用户现在没有对数据库中的数据进行编辑。
- 无其他用户连接到数据库。
- 数据库已启用支持 XML 数据类型。
- 当前地理数据库系统表中的所有信息是否可以打开。
- 对于 Oracle 中的地理数据库以及使用 ST_Geometry 类型的 PostgreSQL 中的地理数据库，它会检测数据库是否可以访问 ST_Geometry 库的当前版本。
- 对于文件地理数据库，确定以下情况：
对于包含分支版本数据的企业级地理数据库，升级过程会分析分支版本和分支版本数据是否存在不一致，并将分析结果写入日志文件。 有关详细信息，请参阅升级地理数据库工作原理。
用于运行升级的 ArcGIS AllSource 或 ArcGIS Server 的版本将决定升级后的地理数据库的版本。
提示：
有关从 ArcGIS Server 计算机运行 Python 的信息，请参阅 ArcGIS Server 和 ArcPy。
参数
arcpy.management.UpgradeGDB(input_workspace, input_prerequisite_check, input_upgradegdb_check)
| 名称 | 说明 | 数据类型 |
input_workspace | 将升级的地理数据库。 当升级企业级地理数据库时，指定以地理数据库管理员身份连接到地理数据库的数据库连接文件 (.sde)。 | Workspace |
input_prerequisite_check | 指定是否会在升级地理数据库之前执行先决条件检查。
| Boolean |
input_upgradegdb_check | 指定是否会升级输入地理数据库。
| Boolean |
派生输出
| 名称 | 说明 | 数据类型 |
| out_workspace | 升级的地理数据库。 | Workspace |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 UpgradeGDB 函数升级文件地理数据库：
import arcpy
default_gdb = "C:/temp/Default.gdb"
arcpy.management.UpgradeGDB(default_gdb, "PREREQUISITE_CHECK", "UPGRADE")以下独立 Python 脚本演示了如何在 Python 脚本中使用 UpgradeGDB 函数升级文件地理数据库：
# Description: Upgrade a file geodatabase
# Import arcpy module
import arcpy
# Local variables:
default_gdb = "C:/temp/Default.gdb"
# Process: Upgrade Geodatabase
arcpy.management.UpgradeGDB(default_gdb, "PREREQUISITE_CHECK", "UPGRADE")以下独立 Python 脚本演示了如何在 Python 脚本中通过现有 .sde 连接文件使用 UpgradeGDB 函数升级企业级地理数据库：
# Description: Upgrade a geodatabase
# Import arcpy module
import arcpy
# Local variable:
default_gdb = "C:\\connections\gdbconnection.sde"
# Process: Upgrade Geodatabase
arcpy.management.UpgradeGDB(default_gdb, "PREREQUISITE_CHECK", "UPGRADE")以下独立 Python 脚本演示了如何在 Linux 计算机上的 Python 脚本中通过现有 .sde 连接文件使用 UpgradeGDB 函数升级企业级地理数据库：
# Description: Upgrade a geodatabase
# Import arcpy module
import arcpy
# Local variable:
default_gdb = "<user>/connections/<Connection_file>"
# Process: Upgrade Geodatabase
arcpy.management.UpgradeGDB(default_gdb, "PREREQUISITE_CHECK", "UPGRADE")