ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • ヘルプ
  • Sign Out
ArcGIS Desktop

ArcGIS Online

組織のマッピング プラットフォーム

ArcGIS Desktop

完全なプロ仕様の GIS

ArcGIS Enterprise

エンタープライズ GIS

ArcGIS Developers

位置情報利用アプリの開発ツール

ArcGIS Solutions

各種業界向けの無料のテンプレート マップおよびテンプレート アプリケーション

ArcGIS Marketplace

組織で使えるアプリとデータを取得

  • ドキュメント
  • サポート
Esri
  • サイン イン
user
  • マイ プロフィール
  • サイン アウト

ArcMap

  • ホーム
  • はじめに
  • マップ
  • 解析
  • データ管理
  • ツール
  • エクステンション

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

  • 概要
  • 使用法
  • 構文
  • コードのサンプル
  • 環境
  • ライセンス情報

概要

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

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

  • DAMENG —Dameng への接続。
  • DB2 —IBM Db2 (Linux、UNIX、Windows) への接続。
  • DB2ZOS —IBM Db2 (z オペレーティング システム) への接続。
  • INFORMIX —IBM Informix への接続。
  • ORACLE —Oracle か Amazon Relational Database Service (RDS) for Oracle に接続します。
  • POSTGRESQL —PostgreSQL、Amazon Aurora (PostgreSQL-compatible edition)、Amazon Relational Database Service (RDS) for PostgreSQL、または Microsoft Azure Database for PostgreSQL への接続。
  • SAP HANA —SAP HANA への接続。
  • SQL_SERVER —Microsoft SQL Server、Microsoft Azure SQL Database、Microsoft Azure SQL Managed Instance、または Amazon Relational Database Service (RDS) for SQL Server への接続。
  • TERADATA —Teradata Data Warehouse Appliance への接続。
String
instance

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

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

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

  • Dameng - Dameng データベースがインストールされているサーバー名
  • Db2 - カタログに表示される Db2 データベース名
  • Db2 for z/OS - カタログに表示される Db2 データベース名
  • Informix - Informix データベースの ODBC (Open Database Connectivity) データ ソース名
  • Oracle - Oracle データベースに接続する TNS 名または Oracle 簡易接続文字列
  • PostgreSQL - PostgreSQL がインストールされているサーバーの名前または PostgreSQL データベース サービス インスタンスの名前
  • SAP HANA - SAP HANA データベースの ODBC データ ソース名
  • 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 —トランザクション バージョンに接続します。
  • HISTORICAL —履歴マーカーに接続します。
  • POINT_IN_TIME —特定時点に接続します。 POINT_IN_TIME を使用する場合、version パラメーターは無視されます。

メモ:

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: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック

  • ワークスペース ツールセットの概要

ArcGIS Desktop

  • ホーム
  • ドキュメント
  • サポート

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

Esri について

  • 会社概要
  • 採用情報
  • Esri ブログ
  • ユーザ カンファレンス
  • デベロッパ サミット
Esri
ご意見・ご感想をお寄せください。
Copyright © 2021 Esri. | プライバシー | リーガル