First Due ODBC Connection Setup and Usage

First Due ODBC Connection Setup and Usage

Purpose Statement

First Due's Open Database Connection (ODBC) provides users with direct access to their department's data through a PostgreSQL data warehouse hosted on AWS. This connection enables departments to analyze, extract, and integrate their First Due data with external analytics applications, business intelligence tools, and custom reporting solutions for enhanced operational insights.


Background Information

The ODBC connection serves as a bridge between your local environment and First Due's cloud-based data warehouse, which contains approximately 100 tables organizing data from nearly all First Due modules into analytics-ready datasets. This warehouse is not a direct replication of the production database but reflects current production data with regular refresh cycles. The connection is particularly valuable for departments seeking advanced analytics capabilities, custom reporting solutions, or integration with existing business intelligence platforms.


Required Permissions

  • Administrator or Data Manager permissions to request ODBC access
  • ODBC Connection must be purchased and activated
  • IT Administrator access may be required for local ODBC driver installation and configuration
  • Contact your Implementation or Client Success Manager to initiate ODBC access setup

Step-by-Step Guide

Step 1: Request ODBC Access

Submit a support ticket or contact your Implementation/Client Success Manager to request ODBC connection credentials and setup information.

Step 2: Install PostgreSQL ODBC Driver

Download and install the appropriate PostgreSQL ODBC driver for your operating system from the official PostgreSQL website.

Step 3: Configure ODBC Data Source

  1. Open your system's ODBC Data Source Administrator
  2. Create a new System DSN or User DSN
  3. Select the PostgreSQL ODBC driver
  4. Enter the connection parameters provided by First Due support:
    • Server/Host information
    • Database name
    • Port number
    • Username and password credentials

Step 4: Test Connection

Verify the connection is working properly by testing the data source configuration before proceeding with your analytics application setup.

Step 5: Connect Analytics Application

Configure your chosen analytics tool, BI platform, or database client to use the established ODBC connection for data access.


Best Practices

Data Refresh Understanding:

  • Standard refresh rate is once daily; premium refresh rates available up to 4 times daily
  • Plan reporting schedules around refresh timing for most current data
  • Remember that data is "pulled" from the warehouse, not "pushed" to your environment

Time Zone Considerations:

  • Most timestamp fields are stored in UTC format
  • Convert UTC timestamps to local time zone for accurate local reporting
  • Look for fields labeled with "_local" suffix for pre-converted local timestamps

Query Optimization:

  • Use appropriate filtering and WHERE clauses to limit data retrieval
  • Consider data volume when designing automated queries
  • Test queries during off-peak hours when possible

Schema Management:

  • Monitor product release notes for warehouse schema updates
  • Maintain flexibility in your queries to accommodate potential structural changes
  • Document any custom queries or integrations for easier maintenance

Troubleshooting & FAQs

Q: What is ODBC?  A:First Due's open database connection allows users to access their data through applications designed to analyze or extract their data. First Due's ODBC is a connection to a PostgreSQL data warehouse hosted on AWS.  

Q: Why don't I see data for certain modules? 
A: Tables will only contain data for modules your department has purchased. Unpurchased modules will have empty associated tables.

Q: How do I get description information for ID reference fields? 
A: Some foreign keys reference information not included in the warehouse. Contact support to request lookup tables for specific ID fields you need decoded.

Q: My timestamps appear incorrect - how do I fix this? 
A: Most timestamps are stored in UTC. Convert these fields to your local time zone, or look for corresponding "_local" labeled fields where available.

Q: How will I know about changes to the warehouse structure? 
A: Schema updates and changes are communicated through product release notes, with advance email notifications sent to department contacts when possible.
     (You can sign up for a ODBC Notification list for schema changes by filling out this form: ODBC Schema Change Notifications)

Q: Who can help with specific field or table questions?
A: Submit a support ticket or contact your Implementation/Client Success Manager to connect with a reporting product specialist.

Q: Can I use this connection as a backup solution?
A: No, the warehouse is not designed as a backup solution. It reflects production data but should not be relied upon for backup purposes.

Q: What is ODBC?
A: First Due's open database connection allows users to access their data through applications designed to analyze or extract their data. First Due's ODBC is a connection to a PostgreSQL data warehouse hosted on AWS.

Q: How does the connection work?
A: Data is hosted on our server, and the ODBC connection allows you to access this data from your local environment. Data is not being "pushed" from the ODBC.

Q: What data is in the warehouse?
A: The warehouse is comprised of about 100 tables which organize data across almost all First Due modules into analytics-ready datasets. The tables contain a mix of raw data and pre-computed columns for enhanced usability. If a module is not purchased, there will be no data in the associated tables.

Q: How does data flow from the database to the warehouse?
A: The warehouse is not a replication of our production database but reflects the data that is stored in our production database. The warehouse will update alongside updates in production and does not necessarily serve as a backup.

Q: How recent is the data?
A: We offer refresh rates as frequently as 4 times a day, but the most common refresh rate is once a day.

Q: What is ODBC commonly used for?
A: Many users will use the ODBC connection for running queries or for connections to analytics applications or BI tools. Users "pull" the data from the ODBC to host in their own environment.

Q: How will updates be communicated?
A: Product release notes include enhancements to the back-end tables. While we try to avoid high risk changes, updates to the schema or data types sometimes become necessary. We try to give advance notice as soon as possible of these changes, with these notices being sent to the fire department contact via email.

Q: Why are timestamp fields not stored in local time zone?
A: Most timestamp fields in the warehouse are stored in UTC, which means that you must convert the fields to the local time zone to read the timestamps in the local time zone. The few fields that are stored in local time zone will be labelled as [field name]_local.

Q: Why are there ID reference fields stored without a matching reference table?
A: There are some foreign keys designed for joins that will not match another table in the warehouse for description information. An example of this is event type, by which you have access to the ID but not the name of the event type itself. We can provide lookup tables for this information by request.

Q: Where should I direct questions about the fields and tables in the warehouse?
A: Submit a ticket to support: Submit a Support Ticket or speak with your Client Success or Implementation Manager to be connected with a reporting product specialist.







    • Related Articles

    • NERIS Data Compliance Reports

      Purpose Statement The NERIS Compliance Reports are designed to help Fire/EMS departments identify and resolve data compliance issues before migrating to the National Emergency Response Information System (NERIS) or to troubleshoot existing NERIS ...
    • Connecting First Due to CAD

      Purpose This article reviews the various types of connections that First Due uses when setting up CAD links Importance of Connecting First Due to CAD The following are just a few of the many benefits of enabling First Due to receive dispatches from ...
    • Form Builder - Adding Custom Data Fields

      Purpose Statement This feature enables administrators to add custom data fields to permit forms, allowing departments to collect specific information tailored to their operational needs and compliance requirements. Custom data fields enhance form ...
    • NFIRS export settings NJ

      Purpose To guide you through NFIRS Export . Background Effective January 1, 2024, for data efficiency and analytical reasons, all Fire Departments will discontinue sending their NFIRS Reports to the NJ Division of Fire Safety, NFIRS Unit. All NFIRS ...
    • Inspection Data Sharing

      Purpose Statement The Inspection Data Sharing feature enables Fire/EMS departments to share inspection data with other First Due clients, allowing authorized users to view in-progress and completed inspections across organizational boundaries. This ...