Advantage SQL Engine
Sets one database property in the data dictionary.
sp_ModifyDatabase(
Property,CHARACTER,200,
Value,MEMO )
Property (I) |
Name of a database property to set. See below for possible values. |
Value (I) |
Property to be stored in the data dictionary. |
AE_INVALID_PROPERTY_ID |
Either the value supplied in Property is not a valid database property index, or the specified property cannot be modified. |
AE_NO_TABLE_ENCRYPTION_PASSWORD |
This error is returned when setting the ENCRYPT_NEW_TABLE property to True and the database’s table encryption password property, ENCRYPT_TABLE_PASSWORD, has not been set. |
sp_ModifyDatabase sets one database property in the data dictionary. The new property overwrites the existing property in the data dictionary. The following are the valid values of Property.
Property |
Description |
COMMENT |
Changes the database description. |
VERSION_MAJOR |
Sets the user defined major version property of the data dictionary. This property is intended for storing a value associated with the major version of the user's dictionary. The user version property is set, read, and interpreted by the application. The Advantage Database Server does not currently use it internally. The default value for this property, if it has never been set, is 0. If a value of NULL is used, the user version property value will be removed. |
VERSION_MINOR |
Sets the user defined minor version property of the data dictionary. This property is intended for storing a value associated with the minor version of the user's dictionary. The user version property is set, read, and interpreted by the application. The Advantage Database Server does not currently use it internally. The default value for this property, if it has never been set, is 0. If a value of is NULL is used, the user version property value will be removed. |
DEFAULT_TABLE_PATH |
Changes the default path for creating new tables. If the value is NULL or an empty string, new tables will be created in the same directory as the data dictionary. No verification of the validity of the path is made. If the default table path is set to an invalid path, subsequent attempts to create new tables in this data dictionary will fail. The path must be a fully qualified UNC path or a relative path from the data dictionary. |
TEMP_TABLE_PATH |
Changes the path for creating temporary tables. If the value is NULL or an empty string, a temporary table will be created in the same directory as the normal tables. Advantage Database Server and Advantage Local Server create temporary tables and indexes when executing SQL statements. The path must be a fully qualified UNC path or a relative path from the data dictionary. |
ADMIN_PASSWORD |
Changes the administrative password of the database. If the value is NULL or an empty string, the data dictionary is re-set to not require an administrative password to maintain the data dictionary. |
LOG_IN_REQUIRED |
Changes whether an anonymous user connection to the database is allowed. The default is False when the data dictionary is created. If the integer pointed to by the pvProperty is zero, the property is set to False. Otherwise the property is set to True. If this property is set to False, anonymous connection to the database with no user name and no password is allowed. Otherwise a user name and password is required to make a database connection to the data dictionary. See AdsConnect60 for more information. |
VERIFY_ACCESS_RIGHTS |
This property determines whether the Advantage Database Server will enforce the user’s access rights when opening a database table or view or executing a stored procedure. This property is a Boolean value. It is defaulted to False when the data dictionary is created. If this property is set to False, the Advantage database server does not verify the user’s access rights when opening a database table or view or when executing a stored procedure. The implication is that all users have full rights to all objects in the database. If this property is set to True, the user’s access rights are verified. Note that an anonymous user does not have any rights to objects in the database. If the database is set up to verify user access rights, an anonymous user can make a connection to the database but he cannot open any table or view or execute any stored procedure. |
ENCRYPT_TABLE_PASSWORD |
This property sets the encryption password for the database tables. Setting this property does not encrypt any table in the data dictionary. It only sets the password that all database tables in the data dictionary will be encrypted with. If the value is NULL or a pointer to an empty string, the function will remove the database encryption password from the data dictionary and, as a side effect, sets the database property ENCRYPT_NEW_TABLE to False. Setting and removing this property requires that all database tables in the data dictionary not be encrypted. If there are encrypted table(s) in the data dictionary, this function will fail with error AE_DD_REQUEST_NOT_COMPLETED. Once this property is set, calling sp_ModifyTableProperty and setting the table property TABLE_ENCRYPTION to True can encrypt individual tables in the data dictionary. |
ENCRYPT_NEW_TABLE |
This property determines whether a new table added or created in the in the data dictionary should be encrypted. This property is a Boolean value. It is set to ‘False’ when the data dictionary is created. When this property is set to ‘True’, all tables added or created into the database will be automatically encrypted. Setting this property has no effect on existing tables in the database. If this property is set to False, new table added or created in the data dictionary will not be encrypted. When setting this property to ‘True’, the database property ENCRYPT_TABLE_PASSWORD must be set. |
ENABLE_INTERNET |
This property enables/disables the Internet access for the data dictionary. If it is disabled, no users will be allowed to connect from the Internet. Expected values are ‘True’ and ‘False’. For more information see Advantage Internet Server. |
INTERNET_SECURITY_LEVEL |
This is the security level for communications between the Advantage Database Server and the clients when they are communicating over the Internet. The values are 0, 1, 2. For more information, see Internet Security Levels. |
MAX_FAILED_ATTEMPTS |
This is the maximum number of failed Internet login attempts a user can have. For more information on this setting, see Maximum Failed Login Attempts. |
LOGINS_DISABLED |
This property disables/enables database logins. Expected values are ‘True’ and ‘False’. See Disabling Database Logins for more details. |
LOGINS_DISABLED_MSG |
This is the custom error string that will be returned to clients attempting database connections when database logins are disabled. See LOGINS_DISABLED above and Disabling Database Logins for more details. |
FTS_NOISE_WORDS |
Changes the default Full Text Search (FTS) noise words for the data dictionary. When new FTS indexes are created with the default noise words, these will be used as the defaults for the new index. |
FTS_DELIMITERS |
Changes the default Full Text Search (FTS) delimiter characters for the data dictionary. When new FTS indexes are created with the default delimiters, these will be used as the defaults for the new index. |
FTS_DROP_CHARS |
Changes the default Full Text Search (FTS) drop characters for the data dictionary. When new FTS indexes are created with the default drop characters, these will be used as the defaults for the new index. |
FTS_CONDITIONAL_CHARS |
Changes the default Full Text Search (FTS) conditional drop characters for the data dictionary. When new FTS indexes are created with the default conditional drop characters, these will be used as the defaults for the new index. |
ENCRYPT_INDEXES |
This property determines whether indexes on dictionary bound ADT tables should be encrypted. This property is a Boolean value. It is defaulted to ‘False’ when the data dictionary is created. When this property is set to ‘True’, all encrypted tables must be re-indexed for the property to take effect. If this property is set to ‘False’, indexes on encrypted tables will remain encrypted until the table is re-indexed. When setting this property to ‘True’, the database property ‘ENCRYPT_TABLE_PASSWORD’ must be set. |
ENCRYPT_COMMUNICATION |
This property determines whether all communication between the Advantage Database Server and Advantage-enabled client applications is encrypted. This property is a Boolean value. It is defaulted to ‘False’ when the data dictionary is created. |
DISABLE_DLL_CACHING |
This property disables/enables DLL caching. Expected values are ‘True’ and ‘False’. See DLL Caching for more details. |
After making a connection to the database, change the description of the database.
EXECUTE PROCEDURE sp_ModifyDatabase(
‘COMMENT’,
‘This is my data dictionary’ );
See Also