エンタープライズ ジオデータベースの作成 (Create Enterprise Geodatabase) (データ管理)

概要

データベース、格納場所、およびジオデータベース管理者またはジオデータベースの所有者としての役割を果たすデータベース ユーザーを作成します。機能は、使用されるデータベース管理システムによって異なります。このツールは、まずジオデータベース管理者にジオデータベースの作成に必要な権限を与えます。次にデータベースにジオデータベースを作成します。

使用法

  • 次の表は、各データベース管理システム (DBMS) におけるツールの機能を示しています。

    機能DBMS

    データベースの作成

    PostgreSQLMicrosoft SQL Server

    表領域の作成

    Oracle

    データベースにジオデータベース管理ユーザーを作成

    OraclePostgreSQL、および SQL Server

    sde スキーマのジオデータベースを作成した場合、このツールは SQL Server のユーザーしか作成しないので注意してください。

    ジオデータベースの作成、ジオデータベースのアップグレードおよびデータベース接続の切断に必要なジオデータベース管理者権限を付与します。

    OraclePostgreSQL

    ジオデータベースの作成およびデータベース接続の切断に必要なジオデータベース管理者権限の付与

    SQL Server (sde スキーマのジオデータベースを作成する場合)

    Oracle Data Pump を使用してデータをインポートするために必要な権限をジオデータベース管理者に付与します。

    Oracle 12c

    指定されたデータベースにジオデータベースを作成

    OraclePostgreSQL、および SQL Server

  • ジオデータベースを作成するコンピューターには、ArcGIS Desktop (Standard または Advanced)、ArcGIS Engine と Geodatabase Update エクステンション、または ArcGIS Server をインストールしておく必要があります。また、Oracle または SQL Server を使用する場合は、ArcGIS クライアントがインストールされているコンピューターで、データベース管理システム クライアントをインストールして構成する必要もあります。

  • Oracle 内にジオデータベースを作成する前に、My Esri から DatabaseSupport.zip ファイル (Windows) または DatabaseSupport.tar ファイル (Linux) をダウンロードして、st_shapelib ライブラリ (Windows) または libst_shapelib ライブラリ (Linux) を取得する必要があります。そのライブラリを Oracle サーバー上に配置します。必ず、Oracle がインストールされているオペレーティング システムに適したライブラリをコピーしてください。

  • PostgreSQL 内にジオデータベースを作成する前に、My Esri から DatabaseSupport.zip ファイル (Windows) または DatabaseSupport.tar ファイル (Linux) をダウンロードして、st_geometry ライブラリを取得する必要があります。そのライブラリを PostgreSQL サーバー上の %PostgreSQL%\lib ディレクトリ (Windows) または $PKGLIBDIR ディレクトリ (Linux) に配置します。必ず、使用している PostgreSQL のバージョンと PostgreSQL がインストールされているオペレーティング システムに適したライブラリをコピーしてください。

  • このツールは、Amazon Relational Database Service (RDS) for PostgreSQLAmazon RDS for SQL ServerAmazon Aurora PostgreSQLMicrosoft Azure SQL DatabaseMicrosoft Azure Database for PostgreSQL ではサポートされていません。

  • ジオデータベースの作成後、そのジオデータベースが格納されているデータベースの名前を変更することはできません。データベース名は、ジオデータベース システム テーブルに格納され、テーブル名とフィーチャクラス名を完全修飾するために使用されます。そのため、データベース ツールを使用してデータベース名を変更すると、ジオデータベースのデータにアクセスできなくなります。

構文

arcpy.management.CreateEnterpriseGeodatabase(database_platform, instance_name, {database_name}, {account_authentication}, {database_admin}, {database_admin_password}, {sde_schema}, {gdb_admin_name}, {gdb_admin_password}, {tablespace_name}, authorization_file)
パラメーター説明データ タイプ
database_platform

ジオデータベースを作成するために接続する、データベース管理システムの種類を指定します。

  • OracleOracle インスタンスに接続します。
  • PostgreSQLPostgreSQL データベース クラスターに接続します。
  • SQL_Server Microsoft SQL Server インスタンスに接続します。
String
instance_name

SQL Server の場合は、SQL Server インスタンス名を指定します。大文字/小文字が区別される照合順序とバイナリ照合順序の SQL Server インスタンスはサポートされていません。

Oracle の場合は、TNS 名または Oracle 簡易接続文字列を指定します。

PostgreSQL の場合は、PostgreSQL がインストールされているサーバーの名前を指定します。

String
database_name
(オプション)

このパラメーターは、PostgreSQLSQL Server に有効です。すでに構成されている既存のデータベースの名前を入力するか、このツールで作成されるデータベースの名前を入力することができます。

このツールを使用して SQL Server にデータベースを作成する場合、ファイル サイズは SQL Server のデータベースに対して定義されたサイズまたは 500 MB (MDF ファイルの場合) / 125 MB (LDF ファイルの場合) のどちらか大きい方になります。MDF ファイルと LDF ファイルはいずれも、データベース サーバー上のデフォルトの SQL Server の場所に作成されます。

このツールを使用して PostgreSQL にデータベースを作成する場合は、template1 データベースがデータベースのテンプレートとして使用されます。別のテンプレートが必要な場合 (たとえば、PostGIS に有効なテンプレート)、このツールを実行する前にデータベースを作成し、既存のデータベースの名前を指定する必要があります。データベース名には必ず小文字を使用します。大文字を使用すると、このツールで小文字に変換されます。

String
account_authentication
(オプション)

データベース接続に使用する認証の種類を指定します。

  • OPERATING_SYSTEM_AUTHオペレーティング システム認証を使用します。このツールを実行しているコンピューターで指定したログイン情報がデータベース接続の認証に使用されます。 データベース管理システムがオペレーティング システム認証を許可するように構成されていないと、認証に失敗します。
  • DATABASE_AUTHデータベース認証を使用します。データベースの認証のために、有効なデータベース ユーザー名とパスワードを指定する必要があります。これがデフォルトです。 データベース管理システムがデータベース認証を許可するように構成されていないと、認証に失敗します。
Boolean
database_admin
(オプション)

データベース認証を使用する場合は、データベース管理者ユーザーを指定します。Oracle の場合は、sys ユーザーを使用します。PostgreSQL の場合は、ステータスがスーパーユーザーのユーザーを指定します。SQL Server の場合は、sysadmin 固定サーバー ロールのメンバーを指定します。

String
database_admin_password
(オプション)

データベース認証を使用する場合、データベース管理者のパスワードを入力します。

Encrypted String
sde_schema
(オプション)

このパラメーターは SQL Server にのみ適用され、ジオデータベースをデータベース内に sde ユーザーのスキーマで作成するか、dbo スキーマで作成するかを指定します。dbo スキーマのジオデータベースを作成する場合は、SQL Server インスタンス内で dbo であるユーザーとして接続します。

  • SDE_SCHEMAジオデータベース リポジトリは sde というユーザーに所有され、そのスキーマに格納されます。これがデフォルトです。
  • DBO_SCHEMAジオデータベース リポジトリはデータベースの dbo スキーマに格納されます。
Boolean
gdb_admin_name
(オプション)

PostgreSQL を使用する場合は、この値を sde にする必要があります。sde ログイン ロールが存在しない場合、このツールはロールを作成し、それにデータベース クラスターのスーパーユーザー ステータスを付与します。sde ログイン ロールが存在する場合、このロールにスーパーユーザー ステータスが付与されていない場合は付与します。また、このツールは、データベース内に sde スキーマも作成し、スキーマでの使用権限を一般ユーザーに付与します。

Oracle を使用する場合、この値は sde です。sde ユーザーが Oracle データベース内に存在しない場合は、[エンタープライズ ジオデータベースの作成 (Create Enterprise Geodatabase)] ツールでこのユーザーが作成され、ジオデータベースの作成およびアップグレードとデータベースからのユーザーの接続の切断に必要な権限がこのユーザーに付与されます。このツールを Oracle 12c または 18c データベースで実行すると、Oracle Data Pump でのデータのインポートを許可する権限も付与されます。sde ユーザーがすでに存在する場合は、このツールで同じ権限が既存のユーザーに付与されます。

メモ:

ArcGIS 10.7 および ArcGIS Pro 2.3 以降、Oracle でユーザースキーマ ジオデータベースを作成できなくなりました。

SQL Server を使用しており、sde スキーマのジオデータベースを指定した場合は、この値を sde にする必要があります。このツールは、sde ログイン、データベース ユーザー、およびスキーマを作成し、ジオデータベースを作成する権限と SQL Server インスタンスへの接続を切断する権限を付与します。dbo スキーマを指定した場合、このパラメーターに値を指定しないでください。

String
gdb_admin_password
(オプション)

ジオデータベース管理者ユーザーのパスワード。ジオデータベース管理者ユーザーがすでにデータベース管理システムに存在する場合は、指定するパスワードが既存のパスワードと一致しなければなりません。ジオデータベース管理者ユーザーがまだ存在していない場合、新規ユーザーのための有効なデータベース パスワードを入力します。パスワードは、データベースで設定されたパスワード ポリシーを満たしている必要があります。

パスワードは、暗号化された文字列です。

Encrypted String
tablespace_name
(オプション)

このパラメーターは、DBMS タイプが Oracle および PostgreSQL の場合にのみ有効です。Oracle の場合は、次のいずれかを実行します。

  • 既存の表領域の名前を指定します。これは、ジオデータベース管理者ユーザーのデフォルトの表領域として使用されます。
  • 新しい表領域に有効な名前を入力します。このツールは、400 MB の表領域を Oracle のデフォルトの格納場所に作成し、ジオデータベース管理者のデフォルトの表領域として設定します。
  • 表領域を空白のままにすると、このツールは SDE_TBS という名前の 400 MB の表領域を Oracle のデフォルトの格納場所に作成します。SDE_TBS 表領域は、ジオデータベース管理者のデフォルトの表領域として設定されます。

このツールは、表領域を PostgreSQL に作成しません。既存の表領域の名前を指定してデータベースのデフォルトの表領域として使用するか、このパラメーターを空白にしておく必要があります。パラメーターを空白のままにした場合、ツールによって pg_default 表領域にデータベースが作成されます。

String
authorization_file

ArcGIS Server を認証した際に作成されたキーコード ファイルのパスとファイル名。このファイルは、\\Program Files\ESRI\License<release#>\sysgen フォルダー (Windows の場合) または /arcgis/server/framework/runtime/.wine/drive_c/Program Files/ESRI/License<release#>/sysgen ディレクトリ (Linux の場合) にあります。このファイルをまだ作成していない場合には、ArcGIS Server を認証して作成します。

キーコード ファイルを ArcGIS Server コンピューターからツールがアクセスできる場所にコピーする必要がある場合があります。

File

派生した出力

名前説明データ タイプ
out_result

エンタープライズ ジオデータベースが正常に作成されたかどうかを示します。

Boolean

コードのサンプル

CreateGeodatabase (ジオデータベースの作成) の例 1 (Python ウィンドウ)

次のスクリプトは、ジオデータベースを Oracle データベース内に作成します。sde ユーザーを作成し、sde ユーザーに対してデフォルトの表領域である sdetbs を作成します。キーコード ファイルは、リモート Linux サーバー上にあります。

import arcpy
arcpy.CreateEnterpriseGeodatabase_management(
    "ORACLE", "ora11g:1521/elf", "", "DATABASE_AUTH", "sys", 
    "manager", "", "sde", "supersecret", "sdetbs", 
    "//myserver/mymounteddrive/myaccessibledirectory/keycodes")
CreateGeodatabase (ジオデータベースの作成) の例 2 (Python ウィンドウ)

このスクリプトは、SQL Server のインスタンス (tor\ssinstance) に接続し、sp_data という名前のデータベースを作成して、そのデータベース内に sde スキーマのジオデータベースを作成します。オペレーティング システム認証を使用して接続します。キーコード ファイルは、リモート Windows サーバー上にあります。

import arcpy
arcpy.CreateEnterpriseGeodatabase_management(
    "SQL_SERVER", "tor\ssinstance1", "sp_data", "OPERATING_SYSTEM_AUTH", "", "", 
    "SDE_SCHEMA", "sde", "sde", "", "//myserver/myaccessibledirectory/keycodes")
CreateGeodatabase (ジオデータベースの作成) の例 3 (Python ウィンドウ)

このスクリプトは、feldspar という名前のサーバー上の PostgreSQL データベース クラスターに接続します。既存の表領域 gdbspace に sde ユーザーとデータベース pggdb が作成されます。キーコード ファイルは、ローカル Linux サーバー上にあります。

import arcpy arcpy.CreateEnterpriseGeodatabase_management(    "POSTGRESQL", "feldspar", "pggdb", "DATABASE_AUTH", "postgres", "averturis",     "", "sde", "nomira", "gdbspace", 
    "//arcgis/server/framework/runtime/.wine/drive_c/Program Files/ESRI/License/sysgen/keycodes")
CreateGeodatabase (ジオデータベースの作成) の例 4 (スタンドアロン スクリプト)

次のスタンドアロン Python スクリプトにより、オプションを使用して各サイトに固有の情報を提供できます。

"""
Name: create_enterprise_gdb.py
Description: Provide connection information to a DBMS instance and create an enterprise geodatabase.
Type  create_enterprise_gdb.py -h or create_enterprise_gdb.py --help for usage
"""

# Import system modules
import arcpy
import os
import optparse
import sys


# Define usage and version
parser = optparse.OptionParser(usage = "usage: %prog [Options]", version="%prog 1.0 for " + arcpy.GetInstallInfo()['Version'] )

#Define help and options
parser.add_option ("--DBMS", dest="Database_type", type="choice", choices=['SQL_SERVER', 'ORACLE', 'POSTGRESQL', ''], default="", help="Type of enterprise DBMS:  SQL_SERVER, ORACLE, or POSTGRESQL.")                   
parser.add_option ("-i", dest="Instance", type="string", default="", help="DBMS instance name")
parser.add_option ("-D", dest="Database", type="string", default="none", help="Database name:  Do not specify for Oracle")
parser.add_option ("--auth", dest="Account_authentication", type ="choice", choices=['DATABASE_AUTH', 'OPERATING_SYSTEM_AUTH'], default='DATABASE_AUTH', help="Authentication type options (case-sensitive):  DATABASE_AUTH, OPERATING_SYSTEM_AUTH.  Default=DATABASE_AUTH")
parser.add_option ("-U", dest="Dbms_admin", type="string", default="", help="DBMS administrator user")
parser.add_option ("-P", dest="Dbms_admin_pwd", type="string", default="", help="DBMS administrator password")
parser.add_option ("--schema", dest="Schema_type", type="choice", choices=['SDE_SCHEMA', 'DBO_SCHEMA'], default="SDE_SCHEMA", help="Schema type  applies to geodatabases in SQL Server only. Type SDE_SCHEMA to create geodatabase in SDE schema or type DBO_SCHEMA to create geodatabase in DBO schema. Default=SDE_SCHEMA")
parser.add_option ("-u", dest="Gdb_admin", type="string", default="", help="Geodatabase administrator user name; Must always be sde for PostgreSQL, sde-schema geodatabases in SQL Server, and sde geodatabase in Oracle")
parser.add_option ("-p", dest="Gdb_admin_pwd", type="string", default="", help="Geodatabase administrator password")
parser.add_option ("-t", dest="Tablespace", type="string", default="", help="Tablespace name; For PostgreSQL, type name of existing tablespace in which to store database. If no tablespace name specified, pg_default is used. For Oracle, type name of existing tablespace, or, if tablespace with specified name does not exist, it will be created and set as the default tablespace for the sde user. If no tablespace name is specified, SDE_TBS tablespace is created and set as sde user default. Tablespace name not supported for SQL Server.")
parser.add_option ("-l", dest="Authorization_file", type="string", default="", help="Full path and name of authorization file; file created when ArcGIS Server Enterprise authorized, and stored in \\Program Files\ESRI\License<release#>\sysgen on Windows or /arcgis/server/framework/runtime/.wine/drive_c/Program Files/ESRI/License<release#>/sysgen on Linux")
# Check if value entered for option
try:
	(options, args) = parser.parse_args()

	
	#Check if no system arguments (options) entered
	if len(sys.argv) == 1:
		print("%s: error: %s\n" % (sys.argv[0], "No command options given"))
		parser.print_help()
		sys.exit(3)

	#Usage parameters for spatial database connection
	database_type = options.Database_type.upper()
	instance = options.Instance
	database = options.Database.lower()	
	account_authentication = options.Account_authentication.upper()
	dbms_admin = options.Dbms_admin
	dbms_admin_pwd = options.Dbms_admin_pwd
	schema_type = options.Schema_type.upper()
	gdb_admin = options.Gdb_admin
	gdb_admin_pwd = options.Gdb_admin_pwd	
	tablespace = options.Tablespace
	license = options.Authorization_file

	
	if( database_type ==""):	
		print(" \n%s: error: \n%s\n" % (sys.argv[0], "DBMS type (--DBMS) must be specified."))
		parser.print_help()
		sys.exit(3)		
		
	if (license == ""):
		print(" \n%s: error: \n%s\n" % (sys.argv[0], "Authorization file (-l) must be specified."))
		parser.print_help()
		sys.exit(3)			
	
	if(database_type == "SQL_SERVER"):
		if(schema_type == "SDE_SCHEMA" and gdb_admin.lower() != "sde"):
			print("\n%s: error: %s\n" % (sys.argv[0], "To create SDE schema on SQL Server, geodatabase administrator must be SDE."))
			sys.exit(3)
		if (schema_type == "DBO_SCHEMA" and gdb_admin != ""):
			print("\nWarning: %s\n" % ("Ignoring geodatabase administrator specified when creating DBO schema..."))
		if( account_authentication == "DATABASE_AUTH" and dbms_admin == ""):
			print("\n%s: error: %s\n" % (sys.argv[0], "DBMS administrator must be specified with database authentication"))
			sys.exit(3)
		if( account_authentication == "OPERATING_SYSTEM_AUTH" and dbms_admin != ""):
			print("\nWarning: %s\n" % ("Ignoring DBMS administrator specified when using operating system authentication..."))
	else:
		if (schema_type == "DBO_SCHEMA"):
			print("\nWarning: %s %s, %s\n" % ("Only SDE schema is supported on", database_type, "switching to SDE schema..." ))
			
		if( gdb_admin.lower() == ""):
			print("\n%s: error: %s\n" % (sys.argv[0], "Geodatabase administrator must be specified."))
			sys.exit(3)

		if( gdb_admin.lower() != "sde"):
			if (database_type == "ORACLE"):
				print("\nGeodatabase admin user is not SDE, creating user schema geodatabase on Oracle...\n")
			else:
				print("\n%s: error: %s for %s.\n" % (sys.argv[0], "Geodatabase administrator must be SDE", database_type))
				sys.exit(3)
			
		if( dbms_admin == ""):
			print("\n%s: error: %s\n" % (sys.argv[0], "DBMS administrator must be specified!"))
			sys.exit(3)

		if (account_authentication == "OPERATING_SYSTEM_AUTH"):
			print("Warning: %s %s, %s\n" % ("Only database authentication is supported on", database_type, "switching to database authentication..." ))

	# Get the current product license
	product_license=arcpy.ProductInfo()
	
	
	# Checks required license level
	if product_license.upper() == "ARCVIEW" or product_license.upper() == 'ENGINE':
		print("\n" + product_license + " license found!" + " Creating an enterprise geodatabase requires an ArcGIS Desktop Standard or Advanced, ArcGIS Engine with the Geodatabase Update extension, or ArcGIS Server license.")
		sys.exit("Re-authorize ArcGIS before creating enterprise geodatabase.")
	else:
		print("\n" + product_license + " license available!  Continuing to create...")
		arcpy.AddMessage("+++++++++")
	
	
	try:
		print("Creating enterprise geodatabase...\n")
		arcpy.CreateEnterpriseGeodatabase_management(database_platform=database_type,instance_name=instance, database_name=database, account_authentication=account_authentication, database_admin=dbms_admin, database_admin_password=dbms_admin_pwd, sde_schema=schema_type, gdb_admin_name=gdb_admin, gdb_admin_password=gdb_admin_pwd, tablespace_name=tablespace, authorization_file=license)
		for i in range(arcpy.GetMessageCount()):
			arcpy.AddReturnMessage(i)
		arcpy.AddMessage("+++++++++\n")
	except:
		for i in range(arcpy.GetMessageCount()):
			arcpy.AddReturnMessage(i)
			
#Check if no value entered for option	
except SystemExit as e:
	if e.code == 2:
		parser.usage = ""
		print("\n")
		parser.print_help()   
		parser.exit(2)

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック