SQL Server
Microsoft SQL Server是由Microsoft開發的關聯式資料庫管理系統。 連線到 SQL Server 以管理資料。 您可以對表格中的列執行各種動作,例如建立、更新、取得和刪除。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 所有 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 中此連接器的詳細資訊,請參閱 從 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 驗證的已知限制
由於目前的驗證管線限制,SQL Server 的 Microsoft Entra ID 連線不支援 Microsoft Entra ID 來賓使用者。 若要解決此問題,請改用 SQL Server 驗證或 Windows 驗證。
啟用 SQL Server 的 Microsoft Entra ID 驗證
將您的帳戶設定並佈建為 SQL Microsoft Entra ID (Microsoft Entra ID) 成員。 如需詳細資訊,請參閱 使用 Azure SQL 設定和管理 Microsoft Entra ID 驗證。
在您的 SQL Server 上,設定您的 Microsoft Entra ID 系統管理員。
- 在 Azure 入口網站中,移至您要啟用 Microsoft Entra ID 驗證的 SQL Server。
- 在 SQL Server 資源功能表的 [設定] 底下,選取 [ Microsoft Entra ID]。
- 在 [Microsoft Entra ID ] 窗格工具列上,選取 [ 設定系統管理員]。
- 在目前租用戶中尋找並選取 Microsoft Entra ID 使用者帳戶,讓他們成為伺服器系統管理員。 儲存您的變更。
在您的 Microsoft Entra ID 租用戶中,建立並註冊 Microsoft Entra ID 應用程式以存取您的 SQL 資料庫。 如需詳細資訊,請參閱 SQL Server - 設定 Microsoft Entra ID 驗證。
在 Azure 入口網站中,移至您要建立 Microsoft Entra ID 應用程式的 Microsoft Entra ID 租用戶。
在租用戶功能表的 [管理] 底下,選取 [應用程式註冊] [>新增註冊]。
在 [註冊應用程式] 窗格中,提供應用程式的名稱。 請記住此名稱,以便稍後建立使用者並授與 SQL 資料庫的角色存取權。
完成時,選取 [註冊],這會建立 Microsoft Entra ID 應用程式。
在 [ 應用程式註冊 ] 窗格中,選取新的 Microsoft Entra ID 應用程式。 在應用程式功能表上,選取 [憑證 & 密碼] [>新增用戶端密碼]。
提供密碼的描述,然後選取到期時間。
使用您設定為伺服器系統管理員之 Microsoft Entra ID 使用者帳戶認證登入您的 SQL Server 和資料庫。
在您的 SQL 資料庫中,建立自主使用者來代表 Microsoft Entra ID 應用程式。 此步驟需要 Microsoft SQL Server Management Studio (SSMS)。
下列步驟會將 和
db_datawriter的角色db_datareader指派給名稱example-Azure-AD-application-name為 的 Microsoft Entra ID 應用程式。 當您執行指定的命令時,請記得取代example-Azure-AD-application-name為 Microsoft Entra ID 應用程式的名稱,並指派您需求的必要角色。啟動 SSMS 並連線到 Microsoft Entra ID 應用程式將存取的 SQL Server。
在 [驗證] 中,使用 Active Directory - 具有 MFA 支援的通用 ,以及您設定為伺服器系統管理員的 Microsoft Entra ID 帳戶。
在 「物件總管」中,展開 「資料庫」 資料夾。
尋找您的資料庫,開啟資料庫捷徑功能表,然後選取 [ 新增查詢]。
在查詢視窗中,執行下列命令,將 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]
受控識別驗證
目前,只有 Azure Logic Apps 支援 SQL Server 連接器的 受控識別驗證 。
服務主體帳戶驗證
在邏輯應用程式上設定受控識別
在 Azure 入口網站中,移至您的邏輯應用程式資源。
啟用系統指派的身分識別或使用者指派的身分識別。 如果您沒有使用者指派的身分識別,則必須先建立該身分識別。 如需詳細資訊,請參閱 使用 Azure Logic Apps 中的受控識別驗證 Azure 資源的存取權。
如果您選取使用者指派的身分識別,請確定您已將該身分識別新增至邏輯應用程式資源。
- 在 Azure 入口網站中,流覽至您想要使用受控識別的邏輯應用程式資源。
- 在邏輯應用程式導覽功能表的 [設定] 底下,選取 [身分識別]。
- 在 [使用者指派] 索引標籤上,選取 [新增]。
- 選取要使用的受控識別,然後選取 [新增]。
設定 SQL Server 以進行受控識別驗證
在您的 SQL Server 上,設定您的 Microsoft Entra ID 系統管理員。
- 在 Azure 入口網站中,流覽至您要啟用 Microsoft Entra ID 驗證的 SQL Server。
- 在 SQL Server 資源功能表的 [設定] 底下,選取 [ Microsoft Entra ID]。
- 在 [Microsoft Entra ID ] 窗格工具列上,選取 [ 設定系統管理員]。
- 在目前租用戶中尋找並選取 Microsoft Entra ID 使用者帳戶,讓他們成為伺服器系統管理員。 儲存您的變更。
在您的 SQL 資料庫中,建立自主使用者來代表受控識別。 此步驟需要 Microsoft SQL Server Management Studio (SSMS)。
下列步驟會將 的角色
db_datareader指派給名稱example-managed-identity-name為 的受控識別。 當您執行指定的命令時,請記得取代example-managed-identity-name為受控識別的名稱,並指派符合您需求的正確角色。 例如,db_datareader無法執行寫入作業。啟動 SSMS 並連線到受控識別將存取的 SQL Server。
在 [驗證] 中,使用 Active Directory - 具有 MFA 支援的通用 ,以及您設定為伺服器系統管理員的 Microsoft Entra ID 帳戶。
在 「物件總管」中,展開 「資料庫」 資料夾。
尋找您的資料庫,開啟資料庫捷徑功能表,然後選取 [ 新增查詢]。
在查詢視窗中,執行下列命令,將受控識別連結至資料庫中的新使用者:
CREATE USER [example-managed-identity-name] FROM EXTERNAL PROVIDER清除查詢視窗。 然後,執行下列命令,將角色指派給管理身分:
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 Logic Apps 中的受控識別來驗證對 Azure 資源的存取權
- 教學課程:使用 Windows VM 系統指派的受控識別來存取 Azure SQL
- 使用 Azure SQL 設定和管理 Microsoft Entra ID 驗證
- 資料庫層級角色
- 伺服器層級角色
虛擬網路支援
在連到虛擬網路的 Power Platform 環境中使用連接器時,存在以下限制:
下列動作是唯一支援的動作:
此清單之外的任何動作都會傳回「403 未授權」錯誤
不支援內部部署資料閘道
使用 Microsoft Entra ID 整合式驗證時,請手動輸入資料庫名稱作為自訂值
動作的已知問題和限制
| 簡短描述 | Operations | 完整描述 |
|---|---|---|
| 在動作輸出中取得確定性結果 | 取得資料列 (V2) | 建議使用參數 Order By ,以便在動作輸出中取得確定性結果。 如果未指定,SQL Order By Server 預設會使用主索引鍵或唯一索引鍵。 非決定性結果可能會導致問題,例如在啟用分頁時複製動作輸出中的記錄。 SQL 檢視不支援主索引鍵,這是 SQL Server 本身的限制。 |
| 執行 SQL 查詢的有限支援 | 執行 SQL 查詢 (V2) | 內部部署 SQL Server 不支援。 |
| 一般 CRUD 需求 |
取得列 (V2) 取得資料列 (V2) 更新列 (V2) 刪除列 (V2) |
在使用 Azure SQL 執行個體的情況下,將會修剪字串值。 因此,空白字串將轉換為空字串。 對於 INSERT 和 UPDATE 作業,連接器會傳回更新的資料列。 這需要連線也需要具有從 SQL Server 讀取資料的權限。 下列作業需要主索引鍵: - 取得項目 - 修補項目 - 刪除項目 |
| 彙總轉換參數支援 | 取得資料列 (V2) | 僅支援下列彙總轉換: - filter:允許過濾輸入集。 支援與 $filter相同的運算式。 範例: filter(ColName1 eq 1).- aggregate:允許使用下列其中一種方法進行彙總: average、、maxmin、sumcountdistinct。 範例: 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 運算子時,所有傳入的值都需要單獨定義,而不是作為包含多個逗號分隔值的單一形式參數。 範例: SELECT * FROM tableName WHERE columnName IN (@formalParameterA, @formalParameterB, @formalParameterC). |
| 使用 Azure Sql DataWareHouse DB 失敗 | 插入列 (V2) | 在 Power Apps 中使用 Azure SQL 資料倉儲資料庫會導致失敗,因為連接器在資料庫上執行時語法不相符。 請在 Power Automate 中使用 Azure SQL 資料倉儲連接器建立流程、從 PowerApps 觸發流程,或形成查詢並在 執行 SQL 查詢 (V2) 動作中使用它。 |
觸發程式的已知問題和限制
備註
關閉和開啟流程不會重設觸發狀態。
| 簡短描述 | Operations | 完整描述 |
|---|---|---|
| 修改項目:列作業 | 修改項目時 (V2) | 在 INSERT 和 UPDATE 列作業上引發。 |
| 修改項目:欄需求 | 修改項目時 (V2) | 需要 ROWVERSION 資料行。 |
| 建立項目:欄需求 | 建立項目時 (V2) | 需要 IDENTITY 直欄。 |
| 建立項目 | 建立項目時 (V2) | 使用最新插入的資料列的身分資料行值作為臨界值 (觸發程式狀態),以稍後識別新插入的資料列。 邏輯假設每個新列的標識都必須大於前一個行。 因此,如果由於明確的 t-sql 命令或資料表截斷而重設資料表的身分識別順序,觸發程式邏輯會略過現有流程的新資料列。 有兩種不同的因應措施:首先,您可以透過更新觸發動作卡 (例如,重新命名、更新參數或新增連線) 來重設流程觸發狀態,並儲存變更。 或者,您可以使用 下列方法還原目標資料表身分序列。 |
一般已知問題與限制
如果您在資料表上定義了 SQL 伺服器端觸發程序,則插入和更新資料表將無法運作。
若要解決此問題,您有下列選項:
- 使用預存程序或原生查詢。
- 從 SQL 資料表中移除觸發程式。
下列限制適用於將 SQL 連接器與內部部署 SQL Server 搭配使用:
- 內部部署 SQL Server 支援的最低版本是 SQL Server 2005。
- 透過內部部署 SQL Server 的要求大小限制為 2 MB。
- 透過內部部署 SQL Server 的回應大小限制為 8 MB。
下列限制適用於透過閘道在內部部署 SQL Server 上叫用預存程序:
- 不會傳回參數的
OUTPUT輸出值。 您仍然可以指定參數的OUTPUT輸入值。 - ResultSets 值為 Untyped。
- 傳回值無法使用。
- 只會傳回第一個結果集。
- 結果集不支援 Dynamics 結構描述。
- 不會傳回參數的
下列資料類型無法作為查詢選項述詞:
datedatetimedatetime2smalldatetime
不支援設定強制加密。 根據預設,SQL Database 和 SQL 受控執行個體會使用傳輸層安全性 (TLS) 加密動態中的資料,以保護客戶資料。 如需詳細資訊,請參閱 Azure SQL 安全性概觀。
目前,SQL 原生查詢執行的多個結果集支援受到限制。 只會傳回結果集,直到第一個空白的結果集為止。
若要解決此問題,請使用預存程序。
執行 SQL 查詢和預存程序之後,結果集結構描述應該包含唯一的非空資料行名稱。
對於預存程序內傳回一組結果的任何作業,例如任何內部
SELECT陳述式,結果集結構描述應該包含唯一的非空資料行名稱。如果 SQL 查詢或預存程序的執行時間超過 110 秒,動作將會逾時。
在 Azure Logic Apps 中,若要解決此限制並瞭解如何執行長時間執行的預存程序,請參閱 Logic Apps 中長時間執行的 SQL 預存程序。
在 Azure Logic Apps 中,您只能從整合服務環境 (ISE) 內存取 SQL Server 上的私人端點。 如需詳細資訊,請參閱 存取 Azure 虛擬網路。
建立具有許多篩選條件的查詢時,可能會發生下列錯誤:「OData 查詢語法樹狀結構已超過節點計數限制 '100'。 請嘗試簡化 OData 查詢參數運算式」。 若要避免此問題,請最佳化篩選條件以減少其數量(例如,使用範圍)。
不建議在目標表格欄位(e.g. xml或文字資料類型)中儲存大量資料(超過 30 MB)。 它可能會導致動作和觸發程式的效能大幅下降,導致 504 逾時錯誤。 請使用「選擇查詢」參數僅包含相對較小的欄位,並避免產生較大的輸出資料欄位。 或者,請改用特製化的檔案儲存體,例如 Azure Blob 儲存體。
由於缺乏 OUTPUT 子句支援,Azure Synapse 來源不支援 CRUD 作業。 強烈建議您改用專用的 Azure SQL 資料倉儲 連接器。
Power Platform 和 Logic Apps 導覽器檢視的清單大小限制為 10,000 個資料表。
不支援不符合 OData 標準識別碼 的資料庫結構描述 (以數字開頭的資料行名稱、包含代理配對字元等) 。 客戶可以使用 View 來抽象化資料行的名稱,也可以使用 SQL 擴充屬性來處理補充平面字元的使用,讓它們與資料庫結構描述分開,請參閱: 將擴充屬性新增至資料表中的資料行。
使用 SQL 連接器作為虛擬表格的資料來源時,伺服器和資料庫值必須在來源資料集與所使用的連線之間相符。 使用 SQL 驗證時,資料集值可以設定為 default,default,因為連線已經包含伺服器和資料庫值。 如果明確說明資料集連線值,則它們必須符合連線的值,否則會出現錯誤,例如「發生問題。 我們無法打開您的桌子。 嘗試重新載入或重新開啟」或「無效資料來源」可能會發生。
當 Power Automate 流程中使用的檢視發生結構描述變更時,觸發程序可能不會觸發,直到針對更新的檢視建立新連線為止 - 僅重新整理連線不足以針對更新的檢視重設觸發程序。
SQL 連接器目前不支援表格式資料串流 (TDS) 通訊協定 8.0。
特殊節流限制
在不同情況下,SQL 連接器有不同的節流限制。 在下表中, 原生 作業包括 SQL 預存程序和 SQL 查詢。 CRUD 代表建立、讀取、更新和刪除操作。
除了下列限制之外,connectionID 層級節流也會根據先前請求在指定時段內花費的總時間來套用。
| 服務 | 環境 | Operations | 名稱 | Calls | 續訂週期(秒) |
|---|---|---|---|---|---|
| 邏輯應用程式和 Power Automate | 共享環境 | Native | 每個連線的 API 呼叫 | 500 | 10 |
| 邏輯應用程式和 Power Automate | 共享環境 | CRUD | 每個連線的 API 呼叫 | 100 | 10 |
| 邏輯應用程式和 Power Automate | 共享環境 | Native | 每個連線的並發呼叫 | 200 | - |
| 邏輯應用程式和 Power Automate | 共享環境 | CRUD | 每個連線的並發呼叫 | 125 | - |
| Power Apps | 共享環境 | 全部 | 每個使用者的 API 呼叫 | 300 | 30 |
| Power Apps | 共享環境 | 全部 | 每個連線的並發呼叫 | 125 | - |
備註
並發呼叫是特定連線可以發出的進行中請求數。 例如,使用 Azure Logic Apps 原生呼叫時,單一連線可以進行 200 個並行呼叫。 如果所有 200 個呼叫仍在執行中,任何後續呼叫都會傳回 429 錯誤。 不存在時間限制,因為呼叫可能需要任意時間。 不過,呼叫限制的重點是防止單一連線產生太多長時間執行的查詢,並對其他連線產生負面影響。
例如,如果連線同時進行 200 個呼叫,且每個呼叫需要 50 秒才能執行,則所有其他呼叫都會失敗,並在接下來的 50 秒內出現 429 錯誤。 在一或多個查詢完成執行並傳回結果之後,會處理任何後續呼叫。
Power Apps 資料類型對應
請參閱 Power Apps SQL 檔
Power Apps 函式和作業可委派至 SQL Server
請參閱 Power Apps SQL 委派檔
操作中的形式參數
執行 SQL 查詢 [已棄用] 和 執行 SQL 查詢 (V2) 動作允許使用正式參數。 它們定義為索引鍵值組,其中 key 是參數名稱, value 是 SQL 資料類型,例如 INT 或 NVARCHAR(255)。 定義名稱和資料類型之後,會顯示值的新輸入欄位。
請將 V1 作業轉換至功能等效的 V2 作業
請遵循此處的步驟,從 V1 作業移轉至其 V2 對等作業。
這很重要
開始移轉之前, 請務必 儲存邏輯應用程式、Power Automate 流程或 Power App 的複本,以進行備份。
備註
所有 V2 作業都有兩個額外的參數: Server Name、 和 Database Name。 這可讓 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 作業識別碼,則必須將該作業移轉至其 V2 對等專案。
例如, PatchItem 操作需要遷移到 PatchItem_V2。
Logic Apps
若要取得包含至少一個 SQL Server V1 作業之 Logic Apps 概觀:
開啟 Azure 入口網站
在預留位置中輸入您的訂用帳戶識別碼,然後執行下列查詢,以取得需要您注意的邏輯應用程式摘要,以及每個 Logic Apps 中的 SQL Server V1 動作計數。
Azure Resource Graph 總管 腳本,以識別具有 V1 動作的邏輯應用程式。
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 = nameAzure Resource Graph 總管 腳本,以識別具有 V1 觸發程序的邏輯應用程式。
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 作業
移轉邏輯應用程式和 Power Automate 自動化
開啟包含 V1 動作的邏輯應用程式或 Power Automate 流程。
在您要更新的 V1 動作之前或之後新增動作。
按一下 SQL Server 連接器,然後尋找與要移轉之動作相當的 V2。
選取要在 V2 動作上使用的連線。
輸入伺服器名稱。
如果您使用
Windows Authentication或SQL Server Authentication,則從下拉式清單中選取伺服器名稱。
如果您使用的
Service principal是 或Microsoft Entra IDManaged Identity驗證類型,請按一下下拉式清單中的「輸入自訂值」,然後輸入您的伺服器名稱。
從下拉式清單中選取資料庫,以輸入資料庫。
輸入其餘參數,使其與 V1 動作相同。
完成設定 V1 動作之後,請刪除 V2 動作。
這很重要
刪除 V1 動作會導致刪除 V1 中的所有動態內容;V2 動態內容將需要重新新增。
移轉 Power Apps
開啟需要更新的應用程式。
刪除所有 SQL 資料來源。
備註
使用已刪除資料來源的公式會顯示錯誤,這是預期的錯誤,並將在後續步驟中修正。
開啟「設定」上的「即將推出的功能」標籤,然後在搜尋框中輸入「SQL」。 「啟用增強型 Microsoft SQL Server 連接器」功能將會出現。
開啟「啟用增強型 Microsoft SQL Server 連接器」功能。
備註
預設情況下,此功能對所有新的 Power Apps 都處於開啟狀態。
重新新增資料來源。
驗證應用程式行為,特別是在處理日期時間資料類型的資料表上。
儲存應用程式。
透過 Azure Logic Apps 中的程式碼檢視移轉作業
對於更複雜的案例,可以透過更新工作流程的定義來移轉動作。
識別需要在邏輯應用程式中移轉的作業 (觸發程序和/或動作) 名稱。
開啟要修改的邏輯應用程式設計工具,然後按一下 [程式碼檢視]。
針對需要移轉的每個動作:
- 尋找動作或觸發程式路徑屬性
- 在路徑屬性中以
/datasets/default/取代/v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/。
更新所有操作後,單擊“設計器”。
確認所有作業都已成功移轉。
- 伺服器和資料庫名稱應該填入連線的值。
- 所有其他參數也應該移入。
儲存並測試邏輯應用程式。
小提示
如有需要,一旦動作移轉至 V2 版本,就可以更新作業的名稱和連線。
以下是移轉 Get 資料列 [已棄用] 的範例。
開啟「程式碼檢視」。
尋找「取得資料列 [已取代]」動作。
"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 的資料夾。
導覽至 ,然後
flows,然後導覽至Microsoft.FlowGUID 具名資料夾。在文字編輯器中開啟 definition.json 檔案。
- 若要改善可讀性,請格式化 JSON。
針對需要移轉的每個動作:
尋找動作或觸發程式屬性
Update
inputs.host.operationId屬性為 V2 對等專案。 您可以在作業的檔中找到值。
新增至
inputs.parameters兩個屬性:-
server有價值default -
database有價值default
-
儲存 definition.json 檔案
導覽回 manifest.json 和 Microsoft.Flow 所在的位置
選取 Microsoft.Flow 和 manifest.json,然後壓縮為 ZIP 檔案。
這很重要
請確定新的 ZIP 檔案具有與原始 ZIP 檔案完全相同的檔案和資料夾結構。
資料夾 Microsoft.Flow 和檔案 manifest.json 必須位於新 ZIP 檔案的根目錄。 如果無法具有相同的結構,則上傳套件時會導致錯誤。
瀏覽至 Power Automate 上的流程。
匯入套件,匯入更新的流程。 選取新建立的 ZIP,然後上傳套件。
選取匯入設定 (匯入/建立新設定),然後選取流程將使用的連線。
匯入完成後,請開啟新的/更新的流程。
確認動作已更新
伺服器和資料庫名稱應該填入連線的值。
所有其他參數也應該移入。
小提示
如有需要,一旦動作移轉至 V2 版本,就可以在 UX 上更新作業的名稱和連線。
以下是移轉執行 SQL 查詢 [已棄用] 的範例。
開啟「程式碼檢視」。
尋找「執行 SQL 查詢 [已棄用]」動作。
"actions": { "Execute_a_SQL_query_[DEPRECATED]": { // ... "inputs": { "host": { // ... "operationId": "ExecutePassThroughNativeQuery" }, "parameters": { "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42", }, // .. } } }使用 V2 作業 ID 等效來更新作業 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", }, // .. } } }
這很重要
Microsoft Entra ID 整合 (Azure 商業) 連線預設會在美國 政府 (GCC) 環境中停用。 若要啟用這些類型的連線,租用戶管理員必須在 Power Platform 系統管理中心啟用連線 至 Azure 商業設定 。
開啟此設定可連線至 Azure 商業中資源,這些資源會在 Power Platform 美國政府合規性界限之外運作和傳送資料。 這專門用於允許從 Power Platform 連接器的 GCC 雲端版本存取商業資源。
Microsoft Entra ID 整合 (Azure 商業) 是唯一適用於從美國政府 (GCC) 環境到 Azure 商業資源的驗證類型。
預設已停用 Azure 商業驗證: 
Power Platform 系統管理中心中的 連線至 Azure 商業 設定: 
正在建立連線
連接器支援下列驗證類型:
| 用戶端憑證驗證 | 使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證 | 所有區域 | 可共用 |
| Microsoft Entra ID 整合式 | 使用 Microsoft Entra ID 來存取您的 SQL 資料庫。 | 除美國政府 (GCC) 之外的所有區域 | 不可共享 |
| Microsoft Entra ID 整合式 (Azure 商業版) | 使用 Microsoft Entra ID 存取 Azure 商業版中的 SQL 資料庫。 | 僅限美國政府 (GCC) | 不可共享 |
| Microsoft Entra ID 整合式 (Azure 政府) | 使用 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 App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 租戶 | 字串 | 對 | |
| 用戶端識別碼 | 字串 | Microsoft Entra ID 應用程式的用戶端識別碼 | |
| 用戶端憑證密碼 | 客戶憑證 | 此應用程式允許的用戶端憑證密碼 | 對 |
Microsoft Entra ID 整合
驗證 ID:oauth
適用:除美國政府 (GCC) 之外的所有地區
使用 Microsoft Entra ID 來存取您的 SQL 資料庫。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
Microsoft Entra ID 整合式 (Azure 商業版)
驗證 ID:oauthCom
適用:僅限美國政府 (GCC)
使用 Microsoft Entra ID 存取 Azure 商業版中的 SQL 資料庫。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
Microsoft Entra ID 整合式 (Azure 政府)
驗證 ID:oauth
適用:僅限美國政府 (GCC)
使用 Microsoft Entra ID 存取 Azure Government 中的 SQL 資料庫。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
服務主體 (Microsoft Entra ID 應用程式)
驗證 ID:oauthSP
適用:所有地區
使用 Microsoft Entra ID 應用程式來存取您的 SQL 資料庫。
這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 租戶 | 字串 | 對 | |
| 用戶端識別碼 | 字串 | 對 | |
| 用戶端密碼 | securestring | 對 |
SQL Server 驗證
驗證識別碼:sqlAuthentication
適用:所有地區
使用帳戶名稱和密碼來存取您的 SQL 資料庫。
這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| SQL Server 名稱 | 字串 | 指定 SQL Server 的名稱 (server[:p ort]) | 對 |
| SQL 資料庫名稱 | 字串 | SQL 資料庫名稱 | 對 |
| 用戶名稱 | securestring | 使用者名稱認證 | 對 |
| 密碼 | securestring | 密碼認證 | 對 |
| Gateway | 閘道設定 | 內部部署閘道 (請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料 |
Windows 驗證
驗證識別碼:windowsAuthentication
適用:所有地區
使用內部部署 Microsoft Entra ID 帳戶名稱和密碼來存取您的 SQL 資料庫。
這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| SQL Server 名稱 | 字串 | 指定 SQL Server 的名稱 (server[:p ort]) | 對 |
| SQL 資料庫名稱 | 字串 | SQL 資料庫名稱 | 對 |
| 用戶名稱 | securestring | 使用者名稱認證 | 對 |
| 密碼 | securestring | 密碼認證 | 對 |
| Gateway | 閘道設定 | 內部部署閘道 (請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料 | 對 |
Windows 驗證 (非共用)
驗證識別碼:windowsAuthenticationNonShared
適用:所有地區
使用內部部署 Microsoft Entra ID 帳戶名稱和密碼來存取您的 SQL 資料庫。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 用戶名稱 | securestring | 使用者名稱認證 | 對 |
| 密碼 | securestring | 密碼認證 | 對 |
| Gateway | 閘道設定 | 內部部署閘道 (請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料 | 對 |
預設值 [已棄用]
適用:所有地區
此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| SQL Server 名稱 | 字串 | SQL Server 名稱 | 對 |
| SQL 資料庫名稱 | 字串 | SQL 資料庫名稱 | 對 |
| 驗證類型 | 字串 | 連線至資料庫的驗證類型 | |
| 用戶名稱 | securestring | 使用者名稱認證 | 對 |
| 密碼 | securestring | 密碼認證 | 對 |
| Gateway | 閘道設定 | 內部部署閘道 (請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 10 秒 |
動作
| 使用 Power Query 轉換資料 |
使用 Power Query 轉換資料。 附註: 使用 SQL Microsoft Entra ID 連線時,此作業無法運作。 |
| 列出連線所公開的資料表 [已淘汰] |
此動作已被取代。 請改用 Get tables (V2)。
|
| 刪除列 [已棄用] |
此動作已被取代。 請改用刪除列 (V2)。
|
| 刪除列 (V2) |
此作業會從資料表中刪除資料列。 |
| 取得列 (V2) |
此作業會從資料表取得資料列。 |
| 取得資料列 [已棄用] |
此動作已被取代。 請改用 Get 列 (V2)。
|
| 取得資料列 [已淘汰] |
此動作已被取代。 請改用 取得資料列 (V2)。
|
| 取得資料列 (V2) |
此作業會從資料表取得資料列。 |
| 取得資料表 (V2) |
此作業會從資料庫取得資料表。 |
| 執行 SQL 查詢 [已棄用] |
此動作已被取代。 請改用執行 SQL 查詢 (V2)。
|
| 執行 SQL 查詢 (V2) |
執行 SQL 查詢 (V2) |
| 執行預存程序 |
此作業會執行預存程式。 |
| 執行預存程序 (V2) |
此作業會執行預存程式。 |
| 插入列 [已棄用] |
此動作已被取代。 請改用插入行 (V2)。
|
| 插入列 (V2) |
此作業會在表格中插入新資料列。 |
| 更新列 [已棄用] |
此動作已被取代。 請改用更新列 (V2)。
|
| 更新列 (V2) |
此作業會更新資料表中的現有資料列。 |
使用 Power Query 轉換資料
使用 Power Query 轉換資料。 附註: 使用 SQL Microsoft Entra ID 連線時,此作業無法運作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
查詢
|
query | mquery |
查詢文字 |
傳回
列出連線所公開的資料表 [已淘汰]
刪除列 [已棄用]
此動作已被取代。 請改用刪除列 (V2)。
此作業會從資料表中刪除資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
表格名稱 |
|
資料列識別碼
|
id | True | string |
要刪除之列的唯一識別碼 |
刪除列 (V2)
此作業會從資料表中刪除資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
server | True | string |
SQL Server 的名稱 |
|
資料庫名稱
|
database | True | string |
資料庫名稱 |
|
資料表名稱
|
table | True | string |
表格名稱 |
|
資料列識別碼
|
id | True | string |
要刪除之列的唯一識別碼 |
取得列 (V2)
此作業會從資料表取得資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
server | True | string |
SQL Server 的名稱 |
|
資料庫名稱
|
database | True | string |
資料庫名稱 |
|
資料表名稱
|
table | True | string |
SQL 資料表的名稱 |
|
資料列識別碼
|
id | True | string |
要擷取之資料列的唯一識別碼 |
傳回
取得資料列 [已棄用]
此動作已被取代。 請改用 Get 列 (V2)。
此作業會從資料表取得資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
SQL 資料表的名稱 |
|
資料列識別碼
|
id | True | string |
要擷取之資料列的唯一識別碼 |
傳回
取得資料列 [已淘汰]
此動作已被取代。 請改用 取得資料列 (V2)。
此作業會從資料表取得資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
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 |
要從項目擷取的特定欄位(預設值 = all)。 |
傳回
取得資料列 (V2)
此作業會從資料表取得資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
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 |
要從項目擷取的特定欄位(預設值 = all)。 |
傳回
取得資料表 (V2)
此作業會從資料庫取得資料表。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
server | True | string |
SQL Server 的名稱 |
|
資料庫名稱
|
database | True | string |
資料庫名稱 |
傳回
代表表格清單。
- 身體
- TablesList
執行 SQL 查詢 [已棄用]
此動作已被取代。 請改用執行 SQL 查詢 (V2)。
執行 SQL 查詢
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Query
|
query | True | dynamic |
查詢內文 |
傳回
執行 SQL 查詢 (V2)
執行 SQL 查詢 (V2)
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
server | True | string |
SQL Server 的名稱 |
|
資料庫名稱
|
database | True | string |
資料庫名稱 |
|
Query
|
query | True | dynamic |
查詢內文 |
傳回
執行預存程序
此作業會執行預存程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
程序名稱
|
procedure | True | string |
預存程序的名稱 |
|
參數清單
|
parameters | True | dynamic |
預存程序的輸入參數 |
傳回
執行預存程序 (V2)
此作業會執行預存程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
server | True | string |
SQL Server 的名稱 |
|
資料庫名稱
|
database | True | string |
資料庫名稱 |
|
程序名稱
|
procedure | True | string |
預存程序的名稱 |
|
參數清單
|
parameters | True | dynamic |
預存程序的輸入參數 |
傳回
插入列 [已棄用]
此動作已被取代。 請改用插入行 (V2)。
此作業會在表格中插入新資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
表格名稱 |
|
Row
|
item | True | dynamic |
要插入指定表格的列 |
傳回
插入列 (V2)
此作業會在表格中插入新資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
server | True | string |
SQL Server 的名稱 |
|
資料庫名稱
|
database | True | string |
資料庫名稱 |
|
資料表名稱
|
table | True | string |
表格名稱 |
|
Row
|
item | True | dynamic |
要插入指定表格的列 |
傳回
更新列 [已棄用]
此動作已被取代。 請改用更新列 (V2)。
此作業會更新資料表中的現有資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
表格名稱 |
|
資料列識別碼
|
id | True | string |
要更新之列的唯一識別碼 |
|
Row
|
item | True | dynamic |
具有更新值的資料列 |
傳回
更新列 (V2)
此作業會更新資料表中的現有資料列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
server | True | string |
SQL Server 的名稱 |
|
資料庫名稱
|
database | True | string |
資料庫名稱 |
|
資料表名稱
|
table | True | string |
表格名稱 |
|
資料列識別碼
|
id | True | string |
要更新之列的唯一識別碼 |
|
Row
|
item | True | dynamic |
具有更新值的資料列 |
傳回
觸發程序
| 修改項目時 [已棄用] |
此動作已被取代。 請改用修改項目時 (V2)。
|
| 修改項目時 (V2) |
在 SQL 中修改/插入項目時觸發流程 |
| 建立項目時 [已棄用] |
此動作已被取代。 請改用建立項目時 (V2)。
|
| 建立項目時 (V2) |
在 SQL 中建立項目時觸發流程 |
修改項目時 [已棄用]
此動作已被取代。 請改用修改項目時 (V2)。
在 SQL 中修改/插入項目時觸發流程
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
SQL 資料表的名稱 |
|
篩選查詢
|
$filter | string |
ODATA 篩選查詢,以限制傳回的專案 (例如 stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
最高計數
|
$top | integer |
要擷取的項目總數 (預設值 = 全部)。 |
|
|
排序方式
|
$orderby | string |
ODATA orderBy 查詢,用於指定項目順序。 |
|
|
選取查詢
|
$select | string |
要從項目擷取的特定欄位(預設值 = all)。 |
傳回
修改項目時 (V2)
在 SQL 中修改/插入項目時觸發流程
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
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 |
要從項目擷取的特定欄位(預設值 = all)。 |
傳回
建立項目時 [已棄用]
此動作已被取代。 請改用建立項目時 (V2)。
在 SQL 中建立項目時觸發流程
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
SQL 資料表的名稱 |
|
篩選查詢
|
$filter | string |
ODATA 篩選查詢,以限制傳回的專案 (例如 stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
最高計數
|
$top | integer |
要擷取的項目總數 (預設值 = 全部)。 |
|
|
排序方式
|
$orderby | string |
ODATA orderBy 查詢,用於指定項目順序。 |
|
|
選取查詢
|
$select | string |
要從項目擷取的特定欄位(預設值 = all)。 |
傳回
建立項目時 (V2)
在 SQL 中建立項目時觸發流程
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
伺服器名稱
|
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 |
要從項目擷取的特定欄位(預設值 = all)。 |
傳回
定義
Table
代表一個表格。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
Name | string |
數據表的名稱。 該名稱在運行時使用。 |
|
顯示名稱
|
DisplayName | string |
資料表的顯示名稱。 |
|
動態屬性
|
DynamicProperties | object |
連接器提供給用戶端的其他資料表屬性。 |
表格清單
代表表格清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of Table |
表格列表 |