Jupyrest (versão prévia)
O Jupyrest é um serviço que pode executar notebooks com contratos predefinidos de entrada e saída.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | LivesiteAutomation |
| URL | https://github.com/microsoft/jupyrest |
| cosmosdbla@microsoft.com |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://github.com/microsoft/jupyrest |
| Política de privacidade | https://github.com/microsoft/jupyrest/blob/main/SECURITY.md |
| Categorias | Dados |
O Jupyrest é um serviço que pode executar notebooks com contratos predefinidos de entrada e saída.
Pré-requisitos
Você precisará do seguinte para usar o conector:
- Uma instância do Juprest (instalando o aplicativo na assinatura do cliente)
- Um aplicativo de ID do Microsoft Entra
- Este é o aplicativo de ID do Microsoft Entra do cliente Juprest para enviar solicitação ao serviço Juprest, que também é fornecido quando você cria sua instância do Juprest seguindo o documento acima.
Como obter credenciais
Seu aplicativo cliente do Microsoft Entra ID criado nos pré-requisitos tem acesso à instância do Jupyrest e será usado para criar uma conexão do conector Jupyrest.
Introdução ao conector
Você precisará inserir sua instância do Jupyrest, a ID do cliente do Microsoft Entra ID e o segredo do cliente para começar a usar o conector.
- Para a instância do Jupyrest, use a URL do aplicativo de funções como https://cdbkeplerprod.azurewebsites.net
- Para a ID e o segredo do cliente do Microsoft Entra ID, use a ID do Microsoft Entra mencionada nos pré-requisitos.
- Para o ResourceUrl, use a URL do aplicativo de funções. Por exemplo: https://cdbkeplerprod.azurewebsites.net
Problemas e limitações conhecidos
"Carregar um notebook no Synapse" não dá suporte ao carregamento de uma execução de notebook existente, considerando uma excutionId.
Erros e soluções comuns
Entre em contato conosco em kepleruser@service.microsoft.com caso de erros e perguntas.
perguntas frequentes
Entre em contato conosco em kepleruser@service.microsoft.com caso de erros e perguntas.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Autenticação de entidade de serviço | Use seu próprio aplicativo do Azure Active Directory para autenticação de entidade de serviço. | Todas as regiões | Não compartilhável |
| Padrão [PRETERIDO] | Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. | Todas as regiões | Não compartilhável |
Autenticação da entidade de serviço
ID de autenticação: oauthServicePrincipal
Aplicável: todas as regiões
Use seu próprio aplicativo do Azure Active Directory para autenticação de entidade de serviço.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID do cliente | cadeia | Verdade | |
| Segredo de Cliente | secureString | Verdade | |
| Inquilino | cadeia | Verdade | |
| ResourceUri | cadeia | O recurso que você está solicitando autorização para usar. | Verdade |
| Instância do Jupyrest | cadeia | Verdade |
Padrão [PRETERIDO]
Aplicável: todas as regiões
Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Carregar um notebook no Synapse |
Carrega um notebook no Synapse, considerando uma ID de Execução existente ou um conjunto de parâmetros. |
| Executar um notebook |
Execute um bloco de anotações. |
| Obter uma execução de notebook |
Obter uma execução de bloco de anotações. |
Carregar um notebook no Synapse
Carrega um notebook no Synapse, considerando uma ID de Execução existente ou um conjunto de parâmetros.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
parameters
|
parameters | dynamic |
Parâmetros de entrada do notebook. |
Retornos
- SynapseResponse
- SynapseResponse
Executar um notebook
Execute um bloco de anotações.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
modo de relatório
|
report | boolean |
Se for true, retorne a versão do relatório dos resultados de execução (sem células de comando do notebook). |
|
|
parameters
|
parameters | True | dynamic |
Parâmetros de entrada do notebook. |
Retornos
- NotebookResponse
- NotebookResponse
Obter uma execução de notebook
Obter uma execução de bloco de anotações.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de execução
|
executionId | True | string |
ID de execução |
|
saída
|
output | True | boolean |
Se for true, retorne a saída salva do notebook |
|
HTML
|
html | True | boolean |
Se true, retornar html resulta na resposta |
|
modo de relatório
|
report | boolean |
Se for true, retorne a versão do relatório dos resultados de execução (sem células de comando do notebook). |
Retornos
- NotebookResponse
- NotebookResponse
Definições
NotebookResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
ID de execução do notebook |
|
status
|
status | string |
status de execução do notebook |
|
notebook
|
notebook | string |
nome do bloco de anotações |
|
parameters
|
parameters | object |
parâmetros de entrada do notebook |
|
saída
|
output | array of |
resultados da saída de execução do notebook |
|
HTML
|
html | string |
resultados do notebook html |
|
hora de início
|
start_time | string |
Hora de início da execução do bloco de anotações |
|
end_time
|
end_time | string |
hora de término da execução do bloco de anotações |
|
exceção
|
exception | string |
exceção de execução do notebook |
SynapseResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
url | string |
URL do Synapse do notebook criado. |