GitHub

GitHub is in Preview in the connection wizard: it is built on GitHub’s documented API and has not yet been proven against a live account, so check the imported tables before relying on them.

1. In DataSquares, open Data Sources and choose Connect Source. The Connect a data source page opens.

2. Pick GitHub on that page (search or browse by category).

3. Fill in the connection details below, then test the connection and save.

Connection details

Field	What to enter
Organization	e.g. acme
Access token	A fine-grained token with read access to the organization’s repositories, issues and members. Stored encrypted and never shown again.

Test Connection reads one page of records with these values; nothing is saved until you import.

Tables

Pick the tables to import — each one becomes a table in the source:

Table	What it holds
repositories	Repositories
issues	Issues and pull requests — Pull requests are the rows with a pull_request.url.
members	Members
teams	Teams

Every table is read through all of its pages, nested fields become parent.child columns, and the whole set is imported at once: the import’s row and size limits count the picked tables together, and if they pass one, nothing is imported and the message says which table and which limit. Refresh the source on a schedule, or by hand, to re-read every table; a table that comes back empty is refused rather than emptied unless you allow it. Nothing is ever written to GitHub.

The requests follow GitHub’s API reference.

Related

• Connector catalog — everything DataSquares connects to.
• Quickstart — from connection to shared dashboard.