Inscrire auprès d’une géodatabase (Gestion des données)

Synthèse

Inscrit des classes d’entités, tables, vues et couches raster auprès de la géodatabase. L’inscription s’applique aux données créées dans la base de données à l’aide d’outils tiers utilisant SQL ou dans ArcGIS AllSource avec des outils qui ne sont pas inscrits auprès de la géodatabase (outils Créer une classe d’entités non inscrite, Créer une table non inscrite et Créer une vue de base de données).

Seules certaines fonctions sont disponibles depuis les clients et services ArcGIS pour les données non inscrites. L’inscription stocke les informations concernant les éléments, tels que les noms de table et de colonne, l’étendue spatiale et le type de géométrie, dans les tables système de la géodatabase. Cela permet aux éléments inscrits de contribuer aux fonctions de la géodatabase.

En savoir plus sur la procédure d’inscription d’une table ou d’une vue auprès de la géodatabase

Utilisation

  • Les vues que vous créez dans les géodatabases fichier et d’entreprise à l’aide de l’outil Créer une vue de base de données peuvent ê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.

  • 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.

Paramètres

ÉtiquetteExplicationType de données
Jeux de données en entrée

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
Champ d’ID d’objet
(Facultatif)

Champ utilisé comme champ ObjectID. Lorsqu’un champ existant des jeux de données en entrée est utilisé, des données de type entier sont requises. Si aucun champ existant n’est employé, un champ ObjectID est créé et renseigné.

Remarque :

Lors de l’inscription d’une vue, un champ existant de type entier est requis.

Field
Champ de forme
(Facultatif)

Le champ qui identifie la forme des entités. 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
Type de géométrie
(Facultatif)

Spécifie le type de géométrie. Si le paramètre Champ de forme est renseigné, vous devez spécifier un type de géométrie. Les types de géométrie pris en charge sont point, multi-point, polygone, polyligne et multipatch. 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.

  • PointLe type de géométrie est Point.
  • Multi-pointLe type de géométrie est Multi-point.
  • PolygoneLe type de géométrie est Polygone.
  • PolyligneLe type de géométrie est Polyligne.
  • MultipatchLa géométrie est de type multipatch.
String
Système de coordonnées
(Facultatif)

Si le paramètre Champ de forme 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.

Spatial Reference
Spécifier l’étendue
(Facultatif)

Si le paramètre Champ de forme est renseigné, spécifiez la plage de coordonnées autorisée pour les coordonnées x,y. Si le jeu de données à inscrire contient des entités existantes, l’étendue des entités existantes sera utilisée.

Envelope

Sortie obtenue

ÉtiquetteExplicationType de données
Jeu de données inscrit

Jeu de données inscrit.

Table

arcpy.management.RegisterWithGeodatabase(in_dataset, {in_object_id_field}, {in_shape_field}, {in_geometry_type}, {in_spatial_reference}, {in_extent})
NomExplicationType 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. Lorsqu’un champ existant des jeux de données en entrée est utilisé, des données de type entier sont requises. Si aucun champ existant n’est employé, un champ ObjectID est créé et renseigné.

Remarque :

Lors de l’inscription d’une vue, un champ existant de type entier est requis.

Field
in_shape_field
(Facultatif)

Le champ qui identifie la forme des entités. 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.

  • POINTLe type de géométrie est Point.
  • MULTIPOINTLe type de géométrie est Multi-point.
  • POLYGONLe type de géométrie est Polygone.
  • POLYLINELe type de géométrie est Polyligne.
  • MULTIPATCHLa géométrie est de type multipatch.
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é, spécifiez 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 obtenue

NomExplicationType 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.management.RegisterWithGeodatabase("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.management.RegisterWithGeodatabase(inTable, oid_field, shape_field, 
                                         geometry_type, sr, in_extent)
Exemple 3 d’utilisation de la fonction RegisterWithGeodatabase (script autonome)

Inscrire une vue nommée trees auprès d’une géodatabase fichier.

# RegisterWithGeodatabase.py
# Description: Example showing use of RegisterWithGeodatabase tool with a file 
#              gdb view.

# Import system modules
import arcpy

# Create a view in the geodatabase
arcpy.management.CreateDatabaseView("C:\\testdata\\mytest.gdb",
                                    "trees",
                                    "select objectid, owner, parcel from inventory where type = trees")

# Set variables
inTable = r"C:\\testdata\\mytest.gdb\\trees"

# Process: Register With Geodatabase
arcpy.management.RegisterWithGeodatabase(inTable, "objectid")

Rubriques connexes