Utilizar o ambiente de script

Anotação:

O ambiente de script do Insights está disponível no Insights in ArcGIS Enterprisee Insights desktop. A conexão primária pode ser Insights in ArcGIS Enterprise ou Insights in ArcGIS Online.

As conexões do Jupyter Kernel Gateway pode ser desativado para uma organização do Insights in ArcGIS Enterprise durante o processo de instalação. Contate seu administrador se as conexões do Jupyter Kernel Gateway não estão disponíveis. Para mais informações, consulte Instalar Insights in ArcGIS Enterprise.

Após criar uma conexão com um Jupyter Kernel Gateway, o ambiente de script poderá ser acessado e utilizado para criar e executar scripts no Python e R. O ambiente de script consiste em uma célula In[ ], onde scripts são carregados ou escritos; uma célula Out[ ], onde os resultados são exibidos; e uma barra de ferramentas.

Abrir o ambiente de script

Para utilizar o ambiente de script, você deve primeiro configurar um Jupyter Kernel Gateway e criar uma conexão para o gateway. Após a conexão do portal ser criada, conclua as seguintes etapas para abrir o ambiente de script e inicie a gravação dos scripts:

1. Abra um livro de tarefas e adicione dados, se necessário.

   Dica:

   Você também pode carregar dados de dentro do ambiente de criação de script.

2. Clique no botão Criar Script na barra de ferramentas do livro de tarefas.
3. Se uma conexão não foi salva no livro de tarefas anteriormente, faça um dos seguintes:
   • Se Insights desktop, se a janela Nova conexão de Portal do Jupyter Kernel aparecer, isso significa que você não criou uma conexão ao portal. Forneça a URL e o endereço de soquete da web no portal para criar a conexão. Consulte Conectar a um portal de kernel para mais informações.
   • No Insights in ArcGIS Enterprise, se a janela Conexão de Portal do Kernel aparecer, selecione uma conexão do portal de kernel existente no menu Nome do ambiente. Você também pode criar uma conexão na guia Adicionar novo. Consulte Conectar a um portal de kernel para mais informações.

   O ambiente de script é aberto e um cabeçalho Scripts é adicionado ao painel de dados.

4. No menu Selecionar Kernel, escolha o kernel a ser usado para scripts.

   Dependendo da conexão do portal de kernel que você está utilizando, as opções serão Python, R ou ambos.

   O ambiente de script atualiza para incluir uma célula In[ ], como também, uma barra de ferramentas.

O ambiente de script agora está agora pronto uso para criar, carregar e executar scripts.

O script é automaticamente salvo no cabeçalho Scripts no painel de dados com o nome Script do Insights. Você pode renomear o script usando o botão Renomear script .

As seguintes opções também estão disponíveis para o script utilizando o botão Opções do conjunto de dados :

• Abrir—Carrega o script em uma célula In[ ].
• Executar—Executa o script sem abrir o ambiente de script.
• Download—Baixa o script como um arquivo Jupyter Notebook (.ipynb).
• Publicar—Publica o script para criar um item de script do Insights (disponível no Insights in ArcGIS Enterprise).
• Remover—Remove o script do painel de dados.

Editar um script

Você pode editar scripts a partir das células In[ ], mesmo após a célula ter sido executada. Para editar um script, clique na célula, faça as edições, e execute a célula. Uma nova célula Out[ ] é criada com os resultados editados.

Exportar um script

Você pode exportar e salvar scripts gravados no ambiente de script como scripts .py para Python ou um script .R para R. Para exportar um script do ambiente de script, selecione uma ou mais células e clique no botão Exportar .

As seguintes opções de exportação estão disponíveis quando você salva um script:

• Baixar Célula Selecionada—Salva somente o script em células In[ ] selecionadas.
• Histórico de Download—Salva o script de todas as células In[ ] no ambiente de script como um arquivo Jupyter Notebook (.ipynb).

Os scripts exportados são salvos na pasta de download padrão no seu computador.

Carregar um script

Você pode criar scripts diretamente no ambiente de script digitando na célula In[ ]. Para carregar scripts existentes no ambiente de script, complete as seguintes etapas:

1. Abra o ambiente de script, se necessário, e escolha o kernel correto para o script que você estará executando.
2. Clique no botão Importar Arquivo na barra de ferramentas do ambiente de script.
3. Procure e abra o script que você deseja executar.

   O script é aberto na célula In[ ].

4. Clique no botão Executar na barra de ferramentas do ambiente de script.

O script executa e os resultados aparecem na célula Out[ ].

Os scripts que foram salvos no painel de dados também podem ser carregado no ambiente de script. Para carregar um script a partir do painel de dados, complete as seguintes etapas:

1. Expanda o cabeçalho Scripts no painel de dados.
2. Clique no botão Opções do Conjunto de Dados para o script que deseja carregar.
3. Clique em Abrir.

   O script é aberto na célula In[ ].

Criar um cartão de imagem

Os resultados do script, como gráficos, podem ser exportados de uma célula Out[ ] para criar um cartão de imagem em sua página do Insights. . Para exportar uma célula, você deve executar o script utilizando o botão Executar , destacar a célula Out[ ] e clicar no botão Criar Cartão para mover a imagem da célula Out[ ] mais recente para um cartão de imagem.

Anotação:

Os cartões de imagem criados a partir de scripts são estáticos e não têm os mesmos recursos interativos de mapas, gráficos e tabelas criados no Insights.

Salvar o script em um modelo

Você pode adicionar o script a partir do ambiente de script a um modelo como um script do Insights usando o botão Adicionar ao Modelo . O script do Insights pode ser editado a partir da Visualização de análise . Para mais informações sobre atualizar um modelo no Insights, consulte Reexecutar sua análise.

Limpar ou fechar o ambiente de script

Para limpar o ambiente de script, incluindo todas as células In[ ] e Out[ ], clique no botão Reiniciar . A limpeza do ambiente de script não pode ser desfeita.

Para fechar o ambiente de script, clique no botão de fechar ou navegue até uma página diferente no Insights.

Para alternar entre a página do Insights e o ambiente de script, minimize o ambiente utilizando o botão de minimizar em vez de fechá-lo, você não perderá seus scripts.