Документация iSZN

pkPart.sql

Сообщения об ошибках

Error_PartitioningRequred

PROCEDURE Error_PartitioningRequred(sTableName VARCHAR2);

Описание

Вызывает exception «Требуется секционирование таблицы».

Error_RepartitioningRequred

PROCEDURE Error_RepartitioningRequred(sTableName VARCHAR2);

Описание

Вызывает exception «Требуется пересекционирование таблицы».

Error_UnpartitioningRequred

PROCEDURE Error_UnpartitioningRequred(sTableName VARCHAR2);

Описание

Вызывает exception «Требуется отключение секционирования таблицы».

Работа с настройками параметров секционирования

GetPartitioningParams

FUNCTION GetPartitioningParams RETURN TPartitioningParams;

Описание

Возвращает текущие параметры секционирования экземпляра Системы.

Работа с секционированием таблиц

GetTablePartitioningType

FUNCTION GetTablePartitioningType(sTableName VARCHAR2) RETURN PLS_INTEGER;

Описание

Возвращает способ секционирования указанной таблицы:

  • 0 - таблица не секционирована;
  • 1 - секционирование по диапазону;
  • 2 - секционирование по хешу;
  • 3 - секционирование по списку.

Если таблица не существует, вызывает exception.

GetCurrTablePartitioningInfo

PROCEDURE GetCurrTablePartitioningInfo(sTableName VARCHAR2, Info OUT TPartitioningParams, sPrimaryRgnColumn OUT VARCHAR2);

Описание

Возвращает текущую информацию о секционировании таблицы.
Параметры:

  • sTableName - наименование таблицы;
  • Info - текущие параметры секционирования;
  • sPrimaryRgnColumn - наименование первичного районного столбца (возвращается независимо от текущего состояния).

Если таблица не существует, возникает exception.

GetTablePartitioningInfo

PROCEDURE GetTablePartitioningInfo(sTableName VARCHAR2, InstancePartitioningParams IN TPartitioningParams, CurrentState OUT TPartitioningParams, RequiredState OUT TPartitioningParams, sPrimaryRgnColumn OUT VARCHAR2);

Описание

Возвращает информацию о секционировании таблицы.
Параметры:

  • sTableName - наименование таблицы;
  • InstancePartitioningParams - параметры секционирования для текущего экземпляра Системы;
  • CurrentState - текущие параметры секционирования;
  • RequiredState - требуемые параметры секционирования;
  • sPrimaryRgnColumn - наименование первичного районного столбца (возвращается независимо от наличия секционирования).

Если таблица не существует, возникает exception.

GetTableRgnPartitionsInfo

PROCEDURE GetTableRgnPartitionsInfo(sTableName VARCHAR2, ssPartNamesByRgnID OUT uszn.pkGen.TStrings30, sDefPartitionName OUT VARCHAR2);

Описание

Загружает информацию о секциях таблицы, секционированной по району (подсекции пока не поддерживаются!!!).
Параметры:

  • sTableName - наименование таблицы;
  • ssPartNamesByRgnID - список наименований имеющихся секций; индекс=ID района;
  • sDefPartitionName - наименование секции по умолчанию.

UpdateTablePartitioning

PROCEDURE UpdateTablePartitioning(sTableName VARCHAR2, iEnablePartitioning PLS_INTEGER, iChangePartitioning PLS_INTEGER, iEnableUnpartitioning PLS_INTEGER, iKeepCustomPartitioning PLS_INTEGER, iUpdateIndexPartitioning PLS_INTEGER, iStrict PLS_INTEGER);

Описание

Приводит состояние секционирования таблицы в соответствие с настройками экземпляра Системы.
Параметры:

  • sTableName - наименование таблицы;
  • iEnablePartitioning - включать ли секционирование, если оно требуется в соответствии с настройками, но выключено (0-нет, 1-да);
  • iChangePartitioning - изменять ли способ секционирования, если он отличается от требуемого (0-нет, 1-да);
  • iEnableUnpartitioning - отключать ли секционирование, если оно не требуется в соответствии с настройками, но включено (0-нет, 1-да);
  • iKeepCustomPartitioning - сохранять ли неизвестные способы секционирования (0-нет, 1-да);
  • iUpdateIndexPartitioning - обновлять параметры секционирования индексов (0-нет, 1-да);
  • iStrict - определяет поведение в том случае, когда требуемый способ изменения секционирования запрещён (передано значение 0).

Если таблица не существует, возникает exception.

Секционирование по районам

GetPrimaryRgnPartitionValues

FUNCTION GetPrimaryRgnPartitionValues(iDataKindID PLS_INTEGER) RETURN uszn.pkGen.TIntegers;

Описание

Возвращает список ID районов для секционирования по первичному районному ключу для указанного вида данных.

GetPrimaryRgnColumnName

FUNCTION GetPrimaryRgnColumnName(sTableName VARCHAR2, iStrict PLS_INTEGER) RETURN VARCHAR2;

Описание

Возвращает наименование столбца первичного района указанной таблицы. Параметр iStrict определяет поведение при отсутствии таблицы или столбца первичного района.