company logo

ObjectSpace :: renameExtentReference - Rename extent reference

When changing an extent name in a schema definition, which is already in production, the extent name has to be changed in all production databases, too. The new extent name passed in sNewName has to be the same name as the new name for the extent definition in the schema.

The original name passed in sExtentName might be defined within a namespace or in the global scope by preceding the extent name with the scope name. The new name ( sNewName ) will be defined in the same namespace, i.e. renaming an extent does not support changing the namespace. When the new name is defined with a scope name, this will be ignored.

The function should be called, only, for databases which have been opened exclusive. No extent must be opened before calling the function.

Implementation overview

Implementation details

  1. Rename extent by extent name in namespace
    ObjectSpace  :: renameExtentReference ( odaba::String &sScope, odaba::String &sExtentName, odaba::String &sNewName )

    In order to rename an extent defined in a namespace (e.g. within a class), the namespace name or hierarchy (scope name) has to be passed in sScope . The extent name (without scope) passed in sExtentName will be renamed. The new extent name passed in sNewName (also without scope) is the new name within the global scope and is passed without scope name, as well.

    • sScope - Scope name

      The scope name addresses a namespace (or class) defined in the database. The scope name may refer to a namespace hierarchy. Namespace names in a hierarchical path are separated by double colon (::).

    • sExtentName - Extent name
    • sNewName - New name

      Names are used for identifying schema entities. In order to rename schema entities, a new name can be passed.

      In order to pass no new name, an empty string ( String() ) might be passed.

    2. to list
  2. Rename extent by extent name
    ObjectSpace  :: renameExtentReference ( odaba::String &sExtentName, odaba::String &sNewName )

    The function allows renaming extents in the global scope. The name of the extent to be renamed has to be passed in sExtentName . and must not contain a scope name. The new extent name passed in sNewName (also without scope) is the new name within the global scope and is passed without scope name, as well.

    • sExtentName - Extent name
    • sNewName - New name

      Names are used for identifying schema entities. In order to rename schema entities, a new name can be passed.

      In order to pass no new name, an empty string ( String() ) might be passed.

    3. to list
to top previous upper table of contents Comment