SQL Server

Microsoft SQL Server — это реляционная система управления базами данных, разработанная корпорацией Майкрософт. Подключитесь к SQL Server для управления данными. Вы можете выполнять различные действия, такие как создание, обновление, получение и удаление строк в таблице.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate
Логические приложения	Стандарт	Все регионы Logic Apps
Power Apps	Премия	Все регионы Power Apps
Power Automate	Премия	Все регионы Power Automate

Метаданные соединителя
Publisher	Microsoft

Подробное описание соединителя

В этой статье описываются операции управляемого соединителя SQL Server, доступные для Azure Logic Apps, Power Automate и Power Apps. Встроенный соединитель SQL Server доступен только для рабочих процессов приложений логики уровня "Стандартный" в Azure Logic Apps.

• Дополнительные сведения об этом соединителе в Power Apps см. в разделе "Подключение к SQL Server" из Power Apps.
• Дополнительные сведения о встроенном соединителе SQL Server и управляемом соединителе в Azure Logic Apps см. в статье "Подключение к базам данных SQL из рабочих процессов в Azure Logic Apps".

Authentication

Если вы хотите создать подключения, отличные от Microsoft Entra ID (Microsoft Entra ID), используйте параметр проверки подлинности строки подключения. Убедитесь, что вы предоставляете те же значения имени сервера и имени базы данных , что и в соединении.

Проверка подлинности идентификатора Microsoft Entra

Известные ограничения с проверкой подлинности Идентификатора Microsoft Entra

Из-за текущих ограничений конвейера проверки подлинности гостевые пользователи Идентификатора Microsoft Entra не поддерживаются для подключений идентификатора Microsoft Entra к SQL Server. Чтобы устранить эту проблему, используйте вместо этого проверку подлинности SQL Server или проверку подлинности Windows.

Включение проверки подлинности идентификатора Microsoft Entra для SQL Server

1. Настройте и подготовьте свою учетную запись в качестве участника Microsoft Entra ID (Microsoft Entra ID). Дополнительные сведения см. в статье "Настройка проверки подлинности идентификатора Записи Майкрософт" и управление ими с помощью SQL Azure.

2. На сервере SQL server настройте администратора идентификатора Microsoft Entra.

   1. На портале Azure перейдите на сервер SQL Server, где требуется включить проверку подлинности идентификатора Microsoft Entra.
   2. В меню ресурсов SQL Server в разделе "Параметры" выберите идентификатор Microsoft Entra.
   3. На панели инструментов области идентификатора Microsoft Entra выберите"Задать администратора".
   4. Найдите и выберите учетную запись пользователя Идентификатора Microsoft Entra в текущем клиенте, чтобы сделать их администратором сервера. Сохраните ваши изменения.

3. В клиенте Идентификатора Microsoft Entra создайте и зарегистрируйте приложение идентификатора Microsoft Entra для доступа к базе данных SQL. Дополнительные сведения см. в статье SQL Server . Настройка проверки подлинности идентификатора Microsoft Entra ID.

   1. На портале Azure перейдите в клиент Идентификатора Microsoft Entra, где вы хотите создать приложение идентификатора Microsoft Entra.

   2. В меню клиента в разделе "Управление" выберите"Регистрацияприложений>".

   3. В области регистрации приложения укажите имя приложения. Помните это имя, чтобы позже создать пользователя и предоставить доступ роли к базе данных SQL.

   4. По завершении нажмите кнопку "Регистрация", которая создает приложение идентификатора Microsoft Entra.

   5. На панели регистрации приложений выберите новое приложение Идентификатора Microsoft Entra. В меню приложения выберите сертификаты и секреты>нового секрета клиента.

   6. Укажите описание секрета и выберите срок действия.

4. Войдите на сервер SQL Server и базу данных с учетными данными учетной записи пользователя Идентификатора Майкрософт, настроенной администратором сервера.

5. В базе данных SQL создайте автономного пользователя для представления приложения Идентификатора Microsoft Entra. Для этого шага требуется Microsoft SQL Server Management Studio (SSMS).

   Ниже приведены инструкции по назначению ролей db_datareader и db_datawriter приложению идентификатора Microsoft Entra ID с именем example-Azure-AD-application-name. При выполнении указанных команд не забудьте заменить example-Azure-AD-application-name имя приложения Идентификатора Microsoft Entra и назначить необходимые роли для ваших потребностей.

   1. Запустите SSMS и подключитесь к СЕРВЕРУ SQL Server, к которому будет обращаться приложение идентификатора Microsoft Entra.

   2. При проверке подлинности используйте Active Directory — универсальную с поддержкой MFA и учетной записью идентификатора Microsoft Entra, настроенной администратором сервера.

   3. В обозревателе объектов разверните папку "Базы данных ".

   4. Найдите базу данных, откройте контекстное меню базы данных и выберите команду "Создать запрос".

   5. В окне запроса выполните следующую команду, чтобы связать приложение Идентификатора Microsoft Entra с новым пользователем в базе данных:

      CREATE USER [example-Azure-AD-app-name] FROM EXTERNAL PROVIDER
      

   6. Снимите окно запроса. Затем выполните следующую команду, чтобы назначить db_datareader роль приложению идентификатора Microsoft Entra ID:

      ALTER ROLE db_datareader ADD MEMBER [example-Azure-AD-application-name]
      

   7. Повторите предыдущий шаг, чтобы назначить db_datawriter роль приложению идентификатора Microsoft Entra ID:

      ALTER ROLE db_datawriter ADD MEMBER [example-Azure-AD-application-name]
      

Аутентификация управляемой идентификации

В настоящее время только Azure Logic Apps поддерживает проверку подлинности управляемого удостоверения для соединителя SQL Server.

Аутентификация служебного принципала

Настройка управляемого удостоверения в приложении логики

1. На портале Azure перейдите к ресурсу приложения логики.

2. Включите удостоверение, назначаемое системой, или удостоверение, назначаемое пользователем. Если у вас нет удостоверения, назначаемого пользователем, сначала необходимо создать это удостоверение. Дополнительные сведения см. в статье "Проверка подлинности доступа к ресурсам Azure с управляемыми удостоверениями в Azure Logic Apps".

3. Если вы выбрали удостоверение, назначаемое пользователем, убедитесь, что вы добавили это удостоверение в ресурс приложения логики.

   1. На портале Azure перейдите к ресурсу приложения логики, в котором вы хотите использовать управляемое удостоверение.
   2. В меню навигации приложения логики в разделе "Параметры" выберите "Удостоверение".
   3. На вкладке User assigned нажмите Добавить.
   4. Выберите управляемое удостоверение для использования и нажмите кнопку "Добавить".

Настройка SQL Server для проверки подлинности управляемого удостоверения

1. На сервере SQL server настройте администратора идентификатора Microsoft Entra.

   1. На портале Azure перейдите к серверу SQL Server, где требуется включить проверку подлинности идентификатора Microsoft Entra.
   2. В меню ресурсов SQL Server в разделе "Параметры" выберите идентификатор Microsoft Entra.
   3. На панели инструментов области идентификатора Microsoft Entra выберите"Задать администратора".
   4. Найдите и выберите учетную запись пользователя Идентификатора Microsoft Entra в текущем клиенте, чтобы сделать их администратором сервера. Сохраните ваши изменения.

2. В базе данных SQL создайте автономного пользователя для представления управляемого удостоверения. Для этого шага требуется Microsoft SQL Server Management Studio (SSMS).

   Следующие действия назначают роль управляемому db_datareader удостоверению с именем example-managed-identity-name. При выполнении указанных команд не забудьте заменить example-managed-identity-name имя управляемого удостоверения и назначить правильную роль для ваших потребностей. Например, db_datareader не удается выполнить операции записи.

   1. Запустите SSMS и подключитесь к СЕРВЕРУ SQL Server, к которому будет обращаться управляемое удостоверение.

   2. При проверке подлинности используйте Active Directory — универсальную с поддержкой MFA и учетной записью идентификатора Microsoft Entra, настроенной администратором сервера.

   3. В обозревателе объектов разверните папку "Базы данных ".

   4. Найдите базу данных, откройте контекстное меню базы данных и выберите команду "Создать запрос".

   5. В окне запроса выполните следующую команду, чтобы связать управляемое удостоверение с новым пользователем в базе данных:

      CREATE USER [example-managed-identity-name] FROM EXTERNAL PROVIDER
      

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

      ALTER ROLE db_datareader ADD MEMBER [example-managed-identity-name]
      

      Замечание

      Если назначить роли управляемому удостоверению на уровне базы данных, удостоверение не будет иметь необходимых областей для перечисления всех баз данных. При выборе из списка имен базы данных в триггере или действии SQL вы получите ошибку, как показано в следующем примере:

      Couldn't retrieve values. Error code: 'Unauthorized', Message: 'Credentials are missing or not valid'.
      Inner exception: The credentials provided for the SQL source are invalid
      

      Чтобы устранить эту проблему, у вас есть следующие параметры:

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

Дополнительные сведения см. в следующей документации:

• Проверка подлинности доступа к ресурсам Azure с помощью управляемых удостоверений в Azure Logic Apps
• Руководство. Использование управляемого удостоверения, назначаемого системой виртуальной машины Windows, для доступа к SQL Azure
• Настройка проверки подлинности идентификатора Записи Майкрософт и управление ими с помощью SQL Azure
• Роли уровня базы данных
• Роли уровня сервера

Поддержка виртуальной сети

Когда соединитель используется в среде Power Platform, связанной с виртуальной сетью, применяются ограничения:

• Следующие действия являются единственными поддерживаемыми действиями:

  • Удаление строки (версия 2)
  • Выполнение SQL-запроса (версия 2)
  • Получение строки (версия 2)
  • Получение строк (версия 2)
  • Получение таблиц (версия 2)
  • Вставка строки (версия 2)
  • Обновление строки (версия 2)
  • Выполнение хранимой процедуры (версия 2)

• Любое действие, за пределами этого списка, вернет ошибку "403 Несанкционированный"

• Локальный шлюз данных не поддерживается

• При использовании встроенной проверки подлинности идентификатора Microsoft Entra ID введите имя базы данных вручную в качестве настраиваемого значения.

Известные проблемы и ограничения с действиями

Краткое описание	Operations	Длинное описание
Получение детерминированных результатов в выходных данных действия	Получение строк (версия 2)	Order By Использование параметра рекомендуется для получения детерминированных результатов в выходных данных действия. Если Order By не указано, первичные ключи или уникальные ключи используются SQL Server по умолчанию. Недетерминированные результаты могут вызвать проблемы, такие как дедупликация записей в выходных данных действия при включении разбиения на страницы. Представления SQL не поддерживают первичный ключ, который является ограничением от самого SQL Server.
Выполнение ограниченной поддержки SQL-запроса	Выполнение SQL-запроса (версия 2)	Не поддерживается для локальной среды SQL Server.
Общие требования CRUD	Получение строки (версия 2) Получение строк (версия 2) Обновление строки (версия 2) Удаление строки (версия 2)	Строковые значения будут обрезаны в случае использования экземпляра SQL Azure. Поэтому пустые строки будут преобразованы в пустые строки. Для операций INSERT и UPDATE соединитель вернет обновленные строки. Для этого необходимо, чтобы подключение было иметь разрешение на чтение данных из SQL Server. Первичный ключ необходим для следующих операций: — GetItem — PatchItem — DeleteItem
Поддержка параметра преобразования агрегирования	Получение строк (версия 2)	Поддерживаются только следующие преобразования агрегирования: - фильтр. Позволяет фильтровать входной набор. Поддерживает те же выражения, что $filterи . Пример: filter(ColName1 eq 1). - агрегат: позволяет агрегироваться с помощью одного из следующих методов: average, , maxmin, sum. countdistinct Пример: aggregate(ColName2 with max as MaxValue). Вы можете объединить несколько операторов, разделенных косыми чертами, чтобы выразить их последовательное применение. Это означает, что результат каждого преобразования — входные данные для следующего преобразования. Пример: filter(ColName1 eq 4)/aggregate(ColName2 with sum as MaxWorkItemId).
Тип данных формального параметра переопределен при выполнении SQL-запроса	Выполнение SQL-запроса [DEPRECATED] Выполнение SQL-запроса (версия 2)	Тип данных, введенный при определении формального параметра в SQL-запросе, может быть переопределен, так как базовая реализация соединителя определяет тип с помощью предоставленного значения параметра.
Оператор IN с использованием формальных параметров требует, чтобы значения были определены отдельно	Выполнение SQL-запроса (версия 2)	При использовании формальных параметров с оператором IN все переданные значения необходимо определить отдельно, а не как один формальный параметр, содержащий несколько разделенных запятыми значений. Пример: SELECT * FROM tableName WHERE columnName IN (@formalParameterA, @formalParameterB, @formalParameterC).
Сбой с помощью базы данных Sql DataWareHouse Azure	Вставка строки (версия 2)	Использование базы данных SQL Azure в Power Apps приводит к сбою из-за несоответствия синтаксиса в выполнении соединителя в базе данных. Создайте поток с соединителем Datawarehouse SQL Azure в Power Automate, активируйте его из PowerApps или создайте запрос и используйте его в действии выполнения SQL-запроса (V2).

Известные проблемы и ограничения с триггерами

Замечание

Отключение и включение потока не сбрасывает состояние триггера.

Краткое описание	Operations	Длинное описание
Изменение элемента: операции строк	При изменении элемента (версия 2)	Выполняется при выполнении операций строки INSERT и UPDATE.
Изменение элемента: требования к столбцам	При изменении элемента (версия 2)	Требуется столбец ROWVERSION.
Создание элемента: требование к столбцу	При создании элемента (версия 2)	Требуется столбец IDENTITY.
Создание элемента	При создании элемента (версия 2)	Используйте последнее значение столбца идентификатора вставленной строки в качестве порогового значения (состояние триггера), чтобы определить только что вставленные строки позже. Логика предполагает, что каждое новое удостоверение строки должно быть больше предыдущего. Поэтому при сбросе последовательности удостоверений для таблицы из-за явной команды t-sql или усечения таблицы логика триггера пропускает новые строки для существующего потока. Существует два различных обходных решения. Во-первых, можно сбросить состояние триггера потока, обновив карточку действия триггера (например, переименуйте ее, обновите параметры или добавьте новое подключение) и сохраните изменения. Кроме того, можно восстановить последовательность удостоверений целевой таблицы с помощью следующего подхода.

Общие известные проблемы и ограничения

• Вставка и обновление таблицы не будет работать, если в таблице определен триггер на стороне SQL Server.

  Чтобы устранить эту проблему, у вас есть следующие параметры:

  • Используйте хранимую процедуру или собственный запрос.
  • Удалите триггер из таблицы SQL.

• Следующие ограничения применяются к использованию соединителя SQL с локальным СЕРВЕРом SQL.

  • Минимальная поддерживаемая версия для локального SQL Server — SQL Server 2005.
  • Ограничение размера запроса составляет 2 МБ через локальный SQL Server.
  • Ограничение размера ответа составляет 8 МБ через локальный SQL Server.

• Следующие ограничения применяются к вызову хранимой процедуры на локальном сервере SQL server через шлюз:

  • Выходные значения для OUTPUT параметров не возвращаются. Вы по-прежнему можете указать входные значения для OUTPUT параметров.
  • Значение ResultSets нетипичено.
  • Возвращаемое значение недоступно.
  • Возвращается только первый результирующий набор.
  • Схемы Dynamics не поддерживаются для результирующих наборов.

• Следующие типы данных нельзя использовать в качестве предикатов параметра запроса:

  • date
  • datetime
  • datetime2
  • smalldatetime

• Параметр принудительного шифрования не поддерживается. По умолчанию база данных SQL и Управляемый экземпляр SQL защищают данные клиента путем шифрования данных в движении с помощью TLS. Дополнительные сведения см. в обзоре безопасности SQL Azure.

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

  Чтобы устранить эту проблему, используйте хранимые процедуры.

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

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

• Если время выполнения превышает 110 секунд для SQL-запроса или хранимой процедуры, действия будут истекает.

  В Azure Logic Apps вы можете обойти это ограничение и узнать, как выполнять длительные хранимые процедуры, см. статью о длительных хранимых процедурах SQL в Logic Apps.

• В Azure Logic Apps можно получить доступ к частной конечной точке SQL Server только из среды службы интеграции (ISE). Дополнительные сведения см. в статье "Доступ к виртуальным сетям Azure".

• При создании запроса со многими фильтрами может возникнуть следующая ошибка: "Дерево синтаксиса запросов OData превысило ограничение количества узлов "100". Попробуйте упростить выражения параметров запроса OData. Чтобы избежать этой проблемы, оптимизируйте условия фильтрации, чтобы уменьшить их число (например, с помощью диапазонов).

• Не рекомендуется хранить большие объемы данных (более 30 мегабайт) в полях целевой таблицы (e.g. xml или текстовых данных). Это может привести к снижению производительности действий и триггеров, что приводит к ошибкам времени ожидания 504. Используйте параметр Select Query, чтобы включить только относительно небольшие поля и избежать больших выходных данных. Или используйте специализированные хранилища файлов, например хранилище BLOB-объектов Azure.

• Операции CRUD не поддерживаются для источников Azure Synapse из-за отсутствия поддержки предложения OUTPUT. Вместо этого настоятельно рекомендуется использовать выделенный соединитель хранилища данных SQL Azure .

• Представления навигатора Power Platform и Logic Apps ограничены размером в 10 000 таблиц.

• Схема базы данных, которая не соответствует стандартным идентификаторам OData , не поддерживается (имя столбца, начиная с номера, содержащее символ суррогатной пары и т. д.). Клиенты могут использовать представление для абстрагирования имени столбцов или использовать расширенные свойства SQL для обработки использования дополнительных символов плоскости, храня их отдельно от схемы базы данных, см. в статье "Добавление расширенного свойства в столбец в таблице".

• При использовании соединителя SQL в качестве источника данных для виртуальных таблиц значения сервера и базы данных должны совпадать между исходным набором данных и используемым подключением. При использовании проверки подлинности SQL значения набора данных можно задать по умолчанию, так как подключение уже будет содержать значения сервера и базы данных. Если значения подключения к набору данных явно указаны, они должны соответствовать значениям подключения в противном случае, например "Что-то пошло не так. Мы не смогли открыть таблицу. Попробуйте перезагрузить или повторно открыть файл. Возможно, может возникнуть ошибка "недопустимый источник данных".

• При изменении схемы в представлениях, используемых в потоках Power Automate, триггеры могут не запускаться до создания нового подключения в обновленном представлении. Для сброса триггера в обновленных представлениях недостаточно только обновление подключения.

• Протокол 8.0 табличного потока данных (TDS) в настоящее время не поддерживается соединителем SQL.

Специальные ограничения регулирования

• В разных случаях соединитель SQL имеет разные ограничения регулирования. В следующей таблице операции машинного кода включают хранимую процедуру SQL и SQL-запрос. CRUD обозначает операции создания, чтения, обновления и удаления.

• Наряду с приведенными ниже ограничениями регулирование уровня connectionID также применяется на основе общего времени, затраченного предыдущими запросами в заданный период времени.

Услуга	Окружающая среда	Operations	Имя	Звонки	Период продления (секунды)
Logic Apps и Power Automate	Общая среда	Native	Вызовы API для каждого подключения	500	10
Logic Apps и Power Automate	Общая среда	CRUD	Вызовы API для каждого подключения	100	10
Logic Apps и Power Automate	Общая среда	Native	Одновременные вызовы для каждого подключения	200	-
Logic Apps и Power Automate	Общая среда	CRUD	Одновременные вызовы для каждого подключения	125	-
Power Apps (Приложения Power)	Общая среда	All	Вызовы API для каждого пользователя	300	30
Power Apps (Приложения Power)	Общая среда	All	Одновременные вызовы для каждого подключения	125	-

Замечание

Одновременные вызовы — это количество выполняемых запросов, которые может выполнять определенное соединение. Например, при собственных вызовах Azure Logic Apps одно подключение может выполнять 200 одновременных вызовов. Все последующие вызовы возвращают ошибку 429, если все 200 вызовов по-прежнему выполняются. Ограничение времени не существует, так как вызовы могут занять произвольное время. Однако точка ограничения вызовов заключается в том, чтобы предотвратить слишком много длительных запросов из одного подключения и отрицательно влиять на другие подключения.

Например, если подключение выполняет 200 вызовов одновременно, и каждый вызов занимает 50 секунд, все остальные вызовы завершаются ошибкой 429 в течение следующих 50 секунд. После завершения выполнения одного или нескольких запросов возвращаются результаты, все последующие вызовы обрабатываются.

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

См. документацию по SQL Power Apps

Функции и операции Power Apps, которые можно делегировать в SQL Server

См. документацию по делегированию Power Apps SQL

Формальные параметры в операциях

Выполнение SQL-запроса [DEPRECATED] и выполнение действий SQL-запроса (V2) разрешает использование формальных параметров. Они определяются как пары "ключ-значение", где key имя параметра и value является типом данных SQL, например INT или NVARCHAR(255). После определения имени и типа данных отображается новое поле ввода для значения.

Перенос операций версии 1 в эквивалентную версию 2

Выполните действия, описанные здесь, чтобы перейти из операции версии 1 в эквивалентную версию 2.

Это важно

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

Замечание

Все операции версии 2 имеют два дополнительных параметра: Server Nameи Database Name. Это позволяет операциям версии 2 поддерживать проверку подлинности идентификатора Microsoft Entra.

Тип операции	Операция V1	Эквивалент операции версии 2
Действие	Удаление строки [не рекомендуется]	Удаление строки (версия 2)
Действие	Выполнение SQL-запроса [DEPRECATED]	Выполнение SQL-запроса (версия 2)
Действие	Выполнение хранимой процедуры	Выполнение хранимой процедуры (версия 2)
Действие	Получение строки [DEPRECATED]	Получение строки (версия 2)
Действие	Получение строк [DEPRECATED]	Получение строк (версия 2)
Действие	Вставка строки [DEPRECATED]	Вставка строки (версия 2)
Действие	Список таблиц, предоставляемых подключением [DEPRECATED]	Получение таблиц (версия 2)
Действие	Обновление строки [не рекомендуется]	Обновление строки (версия 2)
Триггер	При создании элемента [DEPRECATED]	При создании элемента (версия 2)
Триггер	При изменении элемента [DEPRECATED]	При изменении элемента (версия 2)

Определение действий версии 1

Power Automate (платформа автоматизации рабочих процессов)

Для операций Power Automate откройте операцию Code View SQL Server и проверьте host.operationId это значение. Если значение соответствует одному из перечисленных выше идентификаторов операций SQL Server версии 1, то эта операция должна быть перенесена в эквивалент версии 2.

Например, PatchItem операция должна быть перенесена в PatchItem_V2.

Логические приложения

Чтобы получить общие сведения о logic Apps, которые содержат по крайней мере одну операцию SQL Server V1, выполните следующие действия:

1. Открытие портала Azure

2. Открытие обозревателя Azure Resource Graph

3. Введите идентификатор подписки в заполнитель и выполните приведенный ниже запрос, чтобы получить сводку по Logic Apps, которые нуждаются в вашем внимания, и количество действий SQL Server V1 в каждом из них.

   • Скрипт Обозревателя ресурсов Azure для идентификации Logic Apps с действиями версии 1.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend actionsJson=propertiesJson["definition"]["actions"]
     | mv-expand actionsJson
     | where notnull(actionsJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(actionsJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend actionConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(actionsJson))
     | where notnull(actionConnectionName)
     | parse actionConnectionName with "@parameters('$connections')['"parsedActionConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedActionConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, actionsJson
     | summarize v1ActionCount = count() by resourceGroup, logicAppName = name
     

   • Скрипт Обозревателя ресурсов Azure для идентификации Logic Apps с триггерами версии 1.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend triggersJson=propertiesJson["definition"]["triggers"]
     | mv-expand triggersJson
     | where notnull(triggersJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(triggersJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend triggerConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(triggersJson))
     | where notnull(triggerConnectionName)
     | parse triggerConnectionName with "@parameters('$connections')['"parsedTriggerConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedTriggerConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, triggersJson
     | summarize v1TriggerCount = count() by resourceGroup, logicAppName = name
     

Миграция на операции версии 2 в пользовательском интерфейсе

Миграция Logic Apps и автоматизация Power Automate

1. Откройте поток приложения логики или Power Automate, содержащий действие версии 1.

2. Добавьте действие прямо перед или после действия версии 1, которое вы хотите обновить.

   

3. Щелкните соединитель SQL Server и найдите эквивалент действия, перенесенного версии 2.

   

4. Выберите подключение, используемое в действии версии 2.

   Подсказка

   Действия версии 2 поддерживают типы проверки подлинности Идентификатора Microsoft Entra. Logic Apps также поддерживает проверку подлинности управляемых удостоверений в действиях версии 2.

   Дополнительные сведения см. в разделе "Проверка подлинности ".

5. Введите имя сервера.

   • Если вы используете Windows Authentication или SQL Server Authenticationвыберите имя сервера в раскрывающемся списке.

     

   • Если вы используете Service principalMicrosoft Entra ID или Managed Identity тип проверки подлинности, нажмите кнопку "Ввести настраиваемое значение" в раскрывающемся списке, а затем введите имя сервера.

     

6. Введите базу данных, выбрав ее из раскрывающегося списка.

   

7. Введите оставшиеся параметры, чтобы они совпадали с действием V1.

8. После настройки действия версии 1 удалите действие версии 2.

   

   Это важно

   Удаление действия версии 1 приведет к удалению всего динамического содержимого из версии 1; Динамическое содержимое версии 2 потребуется повторно добавить.

Перенос Power Apps

1. Откройте приложение, которое необходимо обновить.

2. Удалите все источники данных SQL.

   Замечание

   Формулы, использующие удаленные источники данных, будут отображать ошибку, это ожидается и будет исправлено на следующих шагах.

   

3. Откройте вкладку "Предстоящие функции" в разделе "Параметры" и введите "SQL" в поле поиска. Появится функция включения расширенного соединителя Microsoft SQL Server.

   

4. Включите функцию включения расширенного соединителя Microsoft SQL Server.

   Замечание

   Эта функция включена по умолчанию для всех новых приложений Power Apps.

   

5. Считывал источник данных.

   

6. Проверьте поведение приложения, специально в таблицах, обрабатывающих типы данных DateTime.

7. Сохраните приложение.

Миграция операций с помощью представления кода в Azure Logic Apps

Для более сложных сценариев можно перенести действия, обновив определение рабочего процесса.

1. Определите имя операций (триггер и/или действия), которые необходимо перенести в приложении логики.

2. Откройте конструктор приложения логики для изменения и щелкните "Представление кода".

   

3. Для каждого действия, которое необходимо перенести:

   1. Поиск свойства пути действия или триггера
   2. Замените /datasets/default/ в свойстве /v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/пути значением .

4. После обновления всех операций щелкните "Конструктор".

   

5. Убедитесь, что все операции успешно перенесены.

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

   

6. Сохраните и проверьте приложение логики.

Подсказка

При необходимости после переноса действий в версию версии 2 имя и подключение операции можно обновить.

Ниже приведен пример миграции строк Get [DEPRECATED].

1. Откройте представление кода.

2. Найдите действие Get rows [DEPRECATED].

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/datasets/default/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

3. Обновите сегмент наборов данных пути, указав указанный выше замещающий элемент.

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

4. Щелкните "Конструктор", чтобы вернуться к первоначальному представлению и убедиться, что действие было правильно заполнено.

Миграция операций с помощью редактирования определения потока

1. Определите имя операций (триггер и/или действия), которые необходимо перенести в приложении логики.

2. Экспорт потока в виде пакета (ZIP).

   

3. Извлеките ZIP-файл.

4. Откройте папку, в которой был извлечен ZIP-файл.

5. Перейдите к папке с именем GUID, а затем flowsперейдите в Microsoft.Flowпапку с именем GUID.

6. Откройте файл definition.json в текстовом редакторе.

   • Чтобы улучшить удобочитаемость, отформатируйте JSON.

7. Для каждого действия, которое необходимо перенести:

   1. Поиск действия или свойства триггера

   2. Обновите inputs.host.operationId свойство до эквивалента версии 2. Значение можно найти в документации по операции.

      

   3. Добавьте к inputs.parameters двум свойствам:

      • server со значением default
      • database со значением default

8. Сохранение файла definition.json

9. Вернитесь к расположению manifest.json и Microsoft.Flow

10. Выберите Microsoft.Flow и manifest.jsonи сжать в ZIP-файл.

    Это важно

    Убедитесь, что новый ZIP-файл имеет ту же структуру файлов и папок, что и исходный ZIP-файл.

    Папка Microsoft.Flow и файл manifest.json должны находиться в корне нового ZIP-файла. При отправке пакета ошибки могут возникнуть ошибки с той же структурой.

    

11. Перейдите к потокам в Power Automate.

12. Импортируйте обновленный поток, импортируя пакет. Выберите только что созданный ZIP-файл и отправьте пакет.

    

13. Выберите настройку импорта (импорт и создание нового) и выберите подключения, которые будут использоваться потоком.

14. После завершения импорта откройте новый или обновленный поток.

15. Убедитесь, что действия обновлены

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

• Все остальные параметры также должны быть заполнены.

  

Подсказка

При необходимости после переноса действий в версию версии 2 имя и подключение операции можно обновить в пользовательском интерфейсе.

Ниже приведен пример миграции SQL-запроса [DEPRECATED].

1. Откройте представление кода.

2. Найдите действие "Выполнение SQL-запроса [DEPRECATED].

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery"
         },
         "parameters": {
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   

3. Обновите идентификатор операции с эквивалентным идентификатором операции версии 2, а затем добавьте параметры сервера и базы данных со значением default , как описано выше.

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery_V2"
         },
         "parameters": {
           "server": "default",
           "database": "default",
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   
   

Это важно

Встроенные подключения Microsoft Entra ID (Azure Commercial) отключены в средах GCC для государственных организаций США по умолчанию. Чтобы включить эти типы подключений, параметр Подключения к коммерческой службе Azure должен быть включен в Центре администрирования Power Platform администратором клиента.

Включение этого параметра позволяет подключаться к ресурсам в коммерческой службе Azure, которые работают и отправляют данные за пределы соответствия требованиям Power Platform ДЛЯ государственных организаций США. Это специально используется для предоставления доступа к коммерческим ресурсам из облачных версий GCC соединителей Power Platform.

Microsoft Entra ID Integrated (Azure Commercial) — это единственный тип проверки подлинности, который работает из сред US Для государственных организаций (GCC) в коммерческие ресурсы Azure.

Коммерческая проверка подлинности Azure отключена по

Параметр "Подключение к коммерческой сети Azure" в Центре Power Platform: представление администратора

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

Проверка подлинности сертификата клиента	Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX	Все регионы	Доступный для общего пользования
Интегрированный идентификатор Microsoft Entra	Используйте идентификатор Microsoft Entra для доступа к базе данных SQL.	Все регионы, кроме правительства США (GCC)	Недоступен для совместного использования
Интегрированная идентификатора Microsoft Entra (коммерческая служба Azure)	Используйте идентификатор Microsoft Entra для доступа к базе данных SQL в коммерческой службе Azure.	Только правительство США (GCC)	Недоступен для совместного использования
Интегрированная идентификатора Microsoft Entra (Azure для государственных организаций)	Используйте идентификатор Microsoft Entra для доступа к базе данных SQL в Azure для государственных организаций.	Только правительство США (GCC)	Недоступен для совместного использования
Субъект-служба (приложение идентификатора Microsoft Entra)	Используйте приложение идентификатора Microsoft Entra для доступа к базе данных SQL.	Все регионы	Доступный для общего пользования
Проверка подлинности SQL Server	Используйте имя учетной записи и пароль для доступа к базе данных SQL.	Все регионы	Доступный для общего пользования
Аутентификация Windows	Используйте локальное имя и пароль учетной записи идентификатора Microsoft Entra для доступа к базе данных SQL.	Все регионы	Доступный для общего пользования
Проверка подлинности Windows (не общая)	Используйте локальное имя и пароль учетной записи идентификатора Microsoft Entra для доступа к базе данных SQL.	Все регионы	Недоступен для совместного использования
По умолчанию [не рекомендуется]	Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.	Все регионы	Недоступен для совместного использования

Проверка подлинности сертификата клиента

Идентификатор проверки подлинности: certOauth

Применимо: все регионы

Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Tenant	струна		True
Идентификатор клиента	струна	Идентификатор клиента для приложения Идентификатора Microsoft Entra
Секрет сертификата клиента	клиентский сертификат	Секрет сертификата клиента, разрешенный этим приложением	True

Microsoft Entra id Integrated

Идентификатор проверки подлинности: oauth

Применимо: все регионы, кроме правительства США (GCC)

Используйте идентификатор Microsoft Entra для доступа к базе данных SQL.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Интегрированная идентификатора Microsoft Entra (коммерческая служба Azure)

Идентификатор проверки подлинности: oauthCom

Применимо: только правительство США (GCC)

Используйте идентификатор Microsoft Entra для доступа к базе данных SQL в коммерческой службе Azure.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Интегрированная идентификатора Microsoft Entra (Azure для государственных организаций)

Идентификатор проверки подлинности: oauth

Применимо: только правительство США (GCC)

Используйте идентификатор Microsoft Entra для доступа к базе данных SQL в Azure для государственных организаций.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Субъект-служба (приложение идентификатора Microsoft Entra)

Идентификатор проверки подлинности: oauthSP

Применимо: все регионы

Используйте приложение идентификатора Microsoft Entra для доступа к базе данных SQL.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Tenant	струна		True
Идентификатор клиента	струна		True
Секрет клиента	securestring		True

Проверка подлинности SQL Server

Идентификатор проверки подлинности: sqlAuthentication

Применимо: все регионы

Используйте имя учетной записи и пароль для доступа к базе данных SQL.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Имя SQL Server	струна	Укажите имя SQL Server (сервер[:p ort])	True
Имя базы данных SQL	струна	Имя базы данных SQL	True
Имя пользователя	securestring	Учетные данные пользователя	True
Пароль	securestring	Учетные данные пароля	True
Gateway	gatewaySetting	Локальный шлюз (дополнительные сведения см. в разделе https://docs.microsoft.com/data-integration/gateway "Дополнительные сведения"

Проверка подлинности Windows

Идентификатор проверки подлинности: windowsAuthentication

Применимо: все регионы

Используйте локальное имя и пароль учетной записи идентификатора Microsoft Entra для доступа к базе данных SQL.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Имя SQL Server	струна	Укажите имя SQL Server (сервер[:p ort])	True
Имя базы данных SQL	струна	Имя базы данных SQL	True
Имя пользователя	securestring	Учетные данные пользователя	True
Пароль	securestring	Учетные данные пароля	True
Gateway	gatewaySetting	Локальный шлюз (дополнительные сведения см. в разделе https://docs.microsoft.com/data-integration/gateway "Дополнительные сведения"	True

Проверка подлинности Windows (не общая)

Идентификатор проверки подлинности: windowsAuthenticationNonShared

Применимо: все регионы

Используйте локальное имя и пароль учетной записи идентификатора Microsoft Entra для доступа к базе данных SQL.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Имя пользователя	securestring	Учетные данные пользователя	True
Пароль	securestring	Учетные данные пароля	True
Gateway	gatewaySetting	Локальный шлюз (дополнительные сведения см. в разделе https://docs.microsoft.com/data-integration/gateway "Дополнительные сведения"	True

По умолчанию [не рекомендуется]

Применимо: все регионы

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

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Имя SQL Server	струна	Имя SQL Server	True
Имя базы данных SQL	струна	Имя базы данных SQL	True
Тип проверки подлинности	струна	Тип проверки подлинности для подключения к базе данных
Имя пользователя	securestring	Учетные данные пользователя	True
Пароль	securestring	Учетные данные пароля	True
Gateway	gatewaySetting	Локальный шлюз (дополнительные сведения см. в разделе https://docs.microsoft.com/data-integration/gateway "Дополнительные сведения"

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	10 секунд

Действия

Вставка строки (версия 2)	Эта операция вставляет новую строку в таблицу.
Вставка строки [DEPRECATED]	Это действие устарело. Вместо этого используйте строку вставки (V2 ). Эта операция вставляет новую строку в таблицу.
Выполнение SQL-запроса (версия 2)	Выполнение SQL-запроса (версия 2)
Выполнение SQL-запроса [DEPRECATED]	Это действие устарело. Вместо этого используйте SQL-запрос (версии 2 ). Выполнение SQL-запроса
Выполнение хранимой процедуры	Эта операция выполняет хранимую процедуру.
Выполнение хранимой процедуры (версия 2)	Эта операция выполняет хранимую процедуру.
Обновление строки (версия 2)	Эта операция обновляет существующую строку в таблице.
Обновление строки [не рекомендуется]	Это действие устарело. Вместо этого используйте строку update (V2). Эта операция обновляет существующую строку в таблице.
Получение строк (версия 2)	Эта операция получает строки из таблицы.
Получение строк [DEPRECATED]	Это действие устарело. Вместо этого используйте команду Get rows (V2). Эта операция получает строки из таблицы.
Получение строки (версия 2)	Эта операция получает строку из таблицы.
Получение строки [DEPRECATED]	Это действие устарело. Вместо этого используйте строку Get (V2 ). Эта операция получает строку из таблицы.
Получение таблиц (версия 2)	Эта операция получает таблицы из базы данных.
Преобразование данных с помощью Power Query	Преобразование данных с помощью Power Query. Примечание. Эта операция не работает при подключении с помощью идентификатора Microsoft Entra SQL.
Список таблиц, предоставляемых подключением [DEPRECATED]	Это действие устарело. Вместо этого используйте таблицы Get (V2 ). Список таблиц, предоставляемых подключением
Удаление строки (версия 2)	Эта операция удаляет строку из таблицы.
Удаление строки [не рекомендуется]	Это действие устарело. Вместо этого используйте строку Delete (V2). Эта операция удаляет строку из таблицы.

Вставка строки (версия 2)

Идентификатор операции:

PostItem_V2

Эта операция вставляет новую строку в таблицу.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных
Имя таблицы	table	True	string	Имя таблицы
Row	item	True	dynamic	Строка для вставки в указанную таблицу

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Вставка строки [DEPRECATED]

Идентификатор операции:

PostItem

Это действие устарело. Вместо этого используйте строку вставки (V2 ).

Эта операция вставляет новую строку в таблицу.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы	table	True	string	Имя таблицы
Row	item	True	dynamic	Строка для вставки в указанную таблицу

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Выполнение SQL-запроса (версия 2)

Идентификатор операции:

ExecutePassThroughNativeQuery_V2

Выполнение SQL-запроса (версия 2)

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных
Query	query	True	dynamic	Текст запроса

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Выполнение SQL-запроса [DEPRECATED]

Идентификатор операции:

ExecutePassThroughNativeQuery

Это действие устарело. Вместо этого используйте SQL-запрос (версии 2 ).

Выполнение SQL-запроса

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Query	query	True	dynamic	Текст запроса

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Выполнение хранимой процедуры

Идентификатор операции:

ExecuteProcedure

Эта операция выполняет хранимую процедуру.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя процедуры	procedure	True	string	Имя хранимой процедуры
Список параметров	parameters	True	dynamic	Входные параметры хранимой процедуры

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Выполнение хранимой процедуры (версия 2)

Идентификатор операции:

ExecuteProcedure_V2

Эта операция выполняет хранимую процедуру.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных
Имя процедуры	procedure	True	string	Имя хранимой процедуры
Список параметров	parameters	True	dynamic	Входные параметры хранимой процедуры

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Обновление строки (версия 2)

Идентификатор операции:

PatchItem_V2

Эта операция обновляет существующую строку в таблице.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных
Имя таблицы	table	True	string	Имя таблицы
Идентификатор строки	id	True	string	Уникальный идентификатор строки для обновления
Row	item	True	dynamic	Строка с обновленными значениями

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Обновление строки [не рекомендуется]

Идентификатор операции:

PatchItem

Это действие устарело. Вместо этого используйте строку update (V2).

Эта операция обновляет существующую строку в таблице.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы	table	True	string	Имя таблицы
Идентификатор строки	id	True	string	Уникальный идентификатор строки для обновления
Row	item	True	dynamic	Строка с обновленными значениями

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение строк (версия 2)

Идентификатор операции:

GetItems_V2

Эта операция получает строки из таблицы.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных
Имя таблицы	table	True	string	Имя таблицы SQL
Преобразование агрегирования	$apply		string	Последовательность преобразований агрегирования OData
Запрос фильтра	$filter		string	Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Заказ по	$orderby		string	Запрос oDATA orderBy для указания порядка записей.
Пропустить число	$skip		integer	Количество пропускаемых записей (по умолчанию = 0).
Первое число	$top		integer	Общее количество записей для получения (по умолчанию = все).
Выбор запроса	$select		string	Определенные поля для извлечения из записей (по умолчанию = все).

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение строк [DEPRECATED]

Идентификатор операции:

GetItems

Это действие устарело. Вместо этого используйте команду Get rows (V2).

Эта операция получает строки из таблицы.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы	table	True	string	Имя таблицы SQL
Преобразование агрегирования	$apply		string	Последовательность преобразований агрегирования OData
Запрос фильтра	$filter		string	Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Заказ по	$orderby		string	Запрос oDATA orderBy для указания порядка записей.
Пропустить число	$skip		integer	Количество пропускаемых записей (по умолчанию = 0).
Первое число	$top		integer	Общее количество записей для получения (по умолчанию = все).
Выбор запроса	$select		string	Определенные поля для извлечения из записей (по умолчанию = все).

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение строки (версия 2)

Идентификатор операции:

GetItem_V2

Эта операция получает строку из таблицы.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных
Имя таблицы	table	True	string	Имя таблицы SQL
Идентификатор строки	id	True	string	Уникальный идентификатор строки для извлечения

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение строки [DEPRECATED]

Идентификатор операции:

GetItem

Это действие устарело. Вместо этого используйте строку Get (V2 ).

Эта операция получает строку из таблицы.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы	table	True	string	Имя таблицы SQL
Идентификатор строки	id	True	string	Уникальный идентификатор строки для извлечения

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение таблиц (версия 2)

Идентификатор операции:

GetTables_V2

Эта операция получает таблицы из базы данных.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных

Возвращаемое значение

Представляет список таблиц.

Тело

TablesList

Преобразование данных с помощью Power Query

Идентификатор операции:

SqlExecutePassThroughPowerQuery

Преобразование данных с помощью Power Query. Примечание. Эта операция не работает при подключении с помощью идентификатора Microsoft Entra SQL.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
query	query		mquery	Текст запроса

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Список таблиц, предоставляемых подключением [DEPRECATED]

Идентификатор операции:

GetTables

Это действие устарело. Вместо этого используйте таблицы Get (V2 ).

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

Возвращаемое значение

Представляет список таблиц.

Тело

TablesList

Удаление строки (версия 2)

Идентификатор операции:

DeleteItem_V2

Эта операция удаляет строку из таблицы.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных
Имя таблицы	table	True	string	Имя таблицы
Идентификатор строки	id	True	string	Уникальный идентификатор строки для удаления

Удаление строки [не рекомендуется]

Идентификатор операции:

DeleteItem

Это действие устарело. Вместо этого используйте строку Delete (V2).

Эта операция удаляет строку из таблицы.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы	table	True	string	Имя таблицы
Идентификатор строки	id	True	string	Уникальный идентификатор строки для удаления

Триггеры

При изменении элемента (версия 2)	Активирует поток при изменении или вставке элемента в SQL
При изменении элемента [DEPRECATED]	Это действие устарело. Используйте вместо этого , когда элемент изменяется (версия 2 ). Активирует поток при изменении или вставке элемента в SQL
При создании элемента (версия 2)	Активирует поток при создании элемента в SQL
При создании элемента [DEPRECATED]	Это действие устарело. Вместо этого используйте команду "При создании элемента" (V2 ). Активирует поток при создании элемента в SQL

При изменении элемента (версия 2)

Идентификатор операции:

GetOnUpdatedItems_V2

Активирует поток при изменении или вставке элемента в SQL

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных
Имя таблицы	table	True	string	Имя таблицы SQL
Запрос фильтра	$filter		string	Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Первое число	$top		integer	Общее количество записей для получения (по умолчанию = все).
Заказ по	$orderby		string	Запрос oDATA orderBy для указания порядка записей.
Выбор запроса	$select		string	Определенные поля для извлечения из записей (по умолчанию = все).

Возвращаемое значение

Выходные данные этой операции являются динамическими.

При изменении элемента [DEPRECATED]

Идентификатор операции:

GetOnUpdatedItems

Это действие устарело. Используйте вместо этого , когда элемент изменяется (версия 2 ).

Активирует поток при изменении или вставке элемента в SQL

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы	table	True	string	Имя таблицы SQL
Запрос фильтра	$filter		string	Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Первое число	$top		integer	Общее количество записей для получения (по умолчанию = все).
Заказ по	$orderby		string	Запрос oDATA orderBy для указания порядка записей.
Выбор запроса	$select		string	Определенные поля для извлечения из записей (по умолчанию = все).

Возвращаемое значение

Выходные данные этой операции являются динамическими.

При создании элемента (версия 2)

Идентификатор операции:

GetOnNewItems_V2

Активирует поток при создании элемента в SQL

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя сервера	server	True	string	Имя SQL Server
Название базы данных	database	True	string	Название базы данных
Имя таблицы	table	True	string	Имя таблицы SQL
Запрос фильтра	$filter		string	Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Первое число	$top		integer	Общее количество записей для получения (по умолчанию = все).
Заказ по	$orderby		string	Запрос oDATA orderBy для указания порядка записей.
Выбор запроса	$select		string	Определенные поля для извлечения из записей (по умолчанию = все).

Возвращаемое значение

Выходные данные этой операции являются динамическими.

При создании элемента [DEPRECATED]

Идентификатор операции:

GetOnNewItems

Это действие устарело. Вместо этого используйте команду "При создании элемента" (V2 ).

Активирует поток при создании элемента в SQL

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя таблицы	table	True	string	Имя таблицы SQL
Запрос фильтра	$filter		string	Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Первое число	$top		integer	Общее количество записей для получения (по умолчанию = все).
Заказ по	$orderby		string	Запрос oDATA orderBy для указания порядка записей.
Выбор запроса	$select		string	Определенные поля для извлечения из записей (по умолчанию = все).

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Определения

Таблица

Представляет таблицу.

Имя	Путь	Тип	Описание
Имя	Name	string	Название таблицы. Имя используется во время выполнения.
Отображаемое имя	DisplayName	string	Отображаемое имя таблицы.
DynamicProperties	DynamicProperties	object	Дополнительные свойства таблицы, предоставляемые соединителем клиентам.

TablesList

Представляет список таблиц.

Имя	Путь	Тип	Описание
value	value	array of Table	Список таблиц