Executando scripts
Execute seu script de carregamento para exportar dados com os dados mais recentes da fonte de dados.
Os scripts no Qlik Cloud Analytics não são executados automaticamente para atualizar suas saídas. A execução do script executa o script de carregamento novamente para carregar os dados mais recentes da fonte de dados do script e depois exportá-los. As execuções de scripts podem ser manuais ou programadas.
Para obter informações sobre quais usuários podem carregar dados, consulte:
Você pode verificar o status da execução de um script. Pode ser Êxito, Recarregando ou Falha.
- Na exibição de lista de scripts, clicando no valor na coluna Última modificação.
- Em Histórico de recarga,
- No diálogo Agendar de tarefas configuradas para recargas agendadas do script (mostra apenas os status das execuções iniciadas por tarefas).
Agendando execuções de scripts
Crie tarefas para agendar execuções do seu script. O agendamento pode usar acionadores baseados em tempo ou em eventos.
Para criar uma tarefa:
-
Realize uma das seguintes ações:
-
No centro de atividades, clique em
no script e selecione Agendar.
-
Em seu script, abra a seção Visão geral e clique em
> Agendar.
-
-
Clique em Criar nova tarefa.
-
Em Nome da tarefa, digite um nome para a tarefa.
-
Como opção, adicione uma Descrição.
-
Em Baseado em, selecione o acionador da tarefa. Você tem as seguintes opções:
-
Baseado em tempo: agende a atualização para ocorrer em um momento específico. Em seguida, configure a tarefa com as configurações associadas a esse acionador. Para obter detalhes, consulte Agendamentos baseados no tempo.
Os seguintes acionadores baseados em tempo estão disponíveis:
-
Diariamente
-
Semanal
-
Mensalmente
-
Anualmente
-
-
Baseado em eventos: agende a atualização para iniciar quando ocorrer um evento específico. Para obter detalhes, consulte Programações baseadas em eventos.
Os seguintes gatilhos baseados em eventos estão disponíveis:
-
Outra tarefa bem-sucedida
-
Falha em outra tarefa
Nota informativaUse acionadores baseados em eventos para criar cadeias de tarefas para atualização de dados. Para obter mais instruções, consulte Criando cadeias de tarefas para atualização de dados. -
-
Agendamentos baseados no tempo
Ao criar uma programação baseada no tempo, você pode escolher:
-
A frequência e o intervalo da atualização
-
O fuso horário e a hora do dia
-
Por quanto tempo a programação estará em vigor
Atualizações repetidas podem ser definidas nos seguintes intervalos:
-
Diariamente: defina os horários do dia, o fuso horário e a hora do dia.
-
Semanalmente: defina os dias da semana, horários do dia, fuso horário e hora do dia.
-
Mensalmente: defina os dias do mês, as vezes por dia, o fuso horário e o horário do dia.
-
Anualmente: defina os meses, os dias do mês, os vezes por dia, o fuso horário e o horário do dia.
Para programações executadas diversas vezes por dia em qualquer intervalo, você também pode definir as horas do dia em que a programação será executada. Especifique um horário específico para a programação começar naquele dia.
Por padrão, as programações serão executadas continuamente, sem data de término. Você pode optar por definir uma data de início, uma data de término ou apenas executar a programação entre duas datas.
Programações baseadas em eventos
Agendamentos baseados em eventos permitem que você encadeie tarefas para diferentes aplicativos, scripts, fluxos de dados e receitas de tabela. Isso é útil para atualizações sequenciais desses ativos.
Para obter mais informações, consulte Criando cadeias de tarefas para atualização de dados.
Gerenciando tarefas
Você pode gerenciar as tarefas existentes se tiver as permissões para isso.
Para exibir e gerenciar tarefas:
-
Realize uma das seguintes ações:
-
No centro de atividades, clique em
no script e selecione Agendar.
-
Em seu script, abra a seção Visão geral e clique em
> Agendar.
-
-
Clique em
ao lado de uma tarefa e selecione qualquer uma das opções disponíveis. Como alternativa, mude para a guia Histórico para ver um histórico detalhado de quando a tarefa foi executada.
Para obter mais informações, consulte Gerenciador de tarefas para atualização de dados.
Limitações e considerações
-
Uma tarefa para atualizar dados é desativada se falhar cinco vezes seguidas na execução. Se você for o proprietário da tarefa, receberá notificações quando isso acontecer. As configurações de notificação podem ser personalizadas para um único aplicativo, todos os aplicativos em um espaço ou todos os aplicativos em um locatário. Para obter mais informações, consulte Propriedade de tarefas.
-
Se o proprietário da tarefa sair ou for excluído do locatário, outro usuário terá que assumir a propriedade da tarefa ou excluí-la e recriá-la. Caso contrário, suas atualizações agendadas falharão. Para obter informações sobre como alterar essa propriedade, consulte Propriedade de tarefas.
-
Se você tiver um grande número de processos de atualização de dados enfileirados e em execução (e processos simultâneos adicionais de CPU e memória), poderá notar que alguns processos de atualização serão executados, em alguns casos, visivelmente após seu horário de início agendado.
-
Tarefas para atualização de dados não são incluídas para a cópia publicada de um script. Scripts publicados devem ter suas tarefas reconfiguradas na versão no espaço gerenciado.
-
Se seu script tiver tarefas para atualizar dados e você movê-lo entre espaços (espaços pessoais ou compartilhados), essas tarefas serão desativadas. Você pode reativá-las quando estiver pronto para retomar as atualizações agendadas. Consulte Ativando e desativando uma tarefa.
Propriedade de tarefas
Uma tarefa para atualização de dados é executada em nome do usuário proprietário da tarefa, e não do proprietário do aplicativo, script, fluxo de dados ou receita de tabela. Para que a tarefa seja executada com sucesso, o proprietário da tarefa ainda deve ter o acesso correto ao aplicativo, script, fluxo de dados ou receita de tabela e suas fontes de dados. Certas ações resultam em alterações em quem é o proprietário da tarefa. O proprietário da tarefa é determinado pelas seguintes regras:
-
Ao criar uma tarefa para executar um script, você se torna o proprietário dessa tarefa.
-
Se outro usuário editar ou salvar uma tarefa existente, ele se tornará o novo proprietário dessa tarefa.
-
Se outro usuário modificar o script de carregamento do script, ele se tornará o novo proprietário de todas as tarefas para execuções agendadas desse script.
Para obter mais informações sobre o desenvolvimento conjunto de modelos de dados de scripts, consulte Desenvolvendo scripts de carregamento de dados de maneira colaborativa em espaços compartilhados.
Administrando tarefas para atualização de dados
Administradores de locatários e administradores de análises podem editar e excluir tarefas para atualizações de dados agendadas. Isso é feito no centro de atividades de Administração. Para obter mais informações, consulte:
Executando scripts manualmente
Você pode executar um script manualmente.
Faça o seguinte:
- Clique em
no script e selecione Executar agora.
Visualizando o histórico de execução de um script
Histórico de recarga contém o histórico de execução do script selecionado. Use-o para ajudar a solucionar problemas de execução programada. Você pode ver o status, os horários de início e de término e a duração das execuções passadas e atuais do script. Também pode visualizar e baixar um arquivo de log correspondente.
Existem duas maneiras de visualizar o histórico de recarga de um script.
- Em Visão geral de um script, clique em Histórico de recarga.
- Na exibição em lista de scripts no centro de atividades do Análises, clique na data da coluna Última modificação e selecione Exibir histórico de recarga.
Histórico de recarga de um script

Na página Histórico de recargas, clique no botão Exibir para visualizar o resumo da execução. Você também tem a opção de baixar um arquivo de log detalhado. Quando o limite para o número de logs armazenados for atingido, novos registros substituirão os registros mais antigos com base na ordem do primeiro a entrar, primeiro a sair.
Talvez você queira cancelar uma execução do seu script se ela estiver demorando muito ou se o script tiver sido atualizado com novos dados e você quiser iniciar uma nova execução. Para cancelar uma execução, acesse Histórico de recargas e clique em Cancelar.
Você pode ver a execução cancelada no seu Histórico de recargas.
Visualizando o histórico de tarefas
Além da exibição do Histórico de recarga, você também pode visualizar um histórico de execução focado nas tarefas criadas para recargas agendadas do script. Para obter mais informações, consulte Exibindo o histórico de atualização de uma tarefa.
Noções básicas sobre carimbos de data/hora: Atualizado, Data de modificação e Data do último carregamento
Você pode visualizar informações de tempo no carimbo de data/hora Atualizado mostrado no bloco de script. Você também pode ver essas informações clicando em um script para abrir Visão geral. Elas são listas em Resumo como Data de modificação. O formato da data pode ser diferente; por exemplo, se o script foi atualizado recentemente, o valor Atualizado no bloco de script poderá aparecer da seguinte forma: Atualizado há 15 minutos.
Você pode ver a Data do último carregamento selecionando no script e, em seguida, selecionando Detalhes. Esse valor só é atualizado quando os dados do script são atualizados. Uma execução também altera os carimbos de data/hora Atualizado e Data de modificação.
Campos Data de modificação e Data do último carregamento nos Detalhes do script

A tabela a seguir lista as operações que atualizam os carimbos de data/hora Atualizado (igual a Data de modificação) e Data da última recarga:
| Operação | Atualizado, Data de modificação | Data do último recarregamento |
|---|---|---|
| Executar (recarregar) | Sim | Sim |
| Alterar nome | Sim | Não |
| Alterar descrição | Sim | Não |
| Publicar script | Sim | Não |
| Alterar proprietário | Sim | Não |
| Alterar script | Sim | Não |