01. Criando modelos

Falamos um pouco nesse artigo sobre como a Kondado lida com a transformação dos dados e por que acreditamos que a nossa funcionalidade de criação de modelos simplifica e agiliza o seu fluxo de informações.

A partir do instante em que você criou sua integração pela Kondado e deseja transformar os dados no seu destino, pode-se criar um modelo. Ao concebê-lo, você criará uma nova tabela no seu destino de dados que será atualizada sempre que o seu acionador (integração ou outro modelo) for executado. Isso garantirá que seus dados estejam comumente transformados e frescos.

Se preferir, assista ao nosso tutorial em vídeo clicando aqui.

Para criar um modelo pela Kondado, siga os passos abaixo:

1) Acesse a páginal inicial de seu perfil na plataforma da Kondado.

2) Clique em "CRIAR +" e depois em "MODELOS":

3) Nomeie o seu modelo e então clique em "SALVAR":

4) Nesse momento, você será direcionado para a página de criação e edição dos modelos. Na parte esquerda da tela estarão todas as configurações do modelo:

  • Nome: Nome do modelo que você definiu no passo anterior.
  • Ativo?: Indica se o seu modelo está ativo. Ao terminar todas as configurações do modelo, é importante se certificar de que esse campo esteja marcado como "sim" para que seu modelo seja aplicado sempre que um acionador for executado. Esse campo deve ser marcado ao final de todas as edições.
  • Nome da tabela: Aqui, você define o nome que a tabela gerada pelo modelo terá no seu destino de dados. Vale ressaltar que você deve seguir o mesmo padrão de nome de tabelas do seu destino. Espaços e acentos não são permitidos.

    Destino: Ao clicar nessa configuração, você será apresentado a uma lista de todos os seus destinos de dados cadastrados na Kondado. Você deverá escolher em qual destino deseja criar a nova tabela(é importante que as tabelas consultadas no modelo estejam destino de dados).
  • Acionadores: Nesta parte da configuração, você deverá escolher quais integrações ou modelos irão acionar a execução do seu novo modelo. Assim que esses acionadores forem executados, seu modelo automaticamente será atualizado. Você pode ter até 10 (dez) acionadores para cada modelo.
  • Acionar: Aqui, você poderá decidir se o modelo irá operar apenas após todos os acionadores definidos no passo anterior forem executados ou se apenas a execução de um dos acionadores será suficiente para o início da execução do modelo.
  • Intervalo entre execuções: Neste tópico, você define o intervalo mínimo de tempo entre as execuções do modelo. Por exemplo, se forem configurados dois acionadores com frequência de execução a cada 5 minutos, mas você deseja que o modelo seja ativado apenas a cada 30 minutos, basta definir esse intervalo. Assim, o modelo será acionado somente após o período estabelecido.

5) Após definir todas as configurações do modelo, insira a sua query no editor. Não é necessário criar comandos como "DROP TABLE" ou "CREATE TABLE". Apenas o "SELECT" deve ser utilizado.

6) Clique em "SALVAR" na parte inferior do editor:



7) E por fim, mude a configuração "Ativo?" para "Sim":



8) Quando o modelo for corretamente acionado, você poderá executá-lo. Para isso, clique em "EXECUTAR MODELO":

Displaying image.png

9) As mensagens de erro, caso exibidas, especificarão o erro encontrado dentro do corpo SQL proposto pelo modelo. Ressalta-se, aqui, que os modelos somente aceitam o comando "SELECT". As tabelas e seus valores de informação estarão sempre dentro do destino de dados:

Agora que seu modelo está ativo, aguarde a primeira execução dos seus acionadores para que a tabela seja criada no seu destino de dados. O modelo será atualizado automaticamente toda vez que os acionadores forem executados dentro do intervalo definido.

Para desativar o seu modelo, basta editar a configuração "Ativo?" para "Não". Desse modo, o modelo não será mais atualizado.

Arquivando modelos

Ao arquivar seu modelo, ele deixará de aparecer na maioria dos ambientes da plataforma e somente poderá ser acessado via URL. Esta ação não poderá ser desfeita e seu modelo não poderá mais ser alterado após arquivado.

Para arquivar seu modelo, desative-o e, então, clique no botão "ARQUIVAR" que estará no final da lista de configurações:

Criar modelos de transformação de dados na Kondado

Aprenda a criar modelos SQL na Kondado para transformar e combinar tabelas diretamente na plataforma, gerando novas tabelas atualizadas automaticamente no seu destino de dados.

1
Acesse a área de modelos na plataforma

Na página inicial do seu perfil na Kondado, clique em "CRIAR +" e selecione "MODELOS". Nomeie seu modelo e salve para acessar a página de edição.

2
Configure o destino e os acionadores

Escolha o destino de dados onde a nova tabela será criada e defina até 10 acionadores (integrações ou outros modelos) que dispararão a execução automática do seu modelo.

3
Defina regras de execução e intervalos

Configure se o modelo executa após todos os acionadores ou apenas um deles, e estabeleça o intervalo mínimo entre execuções para controlar a frequência de atualização da tabela.

4
Escreva a query SQL no editor

Insira apenas o comando "SELECT" no editor — não é necessário usar "DROP TABLE" ou "CREATE TABLE". Certifique-se de que as tabelas consultadas estejam no mesmo destino configurado.

5
Salve e ative o modelo

Clique em "SALVAR", altere a configuração "Ativo?" para "Sim" e, quando desejar, clique em "EXECUTAR MODELO" para processamento imediato. A tabela será criada no destino após a primeira execução dos acionadores.

Perguntas frequentes

O que é um modelo na Kondado e para que serve?
Um modelo é uma funcionalidade da Kondado que permite transformar dados usando SQL diretamente na plataforma. Ele cria uma nova tabela no seu destino de dados que é atualizada automaticamente sempre que os acionadores definidos forem executados, garantindo que suas análises sempre utilizem dados transformados e atualizados.
Quais comandos SQL são aceitos nos modelos?
Os modelos aceitam apenas o comando "SELECT". Não é necessário — nem permitido — utilizar comandos como "DROP TABLE" ou "CREATE TABLE", pois a Kondado gerencia automaticamente a criação e atualização da tabela no destino configurado.
Posso usar tabelas de diferentes destinos em um mesmo modelo?
Não. É obrigatório que todas as tabelas consultadas na query SQL estejam no mesmo destino de dados selecionado nas configurações do modelo. O destino define onde a nova tabela transformada será criada e de onde os dados de origem serão lidos.
O que acontece se eu arquivar um modelo?
Ao arquivar um modelo, ele deixa de aparecer na maioria dos ambientes da plataforma e só pode ser acessado via URL direta. Esta ação é irreversível: o modelo não poderá mais ser editado ou reativado. Para arquivar, primeiro desative-o e depois clique no botão "ARQUIVAR".
Como funciona a configuração de acionadores e intervalo entre execuções?
Você pode definir até 10 acionadores (integrações ou outros modelos) que disparam a execução do seu modelo. Além disso, o "Intervalo entre execuções" define um tempo mínimo de espera: mesmo que os acionadores sejam executados com mais frequência, o modelo só rodará após esse período estabelecido.
O modelo atualiza automaticamente ou preciso executá-lo manualmente?
Uma vez ativado, o modelo atualiza automaticamente sempre que seus acionadores forem executados dentro do intervalo definido. No entanto, você também pode forçar uma execução imediata clicando em "EXECUTAR MODELO" na interface da plataforma.

Escrito por·Publicado em 2020-06-26·Atualizado em 2026-04-25