GitHub

Overview

The GitHub source supports both Full Refresh and Incremental syncs. You can choose if this connector will copy only the new or updated data, or all rows in the tables and columns you set up for replication, every time a sync is run.

This Github source wraps the Singer Github Tap.

Output schema

This connector outputs the following streams:

Features

Feature

Supported?

Full Refresh Sync

Yes

Incremental - Append Sync

Yes

Replicate Incremental Deletes

Coming soon

SSL connection

Yes

Namespaces

No

Performance considerations

The Github connector should not run into Github API limitations under normal usage. Please create an issue if you see any rate limit issues that are not automatically retried successfully.

Getting started

Requirements

  • Github Account

  • Github Personal Access Token wih the necessary permissions (described below)

Setup guide

Log into Github and then generate a personal access token.

Your token should have at least the repo scope. Depending on which streams you want to sync, the user generating the token needs more permissions:

  • For syncing Collaborators, the user which generates the personal access token must be a collaborator. To become a collaborator, they must be invited by an owner. If there are no collaborators, no records will be synced. Read more about access permissions here.

  • Syncing Teams is only available to authenticated members of a team's organization. Personal user accounts and repositories belonging to them don't have access to Teams features. In this case no records will be synced.

  • To sync the Projects stream, the repository must have the Projects feature enabled.