Настройка служба хранилища таблицы Azure в действии копирования

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

Поддерживаемая конфигурация

Для настройки каждой вкладки в действии копирования перейдите к следующим разделам соответственно.

Общие

Ознакомьтесь с руководством по общим параметрам, чтобы настроить вкладку "Общие параметры".

Оригинал

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

Screenshot showing source tab and the list of properties.

Требуются следующие три свойства:

  • Тип хранилища данных: выберите "Внешний".

  • Подключение. Выберите подключение к таблице Azure служба хранилища из списка подключений. Если подключение не существует, создайте новую таблицу Azure служба хранилища, нажав кнопку "Создать".

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

    Если выбрать таблицу:

    Screenshot showing Use query when selecting Table.

    • Таблица. Укажите имя таблицы в экземпляре базы данных служба хранилища таблицы Azure. Выберите таблицу из раскрывающегося списка или введите имя вручную, нажав кнопку "Изменить".

    Если выбрать запрос:

    Screenshot showing Use query when selecting Query.

    • Таблица. Укажите имя таблицы в экземпляре базы данных служба хранилища таблицы Azure. Выберите таблицу из раскрывающегося списка или введите имя вручную, нажав кнопку "Изменить".

    • Запрос. Укажите настраиваемый запрос хранилища таблиц для чтения данных. Исходный запрос — это прямая карта из параметра запроса, поддерживаемого $filter служба хранилища таблиц Azure, дополнительные сведения о синтаксисе из этой статьи.

      Примечание.

      Время ожидания операции запроса к таблице Azure истекает через 30 секунд, как предписывает служба таблиц Azure. Сведения о том, как оптимизировать запрос, см. в статье Разработка для запросов.

В разделе "Дополнительно" можно указать следующие поля:

  • Игнорировать таблицу не найдена. Указывает, следует ли разрешать исключение таблицы не существовать. По умолчанию он не выбирается.

  • Дополнительные столбцы: добавление дополнительных столбцов данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего.

Назначение

Перейдите на вкладку "Назначение" , чтобы настроить назначение действия копирования. См. следующее содержимое для подробной конфигурации.

Screenshot showing destination tab and the list of properties.

Требуются следующие три свойства:

  • Тип хранилища данных: выберите "Внешний".
  • Подключение. Выберите подключение к таблице Azure служба хранилища из списка подключений. Если подключение не существует, создайте новую таблицу Azure служба хранилища, нажав кнопку "Создать".
  • Таблица. Укажите имя таблицы в экземпляре базы данных служба хранилища таблицы Azure. Выберите таблицу из раскрывающегося списка или введите имя вручную, нажав кнопку "Изменить".

В разделе "Дополнительно" можно указать следующие поля:

  • Тип вставки: выберите режим вставки данных в таблицу Azure. Режимы слияния и замены. Это свойство контролирует, будут ли заменены или объединены значения в существующих строках в выходной таблице с совпадающими ключами секций и строк. Этот параметр применяется на уровне строк, а не на уровне таблицы. Ни одна из параметров не удаляет строки в выходной таблице, которая не существует в входных данных. Чтобы узнать о действии этих параметров (merge и replace), ознакомьтесь со статьями Insert or Merge Entity (Вставка или слияние сущностей) и Insert or Replace Entity (Вставка или замена сущности).

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

    Если выбрать параметр "Указать значение секции":

    • Значение секции по умолчанию: укажите значение ключа секции по умолчанию, которое может использоваться назначением.

    Если выбрать "Использовать целевой столбец", выполните следующие действия.

    • Столбец ключа секции: выберите имя столбца, значения столбца которого используются в качестве ключа секции. Если не указано, в качестве ключа раздела используется AzureTableDefaultPartitionKeyValue.
  • Выбор значения ключа строки: выберите из уникального идентификатора или используйте целевой столбец. Значение ключа строки может быть автоматически созданным уникальным идентификатором или может принимать значение из целевого столбца.

    Если выбрать "Использовать целевой столбец", выполните следующие действия.

    • Столбец ключа строки: выберите имя столбца, значения столбцов которого используются в качестве ключа строки. Если имя не указано, используйте для каждой строки идентификатор GUID.
  • Запись размера пакета. Вставляет данные в таблицу Azure при попадании указанного размера пакета записи. Допустимые значения: целое число (количество строк). Значение по умолчанию — 10 000.

  • Время ожидания пакетной службы. Вставка данных в таблицу Azure при попадании указанного времени ожидания пакетной записи. Допустимое значение — timespan.

  • Максимальное число одновременных подключений: верхний предел одновременных подключений, установленных в хранилище данных во время выполнения действия. Укажите значение только в том случае, если требуется ограничить одновременные подключения

Сопоставление

Сведения о настройке вкладки "Сопоставление" см. в разделе "Настройка сопоставлений" на вкладке "Сопоставление".

Настройки

Для настройки вкладки Параметры перейдите к разделу "Настройка других параметров" на вкладке "Параметры".

Сводка таблицы

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

Сведения об источнике

Имя Описание Значение Обязательное поле Свойство скрипта JSON
Тип хранилища данных Тип хранилища данных. Внешний Да /
Соединение Подключение к исходному хранилищу данных. <подключение к таблице Azure служба хранилища> Да подключение
Использование запроса Способ чтения данных. Примените таблицу для чтения данных из указанной таблицы или применения запроса для чтения данных с помощью запросов. •Таблице
•Запроса
Да /
Таблицу Имя таблицы в экземпляре базы данных таблицы Azure служба хранилища. < имя таблицы > Да tableName
Запрос Укажите настраиваемый запрос хранилища таблиц для чтения данных. Исходный запрос — это прямая карта из параметра запроса, поддерживаемого $filter служба хранилища таблиц Azure, дополнительные сведения о синтаксисе из этой статьи. < запрос > No AzureTableSourceQuery
Игнорировать таблицу не найдена Указывает, следует ли разрешить исключение, связанное с отсутствием таблицы. выбран или не выбран (по умолчанию) No azureTableSourceIgnoreTableNotFound:
true или false (по умолчанию)
Дополнительные столбцы Добавьте дополнительные столбцы данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего. • Имя
•Значение
No additionalColumns:
•Имя
•Значение

Сведения о назначении

Имя Описание Значение Обязательное поле Свойство скрипта JSON
Тип хранилища данных Тип хранилища данных. Внешний Да /
Соединение Подключение к целевому хранилищу данных. <подключение к таблице Azure служба хранилища> Да подключение
Таблицу Имя таблицы в экземпляре базы данных таблицы Azure служба хранилища. < имя таблицы > Да tableName
Тип вставки Режим для вставки данных в таблицу Azure. Это свойство контролирует, будут ли заменены или объединены значения в существующих строках в выходной таблице с совпадающими ключами секций и строк. Слияние
Замена
No azureTableInsertType:
•Объединить
•Заменить
Выбор значения ключа секции Значение ключа секции может быть фиксированным или может принимать значение из целевого столбца. Укажите значение секции
Использование целевого столбца
No /
Значение секции по умолчанию Значение ключа секции по умолчанию, которое может использоваться назначением < значение секции по умолчанию > No azureTableDefaultPartitionKeyValue
Столбец ключа секции Имя столбца, значения которого используются в качестве ключей секций. Если не указано, в качестве ключа раздела используется AzureTableDefaultPartitionKeyValue. < столбец ключа секции > No azureTablePartitionKeyName
Выбор значения ключа строки Значение ключа строки может быть автоматически созданным уникальным идентификатором или может принимать значение из целевого столбца. Уникальный идентификатор
Использование целевого столбца
No /
Столбец ключа строки Имя столбца, значения столбцов которого используются в качестве ключа строки. Если имя не указано, используйте для каждой строки идентификатор GUID. < столбец ключа строки > No azureTableRowKeyName
Размер пакета записи Вставляет данные в таблицу Azure при попадании размера пакета записи. Целое число
(по умолчанию — 10 000)
No writeBatchSize
Время ожидания пакетной службы Вставка данных в таблицу Azure при попадании времени ожидания пакетной записи timespan No writeBatchTimeout
Максимальное число одновременных подключений Верхний предел одновременных подключений, установленных для хранилища данных при выполнении действия. Указывайте значение только при необходимости ограничить количество одновременных подключений. < максимальное число одновременных подключений > No maxConcurrentConnections