Skip to content

Latest commit

 

History

History
58 lines (40 loc) · 3.56 KB

github.md

File metadata and controls

58 lines (40 loc) · 3.56 KB

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

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. 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.
  • To sync the Projects stream, the repository must have the Projects feature enabled.