Sustainability of Digital Formats: Planning for Library of Congress Collections

Introduction | Sustainability Factors | Content Categories | Format Descriptions | Contact
Format Description Categories >> Browse Alphabetical List

ESRI Geodatabase XML

>> Back
Table of Contents
Format Description Properties Explanation of format description terms

Identification and description Explanation of format description terms

Full name ESRI Geodatabase XML
Description ESRI's Geodatabase XML (GeoDB_XML) format is ESRI's open mechanism for data sharing among ArcGIS users, and for information interchange between geodatabases and external systems. GeoDB_XML is used by ArcGIS to import and export all items and data in a geodatabase such as domains, rules, feature datasets, and topologies. Using GeoDB_XML, external application can receive XML data streams that include full or partial portions of geodatabase schemas shareable between ArcGIS users, complete lossless datasets, simple feature sets (such as shapefiles) and change-only or delta record sets. The delta record-sets are XML streams that can be used to pass updates and changes among geodatabases and other external data structures.

There are three types of XML documents that can be created in ArcGIS: a workspace document, a record set document, and a data changes document.

  • Workspace Document -- XML Workspace documents are used to share schema information, exchange feature datasets and all of their contents, as well as any datasets with all associated data elements that have relationships to a dataset selected for export. The Workspace documents hold all of the contents of a geodatabase or any subset of the content including all of the schema information and, optionally, the data.

    The XML Workspace document contains two elements: WorkspaceDefinition and WorkspaceData. The schema, relationship, and behavior information exported as part of the WorkspaceDefinition section includes all simple and custom features data, participation in networks and topologies, network connectivity and topology rules, simple and composite relationships, and any other information associated with the geodatabase datasets. Therefore, all behavior associated with the geodatabase is preserved and can be re-created when the XML document is imported. The WorkspaceData contains the data for the dataset as well as attributes describing the dataset name and type.

    Using the WorkspaceDefinition and WorkspaceData elements, workspace documents contain the schema of a geodatabase and, optionally, data from its tables. The XML Workspace Document was designed to separate the the definition from the actual data so that software agents need read only the definition section of the document to discover what it contains. By making the data section optional, a workspace document can be used to transfer only schema information. In the case of tables and feature classes, the name of the data element in the definition section corresponds to the name of the table data in the data section. Other datasets, such as topologies, geometric networks, or feature datasets, appear only in the definition section and no data is exported for them.

  • Record Set Document -- The geodatabase RecordSet document is used to export the rows from a single feature class or table as simple features or attribute records. Exporting to a RecordSet document is analogous to exporting to a shapefile. The rows are exported as records, and no additional geodatabase-related information is written to the output file. For example, topologies and other feature dataset information will not be exported. Relationships to features in other tables will not be exported.
  • Data Changes Document -- As part of geodatabase transaction and version management, users may want to share and work with change-only record sets. The XML Data Changes document is used to share changes or updates among geodatabases and between the geodatabase and external systems. It does this by only distributing changes that can be tracked in the geodatabase using versioning. The primary information of a Data Changes document is an UpdateGram in which only changes are delivered as part of the XML document.

The XML schema for GeoDB_XML, GdbExchange.xsd can be found in the Program Files\ArcGIS\XMLSchema directory of the file system upon which ArcGIS products are implemented.

Production phase Primarily used as a middle-state format for transfer and exchange of geodatabase data and schema among ArcGIS products. For specific instructions on copying the schema of a geodatabase and other production tasks, see the discussion on the ESRI Developer Network Documentation Library at Copying the schema of a geodatabase.
Relationship to other formats
    Defined via XML_Schema, W3C XML Schema Language
    Affinity to GeoDB, ESRI Arc Geodatabase. This is the data model that serves as the framework for all Arc geodatabases, whether single user or multi-user. This data model has superseded the ESRI ArcInfo Coverage format which cannot be edited in ArcGIS 8.3 and subsequent versions.
    Affinity to GeoDB_File, ESRI Arc Geodatabase. A single user, file system based geodatabase that is one option for data storage for an ESRI Geodatabase.
    Affinity to GeoDB_Personal, GeoDB, ESRI Geodatabase (Personal). GeoDB_Personal, GeoDB, ESRI Geodatabase (Personal). An option for data storage for a single-user ESRI Geodatabase that is implemented as a single Microsoft Access file.
    Affinity to GeoDB_SDE, GeoDB, ESRI Geodatabase ArcSDE. The spatial database engine is the multi-user option for data storage for an ESRI Geodatabase.

Local use Explanation of format description terms

LC experience or existing holdings  
LC preference  

Sustainability factors Explanation of format description terms

Disclosure A proprietary XML-based data structure used in ESRI GIS products. Published as an XML schema, which is distributed to ArcGIS customers with the product and updated with each product version to fix bugs and cover new features. The schema is described, informally but in some detail, in a document available in PDF form and on the web from ESRI.

The XML Schema for Geodatabase XML is distributed to ArcGIS customers. It is found in the file GdbExchange.xsd at the path ArcGIS\XmlSchema\GdbExchange.xsd after product installation.

The latest version of the schema description is available from ESRI Support, White Papers/ArcInfo Desktop. As of August 2011, the latest version of the document, XML Schema of the Geodatabase was dated June 2008.

Adoption TBD
    Licensing and patents ESRI Licensing agreements detail the terms of use and compliance for ESRI GIS software per
Transparency The XML Workspace version of a Geodatabase instance is the most transparent of forms an ESRI Geodatabase can take, since the XML can be parsed and interpreted using general XML tools when the XML Schema is accessible.
Self-documentation TBD
External dependencies Software: The output from use of the GeoDB_XML format is viewable using ArcGIS products such as ArcCatalog. For those not licensing ArcCatalog, the ArcGIS Engine Developer Kit has the tools (ArcObjects) to use for building a viewer. Safe Software has an ESRI Geodatabase (XML) Reader / Writer, for which ArcGIS Desktop must be installed. See ESRI Geodatabase (XML) Reader/Writer for more information on this product. Safe Software also has a tool for reading and extracting data from Geodatabases within its FME Workbench product.
Technical protection considerations TBD

Quality and functionality factors Explanation of format description terms

GIS images and datasets
Normal functionality Any products of spatial analysis as reflected in topologies, tables of attributes, network analysis, etc. should be transferable as part of an XML workspace document using the GeoDB_XML format. If the data structure alone of a given geodatabase is desired, the GeoDB_XML format can be used to transfer the geodatabase schema without the data. In addition, simple changes to a database can be transferred between geodatabase versions using the GeoDB_XML format by using the portion of the GeoDB_XML schema that documents the changes in the geodatabase (Data Changes Document).

There is some indication that limitations in the ArcGIS tools also limit what can be transferred using the GeoDB_XML format. For instance, in cases when the user is interested in saving and restoring a geometric network within a geodatabase, ArcCatalog forces the user to drop any existing geometric network data when new data is to be included from another version of a geodatabase or an associated geodatabase. Other tool sets have been created to work around this problem, namely Geodatabase Designer 2. For discussion of this problem, see Geodatabases from Wildsong Wiki.

File type signifiers and format identifiers Explanation of format description terms

Tag Value Note
Filename extension xml
Internet Media Type text/xml

Notes Explanation of format description terms

General See Methods for copying geodatabases for an example implementation illustrating how users can share data updates between heterogenous systems.

The ArcGIS disconnected editing framework allows you to check data out of a database into a separate geodatabase, then edit the data without having a live connection to the parent database. Once the editing is done, it is possible to export only the changes (not all the data) to an XML file. This file can be used to subsequently check in the changes to the parent database. For more information about the disconnected editing framework, see Replication types. This is also a key part of geodatabase replication. For more information about geodatabase replication, see Working with geodatabase replication.

A set of tools that is recommended to use in conjunction with GeoDB_XML or other geodatabase schema is Geodatabase Designer 2 (GD2). GD2 is an open source tool set that is designed to document and exchange geodatabase schema, particularly when geometric networks are included in the geodatabase. GD2 includes an editor for geometric network connectivity rules. See ArcScripts for Geodatabase Designer v2 (9.2) for more information about this set of tools.

History The XML schema was made available in 2004 with version 9.0+ of ArcGIS, and updated in 2006. Changes to the schema have been documented in the 2008 version of the informal format specification document, "XML Schema of the Geodatabase."

Format specifications Explanation of format description terms

Useful references


Last Updated: 02/22/2017