ArcGIS Help 10.2 - 创建 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: 是

5/10/2014

创建 ArcSDE 连接文件 (Data Management)

摘要

用法

语法

代码实例

环境

相关主题

许可信息