描述
创建连接字符串,以供地理处理工具连接到数据库或企业级地理数据库。
使用方法
当您具有使用数据库或企业级地理数据库数据集的自动地理处理工作流(脚本或模型)时,请使用此工具而不是连接文件。可生成可用作支持指定数据集类型的所有地理处理工具输入的连接字符串,而不是通过连接文件工作空间使用数据库的路径。
不再支持从 ArcGIS 连接到 Altibase 和 Netezza。
语法
arcpy.management.CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})
参数 | 说明 | 数据类型 |
database_platform | 指定要建立连接的数据库平台。
| String |
instance | 要连接的数据库服务器或实例。 此参数值取决于选择的数据库平台参数值。 | String |
account_authentication (可选) | 指定要使用的身份验证类型。
| Boolean |
username (可选) | 采用数据库身份验证时将使用的数据库用户名。 | String |
password (可选) | 采用数据库身份验证时将使用的数据库用户密码。 | Encrypted String |
database (可选) | 将连接的数据库的名称。此参数仅适用于 PostgreSQL 和 SQL Server 平台。 | String |
object_name (可选) | 数据库中连接字符串指向的数据集或对象名称。此连接字符串可用作指定数据集的路径。 | String |
data_type (可选) | 数据集对象名称中引用的数据集或对象的类型。如果数据库中存在多个同名对象,则可能需要指定要为其创建连接字符串的对象的数据类型。 | String |
feature_dataset (可选) | 包含要为其创建连接字符串的数据集或对象的要素数据集名称。如果数据集不在要素数据集中(例如,如果它位于数据库的根目录下),请不要指定目标要素数据集。 | String |
schema (可选) | 将连接到的用户方案地理数据库。此选项仅适用于至少包含一个用户方案地理数据库的 Oracle 数据库。此参数的默认值为使用 SDE 方案(主)地理数据库。 | String |
version_type (可选) | 指定将连接的版本类型。此参数仅在连接到地理数据库时适用。
注:如果选择历史并提供了名称,将使用默认的事务版本。如果选择时间点并且未在日期和时间参数中提供日期,将使用默认的事务版本。 | String |
version (可选) | 要连接到的地理数据库事务版本或历史标记。默认选项将使用默认事务版本。 如果选择分支版本类型,则会始终连接到默认分支版本。 | String |
date (可选) | 此值表示在使用启用了存档功能的数据时,将用于连接到数据库的日期和时间。 可按以下格式输入日期:
注:
| Date |
派生输出
名称 | 说明 | 数据类型 |
out_connection_string | CIMDATA 连接字符串。 | 字符串 |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 CreateDatabaseConnectionString 函数。
import arcpy
data_conn_str = arcpy.CreateDatabaseConnectionString_management("SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"",
"gdb.roads")
arcpy.Buffer_analysis(data_conn_str, r"c:\temp\Buffers.shp", "10 Miles")
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是