vectordotdev · powerumc · Apr 24, 2025 · Aug 25, 2025 · Sep 1, 2025 · Sep 16, 2025
@@ -33,6 +33,10 @@ inputs:
     required: false
     default: false
     description: "Install libsasl2." # Required to fully build Vector
+  unixodbc:
+    required: false
+    default: false
+    description: "Install unixODBC headers/libs (apt unixodbc-dev, dnf unixODBC-devel, or brew unixodbc). Required when sources-odbc is enabled."
 
   # prepare.sh - rust
   rust: # rustup module
@@ -212,10 +216,45 @@ runs:
         sudo cp "${TEMP}/cue" /usr/bin/cue
         rm -rf "$TEMP"
 
-    - name: Install libsasl2
-      if: ${{ inputs.libsasl2 == 'true' }}
+    - name: Install system libraries (Linux)
+      if: ${{ runner.os == 'Linux' && (inputs.libsasl2 == 'true' || inputs.unixodbc == 'true') }}
+      shell: bash
+      run: |
+        if command -v apt-get >/dev/null 2>&1; then
+          pkgs=()
+          [[ "${{ inputs.libsasl2 }}" == "true" ]] && pkgs+=(libsasl2-dev)
+          [[ "${{ inputs.unixodbc }}" == "true" ]] && pkgs+=(unixodbc-dev)
+          timeout 30m sudo apt-get update
+          timeout 30m sudo apt-get install -y "${pkgs[@]}"
+        elif command -v dnf >/dev/null 2>&1; then
+          pkgs=()
+          [[ "${{ inputs.libsasl2 }}" == "true" ]] && pkgs+=(cyrus-sasl-devel)
+          [[ "${{ inputs.unixodbc }}" == "true" ]] && pkgs+=(unixODBC-devel)
+          timeout 30m sudo dnf install -y --setopt=install_weak_deps=False "${pkgs[@]}"
+        else
+          echo "No supported package manager (apt-get/dnf) found for system libraries" >&2
+          exit 1
+        fi
+
+    - name: Install unixODBC (macOS)
+      if: ${{ runner.os == 'macOS' && inputs.unixodbc == 'true' }}
       shell: bash
-      run: timeout 30m sudo apt-get update && timeout 30m sudo apt-get install -y libsasl2-dev
+      run: |
+        echo "Installing unixODBC"
+        brew install unixodbc
+        # Use the formula prefix so Intel (/usr/local) and Apple Silicon (/opt/homebrew)
+        # both work. odbc-sys also probes `brew --prefix`, but these keep the linker,
+        # headers, and pkg-config consistent for the rest of the build.
+        prefix="$(brew --prefix unixodbc)"
+        lib_dir="${prefix}/lib"
+        include_dir="${prefix}/include"
+        pkgconfig_dir="${prefix}/lib/pkgconfig"
+        {
+          echo "LIBRARY_PATH=${lib_dir}${LIBRARY_PATH:+:$LIBRARY_PATH}"
+          echo "CPATH=${include_dir}${CPATH:+:$CPATH}"
+          echo "PKG_CONFIG_PATH=${pkgconfig_dir}${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}"
+          echo "DYLD_FALLBACK_LIBRARY_PATH=${lib_dir}${DYLD_FALLBACK_LIBRARY_PATH:+:$DYLD_FALLBACK_LIBRARY_PATH}"
+        } >> "$GITHUB_ENV"
 
     - name: Cache cargo binaries
       id: cache-cargo-binaries

@@ -126,6 +126,10 @@ on:
         value: ${{ jobs.int_tests.outputs.nats }}
       nginx:
         value: ${{ jobs.int_tests.outputs.nginx }}
+      odbc-mariadb:
+        value: ${{ jobs.int_tests.outputs.odbc-mariadb }}
+      odbc-postgresql:
+        value: ${{ jobs.int_tests.outputs.odbc-postgresql }}
       opentelemetry:
         value: ${{ jobs.int_tests.outputs.opentelemetry }}
       postgres:
@@ -354,6 +358,8 @@ jobs:
       mqtt: ${{ steps.filter.outputs.mqtt }}
       nats: ${{ steps.filter.outputs.nats }}
       nginx: ${{ steps.filter.outputs.nginx }}
+      odbc-mariadb: ${{ steps.filter.outputs.odbc-mariadb }}
+      odbc-postgresql: ${{ steps.filter.outputs.odbc-postgresql }}
       opentelemetry: ${{ steps.filter.outputs.opentelemetry }}
       postgres: ${{ steps.filter.outputs.postgres }}
       prometheus: ${{ steps.filter.outputs.prometheus }}
@@ -419,6 +425,8 @@ jobs:
             "mqtt": ${{ steps.filter.outputs.mqtt }},
             "nats": ${{ steps.filter.outputs.nats }},
             "nginx": ${{ steps.filter.outputs.nginx }},
+            "odbc-mariadb": ${{ steps.filter.outputs.odbc-mariadb }},
+            "odbc-postgresql": ${{ steps.filter.outputs.odbc-postgresql }},
             "opentelemetry": ${{ steps.filter.outputs.opentelemetry }},
             "postgres": ${{ steps.filter.outputs.postgres }},
             "prometheus": ${{ steps.filter.outputs.prometheus }},

@@ -134,6 +134,8 @@ jobs:
             "mongodb",
             "nats",
             "nginx",
+            "odbc-mariadb",
+            "odbc-postgresql",
             "opentelemetry",
             "postgres",
             "prometheus",

@@ -49,6 +49,7 @@ jobs:
           cargo-nextest: true
           protoc: true
           libsasl2: true
+          unixodbc: true
           cargo-hack: true
           cargo-cache: true
 

@@ -126,6 +126,8 @@ jobs:
             "mqtt",
             "nats",
             "nginx",
+            "odbc-mariadb",
+            "odbc-postgresql",
             "opentelemetry",
             "postgres",
             "prometheus",

@@ -30,6 +30,7 @@ jobs:
           rust: true
           protoc: true
           libsasl2: true
+          unixodbc: true
           cargo-msrv: true
           cargo-cache: true
       - run: cargo msrv verify
@@ -91,7 +91,7 @@ jobs:
         run: |
           dnf install -y --setopt=install_weak_deps=False \
             gcc gcc-c++ make cmake perl perl-IPC-Cmd \
-            openssl-devel cyrus-sasl-devel zlib-devel \
+            openssl-devel cyrus-sasl-devel zlib-devel unixODBC-devel \
             pkgconfig clang \
             rpm-build sudo \
             git tar gzip xz which findutils \
@@ -126,6 +126,7 @@ jobs:
           rust: true
           cargo-deb: true
           protoc: true
+          unixodbc: true
       - name: Build Vector
         run: make NATIVE=true package-${{ matrix.target }}-all
       - name: Stage package artifacts for publish

@@ -52,6 +52,7 @@ jobs:
           rust: true
           protoc: true
           libsasl2: true
+          unixodbc: true
           cargo-nextest: ${{ inputs.cargo_nextest }}
           datadog-ci: ${{ inputs.upload_test_results }}
           cargo-cache: true

@@ -53,6 +53,7 @@ jobs:
           protoc: true
           libsasl2: true
           cargo-cache: true
+          unixodbc: true
       - run: make check-clippy
 
   test:
@@ -149,6 +150,7 @@ jobs:
           cue: true
           libsasl2: true
           cargo-cache: true
+          unixodbc: true
       - run: make check-generated-docs
 
   check-rust-docs:
@@ -162,6 +164,9 @@ jobs:
         with:
           rust: true
           cargo-cache: true
+          # `docs` enables sources-dnstap and sources-odbc.
+          protoc: true
+          unixodbc: true
       - run: cd rust-doc && make ci-docs-build
 
   test-vrl:

@@ -81,6 +81,7 @@ jobs:
           protoc: true
           libsasl2: true
           cargo-cache: true
+          unixodbc: true
 
       - name: Run tests
         run: |

@@ -27,6 +27,7 @@ jobs:
           cargo-nextest: true
           protoc: true
           cargo-cache: true
+          unixodbc: true
 
       # Some tests e.g. `reader_exits_cleanly_when_writer_done_and_in_flight_acks` are flaky.
       - name: Run tests

@@ -35,6 +35,7 @@ jobs:
           rust: true
           protoc: true
           libsasl2: true
+          unixodbc: true
           vdev: true
           cargo-cache: true
           cache-save: true