Jupyrest(미리 보기)
Jupyrest는 미리 정의된 입력 및 출력 계약을 사용하여 Notebook을 실행할 수 있는 서비스입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | LivesiteAutomation |
| URL | https://github.com/microsoft/jupyrest |
| 전자 메일 | cosmosdbla@microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://github.com/microsoft/jupyrest |
| 개인 정보 보호 정책 | https://github.com/microsoft/jupyrest/blob/main/SECURITY.md |
| 카테고리 | 데이터 |
Jupyrest는 미리 정의된 입력 및 출력 계약을 사용하여 Notebook을 실행할 수 있는 서비스입니다.
필수 조건
커넥터를 사용하려면 다음이 필요합니다.
- Juprest 인스턴스(고객 구독에 앱 설치)
- Microsoft Entra ID 애플리케이션
- Juprest 서비스에 요청을 제출하기 위한 Juprest 클라이언트 Microsoft Entra ID 앱이며, 위의 문서에 따라 Juprest 인스턴스를 만들 때도 제공됩니다.
자격 증명을 가져오는 방법
필수 구성 요소에서 만든 Microsoft Entra ID 클라이언트 앱은 Jupyrest 인스턴스에 액세스할 수 있으며 Jupyrest 커넥터의 연결을 만드는 데 사용됩니다.
커넥터 시작
커넥터 사용을 시작하려면 Jupyrest 인스턴스, Microsoft Entra ID 클라이언트 ID 및 클라이언트 암호를 입력해야 합니다.
- Jupyrest 인스턴스의 경우 다음과 같이 함수 앱의 URL을 사용합니다. https://cdbkeplerprod.azurewebsites.net
- Microsoft Entra ID 클라이언트 ID 및 비밀의 경우 필수 구성 요소에 언급된 Microsoft Entra ID를 사용합니다.
- ResourceUrl의 경우 함수 앱의 URL을 사용합니다. 예: https://cdbkeplerprod.azurewebsites.net
알려진 문제 및 제한 사항
excutionId가 지정된 경우 "Synapse에 Notebook 업로드"는 기존 Notebook 실행 업로드를 지원하지 않습니다.
일반적인 오류 및 해결
오류 및 질문이 있는 경우 문의하세요 kepleruser@service.microsoft.com .
자주 묻는 질문(FAQ)
오류 및 질문이 있는 경우 문의하세요 kepleruser@service.microsoft.com .
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 서비스 주체 인증 | 사용자 고유의 Azure Active Directory 앱을 서비스 주체 인증에 사용합니다. | 모든 지역 | 공유할 수 없음 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
서비스 주체 인증
인증 ID: oauthServicePrincipal
적용 가능: 모든 지역
사용자 고유의 Azure Active Directory 앱을 서비스 주체 인증에 사용합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 클라이언트 ID | 문자열 | 진실 | |
| 클라이언트 암호 | 시큐어스트링 (보안 문자열) | 진실 | |
| 임차인 | 문자열 | 진실 | |
| ResourceUri | 문자열 | 사용할 권한 부여를 요청하는 리소스입니다. | 진실 |
| Jupyrest 인스턴스 | 문자열 | 진실 |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| Notebook 실행 가져오기 |
Notebook 실행을 가져옵니다. |
| Synapse에 Notebook 업로드 |
기존 실행 ID 또는 매개 변수 집합이 지정된 경우 Notebook을 Synapse에 업로드합니다. |
| 노트북을 실행하다 |
Notebook을 실행합니다. |
Notebook 실행 가져오기
Notebook 실행을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
실행 ID
|
executionId | True | string |
실행 ID |
|
output
|
output | True | boolean |
true이면 Notebook의 저장된 출력을 반환합니다. |
|
html
|
html | True | boolean |
true이면 응답에서 html 결과를 반환합니다. |
|
보고서 모드
|
report | boolean |
true이면 보고서 버전의 실행 결과(Notebook 명령 셀 제외)를 반환합니다. |
반환
- NotebookResponse
- NotebookResponse
Synapse에 Notebook 업로드
기존 실행 ID 또는 매개 변수 집합이 지정된 경우 Notebook을 Synapse에 업로드합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
parameters
|
parameters | dynamic |
Notebook 입력 매개 변수입니다. |
반환
- SynapseResponse
- SynapseResponse
노트북을 실행하다
Notebook을 실행합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
보고서 모드
|
report | boolean |
true이면 보고서 버전의 실행 결과(Notebook 명령 셀 제외)를 반환합니다. |
|
|
parameters
|
parameters | True | dynamic |
Notebook 입력 매개 변수입니다. |
반환
- NotebookResponse
- NotebookResponse
정의
NotebookResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
Notebook 실행 ID |
|
status
|
status | string |
Notebook 실행 상태 |
|
notebook
|
notebook | string |
전자 필기장 이름 |
|
parameters
|
parameters | object |
Notebook 입력 매개 변수 |
|
output
|
output | array of |
Notebook 실행 출력 결과 |
|
html
|
html | string |
Notebook html 결과 |
|
시작_시간
|
start_time | string |
Notebook 실행 시작 시간 |
|
종료 시간
|
end_time | string |
Notebook 실행 종료 시간 |
|
exception
|
exception | string |
Notebook 실행 예외 |
SynapseResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
|
url | string |
만든 Notebook의 Synapse URL입니다. |