Script Parameters for Restoring BIA Data
You use Python scripts to back up BIA data (TREX indexes and queues) during routine operation and then restore the BIA data offline.
For more information, see Backing Up and Restoring BIA Data.
The --importManager.py Python script that you use to restore BIA data using a data import operation behaves in accordance with the selected parameters and the prerequisites described below.
The restore operation for BIA data can behave differently depending on whether you already loaded InfoCubes and how many InfoCubes you loaded, even if the --importParts and --importSharedParts parameters selected for importing the BIA data are the same.
There are the following different scenarios to note when using the --importParts and --importSharedParts parameters:
-
NO InfoCube Loaded
-
ONE InfoCube Loaded
-
TWO OR MORE InfoCubes Loaded
NoteThe following information is only valid for indexes with shared parts (other indexes that share specific indexes).
1. NO InfoCube Loaded
If you did not yet load any InfoCubes, no indexes can be shared between multiple InfoCubes. This means that the --importSharedparts parameter has no effect on the import.
|
No. |
Selected parameters |
|
1.1 |
--indexId=* --importParts=0 --importSharedParts=0 |
|
1.2 |
--indexId=* --importParts=0 --importSharedParts=1 |
|
1.3 |
--indexId=* --importParts=1 --importSharedParts=0 |
|
1.4 |
--indexId=* --importParts=1 --importSharedParts=1 |
Result:
All indexes are imported regardless of which parameter values you selected.
|
No. |
Selected parameters |
|
1.5 |
--indexId=cube1 --indexId=cube2 --importParts=0 --importSharedParts=0 |
|
1.6 |
--indexId=cube1 --indexId=cube2 --importParts=0 --importSharedParts=1 |
Result:
Only the metadata for cube1 and cube2 is imported.
|
No. |
Selected parameters |
|
1.7 |
--indexId=cube1 --indexId=cube2 --importParts=1 --importSharedParts=0 |
|
1.8 |
--indexId=cube1 --indexId=cube2 --importParts=1 --importSharedParts=1 |
Result:
All indexes of cube1 and cube2 are imported.
|
No. |
Selected parameters |
|
1.9 |
--indexId=cube1 --importParts=0 --importSharedParts=0 |
|
1.10 |
--indexId=cube1 --importParts=0 --importSharedParts=1 |
Result:
Only the metadata for cube1 is imported.
|
No. |
Selected parameters |
|
1.11 |
--indexId=cube1 --importParts=1 --importSharedParts=0 |
|
1.12 |
--indexId=cube1 --importParts=1 --importSharedParts=1 |
Result:
All indexes of cube1 are imported.
|
No. |
Selected parameters |
|
1.13 |
--indexId=cube1 --excludeIndexID=cube2 --importParts=0 --importSharedParts=0 |
|
1.14 |
--indexId=cube1 --excludeIndexID=cube2 --importParts=0 --importSharedParts=1 |
Result:
Only the metadata for cube1 is imported.
|
No. |
Selected parameters |
|
1.15 |
--indexId=cube1 --excludeIndexID=cube2 --importParts=1 --importSharedParts=0 |
|
1.16 |
--indexId=cube1 --excludeIndexID=cube2 --importParts=1--importSharedPart=1 |
Result:
Only the unshared indexes of cube1 are imported. The indexes that are common to cube1 and cube2 are not imported.
Reason: These shared indexes are common to cube1 and cube2. The -importSharedParts parameter is not the reason why the shared indexes are not imported.
2. ONE InfoCube Loaded
The BIA data import behaves in the same way as described in section 1 - NO InfoCubes Loaded.
3. TWO OR MORE InfoCubes Loaded
The --importSharedParts parameter only takes effect if at least two InfoCubes were already loaded by the BIA, because indexes can only be shared if there are two or more InfoCubes loaded.
|
No. |
Selected parameters |
|
3.1 |
--indexId=* --importParts=0 --importSharedParts=0 |
|
3.2 |
--indexId=* --importParts=1 --importSharedParts=0 |
Result:
All unshared indexes are imported because the IndexId=* parameter specifies all indexes. These indexes are classed as selected and are imported. However, shared parts are ignored because --importShartParts=0.
|
No. |
Selected parameters |
|
3.3 |
--indexId=* --importParts=0 --importSharedParts=1 |
|
3.4 |
--indexId=* --importParts=1 --importSharedParts=1 |
Result:
All indexes are imported because the shared parts are included by --importSharedParts=1.
|
No. |
Selected parameters |
|
3.5 |
--indexId=cube1 --indexId=cube2 --importParts=0 --importSharedParts=0 |
Result:
Only the metadata for cube1 and cube2 is imported.
Reason: The --importParts=0 parameter excludes the parts.
|
No. |
Selected parameters |
|
3.6 |
--indexId=cube1 --indexId=cube2 --importParts=0 --importSharedParts=1 |
Result:
Only the indexes that are shared by cube1 and cube2 are imported.
|
No. |
Selected parameters |
|
3.7 |
--indexId=cube1 --indexId=cube2 --importParts=1 --importSharedParts=0 |
Result:
All indexes of cube1 and cube2 that are not shared by these two cubes are loaded.
|
No. |
Selected parameters |
|
3.8 |
--indexId=cube1 --indexId=cube2 --importParts=1 --importSharedParts=1 |
Result:
All indexes of cube1 and cube2 are imported.
|
No. |
Selected parameters |
|
3.9 |
--indexId=cube1 --importParts=0 --importSharedParts=0 |
Result:
Only the metadata for cube1 is imported.
Reason: The --importParts=0 parameter excludes the parts.
|
No. |
Selected parameters |
|
3.10 |
indexId=cube1 --importParts=0 --importSharedParts=1 |
Result:
Only the indexes that are shared by cube1 and cube2 are imported.
|
No. |
Selected parameters |
|
3.11 |
--indexId=cube1 --importParts=1 --importSharedParts=0 |
Result:
All indexes of cube1 that are not shared by cube1 and cube2 are imported.
|
No. |
Selected parameters |
|
3.12 |
--indexId=cube1 --importParts=1 --importSharedParts=1 |
Result:
All indexes of cube1 are imported.
|
No. |
Selected parameters |
|
3.13 |
--indexId=cube1 --excludeIndexID=cube2 --importParts=0 --importSharedParts=0 |
|
3.14 |
--indexId=cube1 --excludeIndexID=cube2 --importParts=0 --importSharedParts=1 |
Result:
Only the metadata for cube1 is imported.
Reason: The --importParts=0 parameter excludes the parts.
|
No. |
Selected parameters |
|
3.15 |
--indexId=cube1 --excludeIndexID=cube2 --importParts=1 --importSharedParts=0 |
|
3.16 |
--indexId=cube1 --excludeIndexID=cube2 --importParts=1 --importSharedParts=1 |
Result:
Only the unshared indexes of cube1 are imported. The indexes that are common to cube1 and cube2 are not imported.
Reason: These shared indexes are common to cube1 and cube2. The exclude condition excludes them from the import. The exclude condition means that the --importSharedParts parameter has no effect (see 1.13).