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 devez exécuter un outil de géotraitement ou un script Python à partir d’un client ArcGIS.

Lorsque vous créez une géodatabase depuis ArcGIS Pro 3.2, la version de la géodatabase est 11.2.0.

Commencez par lire les conditions préalables, puis conformez-vous aux instructions qui s’appliquent à votre situation.

Remarque :

La création ou la mise à niveau des géodatabases de structure d’utilisateur dans Oracle n’est plus prise en charge.

Conditions requises

Pour créer une géodatabase dans Oracle, procédez comme suit :

  1. Vérifiez que les combinaisons d’ArcGIS, de Oracle et de système d’exploitation que vous voulez utiliser sont compatibles.
  2. Téléchargez le client Oracle requis pour vous 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, qui est créé lorsque vous autorisez ArcGIS Server, et placez-le dans un emplacement accessible depuis le client ArcGIS que vous utiliserez pour créer la géodatabase.
  4. Identifiez l’utilisateur qui créera la géodatabase car cela déterminera l’outil que vous exécuterez pour 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 administrateur de géodatabase et que par conséquent, vous connaissez le mot de passe des deux identifiants de connexion, vous pouvez utiliser l’outil de géotraitement Créer une géodatabase d’entreprise ou un script Python qui appelle cet outil pour créer une géodatabase dans Oracle.

L’outil Créer une géodatabase d’entreprise crée l’utilisateur, la structure et le tablespace sde, et accorde à l’utilisateur sde les privilèges requis pour créer la géodatabase. 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 de 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
  • 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, reportez-vous à la rubrique Privilèges pour les géodatabases dans Oracle.

Remarque :

Vous ne pouvez pas utiliser ce processus pour créer une géodatabase dans un service de base de données.

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 façon dont vous (ou votre service informatique) configurez 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 pour Oracle avant de créer une géodatabase pour vous assurer que les combinaisons de Oracle, d’ArcGIS et de matériel que vous voulez utiliser sont prises en charge.

Si vous avez besoin d’effectuer l’une des opérations ci-après, il est également nécessaire de configurer le processus extproc de Oracle pour pouvoir accéder aux bibliothèques ST_Geometry de Esri :

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

Installer et configurer les clients

Vous pouvez installez ArcGIS Pro (Desktop Standard ou Desktop Advanced) 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 Pro.

Remarque :

Un fichier de codes clés (Enterprise) ArcGIS Server est requis pour autoriser la 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. Il peut être nécessaire de copier le fichier depuis l’ordinateur ArcGIS Server dans un emplacement auquel l’outil de géotraitement ou le script Python 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 identifier la version du client Oracle que vous devez installer pour vous connecter à la version de Oracle que vous utilisez et pour des instructions d’installation et de configuration du client Oracle.

  1. Installez le client ArcGIS que vous utiliserez 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.

    Vous pouvez obtenir le client Oracle Instant, Runtime ou Administrator auprès de Oracle. Consultez la documentation Oracle pour en savoir plus sur l’installation.

  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 Microsoft Windows, définissez la variable d’environnement PATH.

  4. Si le 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 depuis ArcGIS à Oracle en utilisant une chaîne Easy Connect à condition de configurer votre base de données Oracle pour qu’elle admette 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 Créer une géodatabase d’entreprise depuis ArcGIS Pro (Desktop Standard ou Desktop Advanced) ou exécuter un script Python depuis ArcGIS Pro ou depuis un ordinateur ArcGIS Server pour créer un utilisateur, une structure, un tablespace et une géodatabase sde.

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

Vous pouvez exécuter un outil de géotraitement pour créer la géodatabase dans ArcGIS Pro.

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

  1. Démarrez ArcGIS Pro.
  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 en vue de l’utilisation d’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.

    Reportez-vous à la rubrique Connexion à Oracle à partir d’ArcGIS pour obtenir une liste de chaînes Easy Connect valides.

  5. La zone de texte Database Administrator (Administrateur de base de données) est remplie avec le nom d’utilisateur système car 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.
  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, 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, vous devez entrer le mot de passe correspondant à l’utilisateur existant ; 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.
    • Pour créer un tablespace, 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 dans le champ Authorization File (Fichier d’autorisation), recherchez et choisissez le fichier de codes clés qui a été créé lorsque vous avez autorisé ArcGIS Server.

    Si vous ne l’avez pas déjà fait, autorisez maintenant ArcGIS Server à créer le fichier de codes clés. 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.

  11. Cliquez sur Run (Exécuter).

Une géodatabase est créée dans la 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 depuis ArcGIS Pro (Desktop Standard ou Desktop Advanced) ou un ordinateur ArcGIS Server.

  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
    Author: Esri
    """
    
    # Import system modules
    import arcpy, os, optparse, sys
    
    
    # Define usage and version
    parser = optparse.OptionParser(usage = "usage: %prog [Options]", version="%prog 1.0 for 10.1 and higher releases")
    
    #Define help and options
    parser.add_option ("--DBMS", dest="Database_type", type="choice", choices=['SQLSERVER', 'ORACLE', 'POSTGRESQL', ''], default="", help="Type of enterprise DBMS:  SQLSERVER, 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:  Not required 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 for SQL Server geodatabase, SDE or DBO. Default=SDE_SCHEMA")
    parser.add_option ("-u", dest="Gdb_admin", type="string", default="", help="Geodatabase administrator user name")
    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")
    parser.add_option ("-l", dest="Authorization_file", type="string", default="", help="Full path and name of authorization file")
    parser.add_option ("--type", dest="Spatial_type", type="choice", choices=['ST_GEOMETRY', 'POSTGIS'], default="ST_GEOMETRY", help="Spatial Type for PostgreSQL geodatabase, ST_GEOMETRY or POSTGIS. Default=ST_GEOMETRY")
    
    # 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
    	spatial_type = options.Spatial_type.upper()
    	
    	
    	if (database_type == "SQLSERVER"):
    		database_type = "SQL_SERVER"
    	
    	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( 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 for Desktop Standard or Advanced, ArcGIS Engine with the Geodatabase Update extension, or ArcGIS for 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.management.CreateEnterpriseGeodatabase(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, spatial_type=spatial_type)
    		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 de clés se trouvant dans l’emplacement ArcGIS Server par défaut 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 ordinateur 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 l’utilisateur qui crée la géodatabase ne connaît pas le mot de passe de l’administrateur de base de données, l’administrateur de base de données peut configurer la base de données et l’utilisateur sde pour que l’administrateur de géodatabase puisse se connecter à la base de données avec l’identifiant de connexion sde et créer une géodatabase à l’aide de l’outil de géotraitement 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érifier la configuration système requise d’ArcGIS pour vous assurer que les combinaisons de système de gestion de bases de données, d’ArcGIS et de matériel que vous voulez utiliser sont prises en charge.

  • Créer une structure et un utilisateur sde.
  • Accorder à l'utilisateur sde les privilèges nécessaires pour créer une géodatabase. Pour obtenir la liste des privilèges requis, reportez-vous à la rubrique Privilèges pour les géodatabases dans Oracle.
  • 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 execute 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 avez besoin d’effectuer l’une des opérations ci-après, il est également nécessaire de configurer le processus extproc de Oracle pour pouvoir accéder aux bibliothèques ST_Geometry 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 Pro (Desktop Standard ou Desktop Advanced) ou ArcGIS Server pour exécuter un script Python et créer une géodatabase. Pour exécuter l’outil de géotraitement Activer une géodatabase d’entreprise au lieu d’un script, installez ArcGIS Pro.

Remarque :

Un fichier de codes clés (Enterprise) ArcGIS Server est requis pour autoriser la 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. Il peut être nécessaire de copier le fichier depuis l’ordinateur ArcGIS Server dans un emplacement auquel l’outil de géotraitement ou le script Python 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 de Oracle que vous utilisez et pour savoir comment installer et configurer le client.

  1. Installez le client ArcGIS que vous utiliserez 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.

    Vous pouvez obtenir le client Oracle Instant, Runtime ou Administrator auprès de Oracle. Consultez la documentation Oracle pour en savoir plus sur l’installation.

  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.

  4. Si le 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 d’ArcGIS à l’aide d’une chaîne Easy Connect. Pour ce faire, l’administrateur de base de données doit configurer la 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, 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 Activer une géodatabase d’entreprise depuis ArcGIS Pro (Desktop Standard ou Desktop Advanced) ou exécuter un script Python depuis un ordinateur ArcGIS Pro (Desktop Standard ou Desktop Advanced) ou ArcGIS Server pour créer une géodatabase dans la base de données existante.

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

Exécutez l’outil de géotraitement depuis ArcGIS Pro pour créer une géodatabase.

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

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

    Enregistrez 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. Indiquez la connexion à la base de données que vous avez créée à l’étape 2 dans le champ Input Database Connection (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 Authorization File (Fichier d’autorisation).

    Si vous ne l’avez pas déjà fait, autorisez ArcGIS Server à créer ce fichier. Lorsque vous utilisez l’assistant pour autoriser 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. Copiez le fichier de codes clés dans un emplacement accessible par l'outil.

  6. Cliquez sur Run (Exécuter).

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 de 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

Si vous voulez créer la géodatabase en exécutant un script depuis une installation de ArcGIS Server ou ArcGIS Pro, 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 de clés se trouvant dans l’emplacement ArcGIS Server par défaut 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 ordinateur 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.