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

サマリー

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

使用法

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

  • データベースでは、[ジオプロセシング] ウィンドウの [ジオデータベース コネクション プロパティ] パラメーター カテゴリにあるすべてのパラメーターが無視されます。
  • ジオデータベースでは、このツールによって [ジオデータベース コネクション プロパティ] パラメーター カテゴリが自動的に入力されます。 [スキーマ] パラメーターに sde スキーマが設定され (Oracle ユーザー スキーマ ジオデータベースのみ)、ジオデータベースのデフォルトの [バージョン タイプ] 値と、デフォルト バージョンも設定されます。

• 接続情報が [結果] ウィンドウやジオプロセシング履歴ログ ファイルに保存されないようにする場合は、履歴ログを無効にしてコネクション ファイルを保存し、接続情報が保存されないようにします。

• ArcGIS から Altibase および Netezza への接続は、サポートされなくなりました。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
コネクション ファイルの場所	データベース接続ファイル (.sde) の保存先となるフォルダー パス。	Folder
コネクション ファイル名	データベース コネクション ファイルの名前。 出力ファイルに拡張子「.sde」が付きます。	String
データベース プラットフォーム	接続先のデータベース管理システム プラットフォームを指定します。 有効なオプションは次のとおりです。 BigQuery—Google BigQuery への接続が確立されます。 Dameng—Dameng への接続が確立されます。 DB2—IBM Db2 for Linux、UNIX、Windows への接続が確立されます。 Oracle—Oracle、Amazon Relational Database Service (RDS) for Oracle、または Autonomous Transaction Processing への接続が確立されます。 PostgreSQL—PostgreSQL、Amazon Aurora (PostgreSQL-compatible edition)、Amazon Relational Database Service (RDS) for PostgreSQL、Google Cloud SQL for PostgreSQL、Microsoft Azure Database for PostgreSQL、または Microsoft Azure Cosmos DB for PostgreSQL への接続が確立されます。 Redshift—Amazon Redshift への接続が確立されます。 Teradata—Teradata Vantage への接続が確立されます。 SAP HANA—SAP HANA または SAP HANA Cloud への接続が確立されます。 雪の結晶—Snowflake への接続が確立されます。 SQL Server—Microsoft SQL Server、Microsoft Azure SQL Database、Microsoft Azure SQL Managed Instance、または Amazon 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 データベース サービス インスタンスの名前 Redshift - Redshift サーバーの URL SAP HANA - SAP HANA データベースまたはデータベース サービスの ODBC (Open Database Connectivity) データ ソース名 Snowflake - Snowflake サーバーの URL SQL Server - SQL Server データベース インスタンスまたはデータベース サービス インスタンスの名前 Teradata - Teradata データベースの ODBC データ ソース名	String
データベース認証 (オプション)	使用される認証のタイプを指定します。 データベース認証—データベース認証が使用されます。 内部データベース ユーザー名およびパスワードが、データベースへの接続に使用されます。 接続を確立するときにユーザー名とパスワードを入力する必要はありませんが、入力していない場合は、接続が確立されたときにユーザー名とパスワードを入力するよう求められます。 注意: 作成する接続ファイルによって、ArcGIS サービスにデータベースまたはジオデータベースへのアクセス権限が付与される場合、またはカタログ検索を使用してこの接続ファイル経由でアクセスするデータを検索する場合は、ユーザー名およびパスワードを含める必要があります。 オペレーティング システム認証—オペレーティング システム認証が使用されます。 ユーザー名とパスワードを入力する必要はありません。 オペレーティング システムへのログインで使用されたユーザー名とパスワードを使ってコネクションが作成されます。 オペレーティング システムで使用したログイン情報がデータベースへのログインで無効な場合、接続は確立されません。	Boolean
ユーザー名 (オプション)	データベース認証で使用されるデータベース ユーザー名。	String
パスワード (オプション)	データベース認証で使用されるデータベース ユーザー パスワード。	Encrypted String
ユーザー名とパスワードを保存 (オプション)	ユーザー名とパスワードを保存するかどうかを指定します。 オン - ユーザー名とパスワードを接続ファイルに保存します。 これがデフォルトです。 作成するコネクション ファイルによって、ArcGIS サービスにデータベース、ジオデータベース、またはクラウド データ ウェアハウスへのアクセス権限が付与される場合、またはカタログ検索を使用してこのコネクション ファイル経由でアクセスするデータを検索する場合は、ユーザー名およびパスワードを保存する必要があります。 オフ - ユーザー名とパスワードを接続ファイルに保存しません。 このファイルを使用して接続を試行するたびに、ユーザー名とパスワードを入力するよう求められます。	Boolean
データベース (オプション)	接続先のデータベースの名前。 このパラメーターは、PostgreSQL、Redshift、Snowflake、および 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
高度な認証タイプ (オプション)	クラウド データ ウェアハウス、Microsoft Azure SQL Database、または Azure SQL Managed Instance に接続するときに使用される高度な認証タイプを指定します。 Azure Active Directory Universal with MFA—Azure Active Directory ユーザー名認証タイプが使用されますが、パスワードは使用されません。 接続するときに、テキスト メッセージ、電子メール、または MFA デバイスでコードが送信されます。または、認証に指紋スキャンを使用できます。 この認証プロセスの 2 つ目の部分は、お使いのネットワークと認証プロトコルの構成方法によって異なります。このオプションは、Azure SQL Database と Azure SQL Managed Instance でのみサポートされています。 Azure Active Directory Password—ユーザー名およびパスワード パラメーターを使用する Azure Active Directory ユーザー名とパスワード認証タイプが使用されます。 ユーザー名には、最大で 30 文字まで入力できます。このオプションは、Azure SQL Database と Azure SQL Managed Instance でのみサポートされています。 サービス認証—Google BigQuery への接続時のサービス認証タイプが使用されます。 詳細については、Google BigQuery の認証に関するドキュメントをご参照ください。 標準—Amazon Redshift への接続時の標準認証タイプが使用されます。 標準認証の詳細については、「Amazon Redshift ODBC データ コネクタ インストールおよび構成ガイド」をご参照ください。 ユーザー—Snowflake への接続時にユーザー名とパスワードを要求する認証方法が使用されます。 ユーザー認証—Google BigQuery への接続時のユーザー認証タイプが使用されます。 詳細については、Google BigQuery の認証に関するドキュメントをご参照ください。	String
プロジェクト ID (オプション)	Google BigQuery 接続のプロジェクト ID。	String
デフォルトのデータセット (オプション)	Google BigQuery 接続のデフォルトのデータセット。	String
リフレッシュ トークン (オプション)	リフレッシュ トークンの値。 このパラメーターは、高度な認証タイプがユーザー認証の場合に Google BigQuery 接続にのみ適用されます。	String
キー ファイル (オプション)	キー ファイルの値。 このパラメーターは、高度な認証タイプがサーバー認証の場合に Google BigQuery 接続にのみ適用されます。	String
ロール (オプション)	クラウド データ ウェアハウス接続のロールの値。 このパラメーターは、Snowflake への接続にのみ適用されます。	String
倉庫 (オプション)	接続のウェアハウスの値。 このパラメーターは、Snowflake への接続にのみ適用されます。	String
高度な設定 (オプション)	接続の高度なオプション。 これは、接続先のクラウド データ ウェアハウス プラットフォーム (Google BigQuery、Amazon Redshift、または Snowflake) に固有のオプションの接続情報です。 セミコロンで区切った Option=<値> を使用して高度なオプションを指定します。 例: option1=value1;option2=value2; オプションの接続オプションの詳細については、クラウド データ ウェアハウスのドキュメントをご参照ください。	String

派生した出力

ラベル	説明	データ タイプ
出力ワークスペース	出力データベース コネクション ファイル (.sde)。	workspace

Python

arcpy.management.CreateDatabaseConnection(out_folder_path, out_name, database_platform, {instance}, {account_authentication}, {username}, {password}, {save_user_pass}, {database}, {schema}, {version_type}, {version}, {date}, {auth_type}, {project_id}, {default_dataset}, {refresh_token}, {key_file}, {role}, {warehouse}, {advanced_options})

名前	説明	データ タイプ
out_folder_path	データベース接続ファイル (.sde) の保存先となるフォルダー パス。	Folder
out_name	データベース コネクション ファイルの名前。 出力ファイルに拡張子「.sde」が付きます。	String
database_platform	接続先のデータベース管理システム プラットフォームを指定します。 有効なオプションは次のとおりです。 BIGQUERY—Google BigQuery への接続が確立されます。 DAMENG—Dameng への接続が確立されます。 DB2—IBM Db2 for Linux、UNIX、Windows への接続が確立されます。 ORACLE—Oracle、Amazon Relational Database Service (RDS) for Oracle、または Autonomous Transaction Processing への接続が確立されます。 POSTGRESQL—PostgreSQL、Amazon Aurora (PostgreSQL-compatible edition)、Amazon Relational Database Service (RDS) for PostgreSQL、Google Cloud SQL for PostgreSQL、Microsoft Azure Database for PostgreSQL、または Microsoft Azure Cosmos DB for PostgreSQL への接続が確立されます。 REDSHIFT—Amazon Redshift への接続が確立されます。 SAP HANA—SAP HANA または SAP HANA Cloud への接続が確立されます。 SNOWFLAKE—Snowflake への接続が確立されます。 SQL_SERVER—Microsoft SQL Server、Microsoft Azure SQL Database、Microsoft Azure SQL Managed Instance、または Amazon Relational Database Service (RDS) for SQL Server、または Google Cloud SQL for SQL Server への接続が確立されます。 TERADATA—Teradata Vantage への接続が確立されます。	String
instance (オプション)	接続先のデータベース サーバーまたはインスタンス。 database_platform パラメーターに指定する値は、接続先のデータベースまたはクラウド データ ウェアハウスのタイプを示します。 instance パラメーターで指定する情報は、指定したプラットフォームによって異なります。 各プラットフォームに入力する内容の詳細については、以下をご参照ください。 Dameng - Dameng データベースがインストールされているサーバー名 Db2 - カタログに表示される Db2 データベース名 Oracle - Oracle データベースまたはデータベース サービスに接続する TNS 名または Oracle 簡易接続文字列 PostgreSQL - PostgreSQL がインストールされているサーバーの名前または PostgreSQL データベース サービス インスタンスの名前 Redshift - Redshift サーバーの URL SAP HANA - SAP HANA データベースまたはデータベース サービスの ODBC (Open Database Connectivity) データ ソース名 Snowflake - Snowflake サーバーの URL 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、Redshift、Snowflake、および 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
auth_type (オプション)	クラウド データ ウェアハウス、Microsoft Azure SQL Database、または Azure SQL Managed Instance に接続するときに使用される高度な認証タイプを指定します。 AZURE_ACTIVE_DIRECTORY_UNIVERSAL_WITH_MFA—Azure Active Directory ユーザー名認証タイプが使用されますが、パスワードは使用されません。 接続するときに、テキスト メッセージ、電子メール、または MFA デバイスでコードが送信されます。または、認証に指紋スキャンを使用できます。 この認証プロセスの 2 つ目の部分は、お使いのネットワークと認証プロトコルの構成方法によって異なります。このオプションは、Azure SQL Database と Azure SQL Managed Instance でのみサポートされています。 AZURE_ACTIVE_DIRECTORY_PASSWORD—ユーザー名およびパスワード パラメーターを使用する Azure Active Directory ユーザー名とパスワード認証タイプが使用されます。 ユーザー名には、最大で 30 文字まで入力できます。このオプションは、Azure SQL Database と Azure SQL Managed Instance でのみサポートされています。 SERVICE_AUTHENTICATION—Google BigQuery への接続時のサービス認証タイプが使用されます。 詳細については、Google BigQuery の認証に関するドキュメントをご参照ください。 STANDARD—Amazon Redshift への接続時の標準認証タイプが使用されます。 標準認証の詳細については、「Amazon Redshift ODBC データ コネクタ インストールおよび構成ガイド」をご参照ください。 USER—Snowflake への接続時にユーザー名とパスワードを要求する認証方法が使用されます。 USER_AUTHENTICATION—Google BigQuery への接続時のユーザー認証タイプが使用されます。 詳細については、Google BigQuery の認証に関するドキュメントをご参照ください。	String
project_id (オプション)	Google BigQuery 接続のプロジェクト ID。	String
default_dataset (オプション)	Google BigQuery 接続のデフォルトのデータセット。	String
refresh_token (オプション)	リフレッシュ トークンの値。 このパラメーターは、高度な認証タイプがユーザー認証の場合に Google BigQuery 接続にのみ適用されます。	String
key_file (オプション)	キー ファイルの値。 このパラメーターは、高度な認証タイプがサーバー認証の場合に Google BigQuery 接続にのみ適用されます。	String
role (オプション)	クラウド データ ウェアハウス接続のロールの値。 このパラメーターは、Snowflake への接続にのみ適用されます。	String
warehouse (オプション)	接続のウェアハウスの値。 このパラメーターは、Snowflake への接続にのみ適用されます。	String
advanced_options (オプション)	接続の高度なオプション。 これは、接続先のクラウド データ ウェアハウス プラットフォーム (Google BigQuery、Amazon Redshift、または Snowflake) に固有のオプションの接続情報です。 セミコロンで区切った Option=<値> を使用して高度なオプションを指定します。 例: option1=value1;option2=value2; オプションの接続オプションの詳細については、クラウド データ ウェアハウスのドキュメントをご参照ください。	String

派生した出力

名前	説明	データ タイプ
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