Копирование данных из Square с помощью Azure Data Factory или Synapse Analytics

ОБЛАСТЬ ПРИМЕНЕНИЯ: Фабрика данных Azure Azure Synapse Analytics

Совет

Попробуйте использовать фабрику данных в Microsoft Fabric, решение для аналитики с одним интерфейсом для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных в режиме реального времени, бизнес-аналитики и отчетности. Узнайте, как бесплатно запустить новую пробную версию !

В этой статье описывается, как с помощью действия Copy в конвейере Фабрики данных Azure или Synapse Analytics копировать данные из Square. Это продолжение статьи об обзоре действия копирования, в которой представлены общие сведения о действии копирования.

Внимание

Соединитель Square версии 1.0 находится на этапе удаления. Рекомендуется обновить соединитель Square с версии 1.0 до версии 2.0.

Поддерживаемые возможности

Этот соединитель Square поддерживает следующие возможности:

Поддерживаемые возможности	IR
Действие копирования (источник/-)	(1) (2)
Действие поиска	(1) (2)

① Среда выполнения интеграции Azure ② Локальная среда выполнения интеграции

Список хранилищ данных, которые поддерживаются в качестве источников/приемников, см. в таблице Поддерживаемые хранилища данных.

Служба предоставляет встроенный драйвер для обеспечения подключения, поэтому вам не нужно вручную устанавливать какой-либо драйвер с помощью этого соединителя.

Соединитель поддерживает версии Windows в этой статье.

Предпосылки

Если хранилище данных находится в локальной сети, виртуальной сети Azure или Amazon Virtual Private Cloud, необходимо настроить локальную среду выполнения интеграции для подключения к ней.

Если же хранилище данных представляет собой управляемую облачную службу данных, можно использовать Azure Integration Runtime. Если доступ предоставляется только по IP-адресам, утвержденным в правилах брандмауэра, вы можете добавить IP-адреса Azure Integration Runtime в список разрешений.

Вы также можете использовать функцию среды выполнения интеграции в управляемой виртуальной сети в Фабрике данных Azure для доступа к локальной сети без установки и настройки локальной среды выполнения интеграции.

Дополнительные сведения о вариантах и механизмах обеспечения сетевой безопасности, поддерживаемых Фабрикой данных, см. в статье Стратегии получения доступа к данным.

Примечание.

Версия 2.0 поддерживается с локальной средой выполнения интеграции версии 5.56.0.0 или более поздней.

Начало работы

Для выполнения действия копирования с конвейером можно использовать один из следующих средств или пакетов SDK:

Создание связанной службы для Square с помощью пользовательского интерфейса

Выполните следующие действия, чтобы создать связанную службу для Square с помощью пользовательского интерфейса на портале Azure.

Перейдите на вкладку "Управление" в рабочей области Фабрики данных Azure или Synapse и выберите "Связанные службы", после чего нажмите "Создать":
- Фабрика данных Azure
- Azure Synapse
Найдите Square и выберите соединитель Square.
Настройте сведения о службе, проверьте подключение и создайте связанную службу.

Сведения о конфигурации соединителя

Следующие разделы содержат сведения о свойствах, используемых для определения сущностей фабрики данных, относящихся к соединителю Square.

Свойства связанной службы

Соединитель Square теперь поддерживает версию 2.0. См. этот раздел , чтобы обновить версию соединителя Square с версии 1.0. Чтобы узнать подробности о свойстве, см. соответствующие разделы.

Версия 2.0
Версия 1.0

Версия 2.0

Связанная служба Square поддерживает следующие свойства при применении версии 2.0:

Свойство	Описание:	Обязательное поле
type	Для свойства type необходимо задать значение Square	Да
version	Версия, которую вы указали. Значение равно `2.0`.	Да
host	URL-адрес экземпляра Square. (т. е. mystore.mysquare.com)	Да
clientId	Идентификатор клиента, связанный с приложением Square.	Да
clientSecret	Секрет клиента, связанный с приложением Square. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault.	Да
accessToken	Маркер доступа, полученный из Square. Предоставляет ограниченный доступ к учетной записи Square, запрашивая у пользователя, прошедшего проверку подлинности, явные разрешения. Срок действия маркеров доступа OAuth истекает через 30 дней после выдачи, но срок действия маркеров обновления не истекает. Маркеры доступа могут обновляться маркером обновления. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault. Дополнительные сведения о типах маркеров доступа см. в разделе "Типы маркеров доступа".	Да
refreshtoken	Маркер обновления, полученный из Square. Используется для получения новых маркеров доступа при истечении срока действия текущего. Установите для этого поля метку SecureString для его безопасного хранения или добавьте ссылку на секрет, хранящийся в Azure Key Vault.	No
connectVia	Среда выполнения интеграции, используемая для подключения к хранилищу данных. Если не указано другое, по умолчанию используется интегрированная среда выполнения Azure. Вы можете использовать локальную среду выполнения интеграции, а ее версию — 5.56.0.0 или более поздней.	No

Пример:

{
    "name": "SquareLinkedService",
    "properties": {
        "type": "Square",
        "version": "2.0",
        "typeProperties": {
            "host": "<e.g. mystore.mysquare.com>", 
            "clientId": "<client ID>", 
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            }, 
            "accessToken": {
                "type": "SecureString",
                "value": "<access token>"
            }, 
            "refreshToken": {
                "type": "SecureString",
                "value": "<refresh token>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Версия 1.0

Связанная служба Square поддерживает следующие свойства при применении версии 1.0:

Свойство	Описание:	Обязательное поле
type	Для свойства type необходимо задать значение Square	Да
connectionProperties	Группа свойств, определяющих способ подключения к Square.	Да
В разделе `connectionProperties`:
host	URL-адрес экземпляра Square. (т. е. mystore.mysquare.com)	Да
clientId	Идентификатор клиента, связанный с приложением Square.	Да
clientSecret	Секрет клиента, связанный с приложением Square. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault.	Да
accessToken	Маркер доступа, полученный из Square. Предоставляет ограниченный доступ к учетной записи Square, запрашивая у пользователя, прошедшего проверку подлинности, явные разрешения. Срок действия маркеров доступа OAuth истекает через 30 дней после выдачи, но срок действия маркеров обновления не истекает. Маркеры доступа могут обновляться маркером обновления. Пометьте это поле как SecureString, чтобы безопасно хранить его, или добавьте ссылку на секрет, хранящийся в Azure Key Vault. Дополнительные сведения о типах маркеров доступа см. в разделе "Типы маркеров доступа".	Да
refreshtoken	Маркер обновления, полученный из Square. Используется для получения новых маркеров доступа при истечении срока действия текущего. Установите для этого поля метку SecureString для его безопасного хранения или добавьте ссылку на секрет, хранящийся в Azure Key Vault.	No
useEncryptedEndpoints	Указывает, шифруются ли конечные точки источника данных с помощью протокола HTTPS. Значение по умолчанию — true.	No
useHostVerification	Указывает, следует ли требовать, чтобы имя узла в сертификате сервера совпадало с именем узла сервера при подключении по протоколу TLS. Значение по умолчанию — true.	No
usePeerVerification	Указывает, следует ли проверять удостоверение сервера при подключении по протоколу TLS. Значение по умолчанию — true.	No
connectVia	Среда выполнения интеграции, используемая для подключения к хранилищу данных. Если не указано другое, по умолчанию используется интегрированная среда выполнения Azure.	No

Пример:

{
    "name": "SquareLinkedService",
    "properties": {
        "type": "Square",
        "typeProperties": {
            "connectionProperties": {
                "host": "<e.g. mystore.mysquare.com>", 
                "clientId": "<client ID>", 
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<clientSecret>"
                }, 
                "accessToken": {
                    "type": "SecureString",
                    "value": "<access token>"
                }, 
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refresh token>"
                }, 
                "useEncryptedEndpoints": true, 
                "useHostVerification": true, 
                "usePeerVerification": true 
            }
        }
    }
}

Типы маркеров доступа

Square поддерживает два типа маркера доступа: личный и OAuth.

Личные маркеры доступа используются для получения неограниченного доступа через API подключения к ресурсам в своей учетной записи Square.
Маркеры доступа OAuth используются для получения доступа к любой учетной записи Square через API подключения с проверкой подлинности и с заданной областью. Используйте их, когда приложение обращается к ресурсам в других учетных записях Square от имени владельцев учетных записей. Маркеры доступа OAuth также можно использовать для доступа к ресурсам в своей учетной записи Square.

Внимание

Чтобы выполнить тестовое подключение в связанной службе, MERCHANT_PROFILE_READ должен получить маркер доступа OAuth с заданной областью действия. Разрешения на доступ к другим таблицам описаны в справочнике по разрешениям Square OAuth.

Проверка подлинности с помощью личного маркера доступа требует только accessToken, тогда как для проверки подлинности с помощью OAuth необходимы accessToken и refreshToken. Узнайте, как получить маркер доступа, здесь.

Свойства набора данных

Полный список разделов и свойств, доступных для определения наборов данных, см. в статье о наборах данных. В этом разделе содержится список свойств, поддерживаемых набором данных Square.

Чтобы скопировать данные из Square, установите свойство type набора данных SquareObject. Поддерживаются следующие свойства:

Свойство	Описание:	Обязательное поле
type	Свойство type для набора данных должно иметь значение SquareObject	Да
tableName	Имя таблицы.	Да для версии 2.0. Нет для версии 1.0 (если указан "запрос" в источнике действия)

Пример

{
    "name": "SquareDataset",
    "properties": {
        "type": "SquareObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Square linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Свойства действия копирования

Полный список разделов и свойств, используемых для определения действий, см. в статье Конвейеры и действия в фабрике данных Azure. В этом разделе содержится список свойств, поддерживаемых источником Square.

Square в качестве источника

Чтобы скопировать данные из Square, задайте тип источника SquareSource в действии копирования. В разделе source действия копирования поддерживаются следующие свойства:

Свойство	Описание:	Обязательное поле
type	Свойство type источника действия копирования должно иметь значение SquareSource	Да
query	Используйте пользовательский SQL-запрос для чтения данных. Например: `"SELECT * FROM Business"`.	Нет (если для набора данных задано свойство tableName)

Примечание.

query не поддерживается в версии 2.0.

Пример:

"activities":[
    {
        "name": "CopyFromSquare",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Square input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SquareSource",
                "query": "SELECT * FROM Business"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Сопоставление типов данных для Square

При копировании данных из Квадрата следующие сопоставления применяются из типов данных Square к внутренним типам данных, используемым службой. Чтобы узнать, как действие копирования сопоставляет исходную схему и типы данных с приемником, см. раздел Сопоставление схем и типов данных.

Квадратный тип данных	Тип данных промежуточной службы (для версии 2.0)	Тип данных промежуточной службы (для версии 1.0)
String	String	String
Целое число	Int32	Int32
Long	Int64	Int64
Boolean	Boolean	Boolean
Date	String	Не поддерживается.
Отметка времени	String	Не поддерживается.
Метка времени со смещением	String	Не поддерживается.
Длительность (полная)	String	String
Длительность (только время)	String	String
Деньги	Int64	Int64

Свойства действия поиска

Подробные сведения об этих свойствах см. в разделе Действие поиска.

Жизненный цикл и обновление квадратных соединителей

В следующей таблице показаны этап выпуска и журналы изменений для различных версий соединителя Square:

Версия	Этап выпуска	Журнал изменений
Версия 1.0	Removed	Неприменимо.
Версия 2.0	Общая доступность	• Локальная версия среды выполнения интеграции должна быть 5.56.0.0 или более поздней. • Дата, метка времени и метка времени со смещением считываются как тип данных String. • `useEncryptedEndpoints`, `useHostVerificationusePeerVerification` не поддерживаются в связанной службе. • `query` не поддерживается.

Обновление соединителя Square с версии 1.0 до версии 2.0

На странице "Изменить связанную службу" выберите версию 2.0. Дополнительные сведения см. в свойствах связанной службы версии 2.0.
Сопоставление типов данных для связанной службы Square версии 2.0 отличается от сопоставления типов данных для версии 1.0. Сведения о последнем сопоставлении типов данных см. в разделе "Сопоставление типов данных" для Square.
Примените локальную среду выполнения интеграции с версией 5.56.0.0 или более поздней.
query поддерживается только в версии 1.0. Следует использовать tableName вместо query в версии 2.0.

Список хранилищ данных, которые поддерживаются в качестве источников и приемников для действия Copy, приведен в таблице Поддерживаемые хранилища данных и форматы.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-12-16

Поделиться через

Копирование данных из Square с помощью Azure Data Factory или Synapse Analytics

Поддерживаемые возможности

Предпосылки

Начало работы

Создание связанной службы для Square с помощью пользовательского интерфейса

Сведения о конфигурации соединителя

Свойства связанной службы

Версия 2.0

Версия 1.0

Типы маркеров доступа

Свойства набора данных

Свойства действия копирования

Square в качестве источника

Сопоставление типов данных для Square

Свойства действия поиска

Жизненный цикл и обновление квадратных соединителей

Обновление соединителя Square с версии 1.0 до версии 2.0

Связанный контент

Обратная связь

Дополнительные ресурсы