分享方式:


使用 Azure Data Factory 或 Synapse Analytics 轉換 TeamDesk (預覽版) 中的資料

適用於:Azure Data Factory Azure Synapse Analytics

提示

試用 Microsoft Fabric 中的 Data Factory,這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。 了解如何免費開始新的試用

本文概述如何使用資料流程來轉換 TeamDesk (預覽版) 中的資料。 若要深入了解,請閱讀 Azure Data FactoryAzure Synapse Analytics 的介紹文章。

重要

此連接器目前為預覽版。 您可以親身體驗並提供意見反應。 如果您需要依賴解決方案中的預覽連接器,請連絡 Azure 支援

支援的功能

此 TeamDesk 連接器支援下列功能:

支援的功能 IR
對應資料流程 (來源/-)

① Azure 整合執行階段 ② 自我裝載整合執行階段

如需支援做為來源/接收器的資料存放區清單,請參閱支援的資料存放區表格。

使用 UI 建立連結至 TeamDesk 服務

使用下列步驟,在 Azure 入口網站 UI 中建立連結至 TeamDesk 的服務。

  1. 瀏覽至 Azure Data Factory 或 Synapse 工作區中的 [管理] 索引標籤,並選取 [連結服務],然後選取 [新增]:

  2. 搜尋 TeamDesk (預覽版),然後選取 TeamDesk (預覽版) 連接器。

    Screenshot showing selecting TeamDesk connector.

  3. 設定服務詳細資料,測試連線,然後建立新的連結服務。

    Screenshot of configuration for TeamDesk linked service.

連接器設定詳細資料

下列各節提供屬性的詳細資訊,這些是用來定義 TeamDesk 特有的 Data Factory 和 Synapse 管線實體的屬性。

連結服務屬性

下列是 TeamDesk 連結服務所支援的屬性:

屬性 描述 必要
type 類型屬性必須設為 TeamDesk Yes
URL TeamDesk 資料庫的 URL。 例如 https://www.teamdesk.net/secure/db/xxxxx Yes
authenticationType 用來連線到 TeamDesk 服務的驗證類型。 允許的值為 basictoken。 請分別參閱下列有關更多屬性和範例的對應區段。 Yes

基本驗證

authenticationType 屬性設為 basic。 除了上一節所述的一般屬性以外,請指定下列屬性:

屬性 描述 必要
userName 用來登入 TeamDesk 的使用者名稱。 Yes
password 針對使用者名稱指定的使用者帳戶,指定該帳戶的密碼。 將此欄位標記為 SecureString 以將其安全地儲存。 或者,可以參考 Azure Key Vault 中儲存的認證 Yes

範例:

{
    "name": "TeamDeskLinkedService",
    "properties": {
        "type": "TeamDesk",
        "typeProperties": {
            "url": "https://www.teamdesk.net/secure/db/xxxxx",
            "authenticationType": "basic",
            "userName": "<user name>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

權杖驗證

authenticationType 屬性設為 token。 除了上一節所述的一般屬性以外,請指定下列屬性:

屬性 描述 必要
apiToken 指定 TeamDesk 的 API 權杖。 將此欄位標記為 SecureString 以將其安全地儲存。 或者,可以參考 Azure Key Vault 中儲存的認證 Yes

範例:

{
    "name": "TeamDeskLinkedService",
    "properties": {
        "type": "TeamDesk",
        "typeProperties": {
            "url": "https://www.teamdesk.net/secure/db/xxxxx",
            "authenticationType": "token",
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

對應資料流程屬性

在對應資料流程中轉換資料時,您可以從 TeamDesk 讀取資料表。 如需詳細資訊,請參閱對應資料流程中的來源轉換。 您只能使用內置資料集作為來源類型。

來源轉換

下表列出 TeamDesk 來源所支援的屬性。 您可以在 [來源選項] 索引標籤中編輯這些屬性。

名稱 描述 必要 允許的值 資料流程指令碼屬性
Table 資料流程會從來源選項中指定的資料表擷取所有資料。 使用內嵌模式時,是 - table
檢視 資料流程會針對來源選項中指定的資料表擷取指定的檢視。 No - 檢視

TeamDesk 來源指令碼範例

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'teamdesk',
	format: 'rest',
	table: 'Table',
	view: 'View') ~> TeamDesksource

如需複製活動支援作為來源和接收器的資料存放區清單,請參閱支援的資料存放區