---
warning: DO NOT CHANGE THIS MANUALLY, THIS IS GENERATED BY https://github.com/duckdb/community-extensions repository, check README there
title: events
excerpt: |
  DuckDB Community Extensions
  A extension that hooks into database events and sends JSON-formatted notifications to external programs.

docs:
  extended_description: For more information regarding usage, see the [documentation](https://query.farm/products/extensions/events/).
extension:
  build: cmake
  description: A extension that hooks into database events and sends JSON-formatted notifications to external programs.
  language: C++
  license: Apache-2.0
  maintainers:
  - rustyconover
  name: events
  version: '2026041501'
repo:
  github: query-farm/events
  ref: d6e9afda80991072386f64825c5c11339f051e99

extension_star_count: 4
extension_star_count_pretty: 4
extension_download_count: 817
extension_download_count_pretty: 817
image: '/images/community_extensions/social_preview/preview_community_extension_events.png'
layout: community_extension_doc
---
### Compatibility Matrix

This table covers all DuckDB releases that have not reached [end-of-life](https://duckdb.org/release_calendar), including LTS releases, and shows the 2 most recent patch releases of each. Older patch releases are not listed, but the extension may be available for them as well.

<div class="extension_compatibility_table"></div>

| Platform | 1.4.4 | 1.4.5 | 1.5.5 | 1.5.6 | 2.0.0 |
| :--- | :---: | :---: | :---: | :---: | :---: |
| Linux AMD64 | ❌ | ❌ | ❌ | ✅ | ❌ |
| Linux ARM64 | ❌ | ❌ | ❌ | ✅ | ❌ |
| macOS AMD64 | ❌ | ❌ | ❌ | ✅ | ❌ |
| macOS ARM64 | ❌ | ❌ | ❌ | ✅ | ❌ |
| Windows AMD64 | ❌ | ❌ | ❌ | ✅ | ❌ |
| Windows ARM64 | ❌ | ❌ | ❌ | ❌ | ❌ |
| WebAssembly | ❌ | ❌ | ❌ | ✅ | ❌ |

### Installing and Loading
```sql
INSTALL {{ page.extension.name }} FROM community;
LOAD {{ page.extension.name }};
```

{% if page.docs.hello_world %}
### Example
```sql
{{ page.docs.hello_world }}```
{% endif %}

{% if page.docs.extended_description %}
### About {{ page.extension.name }}
{{ page.docs.extended_description }}
{% endif %}
### Added Functions

<div class="extension_functions_table"></div>

This extension does not add any functions.

### Overloaded Functions

<div class="extension_functions_table"></div>

This extension does not add any function overloads.

### Added Types

<div class="extension_types_table"></div>

This extension does not add any types.

### Added Settings

<div class="extension_settings_table"></div>

|        name         |                                                                                                                              description                                                                                                                              | input_type | scope  | aliases |
|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------|--------|---------|
| events_async        | If true, events are delivered asynchronously (fire and forget). Default is false (synchronous).                                                                                                                                                                       | BOOLEAN    | GLOBAL | []      |
| events_destination  | Path to the program that receives event notifications via stdin                                                                                                                                                                                                       | VARCHAR    | GLOBAL | []      |
| events_session_name | Optional name for this session, included in all events                                                                                                                                                                                                                | VARCHAR    | GLOBAL | []      |
| events_types        | List of event types to send to the destination. Valid types: connection_opened, connection_closed, query_begin, query_end, transaction_begin, transaction_commit, transaction_rollback, planning_error, finalize_prepare, execute_prepared, rebind_prepared_statement | VARCHAR[]  | GLOBAL | []      |