描述
创建一个 ArcGIS 用来连接到数据库或企业级地理数据库、工作组级地理数据库或桌面地理数据库的文件。
使用方法
在工具对话框中输入有效的连接信息并建立连接后，该工具将连接到数据库，以确定其是否包含地理数据库方案。
- 对于数据库，工具对话框地理数据库连接属性部分中的所有参数均将被忽略。
- 对于地理数据库，该工具会自动填充地理数据库连接属性部分。 方案参数设置有 sde 方案（仅适用于 Oracle 用户方案地理数据库）、地理数据库的默认版本类型和默认版本。
如果不希望将连接信息保存在结果窗口中或存储在地理处理历史日志文件中，则禁用历史记录，并在保存连接文件时不保存连接信息。
不再支持从 ArcGIS 连接到 Altibase 和 Netezza。
语法
arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})| 参数 | 说明 | 数据类型 |
out_folder_path | 存储数据库连接文件 (.sde) 的文件夹路径。 | Folder |
out_name | 数据库连接文件的名称。 输出文件的扩展名将为 .sde。 | String |
database_platform | 指定要建立连接的数据库管理系统平台。 有效选项如下：
| String |
instance | 要连接的数据库服务器或实例。 所指定的 database_platform 参数值表示要连接的数据库类型。 根据所指定的数据库平台，可为 instance 参数提供不同的信息。 有关为各个数据库平台提供的内容的详细信息，请参阅下文。
| String |
account_authentication （可选） | 指定要使用的身份验证类型。
| Boolean |
username （可选） | 将用于数据库身份验证的数据库用户名。 | String |
password （可选） | 将用于数据库身份验证的数据库用户密码。 | Encrypted String |
save_user_pass （可选） | 指定是否将保存用户名和密码。
| Boolean |
database （可选） | 要建立连接的数据库名称。 此参数仅适用于 PostgreSQL 和 SQL Server 平台。 | String |
schema （可选） | 将与之建立连接的用户方案地理数据库。 此选项仅适用于至少包含一个用户方案地理数据库的 Oracle 数据库。 此参数的默认值为使用 sde 方案地理数据库。 | String |
version_type （可选） | 指定要建立连接的版本类型。
| String |
version （可选） | 要与之建立连接的地理数据库事务版本或历史标记。 默认选项将使用默认事务版本。 | String |
date （可选） | 此值表示在使用启用了存档功能的数据时，将用于连接到数据库的日期和时间。 可按以下格式输入日期：
| Date |
派生输出
| 名称 | 说明 | 数据类型 |
| out_workspace | 输出数据库连接文件 (.sde)。 | workspace |
代码示例
CreateDatabaseConnection 示例 1（Python 窗口）
以下 Python 窗口脚本演示了如何在即时模式下使用 CreateDatabaseConnection 函数。
import arcpy
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"utah.sde",
"SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"SAVE_USERNAME",
"garfield",
"#",
"TRANSACTIONAL",
"sde.DEFAULT")
CreateDatabaseConnection 示例 2（独立脚本）
以下独立脚本演示了如何使用 CreateDatabaseConnection 函数。
# Name: CreateDatabaseConnection2.py
# Description: Connects to a database using Easy Connect string
# and operating system authentication.
# Import system modules
import arcpy
# Run the tool
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"zion.sde",
"ORACLE",
"zionserver/ORCL",
"OPERATING_SYSTEM_AUTH")
CreateDatabaseConnection 示例 3（Python 窗口）
以下 Python 窗口脚本演示了如何使用 CreateDatabaseConnection 函数连接到历史标记。
# Name: CreateDatabaseConnection3.py
# Description: Connects to a geodatabase historical marker using a
# cataloged DB2 database and database authentication.
# Import system modules
import arcpy
# Run the tool
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"history.sde",
"DB2",
"DB2_DS",
"DATABASE_AUTH",
"butch",
"sundance",
"SAVE_USERNAME",
"#",
"#",
"HISTORICAL",
"June 9, 2010",
"#")
CreateDatabaseConnection 示例 4（Python 窗口）
以下 Python 窗口脚本演示了如何使用 CreateDatabaseConnection 函数连接到时间点。
# Name: CreateDatabaseConnection4.py
# Description: Connects to a point in time in the geodatabase in
# PostgreSQL using database authentication.
# Import system modules
import arcpy
# Run the tool
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"history.sde",
"POSTGRESQL",
"dbserver",
"DATABASE_AUTH",
"stevie",
"smith",
"SAVE_USERNAME",
"archivedb",
"#",
"POINT_IN_TIME",
"#",
"5/19/2011 8:43:41 AM")
环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是