connector-github.md

title	Connect to GitHub
titleSuffix	Azure Data Factory & Azure Synapse
description	Use GitHub to specify your Common Data Model entity references
author	jianleishen
ms.subservice	data-movement
ms.topic	how-to
ms.date	10/20/2023
ms.author	jianleishen
ms.custom	synapse sfi-image-nochange

Use GitHub to read Common Data Model entity references

[!INCLUDEappliesto-adf-asa-md]

The GitHub connector in Azure Data Factory and Synapse Analytics pipelines is only used to receive the entity reference schema for the Common Data Model format in mapping data flow.

Create a linked service to GitHub using UI

Use the following steps to create a linked service to GitHub in the Azure portal UI.

1. Browse to the Manage tab in your Azure Data Factory or Synapse workspace and select Linked Services, then click New:

   Azure Data Factory

   :::image type="content" source="media/connector-github/new-linked-service.png" alt-text="Screenshot of creating a new linked service with Azure Data Factory UI.":::

   Azure Synapse

   :::image type="content" source="media/connector-github/new-linked-service-synapse.png" alt-text="Screenshot of creating a new linked service with Azure Synapse UI.":::

2. Search for GitHub and select the GitHub connector.

   :::image type="content" source="media/connector-github/github-connector.png" alt-text="Screenshot of the GitHub connector.":::

3. Configure the service details, test the connection, and create the new linked service.

   :::image type="content" source="media/connector-github/configure-github-linked-service.png" alt-text="Screenshot of linked service configuration for GitHub.":::

Linked service properties

The following properties are supported for the GitHub linked service.

Property	Description	Required
type	The type property must be set to GitHub.	yes
userName	GitHub username	yes
password	GitHub password	yes

Related content

Create a source dataset in mapping data flow.