Função de Tempo de Execução Mvsql - Event()¶

Resumo¶

Retorna informações sobre a execução do evento atual.

Sintaxe¶

event(<parameter>)

Parâmetros¶

Parâmetro¶

Um parâmetro que determina qual atributo de evento é retornado. Parâmetros válidos incluem:

• 'contextid' - Identificador exclusivo que pode ser usado para correlacionar eventos que ocorrem dentro de uma única operação, como uma regra CRUD comercial.
• 'rowid' - Identificador exclusivo para a linha na qual o evento foi invocado. No caso de uma regra CRUD de negócios, isso se refere à linha de destino.
• 'source.rowid' - Identificador exclusivo para a linha de origem de inserção e atualização do CRUD comercial.
• 'exception' - Mensagem de exceção ou string vazia se nenhuma exceção foi lançada. Este valor é acessível a manipuladores de falha de ação se o evento falhou como resultado de uma exceção.

Devoluções¶

string

Veja o parâmetro.

Observações¶

O event() A função é normalmente usada em manipuladores de falhas de ação para rastrear falhas em nível de linha ao executar regras CRUD de negócios. O contexto e os identificadores de linha podem ser correlacionados com entradas do histórico de eventos. Consulte Histórico de eventos para obter mais informações.

Quando executada fora do contexto de um evento, a função event() retorna valores vazios preenchidos com zeros. Os parâmetros contextid, rowid e source.rowid retornam um GUID vazio. O parâmetro exception retorna uma string vazia.

Exemplos¶

event('contextid')

Retorna:

'5e1eb577-c4a0-4681-bd72-f15a2980e273'

event('rowid')

Retorna:

'5e1eb577-c4a0-4681-bd72-f15a2980e273'

event('source.rowid')

Retorna:

'5e1eb577-c4a0-4681-bd72-f15a2980e273'

event('exception')

Retorna:

'Acesso negado'