SQL Server
Microsoft SQL Server は、Microsoft によって開発されたリレーショナル データベース管理システムです。 SQL Server に接続してデータを管理します。 テーブル内の行に対して、作成、更新、取得、削除などのさまざまなアクションを実行できます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | すべての地域 Power Automate |
| ロジック アプリ | Standard | すべての Logic Apps リージョン |
| Power Apps | Premium | すべての Power Apps リージョン |
| Power Automate | Premium | すべての地域 Power Automate |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
コネクタの詳細
この記事では、Azure Logic Apps、Power Automate、Power Apps で使用できる SQL Server マネージド コネクタの操作について説明します。 SQL Server 組み込み コネクタは、Azure Logic Apps の標準ロジック アプリ ワークフローでのみ使用できます。
- Power Apps のこのコネクタの詳細については、「Power Apps から SQL Server に接続する」を参照してください。
- Azure Logic Apps の SQL Server 組み込みコネクタとマネージド コネクタの詳細については、「Azure Logic Apps のワークフローから SQL データベースに接続する」を参照してください。
Authentication
Microsoft Entra ID (Microsoft Entra ID) 以外の接続を作成する場合は、接続文字列認証オプションを使用します。 接続で定義されているのと同じ サーバー名 と データベース名 の値を指定してください。
Microsoft Entra ID 認証
Microsoft Entra ID 認証に関する既知の制限事項
現在の認証パイプラインの制限により、Microsoft Entra ID ゲスト ユーザーは SQL Server への Microsoft Entra ID 接続ではサポートされていません。 この問題を解決するには、代わりに SQL Server 認証または Windows 認証を使用します。
SQL Server の Microsoft Entra ID 認証を有効にする
SQL Microsoft Entra ID (Microsoft Entra ID) メンバーとしてアカウントを設定してプロビジョニングします。 詳細については、「 Azure SQL を使用した Microsoft Entra ID 認証の構成と管理」を参照してください。
SQL サーバーで、Microsoft Entra ID 管理者を設定します。
- Azure portal で、Microsoft Entra ID 認証を有効にする SQL サーバーに移動します。
- SQL Server リソース メニューの [設定] で、 Microsoft Entra ID を選択します。
- Microsoft Entra ID ペインのツール バーで、[管理者の設定] を選択します。
- 現在のテナントで Microsoft Entra ID ユーザー アカウントを見つけて選択し、サーバー管理者にします。 変更を保存します。
Microsoft Entra ID テナントで、SQL データベースにアクセスするための Microsoft Entra ID アプリケーションを作成して登録します。 詳細については、「 SQL Server - Microsoft Entra ID 認証を設定する」を参照してください。
Azure portal で、Microsoft Entra ID アプリケーションを作成する Microsoft Entra ID テナントに移動します。
テナント メニューの [ 管理] で、[ アプリの登録>新しい登録] を選択します。
[ アプリケーションの登録 ] ウィンドウで、アプリケーションの名前を指定します。 後でユーザーを作成し、ロールに SQL データベースへのアクセス権を付与できるように、この名前を覚えておいてください。
完了したら、[ 登録] を選択して、Microsoft Entra ID アプリケーションを作成します。
[ アプリの登録 ] ウィンドウで、新しい Microsoft Entra ID アプリケーションを選択します。 アプリケーション メニューで、 証明書とシークレット>新しいクライアント シークレットを選択します。
シークレットの説明を入力し、有効期限を選択します。
サーバー管理者として設定した Microsoft Entra ID ユーザー アカウントの資格情報を使用して、SQL サーバーとデータベースにサインインします。
SQL データベースで、Microsoft Entra ID アプリケーションを表す包含ユーザーを作成します。 この手順には 、Microsoft SQL Server Management Studio (SSMS) が必要です。
次の手順では、
db_datareaderとdb_datawriterのロールを、example-Azure-AD-application-nameという名前で Microsoft Entra ID アプリケーションに割り当てます。 指定したコマンドを実行するときは、example-Azure-AD-application-nameを Microsoft Entra ID アプリケーションの名前に置き換え、ニーズに必要なロールを割り当てておく必要があります。SSMS を起動し、Microsoft Entra ID アプリケーションがアクセスする SQL サーバーに接続します。
認証では、MFA サポートとサーバー管理者として設定した Microsoft Entra ID アカウントで Active Directory - Universal を使用します。
オブジェクト エクスプローラーで、[データベース] フォルダーを展開します。
データベースを見つけ、データベースのショートカット メニューを開き、[ 新しいクエリ] を選択します。
クエリ ウィンドウで、次のコマンドを実行して、Microsoft Entra ID アプリケーションをデータベース内の新しいユーザーにリンクします。
CREATE USER [example-Azure-AD-app-name] FROM EXTERNAL PROVIDERクエリ ウィンドウをクリアします。 次に、次のコマンドを実行して、
db_datareaderロールを Microsoft Entra ID アプリケーションに割り当てます。ALTER ROLE db_datareader ADD MEMBER [example-Azure-AD-application-name]前の手順を繰り返して、
db_datawriterロールを Microsoft Entra ID アプリケーションに割り当てます。ALTER ROLE db_datawriter ADD MEMBER [example-Azure-AD-application-name]
マネージド ID の認証
現時点では、SQL Server コネクタの マネージド ID 認証 は Azure Logic Apps でのみサポートされています。
サービス プリンシパルの認証
ロジック アプリでマネージド ID を設定する
Azure portal で、ロジック アプリ リソースに移動します。
システム割り当て ID またはユーザー割り当て ID のいずれかを有効にします。 ユーザー割り当て ID がない場合は、まずその ID を作成する必要があります。 詳細については、「 Azure Logic Apps でマネージド ID を使用して Azure リソースへのアクセスを認証する」を参照してください。
ユーザー割り当て ID を選択した場合は、その ID をロジック アプリ リソースに追加したことを確認します。
- Azure portal で、マネージド ID を使用するロジック アプリ リソースを参照します。
- ロジック アプリのナビゲーション メニューの [設定] で 、[ ID] を選択します。
- 割り当てられたユーザー タブで、追加 を選択します。
- 使用するマネージド ID を選択し、[ 追加] を選択します。
マネージド ID 認証用に SQL Server を設定する
SQL サーバーで、Microsoft Entra ID 管理者を設定します。
- Azure portal で、Microsoft Entra ID 認証を有効にする SQL サーバーを参照します。
- SQL Server リソース メニューの [設定] で、 Microsoft Entra ID を選択します。
- Microsoft Entra ID ペインのツール バーで、[管理者の設定] を選択します。
- 現在のテナントで Microsoft Entra ID ユーザー アカウントを見つけて選択し、サーバー管理者にします。 変更を保存します。
SQL データベースで、マネージド ID を表す包含ユーザーを作成します。 この手順には 、Microsoft SQL Server Management Studio (SSMS) が必要です。
次の手順では、
db_datareaderのロールを、example-managed-identity-nameという名前のマネージド ID に割り当てます。 指定したコマンドを実行するときは、example-managed-identity-nameをマネージド ID の名前に置き換え、ニーズに合った適切なロールを割り当てておく必要があります。 たとえば、db_datareaderは書き込み操作を実行できません。SSMS を起動し、マネージド ID がアクセスする SQL サーバーに接続します。
認証では、MFA サポートとサーバー管理者として設定した Microsoft Entra ID アカウントで Active Directory - Universal を使用します。
オブジェクト エクスプローラーで、[データベース] フォルダーを展開します。
データベースを見つけ、データベースのショートカット メニューを開き、[ 新しいクエリ] を選択します。
クエリ ウィンドウで、次のコマンドを実行して、マネージド ID をデータベース内の新しいユーザーにリンクします。
CREATE USER [example-managed-identity-name] FROM EXTERNAL PROVIDERクエリ ウィンドウをクリアします。 次に、次のコマンドを実行して、管理 ID にロールを割り当てます。
ALTER ROLE db_datareader ADD MEMBER [example-managed-identity-name]注
データベース レベルでマネージド ID にロールを割り当てると、その ID にはすべてのデータベースを一覧表示するために必要なスコープがありません。 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この問題を解決するには、次のオプションがあります。
- すべてのデータベースをマネージド ID に一覧表示できるサーバー レベルのロールを割り当てます。
- SQL トリガーまたはアクションで、 カスタム値の入力 オプションを使用してデータベース名を入力します。
詳細については、次のドキュメントを確認してください。
- Azure Logic Apps でマネージド ID を使用して Azure リソースへのアクセスを認証する
- チュートリアル: Windows VM のシステム割り当てマネージド ID を使用して Azure SQL にアクセスする
- Azure SQL を使用した Microsoft Entra ID 認証の構成と管理
- データベース レベルのロール
- サーバー レベルのロール
Virtual Network のサポート
Virtual Network にリンクされた Power Platform 環境でコネクタが使用されている場合、次の制限が適用されます。
次のアクションのみがサポートされています。
このリスト以外のアクションでは、"403 Unauthorized" エラーが返されます
オンプレミス データ ゲートウェイはサポートされていません
Microsoft Entra ID 統合認証を使用する場合は、カスタム値としてデータベース名を手動で入力してください
アクションに関する既知の問題と制限事項
| 簡単な説明 | オペレーション | 長い説明 |
|---|---|---|
| アクション出力で確定的な結果を取得する | 行の取得 (V2) | アクション出力で確定的な結果を得るには、 Order By パラメーターを使用することをお勧めします。
Order Byが指定されていない場合、SQL Server では既定で主キーまたは一意キーが使用されます。 非決定論的な結果は、改ページが有効な場合にアクション出力のレコードを複製するなど、問題を引き起こす可能性があります。 SQL ビューでは主キーがサポートされていません。これは、SQL Server 自体の制限です。 |
| SQL クエリの制限付きサポートを実行する | SQL クエリの実行 (V2) | オンプレミスの SQL Server ではサポートされていません。 |
| 一般的な CRUD 要件 |
行の取得 (V2) 行の取得 (V2) 行の更新 (V2) 行の削除 (V2) |
Azure SQL インスタンスの使用の場合、文字列値はトリミングされます。 そのため、空白の文字列は空の文字列に変換されます。 INSERT 操作と UPDATE 操作の場合、コネクタは更新された行を返します。 これには、接続にも SQL Server からデータを読み取るアクセス許可が必要です。 次の操作には主キーが必要です。 - GetItem - PatchItem - DeleteItem |
| 集計変換パラメーターのサポート | 行の取得 (V2) | 次の集計変換のみがサポートされています。 - filter: 入力セットのフィルター処理を許可します。 $filterと同じ式をサポートします。 例: filter(ColName1 eq 1)。- aggregate: average、 max、 min、 sum、 countdistinctのいずれかの方法を使用した集計を許可します。 例: aggregate(ColName2 with max as MaxValue)。スラッシュで区切られた複数の演算子を組み合わせて、連続して適用されることを表すことができます。 これは、各変換の結果が次の変換への入力であることを意味します。 例: filter(ColName1 eq 4)/aggregate(ColName2 with sum as MaxWorkItemId)。 |
| SQL クエリの実行時にオーバーライドされる仮パラメーターのデータ型 |
SQL クエリの実行 [非推奨] SQL クエリの実行 (V2) |
SQL クエリで仮パラメーターを定義するときに入力されたデータ型は、コネクタの基になる実装によってパラメーターの指定 された値 を使用して型が決定されるため、オーバーライドされる可能性があります。 |
| 仮パラメーターを使用する IN 演算子では、値を個別に定義する必要があります | SQL クエリの実行 (V2) | IN 演算子で仮パラメーターを使用する場合、渡されるすべての値は、複数のコンマ区切り値を格納する 1 つの仮パラメーターとしてではなく、個別に定義する必要があります。 例: SELECT * FROM tableName WHERE columnName IN (@formalParameterA, @formalParameterB, @formalParameterC)。 |
| Azure Sql DataWareHouse DB の使用に失敗しました | 行の挿入 (V2) | Power Apps で Azure SQL Datawarehouse DB を使用すると、DB でのコネクタの実行で構文の不一致が原因でエラーが発生します。 Power Automate で Azure SQL Datawarehouse コネクタを使用してフローを作成するか、PowerApps からトリガーするか、クエリを作成して SQL クエリの実行 (V2) アクションで使用してください。 |
トリガーに関する既知の問題と制限事項
注
フローをオフにしてオンにしても、トリガーの状態はリセットされません。
| 簡単な説明 | オペレーション | 長い説明 |
|---|---|---|
| アイテムの変更: 行操作 | 項目が変更されたとき (V2) | INSERT と UPDATE の両方の行操作で発生します。 |
| 項目の変更: 列の要件 | 項目が変更されたとき (V2) | ROWVERSION 列が必要です。 |
| 項目の作成: 列の要件 | 項目が作成されたとき (V2) | IDENTITY 列が必要です。 |
| アイテムを作成 | 項目が作成されたとき (V2) | 新しく挿入された行を後で識別するには、挿入された最新の行の ID 列の値をしきい値 (トリガー状態) として使用します。 このロジックは、すべての新しい行の ID が前の行よりも大きい必要があることを前提としています。 したがって、明示的な t-sql コマンドまたはテーブルの切り捨てが原因でテーブルの ID シーケンスがリセットされた場合、トリガー ロジックは既存のフローの新しい行をスキップします。 可能な回避策は 2 つあります。まず、トリガー アクション カードを更新してフロー トリガーの状態をリセットし (たとえば、名前を変更したり、パラメーターを更新したり、新しい接続を追加したり)、変更を保存したりできます。 または、 次の方法を使用して、ターゲット テーブル ID シーケンスを復元できます。 |
一般的な既知の問題と制限事項
テーブルに対して SQL サーバー側トリガーを定義した場合、テーブルへの挿入と更新は機能しません。
この問題を解決するには、次のオプションがあります。
- ストアド プロシージャまたはネイティブ クエリを使用します。
- SQL テーブルからトリガーを削除します。
オンプレミスの SQL サーバーでの SQL コネクタの使用には、次の制限事項が適用されます。
- オンプレミスの SQL Server でサポートされる最小バージョンは SQL Server 2005 です。
- 要求サイズの制限は、オンプレミスの SQL Server を介して 2 MB です。
- 応答サイズの制限は、オンプレミスの SQL Server を介して 8 MB です。
ゲートウェイ経由でオンプレミスの SQL サーバーでストアド プロシージャを呼び出すには、次の制限事項が適用されます。
-
OUTPUTパラメーターの出力値は返されません。OUTPUTパラメーターの入力値を指定することもできます。 - ResultSets の値は型指定なしです。
- 戻り値は使用できません。
- 最初の結果セットのみが返されます。
- Dynamics スキーマは、結果セットではサポートされていません。
-
次のデータ型は、クエリ オプション述語として使用できません。
datedatetimedatetime2smalldatetime
強制暗号化の設定はサポートされていません。 既定では、SQL Database と SQL Managed Instance は、転送中のデータをトランスポート層セキュリティ (TLS) で暗号化することで、顧客データをセキュリティで保護します。 詳細については、 Azure SQL のセキュリティの概要に関するページを参照してください。
現在、SQL ネイティブ クエリの実行では、複数の結果セットのサポートが制限されています。 最初の空の 1 つの結果セットまで、結果セットのみが返されます。
この問題を解決するには、ストアド プロシージャを使用します。
SQL クエリとストアド プロシージャを実行した後、結果セット スキーマには一意の空でない列名が含まれている必要があります。
ストアド プロシージャ内で、内部
SELECTステートメントなど、一部の結果セットを返す操作の場合、結果セット スキーマには空でない一意の列名が含まれている必要があります。SQL クエリまたはストアド プロシージャの実行時間が 110 秒を超えると、アクションはタイムアウトになります。
Azure Logic Apps でこの制限を回避し、実行時間の長いストアド プロシージャを実行する方法については、 Logic Apps での実行時間の長い SQL ストアド プロシージャに関するページを参照してください。
Azure Logic Apps では、統合サービス環境内 (ISE) 内からのみ、SQL Server 上のプライベート エンドポイントにアクセスできます。 詳細については、「 Azure 仮想ネットワークへのアクセス」を参照してください。
多くのフィルターを使用してクエリを作成すると、次のエラーが発生する可能性があります。"OData クエリ構文ツリーがノード数の制限 '100' を超えました。 OData クエリ パラメーターの式を簡略化してみてください。 この問題を回避するには、フィルター条件を最適化して数を減らしてください (範囲の使用など)。
ターゲット テーブル フィールド (e.g. xml またはテキスト データ型) に大量のデータ (30 メガバイトを超える) を格納することはお勧めしません。 アクションとトリガーのパフォーマンスが低下し、504 タイムアウト エラーが発生する可能性があります。 "クエリの選択" パラメーターを使用して、比較的小さいフィールドのみを含め、大きな出力データ フィールドを避けてください。 または、 Azure Blob Storage などの特殊なファイル ストレージを代わりに使用してください。
OUTPUT 句のサポートがないため、Azure Synapse ソースでは CRUD 操作はサポートされていません。 代わりに専用 の Azure SQL Data Warehouse コネクタを使用することを強くお勧めします。
Power Platform および Logic Apps ナビゲーター ビューは、10,000 テーブルのリスト サイズに制限されています。
OData 標準識別子に準拠していないデータベース スキーマはサポートされていません (数値で始まる列名、サロゲート ペア文字などを含む列名)。 お客様は、ビューを使用して列の名前を抽象化するか、SQL 拡張プロパティを使用して、データベース スキーマとは別の補助プレーン文字の使用を処理できます。「 拡張プロパティをテーブル内の列に追加する」を参照してください。
SQL コネクタを仮想テーブルのデータ ソースとして使用する場合、サーバーとデータベースの値は、ソース データセットと使用されている接続の間で一致する必要があります。 SQL 認証を使用する場合は、接続にサーバーとデータベースの値が既に含まれるので、データセットの値を既定値に設定できます。 データセットの接続値が明示的に指定されている場合は、接続の値と一致する必要があります。それ以外の場合は、"問題が発生しました。 テーブルを開くことができませんでした。 再読み込みまたは再度開いてみてください。"無効なデータ ソース" が発生する可能性があります。
Power Automate フローで使用されるビューにスキーマの変更が発生した場合、更新されたビューに対して新しい接続が作成されるまでトリガーが起動しない可能性があります。更新されたビューに対してトリガーをリセットするには、接続を更新するだけでは不十分です。
表形式データ ストリーム (TDS) プロトコル 8.0 は現在、SQL コネクタではサポートされていません。
特別な調整の制限
SQL コネクタのスロットル制限は、異なる場合に異なります。 次の表では、 ネイティブ 操作に SQL ストアド プロシージャと SQL クエリが含まれています。 CRUD は、作成、読み取り、更新、削除の各操作を意味します。
以下の制限に加えて、connectionID レベルの調整は、特定の期間に以前の要求によって費やされた合計時間に基づいて適用されます。
| サービス | 環境 | オペレーション | 名前 | Calls | 更新期間 (秒) |
|---|---|---|---|---|---|
| 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 | 共有環境 | All | ユーザーごとの API 呼び出し | 300 | 30 |
| Power Apps | 共有環境 | All | 接続あたりの同時呼び出し数 | 125 | - |
注
同時呼び出しは、特定の接続で実行できる進行中の要求の数です。 たとえば、Azure Logic Apps のネイティブ呼び出しでは、1 つの接続で 200 回の同時呼び出しを行うことができます。 すべての 200 の呼び出しがまだ実行されている場合、後続の呼び出しでは 429 エラーが返されます。 呼び出しには任意の時間がかかる可能性があるため、時間制限はありません。 ただし、呼び出しの制限のポイントは、1 つの接続から実行時間の長すぎるクエリが多くなりすぎて、他の接続に悪影響を与えないようにすることです。
たとえば、接続が同時に 200 回呼び出しを行い、各呼び出しの実行に 50 秒かかる場合、他のすべての呼び出しは次の 50 秒間 429 エラーで失敗します。 1 つ以上のクエリの実行が完了し、結果が返されると、後続のすべての呼び出しが処理されます。
Power Apps のデータ型のマッピング
Power Apps SQL の ドキュメントを参照してください
SQL Server に委任可能な Power Apps の機能と操作
Power Apps SQL 委任に関するドキュメントを参照してください
操作の仮パラメーター
SQL クエリ [DEPRECATED] を実行 し、 SQL クエリ (V2) アクションを実行 すると、仮パラメーターを使用できます。 これらはキーと値のペアとして定義されます。ここで、 key はパラメーター名、 value は sql データ型 ( INT や NVARCHAR(255)など) です。 名前とデータ型を定義すると、値の新しい入力フィールドが表示されます。
V1 の操作を V2 の同等の操作に移行する
ここでの手順に従って、V1 操作から同等の V2 に移行します。
Important
移行を開始する前に 、必ず ロジック アプリ、Power Automate フロー、または Power App のコピーを保存してバックアップを作成してください。
注
すべての V2 操作には、 Server Nameと Database Nameの 2 つの追加パラメーターがあります。 これにより、V2 操作で Microsoft Entra ID 認証をサポートできます。
| 操作の種類 | V1 操作 | 同等の V2 操作 |
|---|---|---|
| アクション | 行の削除 [非推奨] | 行の削除 (V2) |
| アクション | SQL クエリの実行 [非推奨] | SQL クエリの実行 (V2) |
| アクション | ストアド プロシージャの実行 | ストアド プロシージャの実行 (V2) |
| アクション | 行の取得 [非推奨] | 行の取得 (V2) |
| アクション | 行の取得 [非推奨] | 行の取得 (V2) |
| アクション | 行の挿入 [非推奨] | 行の挿入 (V2) |
| アクション | 接続によって公開されるテーブルの一覧 [非推奨] | テーブルの取得 (V2) |
| アクション | 行の更新 [非推奨] | 行の更新 (V2) |
| トリガー | アイテムが作成されたとき [非推奨] | 項目が作成されたとき (V2) |
| トリガー | アイテムが変更されたとき [非推奨] | 項目が変更されたとき (V2) |
V1 アクションを識別する
Power Automate
Power Automate 操作の場合は、SQL Server 操作の Code View を開き、 host.operationId 値を確認します。
値が上記の SQL Server V1 操作 ID のいずれかに一致する場合は、その操作を同等の V2 に移行する必要があります。
たとえば、 PatchItem 操作を PatchItem_V2に移行する必要があります。
Logic Apps
少なくとも 1 つの SQL Server V1 操作を含む Logic Apps の概要を取得するには:
Azure Portal を開く
プレースホルダーにサブスクリプション ID を入力し、以下のクエリを実行して、注意が必要な Logic Apps の概要と、それぞれの SQL Server V1 アクションの数を取得します。
V1 アクションで Logic Apps を識別するための Azure Resource Graph Explorer スクリプト。
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 = nameV1 トリガーを使用して Logic Apps を識別するための Azure Resource Graph Explorer スクリプト。
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
UX で V2 操作に移行する
Logic Apps と Power Automate の自動化を移行する
V1 アクションを含むロジック アプリまたは Power Automate フローを開きます。
更新する V1 アクションの直前または直後にアクションを追加します。
SQL Server コネクタをクリックし、移行するアクションと同等の V2 を探します。
V2 アクションで使用する接続を選択します。
ヒント
V2 アクションでは、Microsoft Entra ID 認証の種類がサポートされます。 Logic Apps では、Azure Logic Apps では、V2 アクションでの マネージド ID 認証 もサポートされています。
詳細については、「 認証」 セクションを参照してください。
サーバー名を入力します。
Windows AuthenticationまたはSQL Server Authenticationを使用している場合は、ドロップダウンからサーバー名を選択します。
Service principal、Microsoft Entra ID、または認証の種類Managed Identity使用している場合は、ドロップダウンの [カスタム値の入力] をクリックし、サーバー名を入力します。
ドロップダウンからデータベースを選択して、データベースを入力します。
残りのパラメーターを入力して、V1 アクションと同じになるようにします。
V1 アクションの構成が完了したら、V2 アクションを削除します。
Important
V1 アクションを削除すると、V1 のすべての動的コンテンツが削除されます。V2 動的コンテンツを再追加する必要があります。
Power Apps の移行
更新する必要があるアプリを開きます。
すべての SQL データ ソースを削除します。
注
削除されたデータ ソースを使用する数式ではエラーが表示されます。これは想定されており、次の手順で修正されます。
[設定] の [今後の機能] タブを開き、検索ボックスに「SQL」と入力します。 "拡張 Microsoft SQL Server コネクタを有効にする" 機能が表示されます。
[Enable enhanced Microsoft SQL Server connector]\(拡張 Microsoft SQL Server コネクタを有効にする\) 機能をオンにします。
注
この機能は、すべての新しい Power Apps で既定でオンになっています。
データ ソースを読み取った。
DateTime データ型を処理するテーブルに対して、アプリの動作を確認します。
アプリを保存します。
Azure Logic Apps のコード ビューを使用して操作を移行する
より複雑なシナリオでは、ワークフローの定義を更新することでアクションを移行できます。
ロジック アプリで移行する必要がある操作 (トリガーやアクション) の名前を特定します。
変更するロジック アプリのデザイナーを開き、[コード ビュー] をクリックします。
移行する必要があるアクションごとに、次の操作を行います。
- アクションまたはトリガーパスのプロパティを見つける
- path プロパティの
/datasets/default/を/v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/に置き換える。
すべての操作が更新されたら、[デザイナー] をクリックします。
すべての操作が正常に移行されたことを確認します。
- サーバー名とデータベース名には、接続の値を設定する必要があります。
- その他のパラメーターもすべて設定する必要があります。
ロジック アプリを保存してテストします。
ヒント
必要に応じて、アクションが V2 バージョンに移行されると、操作の名前と接続を更新できます。
Get 行の移行の例を次 に示します [DEPRECATED]。
[コード ビュー] を開きます。
"行の取得 [DEPRECATED]" アクションを見つけます。
"actions": { "Get_rows_[DEPRECATED]": { "inputs": { "host": { "connection": {"name": "..."}, "method": "get", "path": "/datasets/default/tables/.../items" }, "runAfter": {}, "type": "ApiConnection" } } }パスのデータセット セグメントを、上記の指定された置き換えで更新します。
"actions": { "Get_rows_[DEPRECATED]": { "inputs": { "host": { "connection": {"name": "..."}, "method": "get", "path": "/v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/tables/.../items" }, "runAfter": {}, "type": "ApiConnection" } } }[デザイナー] をクリックして最初のビューに戻り、アクションが正しく設定されたことを確認します。
フロー定義を編集して操作を移行する
ロジック アプリで移行する必要がある操作 (トリガーやアクション) の名前を特定します。
フローをパッケージ (ZIP) としてエクスポートします。
ZIP ファイルを抽出します。
ZIP が抽出されたフォルダーを開きます。
Microsoft.Flowに移動し、flowsし、次に GUID という名前のフォルダーに移動します。テキスト エディターで definition.json ファイルを開きます。
- 読みやすさを向上させるには、JSON の書式を設定します。
移行する必要があるアクションごとに、次の操作を行います。
アクションまたはトリガーのプロパティを見つける
inputs.host.operationIdプロパティを同等の V2 に更新します。 この値は、操作のドキュメントで確認できます。
次の 2 つのプロパティ
inputs.parameters追加します。-
serverwith valuedefault -
databasewith valuedefault
-
definition.json ファイルを保存する
manifest.json と Microsoft.Flow が配置されている場所に戻ります
Microsoft.Flow と manifest.jsonの両方を選択し、ZIP ファイルに圧縮します。
Important
新しい ZIP ファイルのファイルとフォルダー構造が元の ZIP ファイルとまったく同じであることを確認します。
フォルダー Microsoft.Flow と manifest.json ファイルは、新しい ZIP ファイルのルートにある 必要があります 。 同じ構造にしないと、パッケージのアップロード時にエラーが発生します。
Power Automate でフローに移動します。
パッケージをインポートして、更新されたフローをインポートします。 新しく作成した ZIP を選択し、パッケージをアップロードします。
インポートセットアップを選択し (インポート/新規作成)、フローで使用される接続を選択します。
インポートが完了したら、新しいフローまたは更新されたフローを開きます。
アクションが更新されたことを確認する
サーバー名とデータベース名には、接続の値を設定する必要があります。
その他のパラメーターもすべて設定する必要があります。
ヒント
必要に応じて、アクションが V2 バージョンに移行されると、操作の名前と接続を UX で更新できます。
SQL クエリの実行 [DEPRECATED] の移行例を次に示します。
[コード ビュー] を開きます。
"SQL クエリの実行 [DEPRECATED]" アクションを見つけます。
"actions": { "Execute_a_SQL_query_[DEPRECATED]": { // ... "inputs": { "host": { // ... "operationId": "ExecutePassThroughNativeQuery" }, "parameters": { "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42", }, // .. } } }操作 ID を V2 操作 ID と同等の値に更新し、前述のように
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", }, // .. } } }
Important
Microsoft Entra ID Integrated (Azure Commercial) 接続は、 米国政府 (GCC) 環境では既定で無効になっています。 これらの種類の接続を有効にするには、テナント管理者が Power Platform 管理センターで [Azure Commercial への接続 ] 設定を有効にする必要があります。
この設定を有効にすると、Power Platform US Government のコンプライアンス境界外でデータを操作および送信する Azure Commercial 内のリソースへの接続が可能になります。 これは、GCC クラウド バージョンの Power Platform Connectors から商用リソースへのアクセスを許可するために特に使用されます。
Microsoft Entra ID Integrated (Azure Commercial) は、米国政府 (GCC) 環境から Azure Commercial リソースに対して機能する唯一の認証の種類です。
Azure 商用認証が既定で無効になっている: 
Power Platform 管理センターの [Azure Commercial への接続 ] 設定: ![[管理] ビュー](assets/disablegsscommercialaccess-admin-view.png)
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| クライアント証明書の認証 | PFX 証明書とパスワードを使用して Microsoft Entra ID 資格情報を指定する | すべてのリージョン | 共有可能 |
| Microsoft Entra ID 統合 | Microsoft Entra ID を使用して SQL データベースにアクセスします。 | 米国政府 (GCC) を除くすべてのリージョン | 共有不可 |
| Microsoft Entra ID Integrated (Azure Commercial) | Microsoft Entra ID を使用して、Azure Commercial の SQL データベースにアクセスします。 | 米国政府 (GCC) のみ | 共有不可 |
| Microsoft Entra ID Integrated (Azure Government) | Microsoft Entra ID を使用して、Azure Government の SQL データベースにアクセスします。 | 米国政府 (GCC) のみ | 共有不可 |
| サービス プリンシパル (Microsoft Entra ID アプリケーション) | Microsoft Entra ID アプリケーションを使用して SQL データベースにアクセスします。 | すべてのリージョン | 共有可能 |
| SQL Server 認証 | アカウント名とパスワードを使用して SQL データベースにアクセスします。 | すべてのリージョン | 共有可能 |
| Windows 認証 | オンプレミスの Microsoft Entra ID アカウント名とパスワードを使用して、SQL データベースにアクセスします。 | すべてのリージョン | 共有可能 |
| Windows 認証 (非共有) | オンプレミスの Microsoft Entra ID アカウント名とパスワードを使用して、SQL データベースにアクセスします。 | すべてのリージョン | 共有不可 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 | すべてのリージョン | 共有不可 |
クライアント証明書の認証
認証 ID: certOauth
適用対象: すべてのリージョン
PFX 証明書とパスワードを使用して Microsoft Entra ID 資格情報を指定する
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Tenant | 文字列 | 正しい | |
| クライアントID | 文字列 | Microsoft Entra ID アプリケーションのクライアント ID | |
| クライアント証明書シークレット | クライアント証明書 | このアプリケーションで許可されるクライアント証明書シークレット | 正しい |
Microsoft Entra ID 統合
認証 ID: oauth
適用: 米国政府 (GCC) を除くすべてのリージョン
Microsoft Entra ID を使用して SQL データベースにアクセスします。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
Microsoft Entra ID Integrated (Azure Commercial)
認証 ID: oauthCom
適用: 米国政府 (GCC) のみ
Microsoft Entra ID を使用して、Azure Commercial の SQL データベースにアクセスします。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
Microsoft Entra ID Integrated (Azure Government)
認証 ID: oauth
適用: 米国政府 (GCC) のみ
Microsoft Entra ID を使用して、Azure Government の SQL データベースにアクセスします。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
サービス プリンシパル (Microsoft Entra ID アプリケーション)
認証 ID: oauthSP
適用対象: すべてのリージョン
Microsoft Entra ID アプリケーションを使用して SQL データベースにアクセスします。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Tenant | 文字列 | 正しい | |
| クライアントID | 文字列 | 正しい | |
| クライアント シークレット | securestring | 正しい |
SQL Server 認証
認証 ID: sqlAuthentication
適用対象: すべてのリージョン
アカウント名とパスワードを使用して SQL データベースにアクセスします。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| SQL サーバー名 | 文字列 | SQL サーバーの名前を指定します (server[:p ort]) | 正しい |
| SQL データベース名 | 文字列 | SQL データベース名 | 正しい |
| ユーザー名 | securestring | ユーザー名の資格情報 | 正しい |
| パスワード | securestring | パスワード資格情報 | 正しい |
| Gateway | gatewaySetting | オンプレミス ゲートウェイ (詳細については、 https://docs.microsoft.com/data-integration/gateway を参照してください) |
Windows 認証
認証 ID: windowsAuthentication
適用対象: すべてのリージョン
オンプレミスの Microsoft Entra ID アカウント名とパスワードを使用して、SQL データベースにアクセスします。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| SQL サーバー名 | 文字列 | SQL サーバーの名前を指定します (server[:p ort]) | 正しい |
| SQL データベース名 | 文字列 | SQL データベース名 | 正しい |
| ユーザー名 | securestring | ユーザー名の資格情報 | 正しい |
| パスワード | securestring | パスワード資格情報 | 正しい |
| Gateway | gatewaySetting | オンプレミス ゲートウェイ (詳細については、 https://docs.microsoft.com/data-integration/gateway を参照してください) | 正しい |
Windows 認証 (非共有)
認証 ID: windowsAuthenticationNonShared
適用対象: すべてのリージョン
オンプレミスの Microsoft Entra ID アカウント名とパスワードを使用して、SQL データベースにアクセスします。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| ユーザー名 | securestring | ユーザー名の資格情報 | 正しい |
| パスワード | securestring | パスワード資格情報 | 正しい |
| Gateway | gatewaySetting | オンプレミス ゲートウェイ (詳細については、 https://docs.microsoft.com/data-integration/gateway を参照してください) | 正しい |
既定 [非推奨]
適用対象: すべてのリージョン
このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| SQL サーバー名 | 文字列 | SQL サーバー名 | 正しい |
| SQL データベース名 | 文字列 | SQL データベース名 | 正しい |
| 認証の種類 | 文字列 | データベースに接続するための認証の種類 | |
| ユーザー名 | securestring | ユーザー名の資格情報 | 正しい |
| パスワード | securestring | パスワード資格情報 | 正しい |
| Gateway | gatewaySetting | オンプレミス ゲートウェイ (詳細については、 https://docs.microsoft.com/data-integration/gateway を参照してください) |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 10 秒 |
アクション
| Power Query を使用してデータを変換する |
Power Query を使用してデータを変換します。 注: この操作は、SQL Microsoft Entra ID を使用して接続する場合は機能しません。 |
| SQL クエリの実行 (V2) |
SQL クエリの実行 (V2) |
| SQL クエリの実行 [非推奨] |
このアクションは非推奨になりました。 代わりに SQL クエリの実行 (V2) を使用してください。
|
| ストアド プロシージャの実行 |
この操作では、ストアド プロシージャが実行されます。 |
| ストアド プロシージャの実行 (V2) |
この操作では、ストアド プロシージャが実行されます。 |
| テーブルの取得 (V2) |
この操作では、データベースからテーブルを取得します。 |
| 接続によって公開されるテーブルの一覧 [非推奨] |
このアクションは非推奨になりました。 代わりに 、テーブルの取得 (V2) を使用してください。
|
| 行の削除 (V2) |
この操作により、テーブルから行が削除されます。 |
| 行の削除 [非推奨] |
このアクションは非推奨になりました。 代わりに 、行の削除 (V2) を使用してください。
|
| 行の取得 (V2) |
この操作は、テーブルから行を取得します。 |
| 行の取得 (V2) |
この操作は、テーブルから行を取得します。 |
| 行の取得 [非推奨] |
このアクションは非推奨になりました。 代わりに Get 行 (V2) を使用してください。
|
| 行の取得 [非推奨] |
このアクションは非推奨になりました。 代わりに Get rows (V2) を使用してください。
|
| 行の挿入 (V2) |
この操作により、テーブルに新しい行が挿入されます。 |
| 行の挿入 [非推奨] |
このアクションは非推奨になりました。 代わりに 行の挿入 (V2) を使用してください。
|
| 行の更新 (V2) |
この操作では、テーブル内の既存の行が更新されます。 |
| 行の更新 [非推奨] |
このアクションは非推奨になりました。 代わりに Update 行 (V2) を使用してください。
|
Power Query を使用してデータを変換する
Power Query を使用してデータを変換します。 注: この操作は、SQL Microsoft Entra ID を使用して接続する場合は機能しません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
クエリ
|
query | mquery |
クエリ テキスト |
戻り値
SQL クエリの実行 (V2)
SQL クエリの実行 (V2)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
database | True | string |
データベース名 |
|
Query
|
query | True | dynamic |
クエリ本文 |
戻り値
SQL クエリの実行 [非推奨]
このアクションは非推奨になりました。 代わりに SQL クエリの実行 (V2) を使用してください。
SQL クエリを実行する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Query
|
query | True | dynamic |
クエリ本文 |
戻り値
ストアド プロシージャの実行
この操作では、ストアド プロシージャが実行されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロシージャ名
|
procedure | True | string |
ストアド プロシージャの名前 |
|
パラメーター の一覧
|
parameters | True | dynamic |
ストアド プロシージャへの入力パラメーター |
戻り値
ストアド プロシージャの実行 (V2)
この操作では、ストアド プロシージャが実行されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
database | True | string |
データベース名 |
|
プロシージャ名
|
procedure | True | string |
ストアド プロシージャの名前 |
|
パラメーター の一覧
|
parameters | True | dynamic |
ストアド プロシージャへの入力パラメーター |
戻り値
テーブルの取得 (V2)
この操作では、データベースからテーブルを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
database | True | string |
データベース名 |
戻り値
テーブルの一覧を表します。
- Body
- TablesList
接続によって公開されるテーブルの一覧 [非推奨]
このアクションは非推奨になりました。 代わりに 、テーブルの取得 (V2) を使用してください。
接続によって公開されるテーブルを一覧表示します
戻り値
テーブルの一覧を表します。
- Body
- TablesList
行の削除 (V2)
この操作により、テーブルから行が削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
database | True | string |
データベース名 |
|
テーブル名
|
table | True | string |
テーブルの名前 |
|
行 ID
|
id | True | string |
削除する行の一意識別子 |
行の削除 [非推奨]
このアクションは非推奨になりました。 代わりに 、行の削除 (V2) を使用してください。
この操作により、テーブルから行が削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
テーブルの名前 |
|
行 ID
|
id | True | string |
削除する行の一意識別子 |
行の取得 (V2)
この操作は、テーブルから行を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
database | True | string |
データベース名 |
|
テーブル名
|
table | True | string |
SQL テーブルの名前 |
|
行 ID
|
id | True | string |
取得する行の一意識別子 |
戻り値
行の取得 (V2)
この操作は、テーブルから行を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
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 Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
行の取得 [非推奨]
このアクションは非推奨になりました。 代わりに Get 行 (V2) を使用してください。
この操作は、テーブルから行を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
SQL テーブルの名前 |
|
行 ID
|
id | True | string |
取得する行の一意識別子 |
戻り値
行の取得 [非推奨]
このアクションは非推奨になりました。 代わりに 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 Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
行の挿入 (V2)
この操作により、テーブルに新しい行が挿入されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
database | True | string |
データベース名 |
|
テーブル名
|
table | True | string |
テーブルの名前 |
|
Row
|
item | True | dynamic |
指定したテーブルに挿入する行 |
戻り値
行の挿入 [非推奨]
このアクションは非推奨になりました。 代わりに 行の挿入 (V2) を使用してください。
この操作により、テーブルに新しい行が挿入されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
テーブルの名前 |
|
Row
|
item | True | dynamic |
指定したテーブルに挿入する行 |
戻り値
行の更新 (V2)
この操作では、テーブル内の既存の行が更新されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
database | True | string |
データベース名 |
|
テーブル名
|
table | True | string |
テーブルの名前 |
|
行 ID
|
id | True | string |
更新する行の一意識別子 |
|
Row
|
item | True | dynamic |
更新された値を含む行 |
戻り値
行の更新 [非推奨]
このアクションは非推奨になりました。 代わりに Update 行 (V2) を使用してください。
この操作では、テーブル内の既存の行が更新されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
テーブルの名前 |
|
行 ID
|
id | True | string |
更新する行の一意識別子 |
|
Row
|
item | True | dynamic |
更新された値を含む行 |
戻り値
トリガー
| アイテムが作成されたとき [非推奨] |
このアクションは非推奨になりました。 代わりに 、項目が作成されたとき (V2) を使用してください。
|
| アイテムが変更されたとき [非推奨] |
このアクションは非推奨になりました。 代わりに 、項目が変更されたとき (V2) を使用してください。
|
| 項目が作成されたとき (V2) |
SQL で項目が作成されたときにフローをトリガーします |
| 項目が変更されたとき (V2) |
SQL で項目が変更または挿入されたときにフローをトリガーします |
アイテムが作成されたとき [非推奨]
このアクションは非推奨になりました。 代わりに 、項目が作成されたとき (V2) を使用してください。
SQL で項目が作成されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
SQL テーブルの名前 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
アイテムが変更されたとき [非推奨]
このアクションは非推奨になりました。 代わりに 、項目が変更されたとき (V2) を使用してください。
SQL で項目が変更または挿入されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
SQL テーブルの名前 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
項目が作成されたとき (V2)
SQL で項目が作成されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
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 |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
項目が変更されたとき (V2)
SQL で項目が変更または挿入されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サーバー名
|
server | True | string |
SQL サーバーの名前 |
|
データベース名
|
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 |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
定義
表
テーブルを表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
名前
|
Name | string |
テーブルの名前。 この名前は実行時に使用されます。 |
|
DisplayName
|
DisplayName | string |
テーブルの表示名。 |
|
DynamicProperties
|
DynamicProperties | object |
コネクタによってクライアントに提供される追加のテーブル プロパティ。 |
TablesList
テーブルの一覧を表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of Table |
テーブルの一覧 |