Fonctionnement de l’outil Mettre à niveau la géodatabase

L’outil Mettre à niveau la géodatabase met à jour les objets de géodatabase dans les bases de données pour inclure des correctifs et de nouvelles fonctionnalités, incrémente la version de la géodatabase en fonction de la version du client ArcGIS qui exécute l’outil ou le script ArcPy, et analyse la géodatabase pour détecter les incohérences relatives aux versions de branche, puis rapporte les résultats dans un fichier journal.

Fichier de connexion à une base de données

Le fichier de connexion à une base de données (.sde) que vous fournissez en tant que valeur pour le paramètre Géodatabase en entrée doit accéder à la géodatabase en tant qu’administrateur de géodatabase :

  • Si le compte d’administrateur de géodatabase est un utilisateur de base de données, enregistrez le nom d’utilisateur et le mot de passe de cet utilisateur dans le fichier de connexion à une base de données avant de l’utiliser dans l’outil Mettre à niveau la géodatabase.
  • Si l’administrateur de géodatabase est un identifiant de connexion authentifié par le système d’exploitation, vous devez exécuter l’outil en étant connecté à la machine client ArcGIS avec cet identifiant de connexion.
  • Pour mettre à niveau une géodatabase dans Microsoft Azure SQL Database ou Microsoft Azure SQL Managed Instance qui utilise l’authentification Microsoft Entra ID, il est nécessaire d’effectuer l’une des opérations suivantes pour le fichier de connexion :
    • Pour utiliser un compte d’administrateur de géodatabase authentifié par Microsoft Entra Password ou un compte d’administrateur de géodatabase Microsoft Entra multifactor authentication (MFA), enregistrez le nom d’utilisateur et le mot de passe dans le fichier de connexion.
    • Pour utiliser un compte d’administrateur de géodatabase authentifié par Microsoft Entra Integrated, vous devez exécuter l’outil en étant connecté à la machine client ArcGIS avec cet identifiant de connexion Entra Integrated.

Paramètre Exécuter le contrôle préalable

Le contrôle préalable détecte les autres connexions actives à la géodatabase, détermine si la connexion actuelle procède à des modifications dans la géodatabase et s’assure que les tables système de la géodatabase actuelle peuvent être ouvertes. Pour les géodatabases d’entreprise, il détermine également si l’utilisateur qui tente d’établir la connexion dispose de privilèges suffisants pour mettre à niveau la géodatabase, s’assure que la base de données peut prendre en charge les colonnes XML et vérifie que la base de données et les bibliothèques sont à la même version.

Les résultats de ce contrôle sont rapportés dans la boîte de dialogue de l’outil.

Si l’un de ces prérequis n’est pas satisfait, l’outil n’effectue pas la mise à niveau, même si vous avez sélectionné le paramètre Mettre à niveau la géodatabase. Vous devez résoudre tous les problèmes avant d'exécuter à nouveau la mise à niveau.

Si vous sélectionnez le paramètre Exécuter le contrôle préalable ainsi que le paramètre Mettre à niveau la géodatabase et que tous les prérequis répertoriés ci-dessus sont remplis, l’outil Mettre à niveau la géodatabase effectue la mise à niveau de la géodatabase.

Paramètre Mettre à niveau la géodatabase

La sélection du paramètre Mettre à niveau la géodatabase permet de mettre à jour les objets de géodatabase, si nécessaire, pour mettre en œuvre des correctifs et de nouvelles fonctionnalités dans la géodatabase. Elle permet également d’incrémenter le numéro de version de la géodatabase dans l’une des tables système de la géodatabase.

Conseil :

L’administrateur de géodatabase peut accéder au numéro de version de la géodatabase pour les géodatabases d’entreprise dans la boîte de dialogue Propriétés de la base de données.

De plus, la sélection du paramètre Mettre à jour la géodatabase permet d’analyser les géodatabases d’entreprise pour rechercher les incohérences des données en branche versionnées, comme décrit ci-dessous.

Mises à niveau pour les géodatabases qui contiennent des données en branche versionnées

Lorsque vous mettez à niveau une géodatabase d’entreprise qui contient des données en branche versionnées, l’outil Mettre à niveau la géodatabase recherche les incohérences dans les versions de branche et les données en branche versionnées. Il peut créer des versions de récupération pour accéder aux données affectées. En tant qu’administrateur de géodatabase, vous devez utiliser ces versions de branche pour examiner et corriger les incohérences. L’outil Mettre à niveau la géodatabase crée des versions de branche dont les noms sont au format RECOVERY_VERSION_BR_<id_branche>.

Les informations sur les versions qui sont créées et les données qui leur sont associées sont enregistrées dans le fichier sde_setup.log. Révisez ce fichier pour identifier les versions à examiner pour accepter ou rejeter les modifications, procéder à la réconciliation avec la version par défaut et réinjecter les modifications depuis les versions de récupération dans la version par défaut. Consultez la section suivante pour l’emplacement de ce fichier.

Pour des instructions d’utilisation de ces versions, reportez-vous à l’article technique How To: Review branch recovery versions after upgrading an enterprise geodatabase.

Fichiers journaux et dépannage

Si le contrôle préalable ou la mise à niveau échoue, les résultats sont enregistrés dans le fichier GDBUpgrade.log dans le répertoire c:\Users\<user name>\AppData\Local\ESRI\<ArcGIS product>.

Des informations supplémentaires sont consignées dans le fichier sde_setup.log dans le répertoire TEMP de votre utilisateur. Si aucun répertoire temp n’est configuré pour votre utilisateur, le répertoire TEMP du système est utilisé.