集計

集約 AE は集約 SQL 関数から呼び出されます。

データ構造

構造体 NZAEAGG_HANDLE
アグリゲート・ハンドル Aggregate AE 関数で使用される不透明ハンドル。
structNzaeAggAccumulate
Accumulate構造。
structNzaeAggFieldFunctions
アグリゲーションのためのレコード関数の読み取りと書き込み。
構造体NzaeAggFinalResult
最終結果の構造。
structNzaeAggInitializeState
InitializeState構造体。
structNzaeAggMerge
マージ構造。
structNzaeAggMetadata
NzaeAggMetatadata.
structNzaeAggReadOnlyFieldFunctions
アグリゲーションのための読み取り専用の記録機能。

関数

voidnzaeAggClose(NZAEAGG_HANDLEhandle)
終わったらハンドルを閉じる。
NzaeAggRcCode nzaeAggGetEnv(NZAEAGG_HANDLEhandle, const char *name, const char **result)
AEまたはシステム環境変数を取得する。 AE変数が優先される。
voidnzaeAggGetFirstEnvironmentEntry(NZAEAGG_HANDLEhandle,NzaeEnvironmentEntry*entry)
最初の環境エントリーを返します。
AeUserCode nzaeAggGetLastErrorCode(NZAEAGG_HANDLEhandle)
最後に発生したエラーのコードを取得します。
const char*nzaeAggGetLastErrorText(NZAEAGG_HANDLEhandle)
最後に発生したエラーのメッセージテキストを取得します。
const char*nzaeAggGetLibraryFullPath(NZAEAGG_HANDLEh, const char*libraryName,boolcaseSensitive)
ライブラリ名のファイルパスを取得します。
NzaeSharedLibraryInfo* nzaeAggGetLibraryInfo(NZAEAGG_HANDLEh)
要求された共有ライブラリ情報のNzaeSharedLibraryInfoを返す。
NzaeSharedLibraryInfo* nzaeAggGetLibraryProcessInfo(NZAEAGG_HANDLEh)
NzaeSharedLibraryInfoプロセスの共有ライブラリ情報を返します。 AE がリモートでない場合は NULL を返す。 AEシステムは、この呼び出しによるメモリーを所有する。
boolnzaeAggGetNextEnvironmentEntry(NZAEAGG_HANDLEhandle,NzaeEnvironmentEntry*entry)
次の環境エントリーを返します。
intnzaeAggGetNumberOfParameters(NZAEAGG_HANDLEh)
パラメータの数を返します。
const char*nzaeAggGetParameter(NZAEAGG_HANDLEh, int index)
パラメータを返します。
NzaeAggRcCode nzaeAggGetRuntime(NZAEAGG_HANDLEhandle,NzaeRuntime*arg)
AE 集約に関する実行時情報を取得する。
NzaeAggType nzaeAggGetType(NZAEAGG_HANDLEhandle)
集約タイプを返します。
NzaeAggRcCode nzaeAggLog(NZAEAGG_HANDLEhandle,NzaeLogLevellevel, const char *mes-sage)
指定されたメッセージをログに記録します。
void*nzaeAggNext(NZAEAGG_HANDLEhandle,NzaeAggMessageType *messageType)
次の集約メッセージを取得する。
NzaeAggRcCode nzaeAggPing(NZAEAGG_HANDLEhandle)
AE Aggregate がまだアクティブで、ハングアップしていないことを示す。
NzaeAggRcCode nzaeAggUpdate(NZAEAGG_HANDLEhandle)
結果をデータベースに更新する。
NzaeAggRcCode nzaeAggUserError(NZAEAGG_HANDLEhandle, const char *_template,...)
AE がエラー状態に遭遇したことを示す。

列挙子

enumNzaeAggMessageType { NZAEAGG_NOT_SET= -2, NZAEAGG_ERROR= -1, NZAEAGG_END= 0, NZAEAGG_INITIALIZE= 1, NZAEAGG_ACCUMULATE= 2, NZAEAGG_MERGE= 3, NZAEAGG_FINAL_RESULT= 4 }
メッセージの種類を集約する。
enumNzaeAggRcCode { NZAEAGG_RC_ERROR= -1, NZAEAGG_RC_NORMAL= 0 }
nzaeAgg集約関数の戻りコード。
enumNzaeAggType { NzaeAggUnknown, NzaeAggGrouped, NzaeAggAnalytic }
集約機能タイプ。

詳細説明

集約 AE は集約 SQL 関数から呼び出されます。

機能説明

voidnzaeAggClose(NZAEAGG_HANDLEhandle)
終わったらハンドルを閉じる。
パラメーター:

handle

集合ハンドル。

NzaeAggRcCode nzaeAggGetEnv(NZAEAGG_HANDLEhandle, const char *name, const char **result)
AEまたはシステム環境変数を取得する。 AE変数が優先される。
パラメーター:

  • handle

    集合ハンドル。

  • name

    変数名。

  • result

    出力変数の値、見つからない場合はNULL。

    戻り

    NzaeAggRcCode

    リターンコード。
voidnzaeAggGetFirstEnvironmentEntry(NZAEAGG_HANDLEhandle,NzaeEnvironmen-tEntry*entry)
最初の環境エントリーを返します。
パラメーター:

  • handle

    集合ハンドル。

  • NzaeEnvironmentEntry entry

    最初のエントリー。

    この関数呼び出しの後、nzaeGetNextEnvironmentEntryが繰り返し呼び出される。 AEシステムは、この呼び出しのメモリーを所有する。

AeUserCode nzaeAggGetLastErrorCode(NZAEAGG_HANDLEhandle)
最後に発生したエラーのコードを取得します。
パラメーター:

  • handle

    集合ハンドル。

    戻り

    AeUserCode

    エラーコード。

const char*nzaeAggGetLastErrorText(NZAEAGG_HANDLEhandle)
最後に発生したエラーのメッセージテキストを取得します。
パラメーター:

  • handle

    集合ハンドル。

    戻り

    最後のエラーのテキスト。

const char*nzaeAggGetLibraryFullPath(NZAEAGG_HANDLEh, const char*libraryName,boolcaseSensitive)
ライブラリ名のファイルパスを取得します。
パラメーター:

  • h

    集合ハンドル。

  • libraryName

    ライブラリー名。

  • caseSensitive

    TRUE の場合、大文字小文字を区別して検索します。

    戻り

    見つかればファイルパス、見つからなければ NULL。

    ライブラリが見つからない場合は NULL を返す。 AEシステムは、この呼び出しによるメモリーを所有する。

NzaeSharedLibraryInfo* nzaeAggGetLibraryInfo(NZAEAGG_HANDLEh)
要求された共有ライブラリ情報のNzaeSharedLibraryInfoを返す。
パラメーター:

  • h

    集合ハンドル。

    戻り

    NzaeSharedLibraryInfo

    共有ライブラリーの情報。

    AEシステムは、この呼び出しによるメモリーを所有する。

NzaeSharedLibraryInfo* nzaeAggGetLibraryProcessInfo(NZAEAGG_HANDLEh)
NzaeSharedLibraryInfoプロセスの共有ライブラリ情報を返します。 AE がリモートでない場合は NULL を返す。 AEシステムは、この呼び出しによるメモリーを所有する。
パラメーター:

  • h

    集合ハンドル。

    戻り

    NzaeSharedLibraryInfo

    共有ライブラリーの情報。

boolnzaeAggGetNextEnvironmentEntry(NZAEAGG_HANDLEhandle,NzaeEnvironmentEntry*entry)
次の環境エントリーを返します。
パラメーター:

  • handle

    集合ハンドル。

  • NzaeEnvironmentEntry entry

    次のエントリー

    戻り

    FALSEon end.

    共有ライブラリーの情報。

    最初のnzaeGetNextEnvironmentEntryは、nzaeGetFirstEnvironmentEntryの呼び出しの後に続く必要があります。 終了時に FALSE を返す。 キー名は繰り返されることがあるが、キー名の現在のバージョンは最後に与えられる。 AEシステムは、この呼び出しによるメモリーを所有する。

intnzaeAggGetNumberOfParameters(NZAEAGG_HANDLEh)
パラメータの数を返します。
パラメーター:

  • h

    集合ハンドル。

    戻り

    パラメータの数。
const char*nzaeAggGetParameter(NZAEAGG_HANDLEh, int index)
パラメータを返します。
パラメーター:

  • h

    集合ハンドル。

  • index

    パラメータのインデックス。

    戻り

    パラメーター値。

    インデックスはゼロベースである。

NzaeAggRcCode nzaeAggGetRuntime(NZAEAGG_HANDLEhandle,NzaeRuntime*arg)
AE 集約に関する実行時情報を取得する。
パラメーター:

  • h

    集合ハンドル。

  • NzaeRuntime arg

    呼び出し元が作成したランタイムを記入する。

    戻り

    NzaeAggRcCode

    リターンコード。

const char*nzaeAggGetSystemLogFileName()
AE 集計システムログファイル名を取得します。
戻り

ログファイル名。

NzaeAggType nzaeAggGetType(NZAEAGG_HANDLEhandle)
集約タイプを返します。
パラメーター:

  • handle

    集合ハンドル。

    戻り

    NzaeAggType

    集合体のタイプ。

NzaeAggRcCode nzaeAggLog(NZAEAGG_HANDLEhandle,NzaeLogLevellevel, const char *message)
指定されたメッセージをログに記録します。
パラメーター:

  • handle

    集合ハンドル。

  • NzaeLogLevel level

    ログレベル。

  • message

    ログメッセージ。

    戻り

    NzaeAggRcCode

    リターンコード。

void*nzaeAggNext(NZAEAGG_HANDLEhandle,NzaeAggMessageType *messageType)
次の集約メッセージを取得する。
パラメーター:

  • handle

    集合ハンドル。

  • NzaeAggMessageType messageType

    返されたメッセージ・タイプ。

    戻り

    構造体はvoid * 。

    NzaeAggInitialize, NzaeAggAccumulate,NzaeAggMerge,NzaeAggFinalResult構造体ポイントアーを返す。 messageTypeパラメータを使って、リターン・タイプ、入力終了、エラーを決定する。 エラー時またはデータ終了時に NULL を返す。

NzaeAggRcCode nzaeAggPing(NZAEAGG_HANDLEhandle)
AE Aggregate がまだアクティブで、ハングアップしていないことを示す。
パラメーター:

  • handle

    集合ハンドル。

    戻り

    NzaeAggRcCode

    リターンコード。

NzaeAggRcCode nzaeAggUpdate(NZAEAGG_HANDLEhandle)
結果をデータベースに更新する。
パラメーター:

  • handle

    集合ハンドル。

    戻り

    NzaeAggRcCode

    NzaeAggInitialize, NzaeAggAccumulate,NzaeAggMerge, またはNzaeAggFinalResult構造体ポインタ。 エラー時にはNULLになる。

NzaeAggRcCode nzaeAggUserError(NZAEAGG_HANDLEhandle, const char *_template,...)
AE がエラー状態に遭遇したことを示す。
パラメーター:

  • handle

    集合ハンドル。

  • _template

    printfスタイルのテンプレート。

    戻り

    NzaeAggRcCode

    AEは完了し、この呼び出しの後に終了するはずである。 メッセージはprintfのように作られる。

列挙型のドキュメント

enumNzaeAggMessageType
メッセージの種類を集約する。

NZAEAG_NOT_SET

NZAEAGG_ERROR

NZAEAGG_END

nzaeagg_initialize

nzaeagg_accumulate

NZAEAGG_MERGE

NZAEAG_FINAL_RESULT

enumNzaeAggRcCode
nzaeAgg集約関数の戻りコード。

NZAEAG_RC_ERROR

NZAEAG_RC_NORMAL

enumNzaeAggType
集約機能タイプ。

NzaeAggUnknown

NzaeAggGrouped

NzaeAggAnalytic