Crée un réplica à partir du serveur (Gestion des données)

Synthèse

Crée un réplica à l’aide d’une liste spécifiée de classes d’entités, de couches, de jeux de classes d’entités et de tables depuis une géodatabase distante avec un service de géodonnées publié sur ArcGIS Server.

Utilisation

  • La source doit être un service de géodonnées qui représente une géodatabase d'entreprise distante. La destination peut être soit une géodatabase locale, soit une géodatabase distante.

  • Les données qui seront répliquées doivent être inscrites selon le versionnement traditionnel, mais pas avec l’option d’enregistrement des mises à jour dans la base. L’utilisateur de la base de données connecté doit disposer d’autorisations en écriture sur les données. Pour les deux types de réplicas monodirectionnels et les réplicas bidirectionnels, tous les jeux de données doivent avoir une colonne globalid et une référence spatiale haute précision.

  • Pour les réplicas monodirectionnels et les réplicas d’extraction, la géodatabase du réplica enfant doit être de type fichier ou d’entreprise.

  • Pour les réplicas monodirectionnels et bidirectionnels enfants vers parents, la géodatabase enfant doit être une géodatabase d’entreprise.

  • Pour utiliser l’archivage pour les réplicas monodirectionnels, l’espace de travail parent doit être connecté à la version par défaut. Pour les réplicas monodirectionnels enfants vers parents, l’espace de travail enfant doit être connecté à la version par défaut.

  • L'option par défaut pour les classes d'entités est de répliquer toutes les entités. Le filtre par défaut pour les tables est Structure uniquement ; seule la structure de la table est répliquée. Si vous définissez l’environnement Étendue ou si vous spécifiez des entités de géométrie du réplica, il s’applique en tant que filtre spatial dans lequel seules les entités qui ont une intersection avec l’étendue sont répliquées. Les tables comprennent également des enregistrements associés aux enregistrements qui font partie du réplica.

  • Le paramètre Replica Geometry Features (Entités de géométrie de réplication) peut permettre de définir la géométrie de réplication. Vous pouvez utiliser également le paramètre d’environnement Etendue pour définir la géométrie de réplication.

    • Si seul le paramètre Replica Geometry Features (Entités de géométrie de réplication) est défini, seules les données qui intersectent les entités de géométrie de réplication seront répliquées.
    • Si seul l’environnement Extent (Étendue) est défini, seules les données qui intersectent l’étendue seront répliquées.
    • Si le paramètre Replica Geometry Features (Entités de géométrie de réplication) et l’environnement Extent (Étendue) sont définis, le paramètre Replica Geometry Features (Entités de géométrie de réplication) sera utilisé.
    • Si ni le paramètre Replica Geometry Features (Entités de géométrie de réplication), ni l’environnement Extent (Étendue) n’est spécifié, l’étendue complète des données sera utilisée.

  • Les entités de géométrie de réplication peuvent être des polygones, des lignes ou des points.

  • Une couche d’entités utilisée pour les entités de la géométrie de réplication peut contenir une ou plusieurs entités. En présence de plusieurs entités, les géométries sont combinées et seules les données qui intersectent les géométries combinées sont répliquées.

  • Si des filtres (à savoir. spatial, sélection ou ensemble de définition) ont été définis sur les entités de la géométrie de réplication, seules les entités qui correspondent à ces filtres permettent de définir la géométrie de réplication. Pour plus d’informations, reportez-vous à la rubrique Préparation des données à répliquer.

  • Les options du paramètre Réutiliser la structure sont uniquement disponibles pour les réplicas d’extraction

Paramètres

ÉtiquetteExplicationType de données
Service de géodonnées

Service de géodonnées représentant la géodatabase à partir de laquelle le réplica sera créé. La géodatabase référencée par le service de géodonnées doit être une géodatabase d'entreprise.

GeoDataServer
Jeux de données

Liste des jeux de données d’entité, des classes d’entités autonomes, des tables et des classes de relations attribuées autonomes du service de géodonnées à répliquer.

String
Type de réplica

Spécifie le type de réplica à créer.

  • Réplica bidirectionnelLes modifications sont envoyées entre les réplicas enfant et parent, dans les deux sens.
  • Réplica monodirectionnelLes modifications sont envoyées du réplica parent vers le réplica enfant uniquement.
  • Réplica d’extractionLes données sont répliquées, mises à jour et réinsérées en une seule opération.
  • Réplica monodirectionnel de l’enfant vers le parentLes modifications sont envoyées du réplica enfant vers le réplica parent uniquement.
String
Géodatabase pour la création du réplica

Géodatabase locale qui hébergera le réplica enfant. Des services de géodonnées sont utilisés pour représenter des géodatabases distantes. La géodatabase peut être de type entreprise ou fichier. Pour les réplicas bidirectionnels, la géodatabase enfant doit être une géodatabase d’entreprise. Pour les réplicas monodirectionnels et les réplicas d’extraction, la géodatabase doit être de type fichier ou d’entreprise. Les géodatabases fichier doivent déjà exister avant l’exécution de cet outil.

Workspace ; GeoDataServer
Nom du réplica

Nom permettant d’identifier le réplica.

String
Type d’accès au réplica
(Facultatif)

Spécifie le type d’accès au réplica.

  • CompletLes types complexes, tels que les topologies, sont pris en charge et les données doivent être versionnées. Il s’agit de l’option par défaut.
  • SimpleLes données au niveau enfant ne sont pas versionnées et doivent être simples. Cela permet l’interopérabilité du réplica. Les entités complexes dans le parent (par exemple, entités de topologies) sont converties en entités simples (par exemple, classes d’entités ponctuelles, linéaires et surfaciques).
String
Expéditeur de données initial
(Facultatif)

Spécifie quel réplica envoie des modifications en mode déconnecté. Si vous travaillez en mode connecté, ce paramètre n’a aucun effet. Ceci a pour but d’empêcher l’envoi de mises à jour par le réplica associé tant que les modifications n’ont pas été reçues de l’expéditeur de données initial.

  • Expéditeur de données enfantLe réplica enfant est l’expéditeur de données initial. Il s’agit de l’option par défaut.
  • Expéditeur de données parentLe réplica parent est l’expéditeur de données initial.
String
Développer les classes d’entités et les tables
(Facultatif)

Indique si des tables et des classes d’entités développées, telles que celles qui se trouvent dans les réseaux, les topologies ou les classes de relations, seront ajoutées.

  • Utiliser les options par défautLes tables et les classes d’entités développées associées aux tables et aux classes d’entités dans le réplica seront ajoutées. L’option par défaut pour les classes d’entités est de répliquer toutes les entités qui intersectent le filtre spatial. Si aucun filtre spatial n’a été défini, toutes les entités sont incluses. L’option par défaut pour les tables est de répliquer uniquement la structure. Il s’agit de l’option par défaut.
  • Ajouter avec la structure uniquementSeule la structure pour les classes d’entités et les tables développées sera ajoutée.
  • Toutes les lignesToutes les lignes pour les tables et les classes d’entités développées seront ajoutées.
  • Ne pas ajouterAucune table ou classe d’entités développée n’est ajoutée.
String
Réutiliser la structure
(Facultatif)

Précise si une géodatabase qui contient la structure des données à répliquer sera réutilisée. Cela réduit la durée de réplication des données. Ce paramètre est disponible uniquement pour les réplicas d’extraction.

  • Ne pas réutiliserLa structure ne sera pas réutilisée. Il s’agit de l’option par défaut.
  • RéutiliserLa structure sera réutilisée.
String
Répliquer les données reliées
(Facultatif)

Indique si les lignes associées aux lignes existantes dans le réplica sont répliquées. Prenons l’exemple d’une entité (f1) à l’intérieur du filtre de réplication et d’une entité associée (f2) issue d’une autre classe et extérieure au filtre. L’entité f2 est comprise dans le réplica si vous choisissez d’extraire les données reliées.

  • Ne pas relierLes données associées ne seront pas répliquées.
  • RelierLes données associées seront répliquées. Il s’agit de l’option par défaut.
String
Entités de géométrie de réplication
(Facultatif)

Entités utilisées pour définir la surface à répliquer.

Feature Layer
Utiliser l’archivage pour suivre les modifications apportées à une réplication monodirectionnelle
(Facultatif)

Précise si la classe d’archives sera utilisée pour suivre les modifications plutôt que les tables delta de versionnement. Cette option n’est disponible que pour les réplicas monodirectionnels.

  • ArchivageL’archivage sera utilisé pour le suivi des modifications.
  • Ne pas utiliser l’archivageL’archivage ne sera pas utilisé pour le suivi des modifications. Il s’agit de l’option par défaut.
Boolean
Tous les enregistrements des tables
(Facultatif)

Indique si tous les enregistrements ou uniquement la structure sont copiés vers les géodatabases enfant pour les tables n’ayant pas de filtres appliqués (par exemple, les sélections ou les ensembles de définition).

Les tables comportant des filtres appliqués sont traitées.

  • Sélectionné : Pour les tables sans filtres appliqués, tous les enregistrements sont copiés vers la géodatabase enfant. Cette option remplace la valeur du paramètre Développer les classes d’entités et les tables.
  • Non sélectionné : Pour les tables sans filtres appliqués, seule la structure est copiée vers la géodatabase enfant. Les tables comportant des filtres appliqués sont traitées. Il s’agit de l’option par défaut.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Service de géodonnées en sortie

Service de géodonnées mis à jour.

Workspace;GeoDataServer
Nom du réplica

Nom du réplica en sortie.

String

arcpy.management.CreateReplicaFromServer(in_geodataservice, datasets, in_type, out_geodatabase, out_name, {access_type}, {initial_data_sender}, {expand_feature_classes_and_tables}, {reuse_schema}, {get_related_data}, {geometry_features}, {archiving}, {all_records_for_tables})
NomExplicationType de données
in_geodataservice

Service de géodonnées représentant la géodatabase à partir de laquelle le réplica sera créé. La géodatabase référencée par le service de géodonnées doit être une géodatabase d'entreprise.

GeoDataServer
datasets
[dataset_name,...]

Liste des jeux de données d’entité, des classes d’entités autonomes, des tables et des classes de relations attribuées autonomes du service de géodonnées à répliquer.

String
in_type

Spécifie le type de réplica à créer.

  • TWO_WAY_REPLICALes modifications sont envoyées entre les réplicas enfant et parent, dans les deux sens.
  • ONE_WAY_REPLICALes modifications sont envoyées du réplica parent vers le réplica enfant uniquement.
  • CHECK_OUTLes données sont répliquées, mises à jour et réinsérées en une seule opération.
  • ONE_WAY_CHILD_TO_PARENT_REPLICALes modifications sont envoyées du réplica enfant vers le réplica parent uniquement.
String
out_geodatabase

Géodatabase locale qui hébergera le réplica enfant. Des services de géodonnées sont utilisés pour représenter des géodatabases distantes. La géodatabase peut être de type entreprise ou fichier. Pour les réplicas bidirectionnels, la géodatabase enfant doit être une géodatabase d’entreprise. Pour les réplicas monodirectionnels et les réplicas d’extraction, la géodatabase doit être de type fichier ou d’entreprise. Les géodatabases fichier doivent déjà exister avant l’exécution de cet outil.

Workspace ; GeoDataServer
out_name

Nom permettant d’identifier le réplica.

String
access_type
(Facultatif)

Spécifie le type d’accès au réplica.

  • FULLLes types complexes, tels que les topologies, sont pris en charge et les données doivent être versionnées. Il s’agit de l’option par défaut.
  • SIMPLELes données au niveau enfant ne sont pas versionnées et doivent être simples. Cela permet l’interopérabilité du réplica. Les entités complexes dans le parent (par exemple, entités de topologies) sont converties en entités simples (par exemple, classes d’entités ponctuelles, linéaires et surfaciques).
String
initial_data_sender
(Facultatif)

Spécifie quel réplica envoie des modifications en mode déconnecté. Si vous travaillez en mode connecté, ce paramètre n’a aucun effet. Ceci a pour but d’empêcher l’envoi de mises à jour par le réplica associé tant que les modifications n’ont pas été reçues de l’expéditeur de données initial.

  • CHILD_DATA_SENDERLe réplica enfant est l’expéditeur de données initial. Il s’agit de l’option par défaut.
  • PARENT_DATA_SENDERLe réplica parent est l’expéditeur de données initial.
String
expand_feature_classes_and_tables
(Facultatif)

Indique si des tables et des classes d’entités développées, telles que celles qui se trouvent dans les réseaux, les topologies ou les classes de relations, seront ajoutées.

  • USE_DEFAULTSLes tables et les classes d’entités développées associées aux tables et aux classes d’entités dans le réplica seront ajoutées. L’option par défaut pour les classes d’entités est de répliquer toutes les entités qui intersectent le filtre spatial. Si aucun filtre spatial n’a été défini, toutes les entités sont incluses. L’option par défaut pour les tables est de répliquer uniquement la structure. Il s’agit de l’option par défaut.
  • ADD_WITH_SCHEMA_ONLYSeule la structure pour les classes d’entités et les tables développées sera ajoutée.
  • ALL_ROWSToutes les lignes pour les tables et les classes d’entités développées seront ajoutées.
  • DO_NOT_ADDAucune table ou classe d’entités développée n’est ajoutée.
String
reuse_schema
(Facultatif)

Précise si une géodatabase qui contient la structure des données à répliquer sera réutilisée. Cela réduit la durée de réplication des données. Ce paramètre est disponible uniquement pour les réplicas d’extraction.

  • DO_NOT_REUSELa structure ne sera pas réutilisée. Il s’agit de l’option par défaut.
  • REUSELa structure sera réutilisée.
String
get_related_data
(Facultatif)

Indique si les lignes associées aux lignes existantes dans le réplica sont répliquées. Prenons l’exemple d’une entité (f1) à l’intérieur du filtre de réplication et d’une entité associée (f2) issue d’une autre classe et extérieure au filtre. L’entité f2 est comprise dans le réplica si vous choisissez d’extraire les données reliées.

  • DO_NOT_GET_RELATEDLes données associées ne seront pas répliquées.
  • GET_RELATEDLes données associées seront répliquées. Il s’agit de l’option par défaut.
String
geometry_features
(Facultatif)

Entités utilisées pour définir la surface à répliquer.

Feature Layer
archiving
(Facultatif)

Précise si la classe d’archives sera utilisée pour suivre les modifications plutôt que les tables delta de versionnement. Cette option n’est disponible que pour les réplicas monodirectionnels.

  • ARCHIVINGL’archivage sera utilisé pour le suivi des modifications.
  • DO_NOT_USE_ARCHIVINGL’archivage ne sera pas utilisé pour le suivi des modifications. Il s’agit de l’option par défaut.
Boolean
all_records_for_tables
(Facultatif)

Indique si tous les enregistrements ou uniquement la structure sont copiés vers les géodatabases enfant pour les tables n’ayant pas de filtres appliqués (par exemple, les sélections ou les ensembles de définition).

Les tables comportant des filtres appliqués sont traitées.

  • ALL_RECORDS_FOR_TABLESPour les tables sans filtres appliqués, tous les enregistrements sont copiés vers la géodatabase enfant. Cette option remplace la valeur du paramètre expand_feature_classes_and_tables.
  • SCHEMA_ONLY_FOR_TABLESPour les tables sans filtres appliqués, seule la structure est copiée vers la géodatabase enfant. Les tables comportant des filtres appliqués sont traitées. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_geodata

Service de géodonnées mis à jour.

Workspace;GeoDataServer
output_name

Nom du réplica en sortie.

String

Exemple de code

Exemple 1 d'utilisation de l'outil CreateReplicaFromServer (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction CreateReplicaFromServer en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/Data/MySDEdata.sde"
arcpy.management.CreateReplicaFromServer(
        "C:/MyServerConn/RoadMap.GeoDataServer", "Roads", "TWO_WAY_REPLICA", 
        arcpy.env.workspace, "MajorRoads_replica", "FULL", "CHILD_DATA_SENDER", 
        "USE_DEFAULTS", "DO_NOT_REUSE", "GET_RELATED")
Exemple 2 d'utilisation de l'outil CreateReplicaFromServer (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction CreateReplicaFromServer.

# Name: CreateReplicaFromServer_Example2.py
# Description: Creates a two-way replica from a geodata service

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/MySDEdata.sde"

# Set local variables
gisServer = "C:/MyServerConn/RoadMap.GeodataServer"
in_datasets = "Roads; Streets"
replica_type = "TWO_WAY_REPLICA"
out_workspace = env.workspace
replica_name = "MajorRoads_replica"
access_type = "FULL"
initial_sender = "CHILD_DATA_SENDER"
expand = "USE_DEFAULTS"
reUse = "DO_NOT_REUSE"
related = "GET_RELATED"
replica_geometry = "LA_County"
archiving = "DO_NOT_USE_ARCHIVING"

# Run CreateReplicaFromServer
arcpy.management.CreateReplicaFromServer(
        gisServer, in_datasets, replica_type, out_workspace, replica_name, 
        access_type, initial_sender, expand, reUse, related, replica_geometry, 
        archiving)

Rubriques connexes