Копирование данных из Zoho с помощью Фабрики данных Azure или Synapse Analytics (предварительная версия)
ОБЛАСТЬ ПРИМЕНЕНИЯ: 
Фабрика данных Azure Azure Synapse Analytics
Совет
Попробуйте использовать фабрику данных в Microsoft Fabric, решение для аналитики с одним интерфейсом для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных в режиме реального времени, бизнес-аналитики и отчетности. Узнайте, как бесплатно запустить новую пробную версию !
В этой статье описывается, как с помощью действия копирования в Фабрике данных Azure и конвейерах Azure Synapse Analytics копировать данные из Zoho. Это продолжение статьи об обзоре действия копирования, в которой представлены общие сведения о действии копирования.
Внимание
Сейчас этот соединитель доступен в режиме предварительной версии. Попробуйте поработать с ним и оставьте свой отзыв. Если вы хотите использовать в своем решении зависимость от соединителей в предварительной версии, обратитесь в службу поддержки Azure.
Поддерживаемые возможности
Соединитель Zoho поддерживается для следующих возможностей:
| Поддерживаемые возможности | IR |
|---|---|
| Действие копирования (источник/-) | (1) (2) |
| Действие поиска | (1) (2) |
① Среда выполнения интеграции Azure ② Локальная среда выполнения интеграции
Список хранилищ данных, которые поддерживаются в качестве источников/приемников, см. в таблице Поддерживаемые хранилища данных.
Этот соединитель поддерживает проверку подлинности маркера доступа Xero и проверку подлинности OAuth 2.0.
Служба предоставляет встроенный драйвер для обеспечения подключения, поэтому вам не нужно вручную устанавливать какой-либо драйвер с помощью этого соединителя.
Начало работы
Чтобы выполнить действие копирования с конвейером, можно воспользоваться одним из приведенных ниже средств или пакетов SDK:
- средство копирования данных;
- Портал Azure
- Пакет SDK для .NET
- Пакет SDK для Python
- Azure PowerShell
- The REST API
- шаблон Azure Resource Manager.
Создание связанной службы для Zoho с помощью пользовательского интерфейса
Выполните следующие действия, чтобы создать связанную службу для Zoho в пользовательском интерфейсе портала Azure.
Перейдите на вкладку "Управление" в рабочей области Фабрики данных Azure или Synapse и выберите "Связанные службы", после чего нажмите "Создать":
Выполните поиск Zoho и выберите соединитель Zoho.
Настройте сведения о службе, проверьте подключение и создайте связанную службу.
Сведения о конфигурации соединителя
Следующие разделы содержат сведения о свойствах, используемых для определения сущностей фабрики данных, относящихся к соединителю Zoho.
Свойства связанной службы
Для связанной службы Zoho поддерживаются следующие свойства:
| Свойство | Описание: | Обязательное поле |
|---|---|---|
| type | Для свойства type необходимо задать значение Zoho | Да |
| connectionProperties | Группа свойств, определяющих способ подключения к Zoho. | Да |
В разделе connectionProperties: |
||
| конечная точка | Конечная точка сервера Zoho (crm.zoho.com/crm/private). |
Да |
| authenticationType | Допустимые значения — OAuth_2.0 и Access Token. |
Да |
| clientId | Идентификатор клиента, связанный с приложением Zoho. | Да, для проверки подлинности OAuth 2.0 |
| clientSecrect | clientsecret, связанный с приложением Zoho. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault. | Да, для проверки подлинности OAuth 2.0 |
| refreshtoken | Маркер обновления OAuth 2.0, связанный с приложением Zoho, который используется для обновления маркера доступа по истечении срока его действия. Маркер обновления бессрочный. Чтобы получить маркер обновления, необходимо запросить access_type offline. Дополнительные сведения см. в этой статье. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault. |
Да, для проверки подлинности OAuth 2.0 |
| accessToken | Маркер доступа для аутентификации Zoho. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault. | Да |
| useEncryptedEndpoints | Указывает, шифруются ли конечные точки источника данных с помощью протокола HTTPS. Значение по умолчанию — true. | No |
| useHostVerification | Указывает, следует ли требовать, чтобы имя узла в сертификате сервера совпадало с именем узла сервера при подключении по протоколу TLS. Значение по умолчанию — true. | No |
| usePeerVerification | Указывает, следует ли проверять удостоверение сервера при подключении по протоколу TLS. Значение по умолчанию — true. | No |
Пример: проверка подлинности OAuth 2.0
{
"name": "ZohoLinkedService",
"properties": {
"type": "Zoho",
"typeProperties": {
"connectionProperties": {
"authenticationType":"OAuth_2.0",
"endpoint": "crm.zoho.com/crm/private",
"clientId": "<client ID>",
"clientSecrect": {
"type": "SecureString",
"value": "<client secret>"
},
"accessToken": {
"type": "SecureString",
"value": "<access token>"
},
"refreshToken": {
"type": "SecureString",
"value": "<refresh token>"
},
"useEncryptedEndpoints": true,
"useHostVerification": true,
"usePeerVerification": true
}
}
}
}
Пример: проверка подлинности маркера доступа
{
"name": "ZohoLinkedService",
"properties": {
"type": "Zoho",
"typeProperties": {
"connectionProperties": {
"authenticationType":"Access Token",
"endpoint": "crm.zoho.com/crm/private",
"accessToken": {
"type": "SecureString",
"value": "<access token>"
},
"useEncryptedEndpoints": true,
"useHostVerification": true,
"usePeerVerification": true
}
}
}
}
Свойства набора данных
Полный список разделов и свойств, доступных для определения наборов данных, см. в статье о наборах данных. В этом разделе содержится список свойств, поддерживаемых набором данных Zoho.
Чтобы скопировать данные с Zoho, установите свойство type набора данных ZohoObject. Поддерживаются следующие свойства:
| Свойство | Описание: | Обязательное поле |
|---|---|---|
| type | Свойство type для набора данных должно иметь значение ZohoObject | Да |
| tableName | Имя таблицы. | Нет (если свойство query указано в источнике действия) |
Пример
{
"name": "ZohoDataset",
"properties": {
"type": "ZohoObject",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<Zoho linked service name>",
"type": "LinkedServiceReference"
}
}
}
Свойства действия копирования
Полный список разделов и свойств, используемых для определения действий, см. в статье Конвейеры и действия в фабрике данных Azure. В этом разделе содержится список свойств, поддерживаемых источником Zoho.
Zoho в качестве источника
Чтобы копировать данные из Zoho, установите тип источника ZohoSource в действии копирования. В разделе source действия копирования поддерживаются следующие свойства:
| Свойство | Описание: | Обязательное поле |
|---|---|---|
| type | Свойство type источника действия копирования должно иметь значение ZohoSource. | Да |
| query | Используйте пользовательский SQL-запрос для чтения данных. Например: "SELECT * FROM Accounts". |
Нет (если для набора данных задано свойство tableName) |
Пример:
"activities":[
{
"name": "CopyFromZoho",
"type": "Copy",
"inputs": [
{
"referenceName": "<Zoho input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "ZohoSource",
"query": "SELECT * FROM Accounts"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Свойства действия поиска
Подробные сведения об этих свойствах см. в разделе Действие поиска.
Связанный контент
Список хранилищ данных, которые поддерживаются в качестве источников и приемников для действия Copy, приведен в таблице Поддерживаемые хранилища данных и форматы.