Сводка
Создает базу данных, хранилища и пользователя, обладающего правами администратора и владельца базы геоданных. Функциональные возможности базы геоданных зависят от используемой СУБД. Инструмент предоставляет администратору базы геоданных полномочия, необходимые для создания базы геоданных, а затем создает базу геоданных в базе данных.
Использование
В следующей таблице описана функциональность инструмента для каждого типа системы управления базами данных:
Функция СУБД Создает базу данных
PostgreSQL и Microsoft SQL Server
Создает табличное пространство
Oracle
Создает администратора базы геоданных в базе данных
Oracle, PostgreSQL и SQL Server
Инструмент создает пользователя в SQL Server, только если вы создаете базу геоданных со схемой sde.
Предоставляет администратору базы геоданных права, необходимые для создания базы геоданных, обновления базы геоданных и удаления подключений к базе данных
Oracle и PostgreSQL
Предоставляет администратору базы геоданных права, необходимые для создания базы геоданных и удаления подключений к базе данных
SQL Server (при создании базы геоданных с sde-схемой)
Предоставляет администратору права доступа, необходимые для импорта данных с помощью Oracle Data Pump
Oracle 12c и более новые версии
Создает базу геоданных в указанной базе данных
Oracle, PostgreSQL и SQL Server
На компьютере, где вы хотите создать базу геоданных, должен быть установлен ArcGIS Desktop (Standard или Advanced), ArcGIS Pro (Standard или Advanced), ArcGIS Engine с дополнительным модулем Geodatabase Update или ArcGIS Server. Если вы используете Oracle или SQL Server, также необходимо установить и настроить клиент СУБД на компьютере, где установлен клиент ArcGIS.
Необходимо настроить библиотеку st_geometry прежде чем приступить к созданию базы геоданных в Oracle. Подробнее см. в разделе Создание базы геоданных в Oracle.
Перед созданием базы геоданных в PostgreSQL необходимо поместить файл библиотеки st_geometry на сервер PostgreSQL. Подробнее см. в разделах Создание базы геоданных в PostgreSQL на Linux или Создание базы геоданных в PostgreSQL на Windows.
Этот инструмент не поддерживается сервисами базы данных.
После создания базы геоданных вы не сможете переименовать базу данных, в которой она хранится. Имя базы данных хранится в системных таблицах базы геоданных и используется в полных именах таблиц и классов объектов; поэтому изменение имени базы данных с помощью ее инструментов делает данные базы геоданных недоступными.
Синтаксис
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, {spatial_type})| Параметр | Объяснение | Тип данных |
database_platform | Укажите тип СУБД, к которой вы подключаетесь для создания базы геоданных.
| String |
instance_name | Имя экземпляра. Для SQL Server, введите имя экземпляра SQL Server. Чувствительные к регистру экземпляры SQL Server, а также экземпляры с двойным сравнением не поддерживаются. Для Oracle укажите имя TNS или строку подключения Oracle Easy Connection. Для PostgreSQL введите имя сервера, где установлен PostgreSQL. | String |
database_name (Дополнительный) | Имя базы данных. Этот параметр действителен для PostgreSQL и SQL Server. Вы можете либо ввести имя существующей предварительно настроенной базы данных, либо имя базы данных, которую создаст инструмент. Если инструмент создает базу данных в SQL Server, размеры файлов либо будут совпадать с заданными вами размерами для базы данных модели SQL Server, либо будут равны 500 Мб для файла .mdf и 125 Мб для файла .ldf, в зависимости от того, что больше. Файлы .mdf и .ldf создаются в расположении SQL Server по умолчанию на сервере базы данных. Не называйте базу данных sde. Если инструмент создает базу данных в PostgreSQL, база данных template1 будет использоваться в качестве шаблона для вашей базы данных. Если вам требуется другой шаблон - например, шаблон, подготовленный для PostGIS - следует создать базу данных перед запуском этого инструмента и указать имя имеющейся базы данных. Имя базы данных всегда задается символами нижнего регистра. Если вы используете символы верхнего регистра, инструмент конвертирует их в нижний. | String |
account_authentication (Дополнительный) | Задает тип аутентификации, который будет использоваться для подключения к базе данных.
| Boolean |
database_admin (Дополнительный) | Если вы используете аутентификацию в базе данных, укажите администратора базы данных. Для Oracle используйте пользователя sys. Для PostgreSQL укажите пользователя со статусом superuser. Для SQL Server укажите любого пользователя фиксированной серверной ролью sysadmin. | String |
database_admin_password (Дополнительный) | Если вы используете аутентификацию базы данных, введите пароль администратора базы данных. | Encrypted String |
sde_schema (Дополнительный) | Этот параметр относится только к SQL Server и указывает, создается ли база геоданных в схеме пользователя sde или в схеме dbo базы данных. При создании базы геоданных по схеме dbo, подключитесь как пользователь dbo в экземпляре SQL Server.
| Boolean |
gdb_admin_name (Дополнительный) | Имя пользователя администратора базы геоданных. При использовании PostgreSQL, это значение должно быть sde. Если роль учетной записи sde не существует, этот инструмент создаст ее и предоставит ей статус superuser в кластере базы данных. Если роль учетной записи sde существует, этот инструмент предоставляет для этой роли статус superuser, если он ей еще не предоставлен. Инструмент также создает в базе данных схему sde и предоставляет к ней права usage для всех. Если вы используете Oracle, значение sde. Если пользователь sde отсутствует в базе данных Oracle, инструмент создает пользователя и предоставляет ему права доступа, необходимые для создания и обновления базы геоданных, а также для отключения пользователей от базы данных. Если вы запускаете этот инструмент в базу данных Oracle 12c или выше, он также предоставляет права доступа, необходимые для импорта данных с помощью Oracle Data Pump. Если пользователь sde уже существует, инструмент предоставит ему те же самые права. Если вы используете SQL Server и выбрали базу геоданных с sde-схемой, это значение должно быть sde. Инструмент создает учетную запись sde, пользователя базы данных и схему, после чего наделяет ее правами для создания базы геоданных и удаления подключений из экземпляра SQL Server. Если указана схема dbo, не задавайте значение этого параметра. | String |
gdb_admin_password (Дополнительный) | Пароль пользователя - администратора базы геоданных. Если администратор базы геоданных в СУБД уже существует, введенный пароль должен совпадать с существующим паролем. Если администратор базы геоданных не существует, введите допустимый пароль базы данных для нового пользователя. Пароль должен соответствовать требованиям парольной политики СУБД. Пароль – это зашифрованная строка. | Encrypted String |
tablespace_name (Дополнительный) | Имя табличного пространства. Этот параметр действителен только для СУБД Oracle и PostgreSQL. Для Oracle выполните одно из следующего:
Этот инструмент не создает табличное пространство в 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 |
spatial_type (Дополнительный) | Указывает, какой пространственный тип будет использоваться. Применимо только для баз данных PostgreSQL.
| String |
Производные выходные данные
| Имя | Объяснение | Тип данных |
| out_result | Показывает успешность создания многопользовательской базы геоданных. | Boolean |
Пример кода
CreateEnterpriseGeodatabase, пример 1 (окно Python)
Следующий скрипт создает базу геоданных в базе данных Oracle. Он также создает пользователя sde и табличное пространство по умолчанию (sdetbs) для этого пользователя. Файл ключей расположен на удаленном сервере Linux.
import arcpy
arcpy.CreateEnterpriseGeodatabase_management(
"ORACLE", "ora11g:1521/elf", "", "DATABASE_AUTH", "sys",
"manager", "", "sde", "supersecret", "sdetbs",
"//myserver/mymounteddrive/myaccessibledirectory/keycodes")
CreateEnterpriseGeodatabase, пример 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")
CreateEnterpriseGeodatabase, пример 3 (окно Python)
Этот скрипт подключается к кластеру базы данных PostgreSQL на сервере feldspar. Пользователь sde создается для базы данных pggdb в существующем табличном пространстве gdbspace. Файл ключей расположен на локальном сервере 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")
CreateEnterpriseGeodatabase, пример 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: Да