Jupyrest （預覽版）
Jupyrest 是一項服務，可以執行具有預先定義輸入和輸出合約的筆記本。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Livesite自動化 |
| URL | https://github.com/microsoft/jupyrest |
| cosmosdbla@microsoft.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://github.com/microsoft/jupyrest |
| 隱私策略 | https://github.com/microsoft/jupyrest/blob/main/SECURITY.md |
| 類別 | 資料 |
Jupyrest 是一項服務，可以執行具有預先定義輸入和輸出合約的筆記本。
先決條件
您將需要以下內容才能使用連接器：
- Juprest 執行個體 （在客戶訂閱上安裝應用程式）
- Microsoft Entra ID 應用程式
- 這是您的 Juprest 用戶端 Microsoft Entra ID 應用程式，用於將要求提交至 Juprest 服務，當您按照上述文件建立 Juprest 執行個體時，也會提供該應用程式。
如何取得認證
在必要條件中建立的 Microsoft Entra ID 用戶端應用程式可以存取您的 Jupyrest 執行個體，而且會用來建立 Jupyrest 連接器的連線。
開始使用您的連接器
您必須輸入 Jupyrest 執行個體、Microsoft Entra ID 用戶端識別碼和用戶端密碼，才能開始使用連接器。
- 針對 Jupyrest 實例，請使用函式應用程式的 URL，例如 https://cdbkeplerprod.azurewebsites.net
- 針對 Microsoft Entra ID 用戶端識別碼和秘密，請使用必要條件中提到的 Microsoft Entra ID。
- 針對 ResourceUrl，請使用函式應用程式的 URL。 例如，https://cdbkeplerprod.azurewebsites.net
已知問題與限制
「將筆記本上傳至 Synapse」不支援上傳指定的現有筆記本執行給定 excutionId。
常見錯誤和補救措施
如有錯誤和問題，請通過以下方式聯繫 kepleruser@service.microsoft.com 我們。
FAQ
如有錯誤和問題，請通過以下方式聯繫 kepleruser@service.microsoft.com 我們。
正在建立連線
連接器支援下列驗證類型：
| 服務主體帳戶驗證 | 使用您自己的 Azure Active Directory 應用程式進行服務主體驗證。 | 所有區域 | 不可共享 |
| 預設值 [已棄用] | 此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。 | 所有區域 | 不可共享 |
服務主體帳戶驗證
驗證識別碼：oauthServicePrincipal
適用：所有地區
使用您自己的 Azure Active Directory 應用程式進行服務主體驗證。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 用戶端識別碼 | 字串 | 對 | |
| 用戶端密碼 | securestring | 對 | |
| 租戶 | 字串 | 對 | |
| ResourceUri | 字串 | 您要求授權使用的資源。 | 對 |
| Jupyrest 實例 | 字串 | 對 |
預設值 [已棄用]
適用：所有地區
此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 取得筆記本執行 |
取得筆記本執行。 |
| 執行筆記本 |
執行筆記本。 |
| 將筆記本上傳至 Synapse |
將筆記本上傳至 Synapse，指定現有的執行識別碼或一組參數。 |
取得筆記本執行
取得筆記本執行。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
執行識別碼
|
executionId | True | string |
執行識別碼 |
|
輸出
|
output | True | boolean |
如果為true，則傳回筆記本的已儲存輸出 |
|
HTML全文
|
html | True | boolean |
如果為true，則在回應中傳回html結果 |
|
報告模式
|
report | boolean |
如果為true，則傳回執行結果的報告版本（不含筆記本命令儲存格）。 |
傳回
- Notebook回應
- NotebookResponse
執行筆記本
執行筆記本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
報告模式
|
report | boolean |
如果為true，則傳回執行結果的報告版本（不含筆記本命令儲存格）。 |
|
|
parameters
|
parameters | True | dynamic |
筆記本輸入參數。 |
傳回
- Notebook回應
- NotebookResponse
將筆記本上傳至 Synapse
將筆記本上傳至 Synapse，指定現有的執行識別碼或一組參數。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
parameters
|
parameters | dynamic |
筆記本輸入參數。 |
傳回
- Synapse回應
- SynapseResponse
定義
Notebook回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string |
筆記本執行標識符 |
|
狀態
|
status | string |
筆記本執行狀態 |
|
筆記本
|
notebook | string |
筆記本名稱 |
|
parameters
|
parameters | object |
筆記本輸入參數 |
|
輸出
|
output | array of |
筆記本執行輸出結果 |
|
HTML全文
|
html | string |
筆記本 HTML 結果 |
|
開始時間
|
start_time | string |
筆記本執行開始時間 |
|
end_time
|
end_time | string |
筆記本執行結束時間 |
|
例外狀況
|
exception | string |
筆記本執行異常狀況 |
Synapse回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
url | string |
所建立筆記本的 Synapse URL。 |