サマリ
ArcSDE サービスを使用してエンタープライズ ジオデータベースに接続するためのデータベース接続ファイルを作成します。
使用法
[ArcSDE 接続ファイル名] には .sde ファイル拡張子が含まれている必要があります。
有効な接続情報を入力すると、ツールによって、接続したユーザーがアクセス権限を持つジオデータベースのバージョンを使用してバージョン リストが設定されます。
- 接続情報が [結果] ウィンドウやジオプロセシング履歴ログ ファイルに保存されないようにしたい場合は、履歴ログを無効にして接続ファイルを保存し、表示したくない接続情報が保存されないようにします。
このツールを使用するのは、10.2.2 以前のバージョンのジオデータベースに対してアプリケーション サーバー (ArcSDE サービス) 接続を作成する場合に限られます。10.3 以降のジオデータベースに接続する場合や、10.2.2 以前のジオデータベースに直接接続する場合は、代わりに [データベース接続の作成 (Create Database Connection)] ツールを使用します。
構文
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 (オプション) |
| Boolean |
username (オプション) | データベース認証を使用した接続で使用されるデータベース ユーザー名。 | String |
password (オプション) | データベース認証使用時のデータベース ユーザーのパスワード。 | Encrypted String |
save_username_password (オプション) |
| Boolean |
version (オプション) | 接続先のジオデータベース バージョン。デフォルトでは、DEFAULT バージョンに接続します。 | String |
save_version_info (オプション) |
| Boolean |
コードのサンプル
CreateArcSDEConnectionFile (ArcSDE 接続ファイルの作成) の例 1 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、イミディエイト モードで CreateArcSDEConnectionFile (ArcSDE 接続ファイルの作成) 関数を使用する方法を示しています。
import arcpy
arcpy.CreateArcSDEConnectionFile_management(r'c:\connectionFiles',
'gpserver',
'5151',
'',
'toolbox',
'toolbox',
'SAVE_USERNAME',
'SDE.DEFAULT',
'SAVE_VERSION')
CreateArcSDEConnectionFile (ArcSDE 接続ファイルの作成) の例 2 (スタンドアロン スクリプト)
次のスタンドアロン スクリプトは、CreateArcSDEConnectionFile (ArcSDE接続ファイルの作成) 関数をスクリプティングに適用する例を示しています。
# 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: ○