创建 ArcSDE 连接文件 (Data Management)

摘要

创建用于连接到 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
 
# 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 for Desktop Basic:否

ArcGIS for Desktop Standard:是

ArcGIS for Desktop Advanced:是