SQL Server configuration parameters

Configuration parameters identify a database object to be configured. Their corresponding values identify how the object will be stored in the database. The parameters and their configuration strings are grouped together by configuration keywords.

In geodatabases stored in Microsoft SQL Server, configuration parameters and their corresponding configuration strings are used by ArcGIS to define how data is stored. The following lists storage settings available with different parameters:

  • Define the data type for spatial columns.
  • Define how character data is stored.
  • Make keywords available for users in the ArcGIS interface.
  • Provide comments that describe the configuration keyword.

Legacy:

Configuration keywords and parameters are largely legacy functionality. They were implemented when databases required far more intervention and tinkering on the part of the database administrator to get them to perform well. For the most part, you will not need to alter the configuration parameters in your geodatabase.

When you create an enterprise geodatabase, it is populated with default configuration keywords and parameters. In the majority of cases, the default parameter values are sufficient. Possible exceptions include the following:

  • You might want to change the spatial type used for features. If you want the majority of feature classes to use a spatial type different than the default value, change the GEOMETRY_STORAGE parameter for the DEFAULTS keyword. If you want only some feature classes to use a different spatial type, create a custom keyword and include the GEOMETRY_STORAGE parameter set to the spatial type you want, and include the UI_TEXT parameter to make your custom keyword available to users.
  • If you will never need to store multibyte characters in your attribute fields, you could set the UNICODE_STRING parameter for the DEFAULTS keyword to FALSE. New text fields will use the varchar data type instead of nvarchar, which could save a tiny amount of storage space in your database. If data creators in your organization need to create a few tables or feature classes that store large amounts of single-byte text inside a single field in each table, you can create a custom keyword and include the UNICODE_STRING parameter set to FALSE, and include the UI_TEXT parameter to make your custom keyword available to users.
  • If you want to group your data into different file groups so you can create backups of individual file groups, you can create custom keywords for different types of data and set parameters in each keyword that will store all tables and indexes for that type of data in a specific file group. For example, you might want all actively edited data to go to one file group so you can create more frequent backups, so you would create an EDITED_LAYERS keyword that contains business, adds, and deletes table parameters that store all tables and indexes for these layers in the same file group.

Additional parameters exist to control the following, but you are far less likely to use these parameters. They remain for backward compatibility and, therefore, remain in this page to help you understand their intended use when they were added:

  • Whether to cluster an index.
  • How much to fill each index page (FILLFACTOR).
  • How much binary data should be stored in-line to a data page (OUT_OF_ROW).
  • Define how XML documents are stored. Because ArcGIS does not use XML documents directly, it is unlikely you'll need to set these parameters.

The following table is an alphabetic list of all the possible configuration parameters that can be used in a geodatabase in SQL Server. Default values are listed first where applicable. Following the table is a more in-depth explanation of the parameters roughly grouped by related functionality.

Parameter nameDescriptionValues

A_CLUSTER_RASTER

Index type for raster column in Adds table

0 or 1; 1 = clustered 0 = nonclustered

A_CLUSTER_ROWID

Index type for rowid column on Adds table

0 or 1; 1 = clustered 0 = nonclustered

A_CLUSTER_STATEID

Index type for Adds table stated column

0 or 1; 1 = clustered 0 = nonclustered

A_CLUSTER_USER

Index type for any user-defined indexes on Adds table

0 or 1; 1 = clustered 0 = nonclustered

A_CLUSTER_XML

Index type for xml doc type column of Adds table

0 or 1; 1 = clustered 0 = nonclustered

A_INDEX_RASTER

Index type for raster column in Adds table

0 or 1; 1 = clustered 0 = nonclustered

A_INDEX_ROWID

Adds table object ID column index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

A_INDEX_STATEID

Adds table sde_state_id column index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

A_INDEX_USER

Adds table index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

A_INDEX_XML

Adds table XML column index table storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

A_OUT_OF_ROW

Determines whether or not data will be stored in row or out of row for varbinary(max) columns in the adds table

If set to 0, up to 8,000 bytes can be stored directly in the data page of the table. If set to 1, data will always be stored out of row.

0 or 1

A_STORAGE

Adds table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

AUX_CLUSTER_COMPOSITE

Index type for primary key

1 or 0; 1 = clustered 0 = nonclustered

AUX_INDEX_COMPOSITE

Raster AUX table composite column index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

AUX_STORAGE

Raster AUX table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

B_CLUSTER_RASTER

Index type for raster column in business table

0 or 1; 1 = clustered 0 = nonclustered

B_CLUSTER_ROWID

Index type for rowid column on business table

0 or 1; 1 = clustered 0 = nonclustered

B_CLUSTER_TO_DATE

Specifies the index type on the to_date,archive_rowid column in the history table of a table that is enabled for archiving.

0 or 1; 1 = clustered 0 = nonclustered

B_CLUSTER_USER

Index type for any user-defined indexes on business table

0 or 1; 1 = clustered 0 = nonclustered

B_CLUSTER_XML

Index type for xml doc type column of business table

0 or 1; 1 = clustered 0 = nonclustered

B_INDEX_RASTER

Business table raster column index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

B_INDEX_ROWID

Business table object ID column index raster rowid index R<N>_SDE_ROWID_UK storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

B_INDEX_TO_DATE

Storage parameter info for creating the index R<registration_id>_sde_todate, which is used when updating the history table during an archive operation

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

B_INDEX_USER

Business table user index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

B_INDEX_XML

Business table XML column index table storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

B_OUT_OF_ROW

Determines whether or not data will be stored in row or out of row for varbinary(max) columns in a business table

If set to 0, up to 8,000 bytes can be stored directly in the data page of the table. If set to 1, data will always be stored out of row.

0 or 1

B_STORAGE

Business table and raster attribute table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

BLK_CLUSTER_COMPOSITE

Index type for primary key

1 or 0; 1 = clustered 0 = nonclustered

BLK_INDEX_COMPOSITE

Raster BLK table composite column index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

BLK_OUT_OF_ROW

Determines whether or not data will be stored in row or out of row for varbinary(max) columns in the raster blocks table

If set to 0, up to 8,000 bytes can be stored directly in the data page of the table. If set to 1, data will always be stored out of row.

0 or 1

BLK_STORAGE

Raster BLK table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

BND_CLUSTER_COMPOSITE

Index type for primary key

0 or 1; 1 = clustered 0 = nonclustered

BND_CLUSTER_ID

Index type for RASTER_ID, SEQUENCE_NBR columns

0 or 1; 1 = clustered 0 = nonclustered

BND_INDEX_COMPOSITE

Raster BND table composite column index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

BND_INDEX_ID

Raster BND table RID column index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

BND_STORAGE

Raster BND table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

COLLATION_NAME

Collation of user-defined text columns

Uses the database collation by default, unless other collation is specified

COMMENT

Line used for comments

Description up to 2,048 characters

D_CLUSTER_ALL

Index type for SDE_STATES_ID, SDE_DELETES_ROW_ID, and DELETED_AT columns

0 or 1; 1 = clustered 0 = nonclustered

D_CLUSTER_DELETED_AT

Index type for DELETED_AT column

1 or 0; 1 = clustered 0 = nonclustered

D_INDEX_ALL

FILLFACTOR and location (file group) for composite index on SDE_STATES_ID, SDE_DELETES_ROW_ID, and DELETED_AT columns

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

D_INDEX_DELETED_AT

Deletes table DELETED_AT column index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

D_STORAGE

Deletes table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

GEOMETRY_STORAGE

Indicates storage type for spatial column

GEOMETRY or GEOGRAPHY

GEOM_SRID_CHECK

Adds a check constraint on the geometry column for an SRID value

TRUE or FALSE

I_STORAGE

Defines storage for the i tables, which are used to generate IDs.

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

MVTABLES_MODIFIED_INDEX

Mvtables_modified index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

MVTABLES_MODIFIED_TABLE

Mvtables_modified table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

NUM_DEFAULT_CURSORS

Controls the SQL Server cursor threshold

-1 = All keysets are generated synchronously

0 = All cursor keysets are generated asynchronously

For all other values, the SQL Server Query Optimizer compares the number of expected rows in the cursor set to the number set in the cursor threshold, then builds the keyset asynchronously if it exceeds the cursor threshold number.

PERMISSION_CACHE_THRESHOLD

Controls amount of time (in milliseconds) the database can take to query the sysprotects table

If the PERMISSION_CACHE_THRESHOLD value is exceeded, a temporary table (cache) is created to store a user's permission and is used from then on. If PERMISSION_CACHE_THRESHOLD = 0, permission will always be cached. When PERMISSION_CACHE_THRESHOLD is set to any value greater than 0, the permission is cached if the query time exceeds the value in milliseconds. If PERMISSION_CACHE_THRESHOLD is set to -1 (the default setting), the permission is never cached.

0–1,000

-1(disabled) is the default value

RAS_CLUSTER_ID

Index type for primary key of RAS table

1 or 0; 1 = clustered 0 = nonclustered

RAS_INDEX_ID

Raster RAS table RID index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

RAS_STORAGE

Raster RAS table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

RASTER_STORAGE

Defines the raster data storage type

binary

STATES_INDEX

States table storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

STATES_LINEAGES_INDEX

Controls the storage of the index on the SDE_state_lineages table's primary key

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

STATES_LINEAGES_TABLE

State_lineages table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

STATES_TABLE

States table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

UI_NETWORK_TEXT

User interface parameter, which indicates associated configuration keyword will appear in the ArcGIS user interface; contains description of network configuration

Description up to 2,048 characters

Not used in ArcGIS Pro

UI_TERRAIN_TEXT

User interface parameter, which indicates associated configuration keyword will appear in the ArcGIS user interface; contains description of terrain configuration

Description up to 2,048 characters

UI_TEXT

User interface parameter, which indicates associated configuration keyword will appear in the ArcGIS user interface; contains description of associated noncomposite configuration keyword

Description up to 2,048 characters

UI_TOPOLOGY_TEXT

User interface parameter, which indicates associated configuration keyword will appear in the ArcGIS user interface; contains description of topology configuration

Description up to 2,048 characters

UNICODE_STRING

Determines whether Unicode text types will be used or not

If set to TRUE, character fields will be stored in UNICODE compliant data types. For example, if the UNICODE_STRING parameter is set to FALSE, a string data type would be VARCHAR. If UNICODE_STRING is set to TRUE, the data type of the field would be NVARCHAR.

TRUE or FALSE

VERSIONS_INDEX

Version index storage definition

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

VERSIONS_TABLE

Versions table storage definition

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

XML_COLUMN_PATH_IDX

Determines if an XML path index is created

1 or 0

0 = No path index created, 1 = Path index is created.

XML_COLUMN_PRIMARY_IDX

Determines if XML primary index is created

1 or 0

0 = No primary index created, 1 = Primary index created

XML_COLUMN_PROPERTY_IDX

Determines if XML property index is created

0 or 1

0 = No property index created, 1 = Property index created

XML_COLUMN_SCHEMA

Specifies the XML schema to be used for validation

XML schema collection name, up to 128 characters

XML_COLUMN_TYPE

Specifies the XML document type that a column can store

CONTENT or DOCUMENT

XML_COLUMN_VALUE_IDX

Determines if XML value index is created

1 or 0

0 = No value index created, 1 = Value index is created.

XML_DOC_INDEX

Storage clause for xmldoc<n>_pk and xml_doc<n>_ix indexes on the sde_xml_doc<n> table

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

XML_DOC_MODE

Storage type for XML documents

COMPRESSED or UNCOMPRESSED

XML_DOC_OUT_OF_ROW

Determines whether or not XML document BLOB data will be stored in row or out of row; only used for varbinary(max) columns

If set to 0, up to 8,000 bytes can be stored directly in the data page of the table. If set to 1, data will always be stored out of row.

0 or 1

XML_DOC_STORAGE

Storage clause for sde_xml_doc<n> table

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

XML_DOC_UNCOMPRESSED_TYPE

When the XML_DOC_MODE parameter is set to UNCOMPRESSED, the XML_DOC_UNCOMPRESSED_TYPE parameter determines the storage format for XML documents

Since XML_DOC_MODE is set to COMPRESSED by default, the XML_DOC_UNCOMPRESSED_TYPE parameter is not present by default. Possible values: BINARY, TEXT, or UNICODE

XML_IDX_CLUSTER_DOUBLE

Storage clause indicating if the xmlix<n>_db index on the double_tag column of the sde_xml_idx<n> table is clustered

0 or 1; 1 = clustered 0 = nonclustered

XML_IDX_CLUSTER_ID

Storage clause indicating if the xmlix<n>_id index on the id column of the sde_xml_idx<n> table is clustered

0 or 1; 1 = clustered 0 = nonclustered

XML_IDX_CLUSTER_PK

Storage clause indicating if the xmlix<n>_pk index on the xml_key_column identity column of the sde_xml_idx<n> table is clustered

1 or 0; 1 = clustered 0 = nonclustered

XML_IDX_CLUSTER_STRING

Storage clause indicating if the xmlix<n>_st index on the string_tag column of the sde_xml_idx<n> table is clustered

0 or 1; 1 = clustered 0 = nonclustered

XML_IDX_CLUSTER_TAG

Storage clause indicating if the xmlix<n>_tg index on the tag_id column of the sde_xml_idx<n> table is clustered

0 or 1; 1 = clustered 0 = nonclustered

XML_IDX_FULLTEXT_CAT

Name of the full-text catalog in which the contents of the xml_doc_val column in the sde_xml_doc<n> table and the text_tag column of the sde_xml_idx<n> table are indexed

The name you gave the full-text catalog when it was created; the default is SDE_DEFAULT_CAT. If you gave the catalog any other name, you must change the value of this parameter to match it.

XML_IDX_FULLTEXT_LANGUAGE

The language used for linguistic analysis when building the text index on the contents of the xml_doc_val column in the sde_xml_doc<n> table and the text_tag column of the sde_xml_idx<n> table

There is no default value set for this parameter. Consult your DBMS documentation for valid language settings.

XML_IDX_FULLTEXT_TIMESTAMP

Determines whether or not a time stamp column will be added to the sde_xml_idx<n> table

1 or 0

1 = timestamp column will be added, 0 = time stamp column will not be added.

XML_IDX_FULLTEXT_UPDATE_METHOD

Dictates how changes made to the xml_doc_val column in the sde_xml_doc<n> table (the XML document table) and the text_tag column of the sde_xml_idx<n> table (the index table of an XML column) are propagated to the full-text index

CHANGE_TRACKING BACKGROUND or CHANGE_TRACKING MANUAL

XML_IDX_INDEX_DOUBLE

Storage clause for the xmlix<n>_db index on the double_tag column of the sde_xml_idx<n> table

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

XML_IDX_INDEX_ID

Storage clause for the xmlix<n>_id index on the ID column of the xml_idx<n> table

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

XML_IDX_INDEX_PK

Storage clause for xmlix<n>_pk index on the xml_key_column identity column of the sde_xml_idx<n> table

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

XML_IDX_INDEX_STRING

Storage clause for xmlix<n>_st index on the string_tag column of the sde_xml_idx<n> table

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

XML_IDX_INDEX_TAG

Storage clause for the xmlix<n>_tg index on the tag_id column of the sde_xml_idx<n> table

See the Microsoft SQL Server documentation for CREATE INDEX parameters.

XML_IDX_OUT_OF_ROW

Determines whether or not the contents of the text_tag column in the sde_xml_idx<n> table (the index table of an XML column) can be stored in row or out of row; only used for varbinary(max) columns

If set to 0, up to 8,000 bytes can be stored directly in the data page of the table. If set to 1, data will always be stored out of row.

0 or 1

XML_IDX_STORAGE

Storage clause for sde_xml_idx<n> table (the index table of an XML column)

See the Microsoft SQL Server documentation for CREATE TABLE parameters.

Configuration parameter summary

For the XML parameters, <n> refers to the xml_column_id associated with a specific XML column.

There are a number of ways to categorize configuration parameters. Often, a parameter fits into more than one category. For example, the B_CLUSTER_RASTER parameter can be categorized as a business table parameter, a raster parameter, or a clustered index parameter. The following sections describe these categories.

Parameters specific to feature class and raster storage

The following parameters define how tables are stored in a geodatabase in SQL Server.

Business table parameters

The business table is the attribute table of a feature class or nonspatial table. Business table parameters begin with B and define storage for the business table and its indexes. The parameters are as follows:

ParameterDescription

B_CLUSTER_ROWID

Index type for row ID (object ID) column on the business table; 0 = nonclustered index, 1 = clustered index

B_CLUSTER_USER

Index type for any user-defined indexes on a business table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

B_CLUSTER_XML

Index type for the XML type column of a business table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

B_CLUSTER_RASTER

Index type for the raster column in a business table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

B_INDEX_ROWID

Defines the fillfactor and location (file group) for the row ID column index of a business table

To specify a file group, use the SQL ON statement, for example:

B_INDEX_ROWID "with fillfactor=99 
ON IDXfg"

B_INDEX_USER

Defines the fillfactor and location (file group) for any user defined indexes on a business table

To specify a file group, use the SQL ON statement, for example:

B_INDEX_USER "with fillfactor=99 
ON IDXfg"

B_INDEX_XML

Defines the fillfactor and location (file group) for XML index on a business table

To specify a file group, use the SQL ON statement, for example:

B_INDEX_XML "with fillfactor=99 
ON XMLfg"

B_INDEX_RASTER

Defines the fillfactor and location (file group) for the raster column index on a business table

To specify a file group, use the SQL ON statement, for example:

B_INDEX_RASTER "with fillfactor=99 
ON RASfg"

B_INDEX_TO_DATE

Storage information for creating the index R<registration_id>_sde_todate, which is used when updating the history table during an archive operation

Note:

This parameter does not have a corresponding adds table parameter.

B_OUT_OF_ROW

A value of either 0 or 1

If set to 0, up to 8,000 bytes are stored directly in the data page of the table.

If set to 1, data is always stored out of row.

B_STORAGE

File group location for a business table

Use ON to control location, for example:

B_STORAGE "ON ADDS_FG"

For a nonspatial business table, do one of the following:

  • Change the B_CLUSTER_ROWID parameter's config_string to 1. This will create a clustered index on the object ID field. Any subsequent user-defined indexes you create will be nonclustered.
  • Change the B_CLUSTER_USER parameter's config_string to 1. The first user-defined index created by ArcGIS will be clustered.
  • Create the data and change whatever index (or composite indexes) you would like to be clustered.

Adds table parameters

An adds table is a table that stores insert and update edits made against a feature class in a geodatabase that uses traditional versioning. It is almost identical in structure to the business table but has additional columns to track state IDs. Adds table parameters begin with A. The adds table parameters are as follows:

ParameterDescription

A_CLUSTER_ROWID

Index type for row ID column on an adds table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

A_CLUSTER_STATEID

Index type for the stated column of an adds table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

Note:

This parameter does not have a corresponding business table parameter.

A_CLUSTER_USER

Index type for any user-defined indexes on an adds table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

A_CLUSTER_XML

Index type for the XML type column of an adds table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

A_CLUSTER_RASTER

Index type for a raster column in an adds table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

A_INDEX_ROWID

Specifies the fillfactor and location (file group) for the row ID column index of an adds table

To specify a file group, use the SQL ON statement, for example:

A_INDEX_ROWID "with fillfactor=99 
ON IDXfg"

A_INDEX_STATEID

Specifies the fillfactor and location (file group) for the state ID column index of an adds table

To specify a file group, use the SQL ON statement, for example:

A_INDEX_STATEID "with fillfactor=99 
ON STATEIDXfg"

Note:

This parameter does not have a corresponding business table parameter.

A_INDEX_USER

Specifies the fillfactor and location (file group) for any user-defined indexes on an adds table

To specify a file group, use the SQL ON statement, for example:

A_INDEX_USER "with fillfactor=99 
ON IDXfg"

A_INDEX_XML

Specifies the fillfactor and location (file group) for an XML index on an adds table

To specify a file group, use the SQL ON statement, for example:

A_INDEX_XML "with fillfactor=99 
ON XMLfg"

A_INDEX_RASTER

Specifies the fillfactor and location (file group) for a raster column index on an adds table

To specify a file group, use the SQL ON statement, for example:

A_INDEX_RASTER "with fillfactor=99 
ON RASfg"

A_OUT_OF_ROW

A value of either 0 or 1

If set to 0, up to 8,000 bytes are stored directly in the data page of the table.

If set to 1, data is always stored out of row.

A_STORAGE

Specifies in which file group adds tables will be created when datasets are registered as versioned

Use ON to control location, for example:

A_STORAGE "ON ADDS_FG"

Deletes table parameters

The deletes table is used to track updates and deletes made to tables that use traditional versioning. The deletes table parameters work the same way as adds table parameters. All deletes table parameters begin with D. They are as follows:

ParameterDescription

D_CLUSTER_ALL

Index type for the index created on the SDE_STATES_ID, SDE_DELETES_ROW_ID, and DELETED_AT columns

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

D_CLUSTER_DELETED_AT

Index type for the index on the DELETED_AT column

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

D_INDEX_ALL

Specifies the fillfactor and location (file group) for a composite index on the SDE_STATE_ID, SDE_DELETES_ROW_ID, and DELETED_AT columns, for example:

D_INDEX_ALL "with fillfactor=99 
ON Deletes_fg"

D_INDEX_DELETED_AT

Specifies the fillfactor and location (file group) for the index on the deleted_at column, for example:

D_INDEX_DELETED_AT "with fillfactor=80
 ON Deletes_fg"

D_STORAGE

Specifies in which file group deletes tables will be created when datasets are registered as versioned

Use ON to control location, for example:

D_STORAGE "ON Deletes_fg"

Raster table parameters

Binary and rasterblob rasters (both are BLOB storage types) in ArcGIS are stored as five separate tables: a band table (SDE_bnd_#), a block table (SDE_blk_#), a raster table (SDE_ras_#), an auxiliary table (SDE_aux_#), and a business table.

Rasters can be stored as embedded catalogs or columns in feature classes or can be stand-alone datasets.

Raster table parameters begin with AUX, BLK, BND, and RAS, which correspond to the raster tables. The parameters that define storage for the business table of the raster are defined by business table parameters.

Of all the raster tables, only the block table will get large.

If using binary rasters, make certain the BND_CLUSTER_COMPOSITE config_string is set to 1 to ensure that a clustered index is generated for the band table.

The raster table parameters are as follows:

ParameterDescription

AUX_CLUSTER_COMPOSITE

Index type for the primary key of the auxiliary table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

AUX_INDEX_COMPOSITE

Specifies the fillfactor and file group location for the primary key index of the auxiliary table, for example:

AUX_INDEX_COMPOSITE	"WITH FILLFACTOR= 90 
ON AUX_FG"

AUX_STORAGE

Specifies the file group location for the auxiliary table

Use ON to specify location, for example:

AUX_STORAGE	"ON AUX_FG"

BLK_CLUSTER_COMPOSITE

Index type for the primary key of the block table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

BLK_INDEX_COMPOSITE

Specifies the file group location for the composite index on the block table

Use ON to specify location, for example:

BLK_INDEX_COMPOSITE	"WITH FILLFACTOR = 95 
ON BLK_FG"

BLK_STORAGE

Specifies the file group location for the block table

Use ON to specify location, for example:

BLK_STORAGE	"ON BLK_FG"

BND_CLUSTER_COMPOSITE

Index type for the primary key index of the band table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

BND_CLUSTER_ID

Index type for the raster_id and sequence_nbr columns of the band table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

BND_INDEX_COMPOSITE

Specifies the fillfactor and file group location for the primary key index of the band table, for example:

BND_INDEX_COMPOSITE	"WITH FILLFACTOR =90 
ON BND_FG"

BND_INDEX_ID

Specifies the fillfactor and file group location for the raster_id and sequence_nbr column index of the band table, for example:

BND_INDEX_ID	"WITH FILLFACTOR = 90 
ON BND_FG"

BND_STORAGE

The file group location for the band table

Use ON to control location, for example:

BND_STORAGE " ON BND_FG"

RAS_CLUSTER_ID

Index type for the primary key of the raster table

If set to 0, a nonclustered index is created. If set to 1, a clustered index is created.

RAS_INDEX_ID

Fillfactor and location (file group) for the primary key index of the raster table

Use ON to control location, for example:

RAS_INDEX_ID	"WITH FILLFACTOR = 85 ON RAS_FG"

RAS_STORAGE

File group location for the raster table

Use ON to control location, for example:

RAS_STORAGE	" ON RAS_FG"

RASTER_STORAGE

Only one raster type is supported—binary—which creates an integer field in the base table and BLOB fields in the associated raster tables.

The B_STORAGE parameter defines the storage location for raster attribute tables. This table (or tables; there can be multiple such tables) stores attribute values based on cell values in the raster. If you want to store these tables in a different location than feature class business tables, create a raster keyword that specifies different storage information for the raster attribute tables. Instruct data creators to use this keyword when they create raster datasets.

Parameters specific to indexes

The following describe parameters that control index storage in a geodatabase in SQL Server.

Fill-factor parameters

These parameters are structured as *_INDEX_*. They allow you to specify the FILLFACTOR argument for that index. The FILLFACTOR argument specifies the percentage of space to fill with data on each page in the leaf level of an index when the index is created or rebuilt.

SQL Server uses a default value of 0, and ArcGIS uses a default of 100. Fill-factor values 0 and 100 are equivalent; both values mean that the leaf-level pages are filled to capacity.

You can use the FILLFACTOR configuration parameter to fine-tune index pages and page splits for performance. Refer to the Microsoft SQL Server documentation for information about selecting a fill factor based on the frequency and types of updates that users will make to the table on which you define the index.

Clustered index parameters

Note:

You cannot separate a clustered index from its table; therefore, for the table parameters described in Parameters specific to feature class and raster storage, specify a storage location that is the same for the table's associated clustered indexes.

These parameters are structured as *_CLUSTER_*, and they indicate whether or not a particular index should be clustered (1 = cluster; 0 = nonclustered). Clustered indexes store tabular data at their leaf nodes. The data pages at the clustered index leaf level derive their order from the clustered index key value. This has one important consequence with regard to the configuration parameters: you cannot separate a table from its clustered index. For example, you specify that a feature class's row ID (ROWID) index be created on the NEWIDXGRP file group while the feature class's business table should be stored on the NEWGRP file group. The ROWID index is created as clustered. The configuration settings might look like this:

keywordparameter_nameconfig_string

DEFAULTS

B_CLUSTER_ROWID

1

DEFAULTS

B_INDEX_ROWID

WITH FILLFACTOR=100 ON NEWIDXGRP

DEFAULTS

B_STORAGE

ON NEWGRP

In the preceding example, both the business table and business table's index will reside on the NEWIDXGRP file group. The business table is created first, then a primary key constraint is applied to the ROWID column. The constraint creates a clustered index on the ROWID column and references the NEWIDXGRP file group in this statement:

ALTER TABLE data.dbo.mytable 
 ADD CONSTRAINT f4_pk PRIMARY KEY CLUSTERED (OBJECTID) 
 WITH FILLFACTOR=100  
 ON NEWIDXGRP

Therefore, the ON NEWGRP configuration string is redundant, as the index is created after the table, and the B_INDEX_ROWID configuration string will overwrite that of B_STORAGE. The next example specifies a file group for the feature table but not for the feature table's index.

keywordparameter_nameconfig_string

DEFAULTS

B_CLUSTER_ROWID

1

DEFAULTS

B_INDEX_ROWID

WITH FILLFACTOR=100

DEFAULTS

B_STORAGE

ON NEWGRP

In this case, both the business table and clustered index on the FID column will reside on the NEWGRP file group. This occurs because the table is created first, and when the ALTER TABLE statement is applied, no ON statement is appended because no such string is listed in the preceding config_string column.

ALTER TABLE date.dbo.mytable 
ADD CONSTRAINT r15_pk PRIMARY KEY CLUSTERED (OBJECTID) 
WITH FILLFACTOR=100

Parameters for storing text

The following parameters define how different types of text data are stored in a geodatabase SQL Server.

Text out of row parameters

Raster columns use varbinary(max) data types. You can use the *_OUT_OF_ROW parameters to specify whether or not the first 8,000 bytes of varbinary(max) data is stored in line or whether all of it is stored out of line. By default, these parameters are set to 0, meaning all the data will be stored out of line.

Text column storage parameters

There are two parameters that affect text columns in user tables: UNICODE_STRING and COLLATION_NAME. The UNICODE_STRING parameter determines whether or not text columns use Unicode encoding. By default, this parameter is set to TRUE, meaning all text data created using the DEFAULTS configuration keyword will be stored in Unicode format (UTF-8). If this parameter is set to FALSE, text is stored using the encoding set for the database.

If UNICODE_STRING is set to TRUE, the COLLATION_NAME parameter can be used to specify a collation for user-defined text columns that differs from the collation of the database. By default, all character data columns use the default database collation. When a new dataset (such as a table or feature class) is created, the collation specified in COLLATION_NAME is applied to every character data column. If COLLATION_NAME is blank, the database collation is used. If the UNICODE_STRING parameter is set to FALSE, the COLLATION_NAME parameter is ignored.

If you set the COLLATION_NAME parameter, use the case-sensitive version of your database collation. This usually means altering the CI in the collation name to CS. If you are unsure, check the SQL Server documentation or execute the following query for a list of collation names:

SELECT * FROM ::fn_helpcollations()

The COLLATION_NAME parameter is especially important if you will store text values in Turkish. To avoid issues with uppercasing and lowercasing the letter i in the Turkish alphabet, Turkish language users should set the COLLATION_NAME parameter to indicate they are using a Turkish, case-sensitive collation for text data.

Parameters that affect spatial storage

Spatial index parameters were discussed under the section Parameters specific to indexes. Other parameters that affect spatial data storage are GEOMETRY_STORAGE and GEOM_SRID_CHECK.

GEOMETRY_STORAGE

Geodatabases in SQL Server can use the spatial data storage formats described below. The GEOMETRY_STORAGE parameter indicates which geometry storage method to use for new feature classes.

  • Microsoft SQL Server Geometry type—The Microsoft spatial type for managing spatial data defined by coordinates on an arbitrary plane and for which the curvature of the Earth is not a consideration. This is the default spatial storage method of geodatabases in SQL Server. Keep the GEOMETRY_STORAGE parameter set to GEOMETRY if you want to store your spatial data in this format. If the GEOMETRY_STORAGE parameter is not set, the GEOMETRY type is assumed.
  • Microsoft SQL Server Geography type—The Microsoft spatial type for managing spatial data defined by lat/long coordinates. Use this type when your features span large areas and need to take into consideration the curvature of the Earth. If you want to make this format the default storage type for your geodatabase, set the GEOMETRY_STORAGE parameter to GEOGRAPHY under the DEFAULTS configuration keyword parameter list. If you want to use it for only some datasets, create a custom keyword that contains the GEOMETRY_STORAGE parameter set to GEOGRAPHY and include the UI_TEXT parameter so the keyword will be available to data creators in ArcGIS client apps.

If all the feature classes in your database use the same geometry storage method, set the GEOMETRY_STORAGE parameter once in the DEFAULTS configuration keyword.

Note:

The following geometry storage types have been deprecated in ArcGIS Pro:

  • SDEBINARY
  • WKB_GEOMETRY

You cannot create feature classes that use these storage types. Currently, you can view feature classes that use these geometry storage types, but this functionality will be removed in a future release. Use the Migrate Storage geoprocessing tool to migrate feature classes to supported data types to ensure you can continue to access the data.

GEOM_SRID_CHECK

If you create feature classes in ArcGIS that use the SQL Server geometry type, or you create a spatial table with a SQL Server geometry column using SQL and register the table with the geodatabase, all records in the table must use the same spatial reference ID (SRID).

The database management system does not enforce having a single SRID for all records in a table. Therefore, if you plan to use SQL to edit tables that have a SQL Server geometry column but are registered with the geodatabase, you may want to set the GEOM_SRID_CHECK parameter to TRUE. When this parameter is set to TRUE, ArcGIS adds a check constraint on the geometry column for a SRID value. This ensures that users editing outside of ArcGIS do not add multiple SRIDs to the same table.

Caution:

Setting this parameter to TRUE can impact performance. For that reason, do not set this parameter to TRUE if none of your users are using SQL (or third-party software) to edit spatial tables registered with the geodatabase.

Parameters for XML document storage

Note:

If you do not use XML columns and XML documents in your geodatabase, you do not need to configure these parameters. As there are no longer ArcGIS clients that work directly with XML documents, it is unlikely you need to alter any of these parameters.

You can set the following parameters for tables that use native SQL Server XML columns (DB_XML):

XML_COLUMN_SCHEMA
XML_COLUMN_TYPE
XML_COLUMN_PRIMARY_IDX
XML_COLUMN_PATH_IDX 
XML_COLUMN_PROPERTY_IDX
XML_COLUMN_VALUE_IDX

XML_COLUMN_SCHEMA specifies a schema collection to be used when adding or altering XML data. XML schema collections enforce schema constraints on XML data.

XML data that is associated with an XML schema collection is referred to as typed XML. The XML_COLUMN_TYPE parameter specifies what type of XML document the column stores; either CONTENT or DOCUMENT. CONTENT is the default value. DOCUMENT should only be used if the XML data has only one top-level element.

XML_COLUMN_PRIMARY_IDX, XML_COLUMN_PATH_IDX, XML_COLUMN_PROPERTY_IDX, and XML_COLUMN_VALUE_IDX determine whether or not primary, path, property, or value indexes will be created on the XML column.

If searches typically examine the entire content of XML documents to see if they contain specific words, or if you don't search XML documents at all, the XML document table will be more heavily used. XML document tables will have three parameters:

XML_DOC_INDEX
XML_DOC_STORAGE
XML_DOC_OUT_OF_ROW

XML_DOC_STORAGE provides the storage string for the table's creation statement. XML_DOC_INDEX has the index fill factor and storage parameters, while XML_DOC_OUT_OF_ROW pertains to storing BLOB data out of line. See the section in this topic, "Text in row parameters", for more information.

If individual elements are frequently searched, the XML document index table will be the most heavily accessed of the XML tables. It has more configuration parameters; they all begin with XML_IDX_.

XML_IDX_CLUSTER_DOUBLE
XML_IDX_CLUSTER_ID
XML_IDX_CLUSTER_PK
XML_IDX_CLUSTER_TAG
XML_IDX_INDEX_DOUBLE
XML_IDX_INDEX_ID
XML_IDX_INDEX_PK
XML_IDX_INDEX_TAG
XML_IDX_STORAGE
XML_IDX_OUT_OF_ROW

The XML_IDX_CLUSTER_* parameters dictate which index of the XML document index table should be clustered. By default, the primary key's index (on the xml_key_column) is clustered.

The following parameters affect both the XML document table and the XML document index table for an XML column. They control how and when the document content is indexed.

XML_IDX_FULLTEXT_CAT
XML_IDX_FULLTEXT_LANGUAGE
XML_IDX_FULLTEXT_TIMESTAMP
XML_IDX_FULLTEXT_UPDATE_METHOD

XML_IDX_FULLTEXT_CAT contains the name of the full-text catalog you created. The default is SDE_DEFAULT_CAT. If you name your full-text catalog something other than SDE_DEFAULT_CAT, you must update the config_string for this parameter.

XML_IDX_FULLTEXT_LANGUAGE represents the language to be used for linguistic analysis when building the text indexes on the XML document's content. A default value is not provided; therefore, the language defined for the SQL Server default full-text language setting is used. If a value is provided, this language will be used for linguistic analysis instead.

XML_IDX_FULLTEXT_TIMESTAMP and XML_IDX_FULLTEXT_UPDATE_METHOD control full-text index maintenance. The update_method parameter dictates how changes made to the document table are propagated to the full-text index. The time stamp parameter, by default (1), will add a time stamp column to the SDE_xml_idx<xml_column_id> table. If set to 0, no such column is added.

If update_method is set to 0 and time stamp is set to 0, no index maintenance is performed, and whenever ArcGIS is instructed to update the full-text index (through SE_xmlindex_update_text_index), the index will be fully populated.

If update_method is set to 0 and time stamp is set to 1, no index maintenance is performed, and ArcGIS will perform an incremental index population of whatever has changed since the last incremental update.

If update_method is set to CHANGE_TRACKING MANUAL, the database maintains a list of changed rows but does not update the index.

If update_method is set to CHANGE_TRACKING BACKGROUND, the database tracks changes and automatically updates the index.

It is recommended that you use the default settings provided with the geodatabase. If your server is unable to service its workload and your only recourse is to change indexing behavior, set change tracking to manual (CHANGE_TRACKING MANUAL).

The next parameters, XML_IDX_INDEX_*, control index fill factor and storage on the SDE_xml_idx<xml_column_id> table. The XML_IDX_TEXT_IN_ROW controls how much of the XML document BLOB can be in-line. As with most text in row settings, it is recommended that you do not change the defaults.

Parameters that affect log file tables and indexes

Log file tables are used by ArcGIS to maintain temporary and persistent sets of selected records.

Session log file tables are always created in tempdb in geodatabases in SQL Server. If you created your geodatabase many years ago, even if you upgraded, you may still see these log file parameters in the SDE_dbtune table. Even if log file table parameters are present in these geodatabases, they are ignored.

Additional configuration parameters

Some parameters do not fit well in a particular category. These are described in this section.

NUM_DEFAULT_CURSORS parameter

The NUM_DEFAULT_CURSORS parameter controls the cursor threshold. It specifies the number of rows in a cursor set for which cursor keysets will be generated asynchronously. The default value of -1 means all keysets are generated synchronously, which is better for smaller cursor sets. If you set it to 0, all cursor keysets are generated asynchronously. If you use a value other than 0 or -1, the no matter log file parameters are set to Query Optimizer compares the number of expected rows in the cursor set to the number set in cursor threshold, then builds the keyset asynchronously if it exceeds the cursor threshold number. Asynchronous population means that you can access rows already in the cursor while the cursor is being populated. With synchronous population, all rows are put in the cursor before any are accessible.

Caution:

It is best not to alter the default value; changes made to this value affect the entire server. It is very difficult to determine how big your average cursor keyset is going to be. Unless you know for certain that changing this value is going to help performance, it is best not to change it.

PERMISSION_CACHE_THRESHOLD

Although still present in the geodatabase, this parameter no longer affects connection performance to any great degree. By default, the setting is disabled (it is set to -1).

When this parameter was added, the method for determining object privileges in the database required querying a database system table and building a list of the datasets to which the connecting user had access. Connection performance was sometimes slow if the database contained a large number of objects. SQL Server subsequently improved how this information is accessed, thereby rendering this parameter obsolete.

The PERMISSION_CACHE_THRESHOLD builds a temporary table if the initial query of object permission information exceeds the threshold, in milliseconds, that you set for the parameter. The maximum setting is 1,000 milliseconds. If you set PERMISSION_CACHE_THRESHOLD to 0, the temporary table is always built, and stores the permission for the duration of the connection.

PERMISSION_CACHE_THRESHOLD can be used only in the DEFAULTS parameter group. The temporary table persists for the duration of the connection, so if the connecting user's permissions change during the session, changes won't be seen until the user disconnects and reconnects to the database.

User interface parameters

User interface parameters begin with UI and indicate whether their associated configuration keyword will be available through the ArcGIS user interface and ArcObjects. UI_TEXT is used for noncomposite configuration keywords. UI_TOPOLOGY_TEXT is used for topology keywords. UI_NETWORK_TEXT is used for network keywords. The default configuration keywords that need UI parameters already have them. You would only add one of these parameters if you created your own custom keywords.

Deprecated geometry storage parameters

Compressed binary geometry storage formats—ArcSDE compressed binary (SDEBINARY) and Open Geospatial Consortium (OGC) well-known binary (OGCWKB)—were deprecated as of the ArcGIS Pro 2.6 and ArcGIS Enterprise 10.8.1 releases. They will no longer be supported starting with an upcoming ArcGIS release. Use the Migrate Storage geoprocessing tool to migrate feature classes to a supported geometry storage type.

Because you cannot create feature classes that use this storage type from ArcGIS Pro or using tools run from ArcGIS Server 11.0 or later, new geodatabases will not contain configuration parameters and keywords used to control binary geometry storage. This starts with geodatabases created using ArcGIS Pro 3.2 or tools installed with ArcGIS Server 11.2.

If you created the geodatabase with ArcGIS Pro 3.1 or earlier or tools installed with ArcGIS Server 11.1 or earlier, these parameters and keywords will still be present unless you removed them; upgrading the geodatabase will not remove them.

These parameters include those beginning with F_ and S_, ending with _SHAPE, and configuration keywords referring to SDEBINARY. If you have a mix of clients at your organization and are still using binary geometry storage formats for some of the feature classes in your geodatabase, see the ArcGIS Desktop help for information on configuration parameters for compressed binary geometry storage.