データベース コネクションの作成 (Create Database Connection) (データ管理)

サマリー

ArcGIS がデータベースまたはエンタープライズ ジオデータベースへの接続に使用するファイルを作成します。

使用法

  • 接続を確立するためにツール ダイアログ ボックスで有効な接続情報が入力されると、このツールはデータベースに接続して、ジオデータベース スキーマが含まれているかどうかを判定します。

    • データベースでは、ツール ダイアログ ボックスの [ジオデータベース コネクション プロパティ] セクションのすべてのパラメーターが無視されます。
    • ジオデータベースでは、このツールによって [ジオデータベース コネクション プロパティ] セクションが自動的に入力されます。 [スキーマ] パラメーターに sde スキーマが設定され (Oracle ユーザー スキーマ ジオデータベースのみ)、ジオデータベースのデフォルトの [バージョン タイプ] 値と、デフォルト バージョンも設定されます。
  • ArcGIS から Altibase および Netezza への接続は、サポートされなくなりました。

パラメーター

ラベル説明データ タイプ
コネクション ファイルの場所

データベース接続ファイル (*.sde) の保存先となるフォルダー パス。

Folder
コネクション ファイル名

データベース コネクション ファイルの名前。 出力ファイルに拡張子「*.sde」が付きます。

String
データベース プラットフォーム

接続先のデータベース管理システム プラットフォームを指定します。 有効なオプションは次のとおりです。

  • DamengDameng への接続。
  • DB2IBM Db2 (Linux、UNIX、Windows) への接続。
  • OracleOracleAmazon Relational Database Service (RDS) for Oracle、または Autonomous Transaction Processing への接続。
  • PostgreSQLPostgreSQLAmazon Aurora (PostgreSQL-compatible edition)Amazon Relational Database Service (RDS) for PostgreSQLMicrosoft Azure Database for PostgreSQL、または Google Cloud SQL for PostgreSQL への接続。
  • TeradataTeradata Vantage への接続。
  • SAP HANASAP HANASAP HANA Cloud に接続します。
  • SQL ServerMicrosoft SQL ServerMicrosoft Azure SQL DatabaseMicrosoft Azure SQL Managed InstanceAmazon Relational Database Service (RDS) for SQL Server、または Google Cloud SQL for SQL Server への接続。
String
インスタンス

接続先のデータベース サーバーまたはインスタンス。

[データベース プラットフォーム] ドロップダウン リストで選択した値は、接続先のデータベースの種類を示しています。 [インスタンス] パラメーターで指定する情報は、選択した接続タイプによって異なります。

各データベース プラットフォームに入力する内容の詳細については、以下をご参照ください。

  • Dameng - Dameng データベースがインストールされているサーバー名
  • Db2 - カタログに表示される Db2 データベース名
  • Oracle - Oracle データベースまたはデータベース サービスに接続する TNS 名または Oracle 簡易接続文字列
  • PostgreSQL - PostgreSQL がインストールされているサーバーの名前または PostgreSQL データベース サービス インスタンスの名前
  • SAP HANA - SAP HANA データベースまたはデータベース サービスの ODBC (Open Database Connectivity) データ ソース名
  • SQL Server - SQL Server データベース インスタンス、またはデータベース サービス インスタンスの名前。
  • Teradata - Teradata データベースの ODBC データ ソース名
String
データベース認証
(オプション)

使用される認証のタイプを指定します。

  • データベース認証データベース認証が使用されます。 内部データベース ユーザー名およびパスワードが、データベースへの接続に使用されます。 接続を確立するときにユーザー名とパスワードを入力する必要はありませんが、入力していない場合は、接続が確立されたときにユーザー名とパスワードを入力するよう求められます。
    注意:

    作成する接続ファイルによって、ArcGIS サービスにデータベースまたはジオデータベースへのアクセス権限が付与される場合、またはカタログ検索を使用してこの接続ファイル経由でアクセスするデータを検索する場合は、ユーザー名およびパスワードを含める必要があります。

  • オペレーティング システム認証オペレーティング システム認証が使用されます。 ユーザー名とパスワードを入力する必要はありません。 オペレーティング システムへのログインで使用されたユーザー名とパスワードを使ってコネクションが作成されます。 オペレーティング システムで使用したログイン情報がジオデータベースへのログインで無効な場合、コネクションは確立されません。
Boolean
ユーザー名
(オプション)

データベース認証で使用されるデータベース ユーザー名。

String
パスワード
(オプション)

データベース認証で使用されるデータベース ユーザー パスワード。

Encrypted String
ユーザー名とパスワードを保存
(オプション)

ユーザー名とパスワードを保存するかどうかを指定します。

  • オン - ユーザー名とパスワードを接続ファイルに保存します。 これがデフォルトです。 作成する接続ファイルによって、ArcGIS サービスにデータベースまたはジオデータベースへのアクセス権限が付与される場合、またはカタログ検索を使用してこの接続ファイル経由でアクセスするデータを検索する場合は、ユーザー名およびパスワードを保存する必要があります。
  • オフ - ユーザー名とパスワードを接続ファイルに保存しません。 このファイルを使用して接続を試行するたびに、ユーザー名とパスワードを入力するよう求められます。
Boolean
データベース
(オプション)

接続先のデータベースの名前。 このパラメーターは、PostgreSQL および SQL Server プラットフォームにのみ適用されます。

String
スキーマ (Oracle ユーザー スキーマ ジオデータベースのみ)
(オプション)

接続先のユーザー スキーマ ジオデータベース。 ツールは、接続先がユーザー スキーマ ジオデータベースがある Oracle データベースかどうかを判定します。 Oracle データベースにユーザー スキーマがある場合、このオプションは有効になり、ない場合は無効のままになります。 このパラメーターのデフォルト オプションは、sde スキーマ ジオデータベースの使用です。

String
バージョン タイプ
(オプション)

接続先のバージョン タイプを指定します。 このパラメーターは、ジオデータベースに接続する場合にのみ適用されます。

注意:

[履歴] が選択され、名前が入力されていない場合、デフォルトのトランザクション バージョンが使用されます。 [時点] が選択され、[日時] パラメーターに日付が指定されていない場合、デフォルトのトランザクション バージョンが使用されます。

  • トランザクショントランザクション バージョンに接続します。 [トランザクション] が選択された場合、[次のバージョンを使用する] パラメーターがトランザクション バージョンのリストを使用して入力され、[日時] パラメーターが無効になります。 これがデフォルトです。
  • 履歴履歴マーカーに接続します。 [履歴] が選択された場合、[次のバージョンが使用されます] パラメーターが履歴マーカーのリストを使用して入力され、[日時] パラメーターが無効になります。
  • 時点特定時点に接続します。 [時点] が選択された場合、[次のバージョンを使用する] パラメーターが無効になり、[日時] パラメーターが有効になります。
  • ブランチデフォルトのブランチ バージョンに接続します。
String
次のバージョンが使用されます
(オプション)

接続するジオデータベースのトランザクション バージョンまたは履歴マーカー。 デフォルト オプションは、デフォルトのトランザクション バージョンを使用します。

ブランチ バージョン タイプを選択すると、デフォルトのブランチ バージョンに常に接続します。

String
日時
(オプション)

データベース接続に使用する日時を表す値。 このオプションは、履歴管理が有効なデータとともに使用されます。 適切な日付を選択するには、時刻ピッカーを使用します。

日付を手動で入力する場合は、次の形式が使用できます。

  • 6/9/2011 4:20:15 PM
  • 6/9/2011 16:20:15
  • 6/9/2011
  • 4:20:15 PM
  • 4:20:15 PM

注意:

  • 日付を入力しないまま時刻を入力すると、デフォルトの日付である December 30、1899 が使用されます。
  • 時刻を入力しないまま日付を入力すると、デフォルトの時刻である 12:00:00 AM が使用されます。

Date

派生した出力

ラベル説明データ タイプ
出力ワークスペース

出力データベース コネクション ファイル (*.sde)。

workspace

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

接続先のデータベース管理システム プラットフォームを指定します。 有効なオプションは次のとおりです。

  • DAMENGDameng への接続。
  • DB2IBM Db2 (Linux、UNIX、Windows) への接続。
  • ORACLEOracleAmazon Relational Database Service (RDS) for Oracle、または Autonomous Transaction Processing への接続。
  • POSTGRESQLPostgreSQLAmazon Aurora (PostgreSQL-compatible edition)Amazon Relational Database Service (RDS) for PostgreSQLMicrosoft Azure Database for PostgreSQL、または Google Cloud SQL for PostgreSQL への接続。
  • SAP HANASAP HANASAP HANA Cloud に接続します。
  • SQL_SERVERMicrosoft SQL ServerMicrosoft Azure SQL DatabaseMicrosoft Azure SQL Managed InstanceAmazon Relational Database Service (RDS) for SQL Server、または Google Cloud SQL for SQL Server への接続。
  • TERADATATeradata Vantage への接続。
String
instance

接続先のデータベース サーバーまたはインスタンス。

database_platform パラメーターに指定する値は、接続先のデータベースのタイプを示します。 instance パラメーターで指定する情報は、指定したデータベース プラットフォームによって異なります。

各データベース プラットフォームに入力する内容の詳細については、以下をご参照ください。

  • Dameng - Dameng データベースがインストールされているサーバー名
  • Db2 - カタログに表示される Db2 データベース名
  • Oracle - Oracle データベースまたはデータベース サービスに接続する TNS 名または Oracle 簡易接続文字列
  • PostgreSQL - PostgreSQL がインストールされているサーバーの名前または PostgreSQL データベース サービス インスタンスの名前
  • SAP HANA - SAP HANA データベースまたはデータベース サービスの ODBC (Open Database Connectivity) データ ソース名
  • SQL Server - SQL Server データベース インスタンス、またはデータベース サービス インスタンスの名前。
  • Teradata - Teradata データベースの ODBC データ ソース名
String
account_authentication
(オプション)

使用される認証のタイプを指定します。

  • DATABASE_AUTHデータベース認証が使用されます。 内部データベース ユーザー名およびパスワードが、データベースへの接続に使用されます。 接続を確立するときにユーザー名とパスワードを入力する必要はありませんが、入力していない場合は、接続が確立されたときにユーザー名とパスワードを入力するよう求められます。
    注意:

    作成する接続ファイルによって、ArcGIS サービスにデータベースまたはジオデータベースへのアクセス権限が付与される場合、またはカタログ検索を使用してこの接続ファイル経由でアクセスするデータを検索する場合は、ユーザー名およびパスワードを含める必要があります。

  • OPERATING_SYSTEM_AUTHオペレーティング システム認証が使用されます。 ユーザー名とパスワードを入力する必要はありません。 オペレーティング システムへのログインで使用されたユーザー名とパスワードを使ってコネクションが作成されます。 オペレーティング システムで使用したログイン情報がジオデータベースへのログインで無効な場合、コネクションは確立されません。
Boolean
username
(オプション)

データベース認証で使用されるデータベース ユーザー名。

String
password
(オプション)

データベース認証で使用されるデータベース ユーザー パスワード。

Encrypted String
save_user_pass
(オプション)

ユーザー名とパスワードを保存するかどうかを指定します。

  • SAVE_USERNAMEユーザー名とパスワードをコネクション ファイルに保存します。 これがデフォルトです。 作成する接続ファイルによって、ArcGIS サービスにデータベースまたはジオデータベースへのアクセス権限が付与される場合、またはカタログ検索を使用してこの接続ファイル経由でアクセスするデータを検索する場合は、ユーザー名およびパスワードを保存する必要があります。
  • DO_NOT_SAVE_USERNAMEユーザー名とパスワードをコネクション ファイルに保存しません。 このファイルを使用して接続を試行するたびに、ユーザー名とパスワードを入力するよう求められます。
Boolean
database
(オプション)

接続先のデータベースの名前。 このパラメーターは、PostgreSQL および SQL Server プラットフォームにのみ適用されます。

String
schema
(オプション)

接続先のユーザー スキーマ ジオデータベース。 このオプションは、ユーザー スキーマ ジオデータベースのある Oracle データベースにのみ適用されます。 このパラメーターのデフォルト値は、sde スキーマ ジオデータベースの使用です。

String
version_type
(オプション)

接続先のバージョン タイプを指定します。

  • TRANSACTIONAL従来のトランザクション バージョンに接続します。
    注意:

    このオプションは、SAP HANA のジオデータベースには適用されません。

  • HISTORICAL履歴マーカーに接続します。
  • POINT_IN_TIME特定時点に接続します。 POINT_IN_TIME を使用する場合、version パラメーターは無視されます。
  • BRANCHデフォルトのブランチ バージョンに接続します。

注意:

TRANSACTIONAL または HISTORICAL を使用する場合、date パラメーターは無視されます。 HISTORICAL が使用され、version パラメーターに名前が指定されていない場合、デフォルト トランザクション バージョンが使用されます。 POINT_IN_TIME が使用され、date パラメーターに日付が指定されていない場合、デフォルトのトランザクション バージョンが使用されます。

String
version
(オプション)

接続するジオデータベースのトランザクション バージョンまたは履歴マーカー。 デフォルト オプションは、デフォルトのトランザクション バージョンを使用します。

ブランチ バージョン タイプを選択すると、デフォルトのブランチ バージョンに常に接続します。

String
date
(オプション)

履歴管理が有効なデータを操作するときに、データベース接続に使用する日時を表す値。

日付は、次の形式で入力できます。

  • 6/9/2011 4:20:15 PM
  • 6/9/2011 16:20:15
  • 6/9/2011
  • 4:20:15 PM
  • 4:20:15 PM

注意:

  • 日付を入力しないまま時刻を入力すると、デフォルトの日付である December 30、1899 が使用されます。
  • 時刻を入力しないまま日付を入力すると、デフォルトの時刻である 12:00:00 AM が使用されます。

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: No
  • Standard: Yes
  • Advanced: Yes

関連トピック