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


Настройка хранилища таблиц Azure в копировочной активности

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

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

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

General

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

Исходный материал

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

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

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

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

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

    Снимок экрана: использование запроса при выборе таблицы.

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

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

    Снимок экрана, показывающий использование запроса при выборе команды «Запрос».

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

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

      Замечание

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

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

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

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

Место назначения

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

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

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

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

  • Тип вставки: выберите режим вставки данных в таблицу Azure. Режимы слияния и замены. Это свойство контролирует, будут ли значения существующих строк в выходной таблице с совпадающими ключами секций и строк заменены или объединены. Этот параметр применяется на уровне строки, а не на уровне таблицы. Ни одна из параметров не удаляет строки в выходной таблице, которая не существует в входных данных. Сведения о работе параметров слияния и замены см. в статье "Вставка или слияние сущности " и "Вставка или замена сущности".

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

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

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

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

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

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

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

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

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

Картирование

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

Settings

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

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

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

Исходная информация

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

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

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