Jupyrest
Jupyrestは、事前定義された入力および出力コントラクトを使用してノートブックを実行できるサービスです。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | LivesiteAutomation |
| [URL] | https://github.com/microsoft/jupyrest |
| メール | cosmosdbla@microsoft.com |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://github.com/microsoft/jupyrest |
| プライバシー ポリシー | https://github.com/microsoft/jupyrest/blob/main/SECURITY.md |
| カテゴリー | 日付 |
Jupyrestは、事前定義された入力および出力コントラクトを使用してノートブックを実行できるサービスです。
前提条件
コネクタを使用するには、次を使用する必要があります。
- Juprest インスタンス (顧客サブスクリプションでのアプリのインストール)
- Azure Active Directory アプリケーション
- これは、Juprest サービスにリクエストを送信するための Juprest クライアント AAD アプリです。これは、上記のドキュメントに従って Juprest インスタンスを作成するときにも提供されます。
資格情報の入手方法
前提条件で作成された AAD クライアント アプリは、Jupyrest インスタンスにアクセスでき、Jupyrest コネクタの接続を作成するために使用されます。
コネクタの使用を開始する
コネクタの使用を開始するには、Jupyrest インスタンス、AAD クライアント ID、およびクライアント シークレットを入力する必要があります。
- Jupyrest インスタンスの場合は、次のような関数アプリの URL を使用します: https://cdbkeplerprod.azurewebsites.net
- AAD クライアント ID とシークレットの場合は、前提条件で説明されている AAD を使用します。
- ResourceUrl の場合は、関数アプリの URL を使用します。 例: https://cdbkeplerprod.azurewebsites.net
既知の問題と制限事項
"Synapse へのノートブックのアップロード" では、executionId を指定した既存のノートブック実行のアップロードはサポートされていません。
一般的なエラーと解決策
エラーや質問がある場合は、kepleruser@service.microsoft.com からお問い合わせください。
よくあるご質問
エラーや質問がある場合は、kepleruser@service.microsoft.com からお問い合わせください。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| サービス プリンシパル認証 | サービス プリンシパル認証にお使いの Azure Active Directory アプリを使用します。 | すべての地域 | 共有不可 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 | すべての地域 | 共有不可 |
サービス プリンシパル認証
認証 ID: oauthServicePrincipal
適用可能: すべての領域
サービス プリンシパル認証にお使いの Azure Active Directory アプリを使用します。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 説明設定 | Required |
|---|---|---|---|
| Client ID | string | True | |
| Client Secret | securestring | True | |
| テナント | string | True | |
| ResourceUri | string | 使用認可を要求するリソース。 | True |
| Jupyrest インスタンス | string | True |
既定 [非推奨]
適用可能: すべての領域
このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| Synapse へのノートブックのアップロード |
既存の実行 Id またはパラメーターのセットを指定して、ノートブックを Synapse にアップロードします。 |
| ノートブックの実行 |
ノートブックを実行します。 |
| ノートブックの実行の取得 |
ノートブックの実行を取得します。 |
Synapse へのノートブックのアップロード
既存の実行 Id またはパラメーターのセットを指定して、ノートブックを Synapse にアップロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
parameters
|
parameters | dynamic |
ノートブック入力パラメーター。 |
戻り値
- SynapseResponse
- SynapseResponse
ノートブックの実行
ノートブックを実行します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
report mode
|
report | boolean |
true の場合、実行結果のレポート バージョンを返します (ノートブックのコマンド セルは含まれません)。 |
|
|
parameters
|
parameters | True | dynamic |
ノートブック入力パラメーター。 |
戻り値
- NotebookResponse
- NotebookResponse
ノートブックの実行の取得
ノートブックの実行を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
executionId
|
executionId | True | string |
実行 Id |
|
output
|
output | True | boolean |
true の場合、ノートブックの保存された出力を返します |
|
HTML
|
html | True | boolean |
true の場合、応答で HTML 結果を返します |
|
report mode
|
report | boolean |
true の場合、実行結果のレポート バージョンを返します (ノートブックのコマンド セルは含まれません)。 |
戻り値
- NotebookResponse
- NotebookResponse
定義
NotebookResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | string |
ノートブック実行 id |
|
ステータス
|
status | string |
ノートブック実行ステータス |
|
notebook
|
notebook | string |
ノートブック名 |
|
parameters
|
parameters | object |
ノートブック入力パラメーター |
|
output
|
output | array of |
ノートブック実行の出力結果 |
|
HTML
|
html | string |
ノートブックの HTML 結果 |
|
start_time
|
start_time | string |
ノートブック実行の開始時刻 |
|
end_time
|
end_time | string |
ノートブック実行の終了時刻 |
|
例外
|
exception | string |
ノートブック実行例外 |
SynapseResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
url | string |
作成されたノートブックの Synapse URL。 |