Créer une géodatabase dans Oracle

Disponible avec une licence Standard ou Advanced.

Pour créer une géodatabase dans une base de données Oracle, vous exécutez un outil de géotraitement ou un script Python à partir d’un client ArcGIS. Commencez par lire les conditions préalables, puis conformez-vous aux instructions qui s’appliquent à votre situation.

Remarque :

À partir de ArcGIS 10.7 et ArcGIS Pro 2.3, vous ne pouvez pas créer de géodatabases de structure utilisateur dans Oracle.

Conditions préalables

Pour créer une géodatabase dans Oracle, vous devez suivre les étapes suivantes :

  1. Vérifiez que les combinaisons de ArcGIS, de Oracle et des systèmes d’exploitation que vous voulez utiliser sont compatibles.
  2. Téléchargez le client Oracle requis pour se connecter à la version de Oracle que vous allez utiliser pour stocker votre géodatabase.
  3. Procurez-vous un fichier de codes clés ArcGIS Server et placez-le dans un emplacement accessible depuis le client ArcGIS que vous allez utiliser pour créer la géodatabase.
  4. Déterminez la personne qui crée la géodatabase car cela affecte la personne qui crée la base de données ainsi que l’outil permettant de créer la géodatabase. Suivez les instructions correspondant à votre situation :

Vous êtes administrateur de base de données et de géodatabase

Si vous êtes à la fois administrateur de base de données et de géodatabase et que vous connaissez le mot de passe des deux rôles de connexion, vous pouvez utiliser l’outil de géotraitement Create Enterprise Geodatabase (Créer une géodatabase d’entreprise) ou un script Python pour créer une géodatabase dans Oracle.

L'outil Créer une géodatabase d'entreprise vous permet de configurer facilement une géodatabase, car il crée la structure, le tablespace et l'utilisateur sde, puis accorde à ce dernier les privilèges requis. Pour ce faire, l'outil utilise les paramètres par défaut suivants :

  • Création d'un utilisateur de base de données nommé sde
  • Création d’un tablespace de 400 Mo dans l’emplacement par défaut d’Oracle et attribution de ce dernier à l’utilisateur sde
  • Octroi des privilèges d’utilisateur SDE requis pour créer et mettre à niveau une géodatabase, supprimer des connexions à la base de données et importer des données avec Oracle Data Pump (Oracle 11g uniquement)
  • Attribution de privilèges de paquetages nécessaires pour créer une géodatabase
  • Création d'une géodatabase

Pour plus d’informations sur les privilèges requis, consultez la rubrique Privilèges pour les géodatabases dans Oracle.

Avant d’exécuter l’outil ou le script de création d’une géodatabase, vous devez configurer Oracle.

Installer et configurer Oracle

Avant de créer une géodatabase, vous devez installer et configurer Oracle. La configuration de l’instance Oracle varie en fonction des besoins spécifiques de votre organisation. Consultez la documentation Oracle qui contient des informations sur l’installation et la configuration.

Vérifiez la configuration système requise de ArcGIS pour Oracle avant de configurer une géodatabase pour vous assurer que ArcGIS, Oracle et le matériel que vous souhaitez utiliser sont bien pris en charge.

Si vous êtes amené à exécuter les opérations suivantes, vous devez également configurer le processus extproc d’Oracle pour accéder aux bibliothèques ST de Esri :

Une fois Oracle installé et configuré, installez les clients ArcGIS et Oracle.

Installer et configurer les clients

Vous pouvez installer ArcGIS Desktop (Desktop Standard ou Desktop Advanced), ArcGIS Engine Geodatabase Update ou ArcGIS Server (édition Enterprise) et exécuter un script pour créer une géodatabase. Pour exécuter l'outil de géotraitement Créer une géodatabase d'entreprise plutôt qu'un script, installez ArcGIS Desktop.

Remarque :

Vous avez besoin d'un fichier de codes clés ArcGIS Server (édition Enterprise) pour autoriser votre géodatabase dans la section suivante. Même si vous n’exécutez pas de script Python à partir d’une machine ArcGIS Server pour créer la géodatabase, vous devez installer et autoriser ArcGIS Server pour obtenir le fichier de codes de clés. Vous devrez peut-être copier le fichier de codes clés d'ArcGIS Server vers un emplacement auquel l'outil de géotraitement Créer la géodatabase d'entreprise peut accéder.

Dans la plupart des cas, votre client ArcGIS sera installé sur un ordinateur autre que celui où est installé Oracle. Ainsi, pour vous connecter à l’instance Oracle, votre client Oracle doit être pris en charge sur l’ordinateur du client ArcGIS. Consultez la documentation Oracle pour déterminer quelle version du client Oracle vous devez installer pour vous connecter à la version d’Oracle que vous utilisez et pour savoir comment installer et configurer le client.

  1. Installez le client ArcGIS à utiliser pour créer la géodatabase.

    Suivez les instructions des guides d'installation du logiciel.

  2. Installez et configurez un client Oracle sur l’ordinateur du client ArcGIS.

    Si vous vous connectez à partir d’un client ArcGIS 32 bits (tel que ArcMap), vous devez installer un client Oracle 32 bits. Cela s'applique même si vous installez l'application client ArcGIS sur un ordinateur doté d'un système d'exploitation 64 bits, avec une base de données et un système d'exploitation de serveur de 64 bits. Si vous vous connectez à partir d’un client ArcGIS 64 bits (tel que ArcGIS Server ou ArcGIS Pro), vous devez installer un client Oracle 64 bits.

    Vous pouvez obtenir le client Oracle Instant, Runtime ou Administrator auprès d’Oracle. Pour obtenir des instructions relatives à l’installation, consultez la documentation Oracle.

  3. Définissez la variable d’environnement de votre système d’exploitation ou du profil utilisateur de manière à inclure le chemin d’accès et le nom du répertoire dans lequel est installé le client Oracle.

    • Sous Linux, définissez la variable d’environnement LD_LIBRARY_PATH.

      Vous pouvez obtenir le client Oracle Instant, Runtime ou Administrator auprès d’Oracle. Pour obtenir des instructions relatives à l’installation, consultez la documentation Oracle.

    • Sous Microsoft Windows, définissez la variable d’environnement PATH. Si ArcMap est installé sur le même ordinateur Windows que ArcGIS Pro ou ArcGIS Server, définissez la variable PATH de sorte qu’elle lise le client 64 bits avant le client 32 bits. Si, par exemple, votre client Oracle 32 bits est installé dans le répertoire c:\Program Files (x86)\Oracle et Oracle Instant Client 64 bits dans le répertoire c:\Program Files\Oracle, ajoutez les informations suivantes au début de la valeur de la variable PATH : C:\Program Files\Oracle;C:\Program Files (x86)\Oracle;.

  4. Si votre client ArcGIS était déjà en cours d’exécution, redémarrez-le pour qu’il reconnaisse le client Oracle et les nouvelles variables d’environnement.
  5. Vous pouvez vous connecter à Oracle à partir de ArcGIS à l’aide d’une chaîne Easy Connect. Pour ce faire, vous devez configurer votre base de données Oracle pour qu’elle autorise les chaînes Easy Connect. Si le client Oracle complet est installé, mais que vous souhaitez utiliser la syntaxe Easy Connect pour vous connecter, veillez à ce que le fichier sqlnet.ora sur le client soit configuré de façon à autoriser l’utilisation d’Easy Connect et à ce que le serveur Oracle soit configuré pour autoriser la syntaxe Easy Connect. Pour plus d’informations, reportez-vous à la documentation Oracle.

Vous pouvez maintenant créer une géodatabase.

Créer une géodatabase

Vous pouvez exécuter l’outil Create Enterprise Geodatabase (Créer une géodatabase d’entreprise) à partir de ArcGIS Desktop (Desktop Standard ou Desktop Advanced), ou exécuter un script Python à partir d’un client ArcGIS Desktop, ArcGIS Server ou ArcGIS Engine pour créer un utilisateur sde, une structure, un tablespace et une géodatabase.

Exécuter l'outil Créer une géodatabase d'entreprise

Si vous avez accès à ArcGIS Desktop, vous pouvez exécuter un outil de géotraitement pour créer la géodatabase.

Procédez comme suit pour créer une géodatabase à l'aide de l'outil Créer une géodatabase d'entreprise d'ArcMap :

  1. Démarrez un client ArcGIS Desktop.
  2. Ouvrez l'outil Créer une géodatabase d'entreprise.

    Vous pouvez accéder à cet outil, qui se trouve dans jeu d’outils Administration de la géodatabase de la boîte à outils Gestion des données.

  3. Sélectionnez Oracle dans la liste déroulante Plateforme de la base de données.
  4. Fournissez les informations requises pour vous connecter à l’instance Oracle.
    • Si vous avez déjà configuré le client Oracle pour utiliser un alias de réseau TNS, saisissez l’alias de service Net dans la zone de texte Instance.
    • Si vous n’avez pas configuré l’alias de réseau du client Oracle et que vos base de données et client Oracle sont configurés pour utiliser des chaînes Easy Connect, saisissez la chaîne Easy Connect de Oracle dans la zone de texte Instance.
  5. Vous devez vous connecter à la base de données en tant qu'administrateur de base de données pour créer l'administrateur de géodatabase et le tablespace. Par conséquent, la zone de texte Administrateur de base de données est renseignée avec le nom de l'utilisateur système.
  6. Tapez le mot de passe de l'utilisateur système dans la zone de texte Mot de passe administrateur de géodatabase.
  7. Saisissez sde dans la zone de texte Administrateur de géodatabase.

    Si l'utilisateur sde n'existe pas dans la base de données, l'outil le crée et lui accorde les privilèges requis pour créer une géodatabase. Si l'utilisateur existe déjà, les privilèges requis lui sont accordés.

  8. Saisissez un mot de passe pour l'utilisateur sde dans la zone de texte Mot de passe administrateur de géodatabase.

    Si l'utilisateur sde existe dans la base de données, veillez à entrer le mot de passe correspondant à l'utilisateur existant, car cet outil ne modifiera pas le mot de passe. Si vous créez un utilisateur sde, le mot de passe que vous fournissez est utilisé lors de la création de l'utilisateur sde.

  9. Spécifiez un tablespace pour l'utilisateur sde.
    • Si vous devez utiliser un tablespace préconfiguré pour le référentiel de géodatabase, saisissez son nom dans la zone de texte Nom du tablespace.
    • Si vous souhaitez que l’outil crée un tablespace à votre place, saisissez un nom valide dans la zone de texte Tablespace Name (Nom du tablespace) pour que l’outil crée un tablespace de 400 Mo à l’emplacement Oracle par défaut. Si vous n'entrez pas le nom d'un tablespace, un tablespace SDE_TBS est créé et défini comme tablespace par défaut pour l'utilisateur et ArcSDE.
  10. Pour spécifier un fichier d'autorisation, recherchez et choisissez le fichier de codes clés qui a été créé lorsque vous avez autorisé ArcGIS Server Enterprise.

    Ce fichier est écrit dans le dossier \\Program Files\ESRI\License<release#>\sysgen sur les serveurs Windows et dans /arcgis/server/framework/runtime/.wine/drive_c/Program Files/ESRI/License<release#>/sysgen sur les serveurs Linux. Copiez le fichier de codes clés dans un emplacement accessible par l'outil. Si vous ne l'avez pas déjà fait, autorisez ArcGIS Server à créer ce fichier.

  11. Cliquez sur OK (ArcMap ou ArcCatalog) ou Exécuter (ArcGIS Pro).

Une géodatabase est créée dans votre base de données Oracle.

Les messages relatifs à la création de la géodatabase sont consignés dans le fichier sde_setup.log, qui est créé dans le répertoire spécifié pour votre variable %TEMP% sur l'ordinateur sur lequel l'outil est exécuté. Si vous rencontrez un problème lors de la création d'une géodatabase, consultez ce fichier journal pour le résoudre.

Ensuite, si la valeur du paramètre open_cursors de la base de données Oracle est différente de 300, exécutez la procédure stockée sde.gdb_util.update_open_cursors pour synchroniser votre paramètre de base de données Oracle avec celui de la géodatabase.

Exécuter un script Python

Vous pouvez copier, enregistrer et exécuter le script fourni ici pour créer une géodatabase à partir de ArcGIS Desktop (Desktop Standard ou Desktop Advanced), ArcGIS Server ou ArcGIS Runtime (avec l’extension Geodatabase Update).

  1. Créez un fichier texte sur l’ordinateur du client ArcGIS, puis copiez-y le script suivant.
    """
    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)
  2. Enregistrez le fichier avec l'extension .py.
  3. Exécutez le script en indiquant les options et informations propres à votre site.

    Dans l’exemple suivant, sur un ordinateur Linux, le fichier create_gdb.py est exécuté pour une instance Oracle avec un SID orcl. L'instance est exécutée sur le serveur gisprod. Un utilisateur sde avec le mot de passe Tgdbst@rtsh3r3 est créé, ainsi qu'un tablespace appelé sde. Un fichier de codes clés se trouvant dans l'emplacement par défaut d'ArcGIS Server permet d'autoriser la géodatabase.

    ./create_gdb.py --DBMS ORACLE -i gisprod/orcl --auth DATABASE_AUTH -U sys
     -P N0pe3king! -u sde -p Tgdbst@rtsh3r3 -t sde -l '/usr/arcgis/server/framework/runtime/.wine/drive_c/Program Files/ESRI/License/sysgen/keycodes'

    Dans cet exemple, le même script est exécuté sur un Windows :

    create_gdb.py --DBMS ORACLE -i gisprod/orcl --auth DATABASE_AUTH -U sys
     -P N0pe3king! -u sde -p Tgdbst@rtsh3r3 -t sde -l '\\Program Files\ESRI\License\sysgen\keycodes'
    Conseil :

    Type -h or --help at the command prompt to get syntax help.

Vous disposez maintenant d’une géodatabase dans Oracle.

Les messages relatifs à la création de la géodatabase sont consignés dans le fichier sde_setup.log, qui est créé dans le répertoire spécifié pour votre variable TEMP ou TMP sur l'ordinateur sur lequel l'outil est exécuté. Si vous rencontrez un problème lors de la création d'une géodatabase, consultez ce fichier journal pour le résoudre.

Ensuite, si la valeur du paramètre open_cursors de la base de données Oracle est différente de 300, exécutez la procédure stockée sde.gdb_util.update_open_cursors pour synchroniser votre paramètre de base de données Oracle avec celui de la géodatabase.

L’administrateur de Oracle configure la base de données ; l’administrateur de géodatabase crée la géodatabase

Si la personne qui crée la géodatabase ne connaît pas le mot de passe de l’administrateur de base de données, ce dernier peut configurer la base de données et l’utilisateur sde pour que l’administrateur de géodatabase puisse s’y connecter à l’aide de l’identifiant de connexion sde et créer une géodatabase dans la base de données avec l’outil de géotraitement Enable Enterprise Geodatabase (Activer une géodatabase d’entreprise) ou un script Python.

L'outil Activer une géodatabase d’entreprise utilise en entrée un fichier de connexion à une base de données et crée les vues, les fonctions, les procédures et les tables système de la géodatabase dans la structure de l'utilisateur sde.

Installer et configurer Oracle

Avant que l'administrateur de géodatabase ne crée une géodatabase, l'administrateur de base de données doit effectuer les opérations suivantes :

  • Installer et configurer une instance Oracle. La configuration de l’instance Oracle varie en fonction des besoins spécifiques de votre organisation. Consultez la documentation Oracle qui contient des informations sur l’installation et la configuration.

    Vérifiez la configuration système requise d'ArcGIS avant de configurer une géodatabase pour vous assurer que le système de gestion de base de données, ArcGIS et le matériel que vous souhaitez utiliser sont bien pris en charge. Pour obtenir la liste des privilèges requis, reportez-vous à la rubrique Privilèges pour les géodatabases dans Oracle.

  • Créer une structure et un utilisateur sde.
  • Accorder à l'utilisateur sde les privilèges nécessaires pour créer une géodatabase.
  • Créer un tablespace pour l'utilisateur sde et le définir comme tablespace par défaut de l'utilisateur sde.
  • Accorder des privilèges d'exécution sur les paquetages nécessaires à la création de la géodatabase. Reportez-vous à la rubrique Privilèges pour les géodatabases dans Oracle pour obtenir une liste des paquetages.

Si vous êtes amené à exécuter les opérations suivantes, vous devez également configurer le processus extproc d’Oracle pour accéder aux bibliothèques ST de Esri :

Une fois Oracle installé et configuré, l’administrateur de géodatabase peut installer les clients Oracle et ArcGIS.

Installer et configurer les clients

Vous pouvez installer ArcGIS Desktop (Desktop Standard ou Desktop Advanced), ArcGIS Engine Geodatabase Update ou ArcGIS Server pour exécuter un script Python et créer une géodatabase. Pour exécuter l'outil de géotraitement Créer une géodatabase d'entreprise plutôt qu'un script, installez ArcGIS Desktop.

Remarque :

Vous avez besoin d'un fichier de codes clés ArcGIS Server (édition Enterprise) pour autoriser votre géodatabase dans la section suivante. Même si vous n’exécutez pas de script Python à partir d’une machine ArcGIS Server pour créer la géodatabase, vous devez installer et autoriser ArcGIS Server pour obtenir le fichier de codes de clés. Vous devrez peut-être copier le fichier de codes clés d'ArcGIS Server vers un emplacement auquel l'outil de géotraitement Créer la géodatabase d'entreprise peut accéder.

Dans la plupart des cas, votre client ArcGIS sera installé sur un ordinateur autre que celui où est installé Oracle. Ainsi, pour vous connecter à l’instance Oracle, votre client Oracle doit être pris en charge sur l’ordinateur du client ArcGIS. Consultez la documentation Oracle pour déterminer quelle version du client Oracle vous devez installer pour vous connecter à la version d’Oracle que vous utilisez et pour savoir comment installer et configurer le client.

  1. Installez le client ArcGIS à utiliser pour créer la géodatabase.

    Suivez les instructions des guides d'installation du logiciel.

  2. Installez et configurez un client Oracle sur l’ordinateur du client ArcGIS.

    Si vous vous connectez à partir d’un client ArcGIS 32 bits (tel que ArcMap), vous devez installer un client Oracle 32 bits. Cela s'applique même si vous installez l'application client ArcGIS sur un ordinateur doté d'un système d'exploitation 64 bits, avec une base de données et un système d'exploitation de serveur de 64 bits. Si vous vous connectez à partir d’un client ArcGIS 64 bits (tel que ArcGIS Server ou ArcGIS Pro), vous devez installer un client Oracle 64 bits.

    Vous pouvez obtenir le client Oracle Instant, Runtime ou Administrator auprès d’Oracle. Pour obtenir des instructions relatives à l’installation, consultez la documentation Oracle.

  3. Définissez la variable d’environnement de votre système d’exploitation ou du profil utilisateur de manière à inclure le chemin d’accès et le nom du répertoire dans lequel est installé le client Oracle.

    • Sous Linux, définissez la variable d’environnement LD_LIBRARY_PATH.
    • Sous Windows, définissez la variable d’environnement PATH. Si ArcMap est installé sur le même ordinateur Windows que ArcGIS Pro ou ArcGIS Server, définissez la variable PATH de sorte qu’elle lise le client 64 bits avant le client 32 bits. Si, par exemple, votre client Oracle 32 bits est installé dans le répertoire c:\Program Files (x86)\Oracle et Oracle Instant Client 64 bits dans le répertoire c:\Program Files\Oracle, ajoutez les informations suivantes au début de la valeur de la variable PATH : C:\Program Files\Oracle;C:\Program Files (x86)\Oracle;.

  4. Si votre client ArcGIS était déjà en cours d’exécution, redémarrez-le pour qu’il reconnaisse le client Oracle et les nouvelles variables d’environnement.
  5. Vous pouvez vous connecter à Oracle à partir de ArcGIS à l’aide d’une chaîne Easy Connect. Pour ce faire, l’administrateur de base de données Oracle doit configurer la base de données pour qu’elle autorise les chaînes Easy Connect. Si le client Oracle complet est installé, mais que vous souhaitez utiliser la syntaxe Easy Connect pour vous connecter, assurez-vous que le fichier sqlnet.ora sur le client est configuré de sorte à autoriser l’utilisation d’Easy Connect et que l’administrateur de base de données a configuré le serveur Oracle pour qu’il autorise la syntaxe Easy Connect. Pour plus d’informations, reportez-vous à la documentation Oracle.

Vous pouvez maintenant créer une géodatabase.

Créer une géodatabase

L’administrateur de géodatabase peut exécuter l’outil Enable Enterprise Geodatabase (Activer une géodatabase d’entreprise) à partir de ArcGIS Desktop (Desktop Standard ou Desktop Advanced) ou exécuter un script Python à partir d’un client ArcGIS Desktop, ArcGIS Server ou ArcGIS Engine pour créer une géodatabase dans la base de données existante.

Exécutez l'outil Activer une géodatabase d'entreprise ArcGIS Desktop.

Si vous disposez de l'accès approprié, vous pouvez exécuter l'outil Activer une géodatabase d'entreprise pour créer une géodatabase.

Procédez comme suit pour créer une géodatabase à l'aide de l'outil Activer une géodatabase d'entreprise d'ArcGIS Desktop :

  1. Démarrez un client ArcGIS Desktop.
  2. Connectez-vous à la base de données Oracle en tant qu’utilisateur sde.

    N'oubliez pas d'enregistrer le mot de passe de l'utilisateur dans la boîte de dialogue Connexion à la base de données.

  3. Ouvrez l'outil de géotraitement Activer une géodatabase d'entreprise.
  4. Utilisez la connexion à la base de données créée à l'étape 2 comme Connexion à la géodatabase en entrée.
  5. Accédez au fichier d'autorisation que vous avez créé lorsque vous avez autorisé ArcGIS Server et ajoutez-le à la zone de texte Fichier d'autorisation.

    Lorsque vous utilisez l'assistant d'autorisation d'ArcGIS Server, un fichier de codes clés est écrit sur le serveur où le logiciel est installé. Si vous avez autorisé ArcGIS Server sur un ordinateur Linux, le fichier de codes clés a été créé dans /arcgis/server/framework/runtime/.wine/drive_c/Program Files/ESRI/License<release>/sysgen. Si vous l’avez autorisé sur un serveur Windows, le fichier a été créé dans Program Files\ESRI\License<release>\sysgen. Si vous ne l'avez pas déjà fait, autorisez ArcGIS Server à créer ce fichier. Copiez le fichier de codes clés dans un emplacement accessible par l'outil.

  6. Cliquez sur OK (ArcMap ou ArcCatalog) ou Exécuter (ArcGIS Pro).

Une géodatabase est créée dans la base de données.

Les messages relatifs à la création de la géodatabase sont consignés dans le fichier sde_setup.log, qui est créé dans le répertoire spécifié pour votre variable %TEMP% sur l'ordinateur sur lequel l'outil est exécuté. Si vous rencontrez un problème lors de la création d'une géodatabase, consultez ce fichier journal pour le résoudre.

Si les clients doivent accéder à la géodatabase avec SQL, configurez le processus extproc d’Oracle pour autoriser l’accès.

L’administrateur de base de données peut ensuite synchroniser les paramètres open_cursors entre Oracle et la géodatabase à l’aide de la procédure stockée sde.gdb_util.update_open_cursors.

Exécuter un script Python

Pour créer la géodatabase en exécutant un script à partir d’une installation de ArcGIS Server ou de ArcGIS Desktop ou une installation de ArcGIS Engine, vous pouvez utiliser le script fourni ici.

  1. Créez un fichier texte sur l’ordinateur du client ArcGIS, puis copiez-y le script suivant.

    """
    Name: enable_enterprise_gdb.py
    Description: Provide connection information to an enterprise database
    and enable enterprise geodatabase.
    Type enable_enterprise_gdb.py -h or enable_enterprise_gdb.py --help for usage
    """
    
    # Import system modules
    import arcpy, os, optparse, 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', 'DB2','INFORMIX','DB2ZOS', ''], default="", help="Type of enterprise DBMS:  SQL_SERVER, ORACLE, POSTGRESQL, DB2, INFORMIX, or DB2ZOS.")
    parser.add_option ("-i", dest="Instance", type="string", default="", help="DBMS instance name")
    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="User", type="string", default="", help="Geodatabase administrator user name")
    parser.add_option ("-p", dest="Password", type="string", default="", help="Geodatabase  administrator password")
    parser.add_option ("-D", dest="Database", type="string", default="none", help="Database name:  Not required for Oracle")
    parser.add_option ("-l", dest="Authorization_file", type="string", default="", help="Full path and name of authorization file")
    
    
    # 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
    	account_authentication = options.account_authentication.upper()
    	username = options.User.lower() 
    	password = options.Password	
    	database = options.Database.lower()
    	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)
    
    		
    	# Get the current product license
    	product_license=arcpy.ProductInfo()
    	
    	if (license == ""):
    		print " \n%s: error: %s\n" % (sys.argv[0], "Authorization file (-l) must be specified.")
    		parser.print_help()
    		sys.exit(3)
    	
    	# Checks required license level
    	if product_license.upper() == "ARCVIEW" or product_license.upper() == 'ENGINE':
    		print "\n" + product_license + " license found!" + "  Enabling enterprise geodatabase functionality requires an ArcGIS Desktop Standard or Advanced, ArcGIS Engine with the Geodatabase Update extension, or ArcGIS Server license."
    		sys.exit("Re-authorize ArcGIS before enabling an enterprise geodatabase.")
    	else:
    		print "\n" + product_license + " license available!  Continuing to enable..."
    		arcpy.AddMessage("+++++++++")
    	
    	# Local variables
    	instance_temp = instance.replace("\\","_")
    	instance_temp = instance_temp.replace("/","_")
    	instance_temp = instance_temp.replace(":","_")
    	Conn_File_NameT = instance_temp + "_" + database + "_" + username    
    	
    	if os.environ.get("TEMP") == None:
    		temp = "c:\\temp"	
    	else:
    		temp = os.environ.get("TEMP")
    	
    	if os.environ.get("TMP") == None:
    		temp = "/usr/tmp"		
    	else:
    		temp = os.environ.get("TMP")  
    	
    
    	Connection_File_Name = Conn_File_NameT + ".sde"
    	Connection_File_Name_full_path = temp + os.sep + Conn_File_NameT + ".sde"
    	
    	# Check for the .sde file and delete it if present
    	arcpy.env.overwriteOutput=True
    	if os.path.exists(Connection_File_Name_full_path):
    		os.remove(Connection_File_Name_full_path)
    	
    	print "\nCreating Database Connection File...\n"	
    	# Process: Create Database Connection File...
    	# Usage:  out_file_location, out_file_name, DBMS_TYPE, instnace, database, account_authentication, username, password, save_username_password(must be true)
    	arcpy.CreateDatabaseConnection_management(out_folder_path=temp, out_name=Connection_File_Name, database_platform=database_type, instance=instance, database=database, account_authentication=account_authentication, username=username, password=password, save_user_pass="TRUE")
            for i in range(arcpy.GetMessageCount()):
    		if "000565" in arcpy.GetMessage(i):   #Check if database connection was successful
    			arcpy.AddReturnMessage(i)
    			arcpy.AddMessage("\n+++++++++")
    			arcpy.AddMessage("Exiting!!")
    			arcpy.AddMessage("+++++++++\n")
    			sys.exit(3)            
    		else:
    			arcpy.AddReturnMessage(i)
    			arcpy.AddMessage("+++++++++\n")
    	
    	
    	# Process: Enable geodatabase...
    	try:
    		print "Enabling Enterprise Geodatabase...\n"
    		arcpy.EnableEnterpriseGeodatabase_management(input_database=Connection_File_Name_full_path, 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)
    			
    	if os.path.exists(Connection_File_Name_full_path):
    		os.remove(Connection_File_Name_full_path)
    			
    #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)

  2. Enregistrez le fichier avec l'extension .py.
  3. Exécutez le script en indiquant les options et informations propres à votre site.

    Dans l’exemple suivant, sur un ordinateur Linux, le fichier enable_gdb.py est exécuté pour une instance Oracle avec un SID orcl. L'instance est exécutée sur le serveur gisprod. Un fichier de codes clés se trouvant dans l'emplacement par défaut d'ArcGIS Server permet d'autoriser la géodatabase.

    enable_gdb.py --DBMS ORACLE -i gisprod/orcl --auth DATABASE_AUTH 
    -u sde -p Tgdbst@rtsh3r3 -l '/usr/arcgis/server/framework/runtime/.wine/drive_c/Program Files/ESRI/License/sysgen/keycodes'

    Dans cet exemple, le même script est exécuté sur un Windows :

    create_gdb.py --DBMS ORACLE -i gisprod/orcl --auth DATABASE_AUTH -U sys
     -P N0pe3king! -u sde -p Tgdbst@rtsh3r3 -t sde -l '\\Program Files\ESRI\License\sysgen\keycodes'
    Conseil :

    Type -h or --help at the command prompt to get syntax help.

La base de données Oracle contient maintenant une géodatabase.

Les messages relatifs à la création de la géodatabase sont consignés dans le fichier sde_setup.log, qui est créé dans le répertoire spécifié pour votre variable TEMP ou TMP sur l'ordinateur sur lequel le script est exécuté. Si vous rencontrez un problème lors de la création d'une géodatabase, consultez ce fichier journal pour le résoudre.

L’administrateur de base de données peut ensuite synchroniser les paramètres open_cursors entre Oracle et la géodatabase à l’aide de la procédure stockée sde.gdb_util.update_open_cursors.