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


Настройка База данных SQL Azure в действии копирования

В этой статье описывается, как использовать действие копирования в конвейере данных для копирования данных из База данных SQL Azure.

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

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

Общие

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

Исходный код

Следующие свойства поддерживаются для База данных SQL Azure на вкладке "Источник" действия копирования.

Снимок экрана: вкладка источника и список свойств.

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

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

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

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

    • Таблица: чтение данных из таблицы, указанной в таблице , при выборе этой кнопки.

    • Запрос. Укажите настраиваемый SQL-запрос для чтения данных. Например, select * from MyTable. Или щелкните значок карандаша для редактирования в редакторе кода.

      Снимок экрана: выбор запроса.

    • Хранимая процедура: используйте хранимую процедуру, которая считывает данные из исходной таблицы. Последней инструкцией SQL должна быть инструкция SELECT в хранимой процедуре.

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

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

        Снимок экрана: параметры хранимой процедуры.

  • Время ожидания запроса (минуты): укажите время ожидания для выполнения команды запроса, значение по умолчанию — 120 минут. Если для этого свойства задан параметр, допустимые значения имеют интервал времени, например "02:00:00" (120 минут).

    Снимок экрана: параметры времени ожидания запроса.

  • Уровень изоляции: указывает поведение блокировки транзакций для источника SQL. Допустимые значения: None, ReadCommitted, ReadUncommitted, RepeatableRead, Serializable или Snapshot. Если это не указано, используется уровень изоляции None . Дополнительные сведения см. в разделе "Изоляция".

    Снимок экрана: параметры уровня изоляции.

  • Параметр секционирования: укажите параметры секционирования данных, используемые для загрузки данных из База данных SQL Azure. Допустимые значения: Нет (по умолчанию), физические секции таблицы и динамический диапазон. Если параметр секции включен (то есть нет), степень параллелизма для параллельной загрузки данных из База данных SQL Azure управляется параметром параллельного копирования для действия копирования.

    Снимок экрана: параметры параметра секции.

    • Нет. Выберите этот параметр, чтобы не использовать секцию.

    • Физические секции таблицы: при использовании физической секции столбец секции и механизм автоматически определяются на основе определения физической таблицы.

    • Динамический диапазон: при использовании запроса с параллельным включенным параметром секционирования?DfDynamicRangePartitionCondition диапазона требуется. Пример запроса: SELECT * FROM <TableName> WHERE ?DfDynamicRangePartitionCondition.

      • Имя столбца секционирования: укажите имя исходного столбца в целочисленном или типе даты и даты и времени (int,, smallint, smalldatetimedatedatetimebigintdatetime2, илиdatetimeoffset), используемом секционированием диапазона для параллельной копии. Если значение не указано, автоматически определяется индекс или первичный ключ таблицы, который затем используется в качестве столбца секционирования.
      • Верхняя граница секции: укажите максимальное значение столбца секционирования для разделения диапазона секций. Это значение используется для выбора шага секционирования, а не для фильтрации строк в таблице. Все строки в таблице или результатах запроса секционируются и копируются.
      • Нижняя граница секции: укажите минимальное значение столбца секционирования для разделения диапазона секций. Это значение используется для выбора шага секционирования, а не для фильтрации строк в таблице. Все строки в таблице или результатах запроса секционируются и копируются.
  • Дополнительные столбцы: добавьте дополнительные столбцы данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего. Дополнительные сведения см. в описании "Добавление дополнительных столбцов во время копирования".

Назначение

Следующие свойства поддерживаются для База данных SQL Azure на вкладке "Назначение" действия копирования.

Снимок экрана: вкладка

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

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

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

  • Поведение записи: определяет поведение записи, когда источник является файлами из файлового хранилища данных. Вы можете выбрать команду Insert, Upsert или Хранимую процедуру.

    Снимок экрана: вкладка

    • Вставка. Выберите этот параметр, если исходные данные вставляются.

    • Upsert: выберите этот параметр, если исходные данные имеют как вставки, так и обновления.

      • Использование TempDB: укажите, следует ли использовать глобальную временную таблицу или физическую таблицу в качестве промежуточной таблицы для upsert. По умолчанию служба использует глобальную временную таблицу в качестве промежуточной таблицы, а этот проверка box выбран.

        Снимок экрана: выбор

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

        Примечание.

        Необходимо иметь разрешение на создание и удаление таблиц. По умолчанию промежуточная таблица будет совместно использовать ту же схему, что и целевая таблица.

        Снимок экрана: не выберите

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

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

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

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

        Снимок экрана: параметры хранимой процедуры.

  • Блокировка таблицы массового вставки: нажмите кнопку "Да " или "Нет". Используйте этот параметр, чтобы повысить производительность копирования во время операции массового вставки в таблицу без индекса из нескольких клиентов. Дополнительные сведения см. в раздел BULK INSERT (Transact-SQL)

  • Параметр таблицы. Указывает, следует ли автоматически создавать целевую таблицу , если таблица не существует на основе исходной схемы. Выберите "Нет " или "Автоматически создать таблицу". Автоматическое создание таблицы не поддерживается, если назначение задает хранимую процедуру.

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

  • Время ожидания пакетной операции записи: укажите время ожидания завершения операции вставки пакета до истечения времени ожидания. Допустимое значение — интервал времени. Значение по умолчанию — "00:30:00" (30 минут).

  • Размер пакета записи: укажите количество строк для вставки в таблицу SQL на пакет. Допустимое значение: целое число (количество строк). По умолчанию эта служба динамически определяет соответствующий размер пакета в зависимости от размера строки.

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

  • Отключить аналитику метрик производительности: этот параметр используется для сбора метрик, таких как DTU, DWU, RU и т. д., для оптимизации производительности копирования и рекомендаций. Если вы обеспокоены этим поведением, выберите этот проверка box.

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

Если конфигурация вкладки "Сопоставление" не применяется База данных SQL Azure с автоматическим созданием таблицы в качестве назначения, перейдите к разделу "Сопоставление".

Если вы применяете База данных SQL Azure с автоматическим созданием таблицы в качестве назначения, за исключением конфигурации в сопоставлении, можно изменить тип для столбцов назначения. После выбора схемы импорта можно указать тип столбца в назначении.

Например, тип столбца идентификатора в источнике является int, и его можно изменить на float type при сопоставлении с целевым столбцом.

Снимок экрана: тип целевого столбца сопоставления.

Настройки

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

Параллельная копия из База данных SQL Azure

Соединитель Базы данных SQL Microsoft Azure в действии Copy обеспечивает встроенное секционирование данных для параллельного копирования данных. Параметры секционирования данных можно найти на вкладке Источник действия Copy.

Если включено копирование с секционированием, действие Copy выполняет параллельные запросы к источнику Базы данных SQL Microsoft Azure для загрузки данных по секциям. Параллельная степень управляется степенью параллелизма копирования на вкладке параметров действия копирования. Например, если задать степень параллелизма копирования четырем, служба одновременно создает и выполняет четыре запроса на основе указанного параметра секции и параметров, а каждый запрос получает часть данных из База данных SQL Azure.

Рекомендуется включить параллельное копирование с секционированием данных, особенно при загрузке большого объема данных из Базы данных SQL Microsoft Azure. Ниже приведены рекомендуемые конфигурации для разных сценариев. Если данные копируются в файловое хранилище данных, то рекомендуется сохранять данные в папку несколькими файлами (указывая только имя папки), так как производительность в таком случае будет выше, чем при записи в один файл.

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

Во время выполнения служба автоматически определяет физические секции и копирует данные по секциям.

Чтобы проверить, имеет ли таблица физическую секцию, выполните следующий запрос.
Полная загрузка из большой таблицы без физических секций, когда таблица содержит столбец целочисленного типа или типа даты и времени для секционирования данных. Параметры секции: секция динамического диапазона.
Столбец секционирования (необязательно). Укажите столбец для секционирования данных. Если значение не указано, то используется столбец с индексом или первичным ключом.
Верхняя граница секционирования и Нижняя граница секционирования (необязательно). Указывайте, если необходимо определить шаг секционирования. Эти значения не предназначены для фильтрации строк в таблице. Все строки в таблице будут секционированы и скопированы. Если это не указано, действия копирования автоматически обнаруживают значения.

К примеру, если ваш столбец раздела "Идентификатор" имеет диапазон значений от 1 до 100 и вы установили нижнюю границу как 20, а верхнюю границу как 80 с параллельным копированием как 4, служба извлекает данные по 4 разделам — идентификаторы в диапазоне <=20, [21, 50], [51, 80] и >=81 соответственно.
Загрузка большого объема данных пользовательским запросом без использования физических секций, однако с использованием столбца целочисленного типа или типа даты/даты и времени для секционирования данных. Параметры секции: секция динамического диапазона.
Запрос: SELECT * FROM <TableName> WHERE ?DfDynamicRangePartitionCondition AND <your_additional_where_clause>.
Столбец секционирования: укажите столбец, используемый для секционирования данных.
Верхняя граница секционирования и Нижняя граница секционирования (необязательно). Указывайте, если необходимо определить шаг секционирования. Эти значения не предназначены для фильтрации строк в таблице. Все строки в результатах запроса будут секционированы и скопированы. Если значение не указано, действие копирования автоматически определяет значение.

К примеру, если ваш столбец раздела "Идентификатор" имеет диапазон значений от 1 до 100, и вы установили нижнюю границу как 20, а верхнюю границу как 80, с параллельным копированием как 4, служба извлекает данные по 4 разделам — идентификаторы в диапазоне <=20, [21, 50], [51, 80] и >=81 соответственно.

Ниже приведены дополнительные примеры запросов для различных сценариев.
• Запросите всю таблицу:
SELECT * FROM <TableName> WHERE ?DfDynamicRangePartitionCondition
• Запрос из таблицы с выделенным столбцом и дополнительными фильтрами предложения where:
SELECT <column_list> FROM <TableName> WHERE ?DfDynamicRangePartitionCondition AND <your_additional_where_clause>
• Запрос с вложенными запросами:
SELECT <column_list> FROM (<your_sub_query>) AS T WHERE ?DfDynamicRangePartitionCondition AND <your_additional_where_clause>
• Запрос с секцией в вложенных запросах:
SELECT <column_list> FROM (SELECT <your_sub_query_column_list> FROM <TableName> WHERE ?DfDynamicRangePartitionCondition) AS T

Ниже приведены рекомендации по загрузке данных с параметром секционирования.

  • Чтобы избежать неравномерного распределения данных, выбирайте в качестве столбца секционирования отличительный столбец (например, первичный ключ или уникальный ключ).
  • Если в таблице есть встроенные секции, используйте параметр "Физические секции таблицы " для повышения производительности.

Пример запроса для проверки физической секции

SELECT DISTINCT s.name AS SchemaName, t.name AS TableName, pf.name AS PartitionFunctionName, c.name AS ColumnName, iif(pf.name is null, 'no', 'yes') AS HasPartition
FROM sys.tables AS t
LEFT JOIN sys.objects AS o ON t.object_id = o.object_id
LEFT JOIN sys.schemas AS s ON o.schema_id = s.schema_id
LEFT JOIN sys.indexes AS i ON t.object_id = i.object_id 
LEFT JOIN sys.index_columns AS ic ON ic.partition_ordinal > 0 AND ic.index_id = i.index_id AND ic.object_id = t.object_id 
LEFT JOIN sys.columns AS c ON c.object_id = ic.object_id AND c.column_id = ic.column_id 
LEFT JOIN sys.partition_schemes ps ON i.data_space_id = ps.data_space_id 
LEFT JOIN sys.partition_functions pf ON pf.function_id = ps.function_id 
WHERE s.name='[your schema]' AND t.name = '[your table name]'

Если таблица содержит физическую секцию, параметр HasPartition имеет значение yes, как показано ниже.

Результат sql-запроса.

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

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

Исходный код

Имя Описание Значение Обязательное поле Свойство скрипта JSON
Тип хранилища данных Тип хранилища данных. Внешний Да /
Соединение Подключение к исходному хранилищу данных. <подключение> Да подключение
Тип подключения Тип подключения. Выберите База данных SQL Azure. База данных SQL Azure Да /
Таблицу Таблица исходных данных. <имя целевой таблицы> Да Схемы
table
Использование запроса Настраиваемый SQL-запрос для чтения данных. •Ни один
•Запроса
• Хранимая процедура
No

• sqlReaderQuery
• sqlReaderStoredProcedureName, storedProcedureParameters
Время ожидания запроса Время ожидания выполнения команды запроса по умолчанию — 120 минут. timespan No queryTimeout
Уровень изоляции Задает режим блокировки транзакций для источника данных SQL. •Ни один
• ReadCommitted
• ReadUncommitted
• RepeatableRead
•Сериализуемый
•Снимок
No isolationLevel
Параметр секции Параметры секционирования данных, используемые для загрузки данных из База данных SQL Azure. •Ни один
• Физические секции таблицы
• Динамический диапазон
No partitionOption:
• PhysicalPartitionsOfTable
• DynamicRange
Дополнительные столбцы Добавьте дополнительные столбцы данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего. • Имя
•Значение
No additionalColumns:
•Имя
•Значение

Назначение

Имя Описание Значение Обязательное поле Свойство скрипта JSON
Тип хранилища данных Тип хранилища данных. Внешний Да /
Соединение Подключение к целевому хранилищу данных. <подключение > Да подключение
Тип подключения Тип подключения. Выберите База данных SQL Azure. База данных SQL Azure Да /
Таблицу Целевая таблица данных. <имя целевой таблицы> Да Схемы
table
Поведение записи Определяет поведение записи, когда источник является файлами из файлового хранилища данных. •Вставить
• Upsert
• Хранимая процедура
No writeBehavior:
•Вставить
• upsert
• sqlWriterStoredProcedureName, sqlWriterTableType, storedProcedureParameters
Блокировка таблицы массового вставки Используйте этот параметр, чтобы повысить производительность копирования во время операции массового вставки в таблицу без индекса из нескольких клиентов. "Да" или "Нет" No sqlWriterUseTableLock:
true или false
Параметр таблицы Указывает, следует ли автоматически создавать целевую таблицу, если она не существует на основе исходной схемы. •Ни один
• Автоматическая создание таблицы
No tableOption:
• autoCreate
Скрипт предварительного копирования Скрипт действия копирования для выполнения перед записью данных в целевую таблицу в каждом запуске. Это свойство можно использовать для очистки предварительно загруженных данных. <скрипт предварительного копирования>
(строка)
No preCopyScript
Время ожидания пакетной службы Время ожидания до выполнения операции пакетной вставки, пока не истечет срок ее действия. Разрешенным значением является временной диапазон. Значение по умолчанию — "00:30:00" (30 минут). timespan No writeBatchTimeout
Размер пакета записи Количество строк для вставки в таблицу SQL на пакет. По умолчанию эта служба динамически определяет соответствующий размер пакета в зависимости от размера строки. <количество строк>
(целое число)
No writeBatchSize
Максимальное число одновременных подключений Верхний предел одновременных подключений, установленных для хранилища данных при выполнении действия. Указывайте значение только при необходимости ограничить количество одновременных подключений. <верхний предел одновременных подключений>
(целое число)
No maxConcurrentConnections
Отключение аналитики метрик производительности Этот параметр используется для сбора метрик, таких как DTU, DWU, RU и т. д., для оптимизации производительности копирования и рекомендаций. Если вы обеспокоены этим поведением, выберите этот проверка box. Выбор или отмена выбора No disableMetricsCollection:
true или false