返回顶部

创建数据库连接字符串 (数据管理)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

创建连接字符串，以供地理处理工具连接到数据库或企业级地理数据库。

使用情况

  • 当您具有使用数据库或企业级地理数据库数据集的自动地理处理工作流（脚本或模型）时，请使用此工具而不是连接文件。 可生成可用作支持指定数据集类型的所有地理处理工具输入的连接字符串，而不是通过连接文件工作空间使用数据库的路径。

  • 不再支持从 ArcGIS 连接到 Altibase 和 Netezza。

参数

对话框Python

标注说明数据类型
数据库平台

指定要建立连接的数据库平台。

  • SQL Server—连接至 Microsoft SQL Server 或 Microsoft Azure SQL Database。
  • Oracle—连接到 Oracle。
  • DB2—连接至 Linux、UNIX 或 Windows 上的 IBM DB2。
  • PostgreSQL—连接至 PostgreSQL。
  • Teradata—连接至 Teradata Data Warehouse Appliance。
  • SAP HANA—连接至 SAP HANA。
  • DAMENG—连接至 Dameng。
String
实例

要连接的数据库服务器或实例。

此参数值取决于选择的数据库平台参数值。

String
数据库身份验证
(可选)

指定要使用的身份验证类型。

  • 数据库身份验证—将使用数据库身份验证。 使用内部数据库用户名和密码连接到数据库。 创建连接无需输入用户名和密码；但是，如果不输入用户名和密码，系统将在连接建立好之后提示您输入用户名和密码。 这是默认设置。
    注：

    如果 ArcGIS 服务可通过您所创建的连接文件来对数据库或地理数据库进行访问，或者您想使用目录搜索来查找通过此连接文件访问的数据，您都必须键入用户名和密码。

  • 操作系统身份验证—将使用操作系统身份验证。 不必输入用户名和密码。 将用登录操作系统时所使用的用户名和密码建立连接。 如果操作系统使用的登录信息不能用作地理数据库的登录信息，连接将失败。
Boolean
用户名
(可选)

采用数据库身份验证时将使用的数据库用户名。

String
密码
(可选)

采用数据库身份验证时将使用的数据库用户密码。

Encrypted String
数据库
(可选)

将连接的数据库的名称。 此参数仅适用于 PostgreSQL 和 SQL Server 平台。

String
数据集对象名称
(可选)

数据库中连接字符串指向的数据集或对象名称。 此连接字符串可用作指定数据集的路径。

String
数据类型
(可选)

数据集对象名称中引用的数据集或对象的类型。 如果数据库中存在多个同名对象，则可能需要指定要为其创建连接字符串的对象的数据类型。

String
目标要素数据集
(可选)

包含要为其创建连接字符串的数据集或对象的要素数据集名称。 如果数据集不在要素数据集中（例如，如果它位于数据库的根目录下），请不要指定目标要素数据集。

String
方案（仅 Oracle 用户方案地理数据库）
(可选)

将连接到的用户方案地理数据库。 工具将决定是否连接到包含用户方案地理数据库的 Oracle 数据库。 如果 Oracle 数据库包含用户方案，此选项将激活；否则，将保持非活动状态。 此参数的默认选项为使用 SDE 方案（主）地理数据库。

String
版本类型
(可选)

指定将连接的版本类型。 此参数仅在连接到地理数据库时适用。

注：

如果选择历史并提供了名称，将使用默认的事务版本。 如果选择时间点并且未在日期和时间参数中提供日期，将使用默认的事务版本。

  • 事务—连接到事务版本。 如果选择事务，则将使用事务版本列表填充将使用以下版本参数，而日期和时间参数将处于非活动状态。 这是默认设置。
  • 历史—连接到历史标记。 如果选择历史，则将使用历史标记列表填充将使用以下版本参数，而日期和时间参数将处于非活动状态。
  • 时间点—连接到特定时间点。 如果选择时间点，则将使用以下版本参数将禁用，而日期和时间参数将变为活动状态。
  • 分支—连接到默认分支版本。
String
将使用以下版本
(可选)

要连接到的地理数据库事务版本或历史标记。 默认选项将使用默认事务版本。

如果选择分支版本类型，则会始终连接到默认分支版本。

String
日期和时间
(可选)

此值表示将用于连接到数据库的日期和时间。 此选项用于启用存档的数据。 利用时间选取器选择相应的日期。

如果手动输入日期，可以使用以下格式：

  • 6/9/2011 4:20:15 PM
  • 6/9/2011 16:20:15
  • 6/9/2011
  • 4:20:15 PM
  • 16:20:15

注：

  • 如果所输入的时间无日期，则将使用默认日期 1899 年 12 月 30 日。
  • 如果所输入的日期无时间，则将使用默认时间 12:00:00 AM。

Date

派生输出

标注说明数据类型
CIMDATA 连接字符串

CIMDATA 连接字符串。

String

arcpy.management.CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})
名称说明数据类型
database_platform

指定要建立连接的数据库平台。

  • SQL_SERVER—连接至 Microsoft SQL Server 或 Microsoft Azure SQL Database。
  • ORACLE—连接到 Oracle。
  • DB2—连接至 Linux、UNIX 或 Windows 上的 IBM DB2。
  • POSTGRESQL—连接至 PostgreSQL。
  • TERADATA—连接至 Teradata Data Warehouse Appliance。
  • SAP HANA—连接至 SAP HANA。
  • DAMENG—连接至 Dameng。
String
instance

要连接的数据库服务器或实例。

此参数值取决于选择的数据库平台参数值。

String
account_authentication
(可选)

指定要使用的身份验证类型。

  • DATABASE_AUTH—将使用数据库身份验证。 使用内部数据库用户名和密码连接到数据库。 创建连接无需输入用户名和密码；但是，如果不输入用户名和密码，系统将在连接建立好之后提示您输入用户名和密码。 这是默认设置。
    注：

    如果 ArcGIS 服务可通过您所创建的连接文件来对数据库或地理数据库进行访问，或者您想使用目录搜索来查找通过此连接文件访问的数据，您都必须键入用户名和密码。

  • OPERATING_SYSTEM_AUTH—将使用操作系统身份验证。 不必输入用户名和密码。 将用登录操作系统时所使用的用户名和密码建立连接。 如果操作系统使用的登录信息不能用作地理数据库的登录信息，连接将失败。
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
(可选)

指定将连接的版本类型。 此参数仅在连接到地理数据库时适用。

  • TRANSACTIONAL—连接到事务版本。 如果选择事务，则将使用事务版本列表填充将使用以下版本参数，而日期和时间参数将处于非活动状态。 这是默认设置。
  • HISTORICAL—连接到历史标记。 如果选择历史，则将使用历史标记列表填充将使用以下版本参数，而日期和时间参数将处于非活动状态。
  • POINT_IN_TIME—连接到特定时间点。 如果选择时间点，则将使用以下版本参数将禁用，而日期和时间参数将变为活动状态。
  • BRANCH—连接到默认分支版本。

注：

如果选择历史并提供了名称，将使用默认的事务版本。 如果选择时间点并且未在日期和时间参数中提供日期，将使用默认的事务版本。

String
version
(可选)

要连接到的地理数据库事务版本或历史标记。 默认选项将使用默认事务版本。

如果选择分支版本类型，则会始终连接到默认分支版本。

String
date
(可选)

此值表示在使用启用了存档功能的数据时，将用于连接到数据库的日期和时间。

可按以下格式输入日期：

  • 6/9/2011 4:20:15 PM
  • 6/9/2011 16:20:15
  • 6/9/2011
  • 4:20:15 PM
  • 16:20:15

注：

  • 如果所输入的时间无日期，则将使用默认日期 1899 年 12 月 30 日。
  • 如果所输入的日期无时间，则将使用默认时间 12:00:00 AM。

Date

派生输出

名称说明数据类型
out_connection_string

CIMDATA 连接字符串。

String

代码示例

CreateDatabaseConnectionString 示例（Python 窗口）

以下 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: 是

相关主题

  • 工作空间工具集概述
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息