创建 ArcSDE 连接文件

摘要

创建数据库连接文件以使用 ArcSDE 服务连接到企业级地理数据库。

用法

• ArcSDE 连接文件名称必须包含 .sde 文件扩展名。

• 输入有效的连接信息后，工具将使用连接用户对其具有访问权限的数据库版本填充版本列表。

• 如果要防止连接信息被保存在结果窗口中或存储在地理处理历史日志文件中，则禁用历史日志，并在保存连接文件时不保存想要隐藏的连接信息。

• 该工具应仅用于创建连接至 10.2.2 或更早版本的地理数据库的应用程序服务器（ArcSDE 服务）连接。如果希望连接至 10.3 或更高版本的地理数据库，或直接连接至 10.2.2 或更早版本的地理数据库，则请改用创建数据库连接工具。

语法

CreateArcSDEConnectionFile_management (out_folder_path, out_name, server, service, {database}, {account_authentication}, {username}, {password}, {save_username_password}, {version}, {save_version_info})

参数	说明	数据类型
out_folder_path	存储 .sde 文件的文件夹路径。	Folder
out_name	连接文件的名称。请使用 .sde 文件扩展名。	String
server	安装 ArcSDE 应用程序服务器的计算机的名称。	String
service	ArcSDE 服务名称或 TCP 端口号。	String
database (可选)	要连接的数据库的名称。连接至 Oracle 时不提供数据库名称。	String
account_authentication (可选)	DATABASE_AUTH —数据库身份验证。使用内部数据库用户名和密码连接到 DBMS。创建连接无需输入用户名和密码；但是，如果不输入用户名和密码，系统将在连接建立好之后提示您输入用户名和密码。 OPERATING_SYSTEM_AUTH —使用“操作系统身份验证”。不必输入用户名和密码。将用登录操作系统时所使用的凭据建立连接。如果操作系统使用的登录信息不能用作地理数据库的登录信息，连接将失败。另请注意，您无法使用操作系统身份验证将 ArcSDE 服务连接至存储在 Oracle、DB2 或 Informix 中的地理数据库。	Boolean
username (可选)	使用“数据库身份验证”连接时所需的数据库用户名。	String
password (可选)	当使用“数据库身份验证”时所需的数据库用户密码。	Encrypted String
save_username_password (可选)	SAVE_USERNAME —在连接文件中保存用户名和密码。 DO_NOT_SAVE_USERNAME —不在连接文件中保存用户名和密码。每次使用文件进行连接时，系统都将提示您输入用户名和密码。	Boolean
version (可选)	要连接到的地理数据库版本。默认情况下将连接到 DEFAULT 版本。	String
save_version_info (可选)	SAVE_VERSION —在连接文件中保存版本名称。 DO_NOT_SAVE_VERSION —不在连接文件中保存版本名称。如果没有将版本名称与文件一起保存，在您下次访问连接文件时将建立到 DEFAULT 版本的连接。	Boolean

代码示例

CreateArcSDEConnectionFile 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 CreateArcSDEConnectionFile 函数。

import arcpy
arcpy.CreateArcSDEConnectionFile_management(r'c:\connectionFiles',
                                            'gpserver',
                                            '5151',
                                            '',
                                            'toolbox',
                                            'toolbox',
                                            'SAVE_USERNAME',
                                            'SDE.DEFAULT',
                                            'SAVE_VERSION')

CreateArcSDEConnectionFile 示例 2（独立脚本）

以下独立脚本是如何在脚本中应用 CreateArcSDEConnectionFile 函数的示例。

# CreateArcSDEConnection.py
# Description: Simple example showing use of CreateArcSDEConnectionFile tool
 
# Import system modules
import arcpy

# Set variables
folderName = r"c:\connectionFiles"
fileName = "Connection to gpserver.sde"
serverName = "gpserver"
serviceName = "5151"
databaseName = ""
authType = "DATABASE_AUTH"
username = "toolbox"
password = "toolbox"
saveUserInfo = "SAVE_USERNAME"
versionName = "SDE.DEFAULT"
saveVersionInfo = "SAVE_VERSION"

# Process: Use the CreateArcSDEConnectionFile function
arcpy.CreateArcSDEConnectionFile_management (folderName,
                                             fileName,
                                             serverName,
                                             serviceName,
                                             databaseName,
                                             authType,
                                             username,
                                             password,
                                             saveUserInfo,
                                             versionName,
                                             saveVersionInfo)

环境

• 当前工作空间

许可信息

• ArcGIS Desktop Basic: 否
• ArcGIS Desktop Standard: 是
• ArcGIS Desktop Advanced: 是