Especificar o tempo de execução de um notebook

Quando você cria um notebook, os recursos e as bibliotecas do Python que você utiliza são disponibilizados através de um tempo de execução do notebook. Há dois tempos de execução disponíveis: O tempo de execução Padrão contém o ArcGIS API for Python junto com algumas centenas de outras bibliotecas do Python , e o tempo de execução avançado contém todas as mesmas bibliotecas, bem como ArcPy e algumas bibliotecas relacionadas. Os tempos de execução disponíveis dependem do seu licenciamento e privilégios.

Anotação:

Notebooks que utilizam o tempo de execução Avançado podem ser executados no ArcGIS API for Python e todas as outras bibliotecas do tempo de execução Padrão.

Para criar notebooks, seu administrador deve atribuir a você um papel de membro personalizado que contenha os privilégios apropriados. Dependendo do tempo de execução do notebook necessário, você deve receber o privilégio de usar o tempo de execução padrão ou o tempo de execução avançado. O privilégio do tempo de execução Avançado também permite que você use o tempo de execução Avançado com GPU.

Escolher um tempo de execução do notebook

Ao criar um novo notebook, você escolhe qual tempo de execução o notebook usará. A lista que você escolhe é baseada em seus privilégios, se você tiver recebido o privilégio de Notebooks Avançados, poderá escolher entre os tempos de execução Padrão e Avançado. Você também pode alterar o tempo de execução de um notebook após ter sido criado.

Se você tiver os privilégios apropriados, talvez queira criar notebooks utilizando o tempo de execução em diferentes situações. Por exemplo, se você estiver criando um notebook para compartilhar com outros autores de notebooks em sua organização que não têm privilégios de Notebooks Avançados, pode poderá criar um notebook usando o tempo de execução Avançado.

Alterar um tempo de execução do notebook

Recomenda-se que você atualize o tempo de execução do notebook quando uma nova versão estiver disponível para aproveitar as vantagens das últimas bibliotecas Python disponíveis.

Anotação:

Antes de alterar o tempo de execução de um notebook, revise as bibliotecas disponíveis e as versões de tempo de execução correspondentes usadas no notebook. Alguns códigos podem funcionar de maneira diferente com diferentes versões de bibliotecas. Algumas bibliotecas não estão disponíveis em todos os tempos de execução do notebook. Por exemplo, ArcPy está disponível apenas no tempo de execução do notebook avançado, portanto, se você mudar para o tempo de execução do notebook padrão, um erro aparecerá quando você executar células no notebook que usa ArcPy.

Alterar o tempo de execução de um notebook na página do item

Siga estas etapas para alterar o tempo de execução aplicado a um notebook existente em sua página do item. Esse fluxo de trabalho somente pode ser feito por membros que podem criar notebooks usando o tempo de execução do notebook.

  1. Abra a página de itens do notebook e clique na guia Configurações.

    Na seção Notebook da guia, a opção Tempo de execução do Notebook designa o tempo de execução que o notebook está utilizando.

  2. Clique na lista suspensa e escolha o tempo de execução.
    Anotação:

    Se você não tiver o privilégio Notebooks Avançados, somente o tempo de execução Padrão aparecerá na lista suspensa.

  3. Clique em Salvar para confirmar.

Alterar os tempos de execução do notebook na página inicial do Notebooks

Você pode alterar o tempo de execução aplicado a um notebook existente ou a vários notebooks na página inicial. Esses fluxos de trabalho podem ser criados somente por membros que podem criar notebooks usando o tempo de execução do notebook.

Alterar o tempo de execução de um único notebook na página inicial

Para alterar o tempo de execução aplicado a um notebook individual existente na página inicial, siga estas etapas:

  1. Abra a página inicial do Notebooks e clique em Opções > Atualizar tempo de execução no notebook que deseja atualizar.
  2. Selecione o novo tempo de execução no menu suspenso.
  3. Clique em Atualizar.

Alterar um ou mais tempos de execução do notebook na página inicial

Para alterar os tempos de execução de vários notebooks de uma só vez na página inicial, siga estas etapas:

  1. Abra a página inicial Notebooks e selecione um ou mais notebooks.
  2. Clique em Atualizar tempo de execução.
  3. Clique em Todos os itens selecionados para atualizar todos os notebooks selecionados para o mesmo tempo de execução
    1. Selecione o novo tempo de execução no menu suspenso.
    2. Clique em Atualizar.
  4. Clique em Cada item para selecionar o tempo de execução para cada notebook selecionado individualmente.
    1. Selecione o tempo de execução para cada item do notebook.
    2. Clique em Atualizar.

Instalar módulos durante uma sessão

Os autores do notebook podem criar módulos do Python ou versões de módulos, que não estão incluídas no tempo de execução disponível para uso durante uma sessão de notebook utilizando conda. É recomendado que você utilize conda, pois o ArcGIS Notebooks usa-o para gerenciar módulos.

Esta abordagem instala o módulo desejado pela duração da sessão do notebook. Após fechar o notebook ou o conteiner de pertencente ao usuário for encerrado, o módulo não estará mais disponível. Para instalar módulos usando este método, você deve ter conectividade com a Internet no canal condal.

Anotação:

conda está incluído nos dois tempos de execução do notebook. Você não precisa instalá-lo.

Para instalar o pacote scrapy durante uma sessão, por exemplo, execute uma célula do notebook com um dos seguintes comandos, dependendo do sistema de gerenciamento do pacote que você está utilizando:

Utilizando o sistema de gerenciamento de pacote do conda

!conda install --yes scrapy

Para utilizar uma versão diferente de um módulo do Python no tempo de execução do notebook no qual você está trabalhando, especifique o número da versão no comando.

Você deve reiniciar o kernel após executar um comando conda para que seu novo pacote esteja disponível.

Por exemplo, um determinado pacote está disponível em ambos os tempos de execução do notebook na versão 1.5, mas você deseja utilizar uma ferramenta introduzida no 1.6. Para disponibilizar a versão 1.6 do pacote durante uma sessão, execute uma célula do notebook com um dos seguintes comandos, dependendo do sistema de gerenciamento do pacote que você está utilizando:

Utilizando o sistema de gerenciamento de pacote do conda

!conda install --yes <package name>==1.6