Conditional schemas

Conditional schemas allow you to dynamically enable optional database schemas in your Data Cloud instance. These schemas provide additional data tables and columns for specific connections.

Overview

Each schema corresponds to additional data tracking capabilities for specific connections like Jira Components, GitHub Pull Descriptions, Linear Cycles, and more.

Available schemas

Schema Connection Required Purpose New API Endpoint
Jira Components Jira Cloud / Jira Data Center Adds component tracking to Jira issues N/A
Jira Fix Versions Jira Cloud / Jira Data Center Adds fix project version tracking to Jira issues N/A
GitHub Pull Descriptions GitHub Adds description column to pull request data N/A
GitHub Repository Properties GitHub Adds repository property tracking Get all custom property values for a repository
GitHub Copilot Enterprise User Metrics GitHub Copilot Metrics (Enterprise) Adds daily user-level Copilot usage metrics Get Copilot user 1-day usage metrics
GitHub Issues GitHub Adds GitHub issue tracking List repository issues
JSM Incident Custom Fields Jira Service Management Cloud Adds custom field support for incidents N/A
Google Calendar Event Titles Google Calendar Adds title column to calendar events N/A
PagerDuty Custom Fields PagerDuty Adds custom field support Get custom field values
Repository Groups None Adds repository grouping functionality N/A
Linear Cycles Linear Adds Linear cycle tracking Cycle object
Linear Initiatives Linear Adds Linear initiative tracking Initiative object
Outlook Calendar Event Names Outlook Calendar Adds name column to calendar events N/A
Bitbucket Server Commits Bitbucket Data Center Adds commit tracking N/A
GitLab Deployment Events GitLab Adds deployment event tracking List project deployments
GitHub Copilot Enterprise User Metrics GitHub Copilot Metrics (Enterprise) Adds daily user-level Copilot usage metrics Get Copilot user 1-day usage metrics

Managing conditional schemas

Accessing the interface

  1. Navigate to Admin → Data Cloud → Conditional Schemas
  2. You’ll see a list of available schemas with their current status:
    • Applied: Schema is currently active
    • Available: Schema can be applied
    • Unavailable: Schema cannot be applied (no active required connection)

Applying a schema

  1. Find the schema you want to enable
  2. Ensure the prerequisite base schema exists (created when the respective connection was first established)
  3. Click Apply next to the schema name
  4. The system will validate prerequisites and apply the schema
  5. You’ll receive confirmation when the process completes

Reverting a schema

⚠️ Warning: Reverting a conditional schema will delete all data stored in that schema. Please exercise caution here.

  1. Find the schema you want to remove (marked as “Applied”)
  2. Click Revert next to the schema name
  3. Confirm the action in the dialog
  4. The system will permanently remove the schema and all associated data

Troubleshooting

Common issues

Schema won’t apply

  • Verify that an active connection of the respective type is configured for your account
  • Ensure that you have access to the corresponding API endpoints, if applicable
  • Contact support if you are still facing issues with applying schema

Schema shows as “Unavailable”

  • Create the respective connection first
  • Contact support if the connection is established but schema remains unavailable