Mettre à niveau une géodatabase d'entreprise dans SQL Server—Aide

Disponible avec une licence Standard ou Advanced.

Avant de procéder à la mise à niveau
Mettre à niveau la géodatabase

La mise à niveau d'une géodatabase d'entreprise consiste à mettre à jour les tables système de géodatabase, les procédures stockées, les types et les fonctions pour bénéficier des nouvelles fonctionnalités et des corrections de bogues.

Installez une nouvelle version du client ArcGIS ou appliquez un service pack, un patch ou un correctif à une installation existante, puis mettez à niveau la géodatabase.

Avant de procéder à la mise à niveau

Lorsque vous mettez à niveau un système d'entreprise, y compris une géodatabase, planifiez à l'avance. Testez la nouvelle version sur un serveur de développement ou de test pour vérifier qu'elle fonctionne avec toutes vos applications clientes.

Lorsque vous vous êtes assuré que le nouveau système fonctionne comme attendu, programmez la mise à niveau ; assurez-vous que le personnel nécessaire est disponible pour effectuer la mise à niveau et qu'il dispose des autorisations nécessaires pour effectuer ces tâches.

Vérifiez les éléments suivants :

Le serveur d'applications ArcSDE pour SQL Server n'est plus disponible à partir de la version ArcGIS 10.3. Vous devez migrer toutes les connexions au serveur d'applications utilisées dans les cartes ou les services pour utiliser des connexions directes avant de mettre à niveau votre géodatabase vers la version 10.3.
Les mises à niveau des versions bêta du logiciel ne sont pas prises en charge.
Vous pouvez effectuer une mise à niveau directe d'une géodatabase 9.3.1, 10, 10.1, 10.2, 10.2.1 ou 10.2.2 vers une géodatabase 10.3 si la version de votre base de données est prise en charge.
Si votre géodatabase est de version 9.3 ou antérieure, vous devez commencer par la mettre à niveau vers une géodatabase prise en charge, puis vers la version 10.3.
Une fois la géodatabase mise à niveau, il est possible que les versions précédentes d'ArcGIS ne puissent plus se connecter, car elles sont incapables de lire certaines versions plus récentes de la géodatabase. Les versions antérieures à ArcGIS 10 ne pourront pas se connecter à une géodatabase de version 10.3. Les clients ArcGIS 10 pourront se connecter à la géodatabase de version 10.3.
Il n'existe aucun mécanisme formel permettant de rétrograder une géodatabase vers une version antérieure. Si, après avoir effectué une mise à niveau vers une version plus récente, vous voulez revenir à une version plus ancienne de la géodatabase, vous devez restaurer l'ancienne base de données à partir de la sauvegarde.
Lorsqu'une géodatabase dans SQL Server est mise à niveau d'ArcGIS 10 vers ArcGIS 10.1 ou des versions ultérieures, les nouvelles classes d'entités créées utilisent le type de stockage de la géométrie SQL Server par défaut. Si vous voulez que les nouvelles classes d'entités utilisent par défaut un autre type de stockage de la géométrie, modifiez la valeur du paramètre GEOMETRY_STORAGE sous le mot-clé DEFAULTS.
Si vous mettez à niveau une géodatabase dans SQL Server qui utilise le modèle de base de données spatiales multiple, veillez à exécuter la mise à niveau sur la base de données SDE. N'oubliez pas que, après la mise à niveau d'une géodatabase, vous ne pouvez pas ajouter une nouvelle base de données à une géodatabase de modèle de base de données spatiales multiple.

La liste de contrôle suivante décrit les étapes à suivre avant de mettre à niveau votre géodatabase :

Vérifiez que la version de SQL Server que vous souhaitez utiliser est prise en charge par ArcGIS 10.3. Pour plus d'informations, reportez-vous à la rubrique Spécifications de bases de données Microsoft SQL Server pour ArcGIS.

Vérifiez que votre géodatabase peut être mise à niveau. Pour ce faire, installez la version du client ArcGIS que vous souhaitez migrer vers l'autre ordinateur. Si vous installez ArcGIS for Desktop, vous pouvez vous connecter à la géodatabase et ouvrir la boîte de dialogue Propriétés de la base de données pour déterminer si la géodatabase peut être mise à niveau. Si vous installez ArcGIS for Server ou ArcGIS Engine avec l'extension Geodatabase Update, vous pouvez utiliser la fonction ArcPy Describe pour déterminer si la géodatabase peut être mise à niveau.
```
# Open Python.
cd /arcgis/server/tools
./python

# Create a connection to the geodatabase.
arcpy.CreateDatabaseConnection_management("/tmp/",
                                          "egdb_connection.sde",
                                          "SQL_SERVER",
                                          "prod9",
                                          "DATABASE_AUTH",
                                          "sde",
                                          "mysdepassword",
                                          "SAVE_USERNAME",
                                          "myssgdb")

# Import ArcPy and check the geodatabase release.
import arcpy

isCurrent = arcpy.Describe('/tmp/egdb_connection.sde').currentRelease

print isCurrent
```
Si la valeur false est renvoyée, vous pouvez mettre à niveau votre géodatabase. Si la valeur true est renvoyée, votre géodatabase n'a pas besoin d'être mise à niveau. N'exécutez pas les étapes suivantes.
Créez une sauvegarde de la base de données.
Supprimez les fonctionnalités personnalisées éventuellement ajoutées aux tables système de géodatabase en dehors d'ArcGIS, telles que les déclencheurs, la participation à la réplication SQL Server ou les index supplémentaires. La procédure de mise à niveau ne peut pas être tenue au courant des personnalisations que vous apportez aux tables système. Si de telles personnalisations empêchent la modification d'une table système, la mise à niveau échoue.
Assurez-vous que la connexion que vous utilisez pour mettre à niveau la géodatabase dispose des privilèges adéquats.
Si la géodatabase est stockée dans la schéma dbo, l'administrateur de géodatabase (dbo) détient automatiquement les privilèges nécessaires pour la mise à niveau. Pour les géodatabases stockées dans la structure sde, s'il s'agit d'une géodatabase de modèle de base de données spatiales unique et si la base de données ne se nomme pas sde, l'identifiant de connexion que vous utilisez doit être sysadmin ou appartenir au rôle db_owner. Si vous utilisez une géodatabase de modèle de base de données spatiales multiple (ou une base de données spatiales unique nommée sde), vous devez utiliser l'identifiant de connexion sysadmin pour effectuer la mise à niveau.
Remarque :
N'ajoutez pas l'utilisateur SDE à sysadmin.
Vérifiez qu'aucune connexion n'est établie à la géodatabase que vous mettez à niveau.
Pour voir la liste des utilisateurs actuellement connectés à votre géodatabase, ouvrez l'onglet Utilisateurs connectés de la boîte de dialogue Administration de géodatabase dans ArcGIS for Desktop.

Vous pouvez maintenant mettre à niveau votre géodatabase.

Mettre à niveau la géodatabase

Vous pouvez utiliser l'outil Mettre à niveau la géodatabase dans ArcGIS for Desktop ou exécuter un script Python sur l'ordinateur du client ArcGIS pour mettre à niveau votre géodatabase.

Utiliser l'outil Mettre à niveau la géodatabase

Vous pouvez activer l'outil Mettre à niveau la géodatabase dans la boîte de dialogue Propriétés de la base de données en cliquant sur le bouton Mettre à niveau la géodatabase dans l'onglet Général ou en ouvrant directement l'outil. Si vous ouvrez l'outil à partir de la boîte de dialogue Propriétés de la base de données, la zone de texte Géodatabase en entrée contient déjà les informations nécessaires à une connexion à la géodatabase.

Esri conseille de laisser les options Exécuter une recherche de prérequis et Mettre à niveau la géodatabase activées. De cette façon, l'outil vérifie si les conditions préalables à la mise à niveau sont réunies avant la mise à niveau de la géodatabase.

Le contrôle préalable détecte d'autres connexions actives à la géodatabase, détermine si l'utilisateur qui tente d'établir la connexion a des privilèges suffisants pour mettre à niveau la géodatabase, garantit que la base de données peut prendre en charge des colonnes XML, s'assure que tous les jeux de données peuvent être ouverts et que la base de données et bibliothèques sont à la même version. Si les conditions préalables ne sont pas toutes remplies, l'outil s'arrête. Vous devez résoudre tous les problèmes avant d'exécuter à nouveau la mise à niveau.

Les résultats de ce contrôle sont signalés dans la boîte de dialogue de l'outil de géotraitement. Si la vérification (ou la mise à niveau) échoue, les résultats sont consignés dans le fichier GDBUpgrade.log qui se trouve dans le répertoire c:\Users\<user name>\AppData\Local\ESRI\<ArcGIS product>.

Si tous les contrôles aboutissent, l'outil poursuit la mise à niveau. L'état du contrôle préalable et de la mise à niveau est indiquée dans la boîte de dialogue de progression de l'outil de géotraitement. Si la mise à niveau échoue, des informations sont consignées dans le fichier journal GDBUpgrade.log. Des informations complémentaires sont écrites dans le fichier sdesetup.log, qui se trouve dans le répertoire TEMP système.

Exécuter un script

Pour mettre à niveau la géodatabase, copiez un de ces scripts d'exemple dans un éditeur de texte. Modifiez les valeurs des variables pour qu'elles correspondent aux informations de votre site.

Si vous avez un fichier de connexion à une base de données qui utilise une connexion directe pour se connecter en tant qu'utilisateur sde, copiez le script correspondant à votre système d'exploitation, collez-le dans un éditeur de texte et modifiez-le pour insérer les informations propres à votre site, puis enregistrez le fichier, fermez-le et exécutez-le :

# Name: upgradesdegdb_example.py
# Description: Connect from a Windows computer 
# with an existing database connection file 
# and upgrade an enterprise geodatabase
# Author: Esri

# Import arcpy module
import arcpy
 
# Local variables:
Output_Workspace = "C:\\ArcGIS\connection_files\<Connection file>"
Default_gdb = "C:\\ArcGIS\connection_files\<Connection file>"

# Process: Upgrade Geodatabase
arcpy.UpgradeGDB_management(Default_gdb, "PREREQUISITE_CHECK", "UPGRADE")

Si vous n'avez pas de fichier de connexion à une base de données sur l'ordinateur à partir duquel vous rédigez le script de mise à niveau, vous pouvez copier le script suivant et indiquer les informations propres à votre site sur la ligne de commande :

"""
Name: upgrade_gdb.py
Description: Provide connection information to an Enterprise geodatabase 
and upgrade the geodatabase
Type upgrade_gdb.py -h or upgrade_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 " + arcpy.GetInstallInfo()['Version'] )

#Define help and options
parser.add_option ("--DBMS", dest="Database_type", type="choice", choices=['SQLSERVER', 'ORACLE', 'POSTGRESQL', 'DB2','INFORMIX','DB2ZOS',''], 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 ("--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 ("--upgrade", dest="Upgrade", type="choice", choices=['TRUE', 'FALSE'], default="FALSE", help="Upgrade Options (case-sensitive):  TRUE=Perform Pre-requisite check and upgrade geodatabase, FALSE=Perform Pre-requisite check only.  Default=FALSE")                   
parser.add_option ("-D", dest="Database", type="string", default="none", help="Database name:  Not required for Oracle")


# 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 to upgrade
	account_authentication = options.account_authentication.upper()
	username = options.User.lower() 
	password = options.Password	
	do_upgrade = options.Upgrade
	database = options.Database.lower()
	database_type = options.Database_type.upper()
	instance = options.Instance
	
	if (database_type == ""):
		print "\nDatabase type must be specified!\n"
		parser.print_help()
		sys.exit(3)
	
	if (database_type == "SQLSERVER"):
		database_type = "SQL_SERVER"
	
	# Get the current product license
	product_license=arcpy.ProductInfo()
	
	# Checks required license level to upgrade
	if product_license.upper() == "ARCVIEW" or product_license.upper() == 'ENGINE':
		print "\n" + product_license + " license found!" + "  Enterprise geodatabase upgrade 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 upgrading.")
	else:
		print "\n" + product_license + " license available!  Continuing to upgrade..."
		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")
			
	# Check whether geodatabase needs upgrade
	isCurrent = arcpy.Describe(Connection_File_Name_full_path).currentRelease
	
	if isCurrent == True:
		print "The geodatabase is already at the current release and cannot be upgraded!"
		sys.exit("Upgrade did not run.")
	
	
	# Process: Upgrade geodatabase...
	try:
		if do_upgrade.lower() == "true":
			print "Upgrading Geodatabase...\n"
			arcpy.UpgradeGDB_management(input_workspace=Connection_File_Name_full_path, input_prerequisite_check="PREREQUISITE_CHECK", input_upgradegdb_check="UPGRADE")
			for i in range(arcpy.GetMessageCount()):
				arcpy.AddReturnMessage(i)
			arcpy.AddMessage("+++++++++\n")
	
		else:
			print "Running Pre-Requisite Check...\n"
			arcpy.UpgradeGDB_management(input_workspace=Connection_File_Name_full_path, input_prerequisite_check="PREREQUISITE_CHECK", input_upgradegdb_check="NO_UPGRADE")
			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)

Par exemple, si vous avez enregistré le fichier texte sous le nom gdbupgrade, que votre instance SQL Server est prod9, que votre base de données s'appelle myssgdb et que vous vous connectez avec l'authentification du système d'exploitation, saisissez les informations suivantes à l'invite de commande :

gdbupgrade --DBMS SQL_SERVER -i prod9 --auth OPERATING_SYSTEM_AUTH --upgrade TRUE -D myssgdb