概要
ArcGIS がデータベースまたは、エンタープライズ、ワークグループ、デスクトップ ジオデータベースへの接続に使用するファイルを作成します。
使用法
ツール ダイアログ ボックスに接続を確立するための有効な接続情報が入力されると、このツールはデータベースに接続して、ジオデータベース スキーマが含まれているかどうかを判定します。
- データベースでは、ツール ダイアログ ボックスの [ジオデータベース コネクション プロパティ] セクションのすべてのパラメーターが無視されます。
- ジオデータベースでは、このツールによって [ジオデータベース コネクション プロパティ] セクションが自動的に入力されます。 [スキーマ] パラメーターに sde スキーマが設定され (Oracle ユーザー スキーマ ジオデータベースのみ)、ジオデータベースのデフォルトの [バージョン タイプ] と、デフォルト バージョンも設定されます。
接続情報が [結果] ウィンドウやジオプロセシング履歴ログ ファイルに保存されないようにするには、履歴ログを無効にしてコネクション ファイルを保存し、接続情報が保存されないようにします。
ArcGIS から Altibase および Netezza への接続は、サポートされなくなりました。
構文
arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, instance, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date})| パラメーター | 説明 | データ タイプ |
out_folder_path | データベース接続ファイル (*.sde) の保存先となるフォルダー パス。 | Folder |
out_name | データベース コネクション ファイルの名前。 出力ファイルに拡張子「*.sde」が付きます。 | String |
database_platform | 接続先のデータベース管理システム プラットフォームを指定します。 有効なオプションは次のとおりです。
| String |
instance | 接続先のデータベース サーバーまたはインスタンス。 database_platform パラメーターに指定する値は、接続先のデータベースのタイプを示します。 instance パラメーターで指定する情報は、指定したデータベース プラットフォームによって異なります。 各データベース プラットフォームに入力する内容の詳細については、以下をご参照ください。
| String |
account_authentication (オプション) | 使用される認証のタイプを指定します。
| Boolean |
username (オプション) | データベース認証で使用されるデータベース ユーザー名。 | String |
password (オプション) | データベース認証で使用されるデータベース ユーザー パスワード。 | Encrypted String |
save_user_pass (オプション) | ユーザー名とパスワードを保存するかどうかを指定します。
| Boolean |
database (オプション) | 接続先のデータベースの名前。 このパラメーターは、PostgreSQL および SQL Server プラットフォームにのみ適用されます。 | String |
schema (オプション) | 接続先のユーザー スキーマ ジオデータベース。 このオプションは、ユーザー スキーマ ジオデータベースのある Oracle データベースにのみ適用されます。 このパラメーターのデフォルト値は、sde スキーマ ジオデータベースの使用です。 | String |
version_type (オプション) | 接続先のバージョン タイプを指定します。
| String |
version (オプション) | 接続するジオデータベースのトランザクション バージョンまたは履歴マーカー。 デフォルト オプションは、デフォルトのトランザクション バージョンを使用します。 | String |
date (オプション) | 履歴管理が有効なデータを操作するときに、データベース接続に使用する日時を表す値。 日付は、次の形式で入力できます。
| Date |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_workspace | 出力データベース コネクション ファイル (*.sde)。 | workspace |
コードのサンプル
CreateDatabaseConnection (データベース接続の作成) の例 1 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、イミディエイト モードで CreateDatabaseConnection 関数を使用する方法を示しています。
import arcpy
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"utah.sde",
"SQL_SERVER",
"utah",
"DATABASE_AUTH",
"gdb",
"gdb",
"SAVE_USERNAME",
"garfield",
"#",
"TRANSACTIONAL",
"sde.DEFAULT")
CreateDatabaseConnection (データベース コネクションの作成) の例 2 (スタンドアロン スクリプト)
次のスタンドアロン スクリプトで、CreateDatabaseConnection 関数を使用する方法を示します。
# Name: CreateDatabaseConnection2.py
# Description: Connects to a database using Easy Connect string
# and operating system authentication.
# Import system modules
import arcpy
# Run the tool
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"zion.sde",
"ORACLE",
"zionserver/ORCL",
"OPERATING_SYSTEM_AUTH")
CreateDatabaseConnection (データベース接続の作成) の例 3 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、CreateDatabaseConnection 関数を使用して、履歴マーカーに接続する方法を示しています。
# Name: CreateDatabaseConnection3.py
# Description: Connects to a geodatabase historical marker using a
# cataloged DB2 database and database authentication.
# Import system modules
import arcpy
# Run the tool
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"history.sde",
"DB2",
"DB2_DS",
"DATABASE_AUTH",
"butch",
"sundance",
"SAVE_USERNAME",
"#",
"#",
"HISTORICAL",
"June 9, 2010",
"#")
CreateDatabaseConnection (データベース コネクションの作成) の例 4 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、特定時点に接続するための CreateDatabaseConnection 関数の使用方法を示しています。
# Name: CreateDatabaseConnection4.py
# Description: Connects to a point in time in the geodatabase in
# PostgreSQL using database authentication.
# Import system modules
import arcpy
# Run the tool
arcpy.CreateDatabaseConnection_management("C:\\MyProject",
"history.sde",
"POSTGRESQL",
"dbserver",
"DATABASE_AUTH",
"stevie",
"smith",
"SAVE_USERNAME",
"archivedb",
"#",
"POINT_IN_TIME",
"#",
"5/19/2011 8:43:41 AM")
環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい