ArcGIS applies naming and geometry validation rules when connecting to a data source or creating data in supported databases as described in the following sections.
Tip:
ArcGIS does not support the creation of objects in cloud data warehouses or document databases.
Object names
Database and cloud data warehouse providers have different definitions of acceptable characters for object names. Sometimes the database allows you to use unsupported characters in object names if you provide the object name enclosed in delimiters, such as double quotation marks. However, ArcGIS doesn't delimit object names when querying the database; therefore, ArcGIS cannot recognize these names.
Name length
ArcGIS can read and (in some cases) create database objects such as tables, views, and users. The maximum name length that ArcGIS allows for these objects is listed in the following table, along with exceptions when applicable.
Note:
If the database allows fewer characters than what ArcGIS allows, you are limited to the number of characters allowed by the database. Consult the documentation for the database platform you're using for its object name limits.
The number of characters listed below assumes the use of single-byte characters.
| Object type | Maximum characters created by ArcGIS | Maximum characters read by ArcGIS | Exceptions |
|---|---|---|---|
Database name | Not applicable for any database except SQLite. 250 when creating in SQLite. | Up to the database management system or cloud data warehouse's limit. | ArcGIS can read the maximum database name allowed by Oracle. Database name values do not apply for SAP HANA, Elasticsearch, or OpenSearch. The database name for SQLite consists of the file path, file name, and the file extension. If the SQLite database is configured to use the ST_Geometry or SpatiaLite spatial type, the file extension is (.sqlite). If the SQLite database is configured as an OGC GeoPackage, the file extension is (.gpkg). |
Table, feature class, or view name | 128 158 when creating in SQLite. For databases with an object name limit of fewer than 128 characters, you can create table, view, and feature class names up to the database limit. | 128 158 when reading from SQLite. 127 when reading from Redshift or SAP HANA. 255 when reading from Elasticsearch or OpenSearch. | |
Index name | 128 For databases with an object name limit of fewer than 128 characters, you can create index names up to the database limit. | Up to the database limit. | Index names do not apply cloud data warehouses, Elasticsearch, or OpenSearch. |
Field (column) name | 128 For databases with an object name limit of fewer than 128 characters, you can create field names up to the database limit. | Up to the database or cloud data warehouse limit. | |
User name | ArcGIS only creates users in the following databases, and names up to those supported by the database are created.
| Up to the database or cloud data warehouse limit. | Username values do not apply to SQLite or BigQuery. |
Password | ArcGIS only creates passwords for users in the following databases. Maximum password lengths created are shown.
| 256 for all supported databases and cloud data warehouses except for the following:
| Password values do not apply to SQLite or BigQuery. |
For BigQuery, the maximum supported default dataset name length is 31 characters. The maximum supported project name length is 30 characters.
Geometry validation
When you create data in a database using an ArcGIS client, ArcGIS validates the geometry based on specific rules. If the geometry you construct in an ArcGIS client is not valid, ArcGIS will not allow you to insert it to the database.
Esri and IBM ST_Geometry constructor functions and ArcGIS API use the Esri shape library to validate geometry data when the feature is created. Therefore, even if you create an Esri or IBM ST_Geometry shape using SQL, validation rules are applied and invalid geometries will not be committed to the database.
Other spatial types, such as SDO_Geometry, PostGIS geometry or geography, and Microsoft SQL Server geometry or geography, have their own constructor functions and use their own geometry verification rules. These rules may not be the same as those applied by ArcGIS. ArcGIS clients verify geometry when the data is read and will not display geometries that violate ArcGIS geometry validation rules. If you connect to a database that contains data created outside ArcGIS, you must be aware of the rules ArcGIS applies.
Validation rules for points
The following validation rules are applied for point features:
- The area and length of points are 0.0.
- A single point's envelope is equal to the point's x,y values.
- The envelope of a multipart point is the minimum bounding box.
Validation rules for simple lines or linestrings
The following validation rules are applied for simple line features:
- Each part must have at least two distinct points.
- Each part may not intersect itself. The start point and end point can be the same, but the resulting ring is not treated as a polygon.
- Parts may touch each other at the end points.
- The length is the sum of all the parts.
Validation rules for lines or spaghetti strings
The following validation rules are applied for more complex line features:
- Lines can intersect themselves.
- Each part must have at least two distinct points.
- The length is the sum of all the parts.
Validation rules and operations for polygons
The following are validation rules and operations for polygons:
- Dangles are not valid.
- Line segments that compose the polygon are verified to be closed (z-coordinates at start point and end point must also be the same) and don't cross.
- For polygons with holes, holes must reside wholly inside the outer boundary. Any holes that are outside the outer boundary are invalid.
- A hole that touches an outer boundary at a single common point is converted into an inversion of the polygon.
- Multiple holes that touch at common points are combined into a single hole.
- Multipart polygons cannot overlap. However, two parts may touch at a point.
- Multipart polygons cannot share a common boundary.
- If two rings have a common boundary, they are merged into one ring.
- The total geometry perimeter, including the boundaries of all holes in donut polygons, is calculated and stored as the length of the geometry.
- The area is calculated.
- The envelope is calculated.
- The points of a polygon are stored
counterclockwise, although ArcGIS clients can return points in
either direction. If you generate a polygon that contains
clockwise coordinates, ArcGIS changes the rotation to ensure that
the coordinates follow a counterclockwise
direction.
In this example, the starting point is a and the correct coordinate description is a,b,c,d,a.
- A polygon can have inversions, which are empty spaces inside the polygon that touch the outer boundary.
- Inverted polygons have an interior ring that touches the outer boundary. These are not considered donut polygons.
- When a polygon has a donut hole, the outer boundary is read first. The points of the holes are stored in the opposite direction of the outer boundary.
In the following figure, the outer boundary is described as a,b,c,d,a, and the hole is described as e,f,g,h,e. For the entire polygon, the feature is stored as a,b,c,d,a,e,f,g,h,e.
- If two holes touch at one point, they are treated as one hole, not two.
In this example, the two inner areas are a single hole because they share a common point, g.
- The combination of polygons and polygons with holes can become fairly complex, as shown in the following graphic. The outer boundary is a lake with an island. There is a small lake on the island.
It is possible to represent these polygons as one, two, or three features. You could store each polygon as a separate feature. The larger lake is a donut polygon. The boundary of the large lake is the outer boundary while the island is the boundary of the single donut hole. The island is also a donut polygon. The boundary of the island is the outer boundary while the small lake is the hole. The small lake is a single polygon.
If the lakes are the important features, one feature with a hole represents the big lake, while a second shape represents the small lake. You could also use a multipart polygon to represent the feature. The first polygon part is the big lake with a donut hole representing the island. The second part is the small lake.
- Nil geometries are valid and act as placeholders. They allow you to have an attribute row without a corresponding geometry. One example that would result in a nil geometry is a request for the intersection of two nonintersecting polygons.
Because areas A and B do not touch, the result of an intersection query produces an empty geometry.
- Features have dimensions. A feature with only x,y coordinates is considered two-dimensional. A feature that has z-coordinates or measures is three-dimensional. A feature can also have a nil measure.
Spatial metadata
A geodatabase stores information about the spatial data it contains. ArcGIS clients can read information about the feature class's entity type (for example, points, lines, or polygons), dimensionality (x-, y-, z-, and m-coordinates), spatial reference, unique identifier, and feature class extent from geodatabase system tables. These same system tables are not available when ArcGIS connects to a feature class in a database. For this reason, ArcGIS must get that information from other sources.
When you drag a feature class (spatial table) onto a map in ArcGIS Pro, it creates a query layer. To define the query layer, ArcGIS Pro does the following:
- It queries the database for information about the spatial table, such as dimensionality, spatial reference, and geometry type.
- If that information is not defined for the table as a whole, ArcGIS Pro reads the first row in the table and uses the information from that feature.
- If the spatial reference, geometry type, or dimensionality cannot be determined by querying the first row—for example, if the table doesn't contain data or the row is using a custom spatial reference—you will be prompted to supply this information to use for the layer definition.
- ArcGIS Pro queries the database to find a not null column that can be used as a unique identifier (ObjectID) for the rows in the table. If a qualifying row cannot be found, you are prompted to define an Object ID for the table.
- Lastly, ArcGIS Pro calculates the extent of the layer when you add it to the map.
Because what is displayed in the map is based on a query, you can open the query layer definition and change it. For example, if the feature class contains both point and polygon features, you can open the query layer definition and choose which geometry type to display. Similarly, if the feature class contains multiple spatial columns, you can open the query layer definition and change the query to include a different spatial column instead. Be aware, though, that the query cannot be altered to display unsupported data types.