Рекомендации по использованию пользовательских макросов

При создании или использовании пользовательского макроса помните о следующих рекомендациях:

Имя пользовательского макроса должно быть алфавитно-цифровым. Использовать пробелы в строке имени нельзя, но можно использовать символы подчеркивания (_).

Если источник данных сконфигурирован с использованием свойства ENABLE_SELECT_SORT_BY = TRUE, вы должны написать пользовательский макрос на основе чистого SQL с условием ORDER BY, чтобы произвести сортировку возвращенных записей на основе полей ключа аудитории для уровня аудитории, с которым вы работаете. В противном случае, если порядок сортировки не будет таким, как ожидается, будет сгенерирована ошибка, если пользовательский макрос используется в производном поле в процессе Снимок.

Если вы не сравниваете возвращенное значение с пользовательским макросом и если значение является числовым, ненулевые значения обрабатываются как TRUE (соответственно, ID, связанные с ними, выбираются), а нулевые значения обрабатываются как FALSE. Строчные значения всегда обрабатываются как FALSE.

При создании пользовательского макроса, в котором используется чистый SQL, использование временной таблицы может существенно повысить производительность чистого SQL за счет выбора количества данных, с которыми нужно работать.

Если пользовательский макрос использует временные таблицы в основном алгоритме, временная таблица будет принудительно помещена в базу данных, чтобы обработка алгоритма не завершилась с ошибкой.

Однако, если пользовательский макрос используется на высшем уровне SELECT, не будет никакой хронологии для Campaign, чтобы принудительно поместить временную таблицу в базу данных, и обработка алгоритма завершится с ошибкой.

Таким образом, при создании пользовательского макроса, в котором используется чистый SQL, вам может потребоваться создать две версии одного и того же пользовательского макроса: одну, в которой используются маркеры временной таблицы, и одну, в которой они не используются.

Пользовательский макрос без маркеров временной таблицы может использоваться на высшем уровне дерева (например, в первом операторе SELECT). Пользовательский макрос без маркеров временной таблицы может использоваться в любом другом месте дерева, где может оказаться временная таблица, которой можно воспользоваться.

Возможны самоообъединения при объединении значений, возвращенных пользовательским макросом при запросе из ненормализованных данных, что, вероятно, не является желательным поведением.

Например, если вы используете пользовательский макрос на основе чистого SQL, который возвращает значение и (например, в процессе Снимок) вы выводите пользовательский макрос и другое поле из таблицы, на которой основан пользовательский макрос, Campaign произведет самообъединение для этой таблицы. Если таблица не нормализована, вы получите декартово произведение (то есть, число показанных записей будет больше, чем вы ожидаете).

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

Во время выполнения пользовательский макрос разрешается путем поиска его определения в системной таблице UA_CustomMacros (где хранятся определения), а затем используется/выполняется.

В отличие сохраненных запросов имя пользовательского макроса должно быть уникальным независимо от пути папки. В более ранних выпусках, чем 5.0, у вас мог быть сохраненный запрос A, например, в папках F1 и F2.

Campaign поддерживает хранимые запросы от прежних выпусков. Однако в ссылках на неуникальные сохраненные запросы должен использоваться прежний синтаксис:

storedquery(<query name>)

При разрешении пользовательских переменных в пользовательские макросы Campaign использует текущее значение пользовательской переменной при проверке синтаксиса. Если текущее значение осталось пустым, Campaign сгенерирует ошибку.

Маркер временной таблицы предлагается как дополнительная функция оптимизации производительности, которая выбирает объем данных, извлекаемых из базы данных, с использованием набора ID аудиторий во временной таблице, доступной для использования текущим процессом. Этот список ID во временной таблице может быть надмножеством ID в текущей ячейке. Поэтому функции агрегации, выполняемые для временной таблицы (например, среднее или сумма), не поддерживаются и могут сгенерировать неправильные результаты.

Если вы собираетесь использовать пользовательский макрос в нескольких разных базах данных, вы можете использовать выражение IBM® вместо чистого SQL, так как чистый SQL может быть связан с какой-то определенной базой данных.

Если пользовательский макрос содержит чистый SQL и другой пользовательский макрос, пользовательский макрос будет разрешен, выполнен, и его значение будет возвращено до выполнения чистого SQL.

Campaign рассматривает запятую как разделитель параметров. Если вы используете запятые как буквальные символы в параметре, заключите текст в фигурные скобки ({}), как в следующем примере:

TestCM( {STRING_CONCAT(UserVar.Test1, UserVar.Test2) } )

Campaign поддерживает простую замену параметров в пользовательских макросах с использованием чистого кода SQL. Например, если вы зададите блок процесса Выбрать на поточной диаграмме, содержащей следующий запрос:

exec dbms_stats.gather_table_stats(tabname=> <temptable>,ownname=> 'autodcc')

Campaign успешно подставит фактическую временную таблицу вместо маркера <temptable>. Учтите, что требуется заключить имя таблицы в одинарные кавычки.

В приведенных ниже таблицах показано, как Campaign обрабатывает пользовательские макросы в запросах и производных полях.

Пользовательские макросы в запросах и производных полях (процессы Выбрать, Сегмент и Аудитория)

Тип пользовательского макроса	Как он используется
Чистый SQL: ID	Запускает отдельный запрос. Список ID объединяется с другими результатами. Если пользовательский макрос содержит другой пользовательский макрос плюс чистый SQL, пользовательский макрос будет разрешен и выполнен, после чего будет выполнен чистый SQL.
Чистый SQL: ID + значение	Ожидается, что возвращенное значение будет использоваться в выражении или в качестве сравнения. Если значение не используется таким образом, Campaign обработает ненулевое значение как TRUE для выбора ID, а нулевое значение или строку - как FALSE.
IBM® Выражение	Выражение будет разрешено, и будет выполнена проверка синтаксиса. Поддерживается один запрос на одну таблицу, и ID сопоставляются/объединяются.

В запросе на основе чистого SQL (процессы Выбрать, Сегмент и Аудитория)

Тип пользовательского макроса	Как он используется
Чистый SQL: ID	Разрешается пользовательский макрос, а затем выполняется запрос.
Чистый SQL: ID + значение	Не поддерживается.
IBM® Выражение	Выражение будет разрешено, но проверка синтаксиса не выполняется. Если выражение является неправильным, это будет обнаружено сервером базы данных во время выполнения.