Résumé
Inscrit auprès de la géodatabase les classes d’entités, tables, vues et couches raster créées dans la base de données à l’aide d’outils tiers ou les vues créées à l’aide de l’outil Créer une vue de base de données. Une fois enregistrées, les informations concernant les éléments, tels que les noms de tables et de colonnes, l’étendue spatiale et le type de géométrie, sont stockées dans les tables système de la géodatabase, permettant à ces éléments inscrits de contribuer aux fonctions de la géodatabase.
Utilisation
Utilisez cet outil pour inscrire auprès de la géodatabase les classes d’entités, tables, vues et couches raster que vous créez dans la base de données avec des outils tiers ou SQL. Les vues que vous créez avec l’outil Créer une vue de base de données peuvent également être inscrites auprès de la géodatabase.
Pour inscrire des éléments auprès d’une géodatabase d’entreprise, vous devez être connecté en tant que propriétaire du jeu de données en entrée.
Avant qu’une classe d’entités, table ou couche raster puisse contribuer pleinement aux fonctions de la géodatabase, elle doit être inscrite auprès de la géodatabase. Si elle n’est pas inscrite auprès de la géodatabase, seules certaines fonctions seront disponibles depuis les clients et services ArcGIS.
Les vues qui sont inscrites auprès de la géodatabase ne peuvent pas contribuer à certains comportements de la géodatabase et sont en lecture seule via les clients ArcGIS. Les vues ne sont pas prises en charge dans les services d’entités, même si vous les inscrivez auprès de la géodatabase.
Syntaxe
arcpy.management.RegisterWithGeodatabase(in_dataset, {in_object_id_field}, {in_shape_field}, {in_geometry_type}, {in_spatial_reference}, {in_extent})| Paramètre | Explication | Type de données |
in_dataset | Classe d’entités, table, vue ou couche raster créée à l’aide d’outils tiers ou SQL, ou vue créée à l’aide de l’outil Créer une vue de base de données que vous souhaitez inscrire auprès de la géodatabase. Le jeu de données doit exister dans la même base de données que la géodatabase. | Table View; Raster Layer |
in_object_id_field (Facultatif) | Champ utilisé comme champ ObjectID. Cette entrée est requise lors de l’inscription d’une vue et vous devez fournir un champ de type entier existant. Ce paramètre est facultatif lors de l’inscription d’autres types de jeu de données. Si vous utilisez un champ existant, il doit s’agir d’un champ de type de données entier. Si aucun champ existant n’est indiqué lors de l’inscription de ces autres types de jeux de données, un champ ObjectID est créé et renseigné. | Field |
in_shape_field (Facultatif) | Si le jeu de données en entrée contient une colonne pour le type de données spatiales, intégrez ce champ lors du processus d’inscription. | Field |
in_geometry_type (Facultatif) | Spécifie le type de géométrie. Si le paramètre in_shape_field est renseigné, vous devez spécifier un type de géométrie. Si le jeu de données à inscrire contient des entités existantes, le type de géométrie spécifié doit correspondre au type d’entité de ces entités.
| String |
in_spatial_reference (Facultatif) | Si le paramètre in_shape_field est renseigné et que la table est vide, spécifiez le système de coordonnées à utiliser pour les entités. Si le jeu de données à inscrire contient des entités existantes, le système de coordonnées spécifié doit correspondre au système de coordonnées des entités existantes. Les valeurs valides sont un objet Spatial Reference, un fichier avec une extension .prj ou une représentation de chaîne d’un système de coordonnées. | Spatial Reference |
in_extent (Facultatif) | Si le paramètre in_shape_field est renseigné, précisez la plage de coordonnées autorisée pour les coordonnées x,y dans l’ordre suivant : "XMin YMin XMax YMax". Si le jeu de données à inscrire contient des entités existantes, l’étendue des entités existantes sera utilisée. | Envelope |
Sortie dérivée
| Nom | Explication | Type de données |
| reg_dataset | Jeu de données inscrit. | Table |
Exemple de code
Exemple 1 d’utilisation de la fonction RegisterWithGeodatabase (fenêtre Python)
Le script ci-dessous pour la fenêtre Python explique comment utiliser la fonction RegisterWithGeodatabase dans la fenêtre Python pour une table spatiale qui contient des entités de géométrie de type point. La table sous-jacente contenant des entités existantes, la référence des coordonnées et les informations sur l’étendue des entités sont accessibles et n’ont pas besoin d’être répertoriées de manière explicite.
import arcpy
arcpy.env.workspace = r"Database Connections/connection.sde"
arcpy.RegisterWithGeodatabase_management("database.owner.COUNTIES", "OID",
"Shape", "POINT")
Exemple 2 d’utilisation de la fonction RegisterWithGeodatabase (script autonome)
Le script autonome suivant est un exemple d’application simple de la fonction RegisterWithGeodatabase dans l’écriture de scripts.
# RegisterWithGeodatabase.py
# Description: Simple example showing use of RegisterWithGeodatabase tool
# Import system modules
import arcpy
# Set variables
inTable = r"c:\connectionFiles\Connection to esriServer.sde\database.dbo.cities"
oid_field = "OID"
shape_field = "Shape"
geometry_type = "POINT"
sr = arcpy.SpatialReference(4326)
in_extent = "11 10 14 34"
# Process: Register With Geodatabase
arcpy.RegisterWithGeodatabase_management(inTable, oid_field, shape_field,
geometry_type, sr, in_extent)
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui