共用方式為

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

  • 發行項

適用於：Azure Data Factory Azure Synapse Analytics

提示

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

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

重要

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

支援的功能

此 Zendesk 連接器支援下列功能：

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

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

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

使用 UI 建立 Zendesk 連結服務

使用下列步驟，在 Azure 入口網站 UI 中建立 Zendesk 連結服務。

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

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

    顯示選取 Zendesk 連接器的螢幕快照。

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

    Zendesk 鏈接服務的設定螢幕快照。

連接器設定詳細資料

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

連結服務屬性

下列是 Zendesk 連結服務所支援的屬性：

屬性 描述 必要
type type 屬性必須設定為 Zendesk。 Yes
URL Zendesk 服務的基底 URL。 Yes
authenticationType 用來連線到 Zendesk 服務的驗證類型。 允許的值為 basic 和 token。 請分別參閱下列有關更多屬性和範例的對應區段。 Yes

基本驗證

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

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

範例：

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "basic",
            "userName": "<user name>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

權杖驗證

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

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

範例：

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "token",
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

對應資料流程屬性

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

來源轉換

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

名稱 描述 必要 允許的值 資料流程指令碼屬性
實體 Zendesk 中實體的邏輯名稱。 使用內嵌模式時，是 activities
group_memberships
groups
organizations
requests
satisfaction_ratings
sessions
tags
targets
ticket_audits
ticket_fields
ticket_metrics
tickets
triggers
users
views		 實體

Zendesk 來源指令碼範例

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'zendesk',
	format: 'rest',
	entity: 'tickets') ~> ZendeskSource

相關內容

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