Via Kondado

O destino Via Kondado permite acesso via Link aos dados integrados e modelados pela Kondado

  1. Acessando seus dados
    1. Link copia e cola
      1. Link copia e cola de integrações
      2. Link copia e cola de modelos
    1. Montando o link manualmente
      1. Token de acesso
      2. Leitura de dados
      3. Leitura de metadados
    1. Formato dos dados retornados
  2. Como usar
    1. Unidades
      1. Alteração de unidades
      2. Unidade gratuita
    1. Alterar token de acesso
    2. Criar
    3. Desativar e arquivar
      1. Remover dados sem desativar o destino
    4. Recomendações de segurança
    5. Nomes de tabelas
    6. Modelos
      1. Editor de modelos

Acessando seus dados

Link copia e cola

A conexão com o Via Kondado é realizada via API. Você poderá obter facilmente o link de acesso API para qualquer tabela, de maneira similar ao modal abaixo. Você poderá alterar o separador de decimal entre vírgula e ponto e então clicar no ícone de copiar para obter o link

Link copia e cola de integrações

Para obter todos os links das tabelas de sua integração, basta acessar sua integração e clicar no ícone de compartilhar

O link de cada tabela estará também disponível ao clicar em DETALHES

Link copia e cola de modelos

Montando o link manualmente

A nossa API de leitura deve ser acessada com uma requisição GET no host https://hub.kondado.io e autenticada com o parâmetro token (query string)

Token de acesso

Para obter o token de acesso ao seu destino, basta acessá-lo, clicar nas 3 barras horizontais e então “Ver token”

Este token permite acesso aos seus dados. Mantenha-o em um lugar seguro

Leitura de dados

Para obter os dados de uma tabela tabela_x, basta acessar o path data/tabela_x.

Caso o parâmetro decimal_sep não seja informado, o separador de decimal será o ponto, utilize decimal_sep=comma para obter seus dados separados por vírgula, por exemplo:

https://hub.kondado.io/data/tabela_x?token=seu_token&decimal_sep=comma

Leitura de metadados

O path /metadata retorna metadados de suas tabelas no formato JSON

/metadata/show_tables retorna um ARRAY de JSONs com a lista das tabelas em seu destino na chave tbl_name

/metadata/schemas/tabela_x retorna o schema da tabela tabela_x

  • col_type informa o nome do campo (chave/header)
  • col_type representa o tipo do campo: text, float, int, timestamp, date ou boolean

Formato dos dados retornados

Sempre que o link de dados (/data) for acessado, será retornada a versão mais recente de sua tabela no Via Kondado no formato CSV, o que permite compatibilidade com várias ferramentas de visualização e análise.

O separador de colunas deste arquivo será a vírgula e você poderá alternar entre vírgula ou ponto como separador de decimais com o parâmetro decimal_sep caso crie o link manualmente ou diretamente no modal de obtenção do link de nossa plataforma.

Para aumentar a compatibilidade e formatação do CSV, quebras de linha (/n, /r e /r/n) em campos do tipo text serão removidos nas tabelas de integrações. Nas tabelas de modelos, esta remoção apenas ocorrerá devido a alterações realizadas pelo SQL do modelo.

Além disso, boa parte dos acentos e caracteres especiais serão substituídos.

Como usar

Unidades

Cada destino Via Kondado pode ser configurado para ter uma certa capacidade, de acordo com a quantidade de unidades alocadas. Uma unidade possui 3 componentes:

  • Acessos
    • Cada unidade concede 2 mil acessos/mês
    • É uma medida de acesso aos dados e indica quantas leituras por mês podem ser realizadas via links de dados e metadados do destino.
  • Células:
    • Cada unidade concede 10 milhões de células armazenadas por mês
    • É uma medida de armazenamento de dados. Indica quantas células por mês podem ser armazenadas no destino. De forma similar a uma planilha, uma célula é a menor unidade de uma tabela e representa a intersecção de uma linha e uma coluna. Dentro de um dado mês, a quantidade de células pode ser variável, já que uma tabela pode aumentar/diminuir de tamanho, bem como ser removida ou criada a qualquer momento e a contabilização de células por mês reflete esta variação
  • Modelos ativos
    • Cada unidade concede 2 modelos ativos

Alteração de unidades

É possível alterar o número de unidades diretamente na página do destino

O modal que será aberto indicará a precificação mensal total. Podem ser concedidas unidades gratuitas, a nosso critério. Basta clicar em SALVAR para aplicar a nova configuração

Unidade gratuita

A unidade gratuita inclusa no plano do cliente é concedida no momento de criação ou edição das unidades do destino

Alterar token de acesso

Para alterar o token de acesso de seu destino, basta acessá-lo, clicar nas 3 barras horizontais e então “Alterar token”

Você deve alterar seu token sempre que suspeitar que ele foi comprometido. Aterações frequentes também são recomendadas. Ao alterar seu token, será gerado um novo e o anterior deixará de funcionar, sendo preciso atualizar o novo token em seus links

Criar

Após seu período de teste grátis, você pode ter quantas instâncias de Via Kondado quiser, cada um conterá seus próprios dados e terá seu próprio token de acesso. Para criar um novo destino, basta clicar em “Criar+” na barra superior, escolher Via Kondado, dar um nome e um número de unidades ao novo destino

Desativar e arquivar

Para desativar e arquivar seu destino, basta acessá-lo, clicar nas 3 barras horizontais e então “Desabilitar e arquivar”. Esta ação é irreversível, removerá os dados das tabelas deste destino e o tornará inacessível via Link. Integrações e modelos deste destino serão arquivados

Remover dados sem desativar o destino

Você pode arquivar uma integração ou modelo para remover estes dados específicos de seu destino Via Kondado

Recomendações de segurança

Seu token permite acesso aos seus dados, utilize o mais alto grau de segurança em sua manipulação

É possível obter este token de várias maneiras pela plataforma da Kondado, por isso recomendamos proteger o acesso à sua conta da Kondado aplicando configurações de login adequadas, permitindo acesso somente com métodos que possuam autenticação de 2 fatores habilitados e domínios restritos.

Nomes de tabelas

Nomes de tabelas devem obedecer as seguintes regras:

  • Não começar com duckdb_, pragma_, pg_ ou sqlite_
  • Não conter caracteres especiais ou espaço
  • Utilizar sempre caixa baixa

Modelos

É possível utilizar nossa funcionalidade de modelos no destino Via Kondado, que utiliza a sintaxe DuckDB, com as seguintes particularidades:

  1. Seu SQL deve conter apenas um comando do tipo SELECT
  2. O comando SHOW não é permitido em seu SQL
  3. Alias de colunas serão normalizados na tabela final, substituindo caracteres não ANSI e espaços por “_”
  4. Não deve ser utilizada a notação de ponto “.” para se referir a tabelas em seu SQL
  5. Não é permitida a função RANGE
  6. PIVOT e UNPIVOT devem ser embalados dentro de uma subquery (por exemplo: SELECT * FROM (PIVOT Cities ON YEAR USING SUM(POPULATION)) e SELECT * FROM monthly_sales UNPIVOT (sales FOR month IN (jan, feb, mar, apr, may, jun)))
  7. O tempo total de execução de fato de seu modelo, incluindo carregamento das tabelas dependentes não deverá exceder 10 minutos, sendo no máximo 5 minutos para execução do SQL em si. Caso estes limites sejam excedidos, pode ser necessário consultar menos tabelas, trabalhar com tabelas diminuídas (por exemplo, com o tratamento antecipado utilizando outros modelos a montante) ou simplificar seu SQL
  8. Devido à arquitetura do destino Via Kondado, poderá haver variação considerável entre os tempos de cada execução de um mesmo modelo

Veja mais sobre modelos:

Editor de modelos

O editor de modelos do Via Kondado permite que você teste seu SQL durante a edição.

O teste utiliza amostras das tabelas consultadas, o que irá retornar um resultado diferente da execução real do SQL com os dados originais

Para testar seu SQL, primeiro selecione um destino do tipo Via Kondado e, então você verá o botão TESTAR SQL. Basta clicar nele. Você pode também utilizar o atalho CTRL+ENTER

O teste irá considerar todo o SQL contido no editor, independente do que estiver selecionado ou se o texto foi salvo (o que também pode ser feito com CTRL+S)

Caso durante o teste seja encontrado um erro, ele será apresentado. Caso não haja erros, o resultado da execução com a amostra de dados será apresentado e você poderá também executar seu modelo imediatamenete – clicar neste botão irá também salvar o SQL que está em seu editor

Este destino está em modo beta