创建 ArcSDE 连接文件 (数据管理)

摘要

创建用于连接到 ArcSDE 地理数据库的 ArcSDE 连接文件。

用法

• 虽然您可以为 ArcSDE 连接文件名称输入任意文件扩展名，但如果想要被 ArcGIS 正确识别，则必须使用标准文件扩展名 .sde。

• 在输入有效的连接信息后，该工具将连接到 ArcSDE 服务器，以便用已连接用户有权连接到的版本来填充版本列表。

• 有关 ArcSDE 连接属性的更完整解释，请参阅 ArcSDE 地理数据库连接快速浏览。

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

语法

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	ArcSDE 连接文件的名称。使用 .sde 文件扩展名。	String
server	ArcSDE 服务器计算机名称。	String
service	ArcSDE 服务名称或 TCP 端口号。	String
database （可选）	仅限非 Oracle 数据库。要连接到的 DBMS 数据库。	String
account_authentication （可选）	DATABASE_AUTH —数据库身份验证。使用内部数据库用户名和密码连接到 DBMS。创建连接无需输入用户名和密码；但是，如果不输入用户名和密码，系统将在连接建立好之后提示您输入用户名和密码。 OPERATING_SYSTEM_AUTH —使用“操作系统身份验证”。不必输入用户名和密码。将用登录操作系统时所使用的用户名和密码建立连接。如果操作系统使用的登录信息不能用作地理数据库的登录信息，连接将失败。另请注意，如果要创建与存储在 Oracle、DB2 或 Informix 中地理数据库的连接，则需要使用与数据库的直连。	Boolean
username （可选）	使用“数据库身份验证”连接时所需的数据库用户名。	String
password （可选）	当使用“数据库身份验证”时所需的数据库用户密码。	Encrypted String
save_username_password （可选）	SAVE_USERNAME —在连接文件中保存用户名和密码。 DO_NOT_SAVE_USERNAME —不在连接文件中保存用户名和密码。每次试图使用文件进行连接时，系统都将提示您输入用户名和密码。	Boolean
version （可选）	要连接到的地理数据库版本。	String
save_version_info （可选）	SAVE_VERSION —在连接文件中保存版本名称。 DO_NOT_SAVE_VERSION —不在连接文件中保存版本名称。如果没有在文件中保存版本名称，系统将在每次访问连接文件时提示您输入要连接到的版本。	Boolean

代码示例

CreateArcSDEConnectionFile 示例（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 # Author: ESRI   # 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)  

环境

此工具不使用任何地理处理环境

许可信息

ArcView: 否

ArcEditor: 是

ArcInfo: 是