Reorganizing Tables with BR*Tools

Use

You can use BR*Tools  for Oracle to reorganize tables online.

This section describes how you reorganize a table with BR*Tools.

For more information on the approach to table reorganization, see:

·         Reorganization

·         Reorganization Case Study

You can perform the following types of reorganization:

·        Reorganize tables online

·        Check tables for reorganization

·        Clean up tables after aborted reorganization

·        Convert LONG and LONG RAW fields to CLOB or BLOB online (Oracle 10g or higher)

·        Stop reorganization (command-line mode only)

·        Suspend reorganization (command-line mode only)

·        Resume reorganization (command-line mode only)

For more information, see -f tbreorg.

Prerequisites

You cannot perform online reorganization for tables with LONG or LONG RAW fields but you can convert them to CLOB or BLOB online. After this conversion, you can reorganize all tables online. For more information, see SAP Note 646681.

Procedure

...

       1.      Start the procedure using BRGUI or BRTOOLS, or from the command line:

Ў        BRGUI or BRTOOLS:

                                                  i.       Choose Segment Management ® Reorganize tables.

BRGUI or BRTOOLS displays the menu BRSPACE options for reorganization of tables, where you specify the options with which you call BRSPACE.

                                                ii.       Set the required options:

Menu Entry

Equivalent BRSPACE

Command Option

BRSPACE profile (profile)

-p|-profile

Database user/password (user)

-u|-user

Reorganization action (action)

-f tbreorg -a|-action

Tablespace names (tablespace)

-f tbreorg -s|-tablespace

Table owner (owner)

-f tbreorg -o|-owner

Table names (table)

-f tbreorg -t|-table

Confirmation mode (confirm)

-c|-confirm

Extended output (output)

-o|-output

Scrolling line count (scroll)

-s|-scroll

Message language (language)

-l|-language

BRSPACE command line (command)

This shows you the BRSPACE -f tbreorg command that is to be executed using the current settings.

If required, in Table names you can enter the names of multiple tables. You can use wildcards. For more information, see “Selecting Objects“ in Segment Management with BR*Tools. You can also specify a list of tables to be processed with reorg_table in the initialization profile init<DBSID>.sap.

In Tablespace names and Table owner, you can specify multiple objects but you cannot  use wildcards. BRSPACE processes all the tables in the specified tablespace name(s) or all tables belonging to the specified table owner(s). But these entries and reorganization action entry are optional.

                                               iii.       Choose Continue.

BRGUI or BRTOOLS prompts you to start BRSPACE.

                                               iv.       Choose Continue to start BRSPACE.

Ў        Command line:

...

Enter at least the following command:

brspace –f tbreorg

You can enter more parameters, including the table names, if required. For more information, see BRSPACE -f tbreorg.

Whichever way you start the procedure – with BRGUI or BRTOOLS, or from the command line – you can use quick mode if you know the final object names, in this case the table names. For more information, see How to Use BR*Tools.

BRSPACE starts and you see a message that includes Start of BRSPACE processing. From now on, BRSPACE writes a detail log.

       2.      If you have already entered the table names, continue with step 5 (quick mode).

If you have entered multiple tables, BRSPACE displays as confirmation a List of tables for reorganization. If you have not already made a final selection, you can make a selection from this list.

Continue with step 5 (quick mode).

BRSPACE displays the Table reorganization main menu.

       3.      Choose Reorganize tables.

BRSPACE displays the table list:

List Entry

Meaning

Pos.

List sequence number

Owner

Table owner

Table

Table name

Pt.

Partitioned

DgPk.

Parallel degree / primary key:

“ ” means no

“+” means yes / enabled

“-“ means yes / disabled

Rows

Number of rows

Space [KB]

Space occupied by the table

Data [KB:%]

Amount of data in the table: percentage of occupied space

       4.      Select a table or multiple tables.

These examples only apply to input in character mode.

To select the first three tables in the list, enter 1-3.

To select the first and third tables, enter 1,3.

To select the first three tables and the fifth, enter 1-3,5.

To select all tables, enter 0.

BRSPACE displays the menu, Options for reorganization of tables.

       5.      Set the required options:

Menu Entry

Meaning

New destination tabelspace (newts)

-f tbreorg -n|-newts

Separate index tablespace (indts)

-f tbreorg -i|-indts

Parallel threads (parallel)

-f tbreorg -p|-parallel

Table/Index parallel degree (degree)

-f tbreorg -e|-degree

Create DDL statements (ddl)

-f tbreorg -d|-ddl

There is no SQL command line here because the reorganization is performed in several steps by an Oracle package, which contains multiple procedures.

       6.      To start processing with the selected options, choose Continue.

Results

Check the results in the BRSPACE logs.

·        The summary log space<DBSID>.logdisplays the return code.

·        The detail log s<encoded timestamp>.tbr displays the details.

For more information on how to view the logs with BR*Tools, see Showing Logs and Profiles with BR*Tools.

The file ddl.sql is created in the subdirectory <encoded timestamp> of the directory $SAPDATA_HOME/sapreorg if the option –d|-ddl is set to a value other than no. The file contains the Data Definition Language (DDL) statements used for the creation of interim tables during the reorganization. For more information, see Reorganization. If the –d|-ddl option is set to only, then only DDL statements are created and the actual reorganization is not performed.