Resumen
Crea una base de datos, ubicaciones de almacenamiento y un usuario de bases de datos para que actúe como administrador y propietario de la geodatabase. La funcionalidad varía según el sistema de administración de bases de datos que se utilice. La herramienta concede los privilegios de administrador de geodatabase necesarios para crear una geodatabase y, a continuación, crea una geodatabase en la base de datos.
Uso
La siguiente tabla indica qué puede hacer la herramienta para cada tipo de sistema de administración de bases de datos (DBMS):
Función DBMS Crea una base de datos
PostgreSQL y Microsoft SQL Server
Crea un espacio de tabla
Oracle
Crea un usuario administrador de geodatabase en la base de datos
Oracle, PostgreSQL y SQL Server
Tenga en cuenta que la herramienta solo crea un usuario en SQL Server si crea una geodatabase sde-schema.
Otorga al administrador de geodatabase los privilegios requeridos para crear una geodatabase, actualizar una geodatabase y anular conexiones de base de datos
Oracle y PostgreSQL
Otorga al administrador de geodatabase los privilegios requeridos para crear una geodatabase y anular las conexiones de base de datos
SQL Server (si está creando una geodatabase de esquema sde)
Otorga al administrador de geodatabase los permisos necesarios para importar datos utilizando Oracle Data Pump
Oracle 12c
Crea una geodatabase en la base de datos específica
Oracle, PostgreSQL y SQL Server
Debe tener ArcGIS Desktop (Standard o Advanced), ArcGIS Engine con la extensión Geodatabase Update o ArcGIS Server instalado en el equipo en el que creará la geodatabase. Si utiliza Oracle y SQL Server, también debe instalar y configurar un cliente del sistema de administración de bases de datos en el equipo donde está instalado el cliente ArcGIS.
Para crear una geodatabase en Oracle, debe descargar el archivo DatabaseSupport.zip (Windows) o DatabaseSupport.tar (Linux) desde My Esri para obtener la biblioteca st_shapelib (Windows) o libst_shapelib (Linux). Coloque la biblioteca en el servidor de Oracle. Asegúrese de copiar la biblioteca correcta para el sistema operativo donde está instalado Oracle.
Para crear una geodatabase en PostgreSQL, debe descargar el archivo DatabaseSupport.zip (Windows) o DatabaseSupport.tar (Linux) desde My Esri para obtener la biblioteca st_geometry. Coloque la biblioteca en el directorio %PostgreSQL%\lib (Windows) o $PKGLIBDIR (Linux) en el servidor de PostgreSQL. Asegúrese de copiar la biblioteca correcta para la versión de PostgreSQL que esté utilizando y para el sistema operativo donde esté instalado PostgreSQL.
Esta herramienta no es compatible con servicios de base de datos tales como Amazon Relational Database Service (RDS) for PostgreSQL, Amazon RDS for SQL Server, Amazon Aurora PostgreSQL, Microsoft Azure SQL Database o Microsoft Azure Database for PostgreSQL.
Una vez que se haya creado la geodatabase, no podrá cambiar el nombre de la base de datos en la que está almacenada. El nombre de la base de datos está almacenado en las tablas del sistema de geodatabase y se utiliza para cualificar totalmente los nombres de tablas y clases de entidades. Por consiguiente, si se cambia el nombre de la base de datos utilizando herramientas de bases de datos, no se podrá acceder a los datos de la geodatabase.
Sintaxis
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)
Parámetro | Explicación | Tipo de datos |
database_platform | Especificar el tipo de sistema de administración de bases de datos al cual se conectará para crear una geodatabase.
| String |
instance_name | En el caso de SQL Server, indique el nombre de instancia SQL Server. No se admiten instancias de SQL Server de intercalación binaria o que distingan entre mayúsculas y minúsculas. En el caso de Oracle, proporcione el nombre TNS o cadena de caracteres de Oracle Easy Connection. En el caso de PostgreSQL, proporcione el nombre del servidor en el que está instalado PostgreSQL. | String |
database_name (Opcional) | Este parámetro es válido solo para PostgreSQL y SQL Server. Puede escribir el nombre de una base de datos existente, configurada previamente o el nombre de una base de datos que creará la herramienta. Si la herramienta crea la base de datos en SQL Server, los tamaños de archivo serán los mismos que los definidos para la base de datos de modelo SQL Server o 500 MB para el archivo MDF y 125 MB para el archivo LDF, lo que sea mayor. Tanto los archivos MDF como LDF se crean en la ubicación predeterminada de SQL Server en el servidor de base de datos. Si la herramienta crea la base de datos en PostgreSQL, utiliza la base de datos template1 como plantilla para la base de datos. Si necesita otra plantilla —por ejemplo, necesita una plantilla habilitada para un PostGIS—, debe crear la base de datos antes de ejecutar esta herramienta y proporcionar el nombre de la base de datos existente. Utilice siempre caracteres en minúsculas para el nombre de la base de datos. Si utiliza letras mayúsculas, la herramienta las convertirá a minúsculas. | String |
account_authentication (Opcional) | Especifique el tipo de autenticación que se debe utilizar para la conexión de base de datos.
| Boolean |
database_admin (Opcional) | Si utiliza la autenticación de la base de datos, especifique un usuario administrador de base de datos. En el caso de Oracle, utilice el usuario sys. Para PostgreSQL, especifique un usuario con estado de superusuario. Para SQL Server, especifique cualquier miembro del rol de servidor fijo sysadmin. | String |
database_admin_password (Opcional) | Si utiliza la autenticación de la base de datos, escriba la contraseña para el administrador de base de datos. | Encrypted String |
sde_schema (Opcional) | Este parámetro solo es importante para SQL Server e indica si la geodatabase se creará en el esquema de un usuario llamado sde o en el esquema dbo en la base de datos. Si va a crear una geodatabase con esquema dbo, debe conectarse como un usuario dbo en la instancia SQL Server.
| Boolean |
gdb_admin_name (Opcional) | Si utiliza PostgreSQL, este valor debe ser sde. Si el rol de inicio de sesión sde no existe, esta herramienta lo crea y le asigna el estado de superusuario en el clúster de la base de datos. Si el rol de inicio de sesión sde existe, esta herramienta le asigna el estado de superusuario en el caso de que aún no lo tenga. La herramienta también crea un esquema sde en la base de datos y otorga el uso del esquema al público. Si va a usar Oracle, el valor es sde. Si el usuario de sde no existe en la base de datos Oracle, la herramienta Crear geodatabase corporativa crea el usuario y le otorga los privilegios requeridos para crear y actualizar una geodatabase y anular conexiones de usuario a la base de datos. Si ejecuta esta herramienta en una base de datos de Oracle 12c o 18c, la herramienta también otorga privilegios para permitir las importaciones de datos utilizando Oracle Data Pump. Si el usuario sde ya existe, la herramienta otorgará al usuario existente los mismos privilegios. Nota:A partir de ArcGIS 10.7 y ArcGIS Pro 2.3, no puede crear geodatabases de esquema de usuario en Oracle. Si utiliza SQL Server y especificó una geodatabase del esquema sde, este valor debe ser sde. La herramienta creará un inicio de sesión sde, un usuario de base de datos y un esquema, y le otorgará privilegios para crear una geodatabase y anular las conexiones a la instancia de SQL Server. Si especificó un esquema dbo, no proporcione un valor para este parámetro. | String |
gdb_admin_password (Opcional) | La contraseña para el usuario administrador de la geodatabase. Si ya existe el usuario administrador en la geodatabase en el sistema de administración de bases de datos, la contraseña que proporcione debe coincidir con la contraseña existente. Si el usuario administrador de la geodatabase no existe, escriba una contraseña válida de base de datos para el nuevo usuario. La contraseña debe cumplir la política de contraseñas de la base de datos. La contraseña es una cadena de caracteres cifrados. | Encrypted String |
tablespace_name (Opcional) | Este parámetro es válido solo para tipos de DBMS Oracle y PostgreSQL. En el caso de Oracle, realice una de las siguientes acciones:
Esta herramienta no crea un espacio de tablas en PostgreSQL. Debe proporcionar el nombre de un espacio de tabla existente que se utilizará como espacio de tabla predeterminado para la base de datos o dejar este parámetro en blanco. Si deja en blanco el parámetro, la herramienta creará una base de datos en el espacio de tabla pg_default. | String |
authorization_file | La ruta y el nombre del archivo de códigos clave que se creó al autorizar ArcGIS Server. Este archivo se encuentra en la carpeta \\Program Files\ESRI\License<release#>\sysgen en Windows o en el directorio /arcgis/server/framework/runtime/.wine/drive_c/Program Files/ESRI/License<release#>/sysgen en Linux. Si aún no lo hizo, autorice ArcGIS Server para crear este archivo. Probablemente tendrá que copiar el archivo de códigos clave desde el equipo de ArcGIS Server en una ubicación a la que pueda acceder la herramienta. | File |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_result | Especifica si la geodatabase corporativa se creó correctamente. | Booleano |
Muestra de código
El siguiente script crea una geodatabase en una base de datos de Oracle. Crear un usuario sde y un espacio de tabla predeterminados, sdetbs para el usuario sde. El archivo de códigos clave se encuentra en un servidor Linux remoto.
import arcpy
arcpy.CreateEnterpriseGeodatabase_management(
"ORACLE", "ora11g:1521/elf", "", "DATABASE_AUTH", "sys",
"manager", "", "sde", "supersecret", "sdetbs",
"//myserver/mymounteddrive/myaccessibledirectory/keycodes")
Este script se conecta a la instancia de SQL Server (tor\ssinstance) para crear una base de datos llamada sp_data y una geodatabase con esquema sde en ella. La conexión se realiza al utilizar la autenticación del sistema operativo. El archivo de códigos clave se encuentra en un servidor Windows remoto.
import arcpy
arcpy.CreateEnterpriseGeodatabase_management(
"SQL_SERVER", "tor\ssinstance1", "sp_data", "OPERATING_SYSTEM_AUTH", "", "",
"SDE_SCHEMA", "sde", "sde", "", "//myserver/myaccessibledirectory/keycodes")
Este script conecta a un clúster de la base de datos de PostgreSQL en un servidor llamado feldspar. Se creó el usuario sde como una base de datos, pggdb en el espacio de tabla existente, gdbspace. El archivo de códigos clave se encuentra en el servidor Linux local.
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")
El siguiente script independiente de Python le permite proporcionar la información específica de su sitio utilizando las opciones.
"""
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)
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí