创建 ArcSDE 连接文件 (Data Management)

许可等级:BasicStandardAdvanced

摘要

创建用于连接到 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