データベース接続文字列の作成 (Create Database Connection String) (データ管理)—ArcGIS AllSource

サマリー

ジオプロセシングツールがデータベースまたはエンタープライズジオデータベースへの接続に使用できる接続文字列を作成します。

使用法

データベースまたはエンタープライズジオデータベースのデータセットを使用する自動化されたジオプロセシングワークフロー (スクリプトまたはモデル) がある場合、接続ファイルの代わりにこのツールを使用します。接続ファイルのワークスペースを介してデータベースのパスを使用するのではなく、指定したデータセットタイプをサポートする任意のジオプロセシングツールの入力として使用できる接続文字列を生成できます。
ArcGIS から Altibase および Netezza への接続は、サポートされなくなりました。

パラメーター

ラベル	説明	データタイプ
データベースプラットフォーム	接続先のデータベースプラットフォームを指定します。 SQL Server—Microsoft SQL Server または Microsoft Azure SQL データベースに接続します。 Oracle—Oracle に接続します。 Db2—IBM DB2 (Linux、UNIX、Windows) に接続します。 PostgreSQL—PostgreSQL に接続します。 Teradata—Teradata データウェアハウスアプライアンスに接続します。 SAP HANA—SAP HANA に接続します。 Dameng—Dameng に接続します。	String
インスタンス	接続先のデータベースサーバーまたはインスタンス。このパラメーター値は、選択された [データベースプラットフォーム] パラメーターの値によって異なります。	String
データベース認証 (オプション)	使用される認証のタイプを指定します。データベース認証—データベース認証が使用されます。内部データベースユーザー名およびパスワードが、データベースへの接続に使用されます。コネクションを作成するときにユーザー名とパスワードを入力する必要はありませんが、入力していない場合は、コネクションが確立されたときにユーザー名とパスワードを入力するよう求められます。これがデフォルトです。注意: 作成する接続ファイルによって、ArcGIS サービスにデータベースまたはジオデータベースへのアクセス権限が付与される場合、またはカタログ検索を使用してこの接続ファイル経由でアクセスするデータを検索する場合は、ユーザー名およびパスワードを入力する必要があります。オペレーティングシステム認証—オペレーティングシステム認証が使用されます。ユーザー名とパスワードを入力する必要はありません。オペレーティングシステムへのログインで使用されたユーザー名とパスワードを使ってコネクションが作成されます。オペレーティングシステムで使用したログイン情報がジオデータベースへのログインで無効な場合、コネクションは確立されません。	Boolean
Username (オプション)	データベース認証で使用されるデータベースユーザー名。	String
パスワード (オプション)	データベース認証で使用されるデータベースユーザーパスワード。	Encrypted String
データベース (オプション)	接続先のデータベースの名前。このパラメーターは、PostgreSQL および SQL Server プラットフォームにのみ適用されます。	String
データセットオブジェクト名 (オプション)	接続文字列が指すデータベース内のデータセットまたはオブジェクトの名前。この接続文字列は、指定したデータセットのパスとして使用できます。	String
データタイプ (オプション)	データセットオブジェクト名で参照されるデータセットまたはオブジェクトのタイプ。データベース内に同じ名前を持つ複数のオブジェクトが存在する場合、接続文字列を作成するオブジェクトのデータタイプの指定が必要になることがあります。	String
ターゲットフィーチャデータセット (オプション)	接続文字列を作成するデータセットまたはオブジェクトを含んでいるフィーチャデータセットの名前。データセットがフィーチャデータセットに含まれていない場合 (たとえば、データベースのルートにある場合) は、ターゲットフィーチャデータセットを指定しないでください。	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

派生した出力

ラベル	説明	データタイプ
CIMDATA 接続文字列	CIMDATA 接続文字列。	String

arcpy.management.CreateDatabaseConnectionString(database_platform, instance, {account_authentication}, {username}, {password}, {database}, {object_name}, {data_type}, {feature_dataset}, {schema}, {version_type}, {version}, {date})

名前	説明	データタイプ
database_platform	接続先のデータベースプラットフォームを指定します。 SQL_SERVER—Microsoft SQL Server または Microsoft Azure SQL データベースに接続します。 ORACLE—Oracle に接続します。 DB2—IBM DB2 (Linux、UNIX、Windows) に接続します。 POSTGRESQL—PostgreSQL に接続します。 TERADATA—Teradata データウェアハウスアプライアンスに接続します。 SAP HANA—SAP HANA に接続します。 DAMENG—Dameng に接続します。	String
instance	接続先のデータベースサーバーまたはインスタンス。このパラメーター値は、選択された [データベースプラットフォーム] パラメーターの値によって異なります。	String
account_authentication (オプション)	使用される認証のタイプを指定します。 DATABASE_AUTH—データベース認証が使用されます。内部データベースユーザー名およびパスワードが、データベースへの接続に使用されます。コネクションを作成するときにユーザー名とパスワードを入力する必要はありませんが、入力していない場合は、コネクションが確立されたときにユーザー名とパスワードを入力するよう求められます。これがデフォルトです。注意: 作成する接続ファイルによって、ArcGIS サービスにデータベースまたはジオデータベースへのアクセス権限が付与される場合、またはカタログ検索を使用してこの接続ファイル経由でアクセスするデータを検索する場合は、ユーザー名およびパスワードを入力する必要があります。 OPERATING_SYSTEM_AUTH—オペレーティングシステム認証が使用されます。ユーザー名とパスワードを入力する必要はありません。オペレーティングシステムへのログインで使用されたユーザー名とパスワードを使ってコネクションが作成されます。オペレーティングシステムで使用したログイン情報がジオデータベースへのログインで無効な場合、コネクションは確立されません。	Boolean
username (オプション)	データベース認証で使用されるデータベースユーザー名。	String
password (オプション)	データベース認証で使用されるデータベースユーザーパスワード。	Encrypted String
database (オプション)	接続先のデータベースの名前。このパラメーターは、PostgreSQL および SQL Server プラットフォームにのみ適用されます。	String
object_name (オプション)	接続文字列が指すデータベース内のデータセットまたはオブジェクトの名前。この接続文字列は、指定したデータセットのパスとして使用できます。	String
data_type (オプション)	データセットオブジェクト名で参照されるデータセットまたはオブジェクトのタイプ。データベース内に同じ名前を持つ複数のオブジェクトが存在する場合、接続文字列を作成するオブジェクトのデータタイプの指定が必要になることがあります。	String
feature_dataset (オプション)	接続文字列を作成するデータセットまたはオブジェクトを含んでいるフィーチャデータセットの名前。データセットがフィーチャデータセットに含まれていない場合 (たとえば、データベースのルートにある場合) は、ターゲットフィーチャデータセットを指定しないでください。	String
schema (オプション)	接続先のユーザースキーマジオデータベース。このオプションは、ユーザースキーマジオデータベースのある Oracle データベースにのみ適用されます。このパラメーターのデフォルト値は、sde スキーマ (マスター) ジオデータベースの使用です。	String
version_type (オプション)	接続先のバージョンのタイプを指定します。このパラメーターは、ジオデータベースに接続する場合にのみ適用されます。 TRANSACTIONAL—トランザクションバージョンに接続します。 [トランザクション] が選択された場合、[次のバージョンを使用する] パラメーターがトランザクションバージョンのリストを使用して入力され、[日時] パラメーターが無効になります。これがデフォルトです。 HISTORICAL—履歴マーカーに接続します。 [履歴] が選択された場合、[次のバージョンを使用する] パラメーターが履歴マーカーのリストを使用して入力され、[日時] パラメーターが無効になります。 POINT_IN_TIME—特定時点に接続します。 [時点] が選択された場合、[次のバージョンを使用する] パラメーターが無効になり、[日時] パラメーターが有効になります。 BRANCH—デフォルトのブランチバージョンに接続します。注意: [履歴] が選択され、名前が入力されていない場合、デフォルトのトランザクションバージョンが使用されます。 [時点] が選択され、[日時] パラメーターに日付が入力されていない場合、デフォルトのトランザクションバージョンが使用されます。	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_connection_string	CIMDATA 接続文字列。	String

コードのサンプル

CreateDatabaseConnectionString (データベース接続文字列の作成) の例 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、イミディエイトモードで CreateDatabaseConnectionString 関数を使用する方法を示しています。

import arcpy
data_conn_str = arcpy.CreateDatabaseConnectionString_management("SQL_SERVER",
                                          "utah",
                                          "DATABASE_AUTH",
                                          "gdb",
                                          "gdb", 
                                          "",
                                          "gdb.roads")
arcpy.Buffer_analysis(data_conn_str, r"c:\temp\Buffers.shp", "10 Miles")

環境

現在のワークスペース

サマリー

使用法

パラメーター

注意:

注意:

注意:

派生した出力

注意:

注意:

注意:

派生した出力

コードのサンプル

環境

関連トピック

このトピックの内容