![\"PowerBIViaKondadoLogo\"](\"http:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/06\/visualization_powerbi.png\")
\n Como conectar ao PowerBI<\/span>\n <\/a>\n \n ![\"LookerStudioViaKondadoLogo\"](\"http:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/06\/visualization_lookerstudio.png\")
\n Como conectar ao Looker Studio<\/span>\n <\/a>\n<\/div>\n\n\n\n\n- Acessando seus dados<\/a>
- Link copia e cola<\/a>
- Link copia e cola de integra\u00e7\u00f5es<\/a><\/li>
- Link copia e cola de modelos<\/a><\/li><\/ol><\/li><\/ol>
- Montando o link manualmente<\/a>
- Token de acesso<\/a><\/li>
- Leitura de dados<\/a><\/li>
- Leitura de metadados<\/a><\/li><\/ol><\/li><\/ol>
- Formato dos dados retornados<\/a><\/li><\/ol><\/li>
- Como usar<\/a><\/span>
- Unidades<\/a>
- Altera\u00e7\u00e3o de unidades<\/a><\/li>
- Unidade gratuita<\/a><\/li><\/ol><\/li><\/ol>
- Alterar token de acesso<\/a><\/li>
- Criar<\/a><\/li>
- Desativar e arquivar<\/a>
- Remover dados sem desativar o destino<\/a><\/li><\/ol><\/li>
- Recomenda\u00e7\u00f5es de seguran\u00e7a<\/a><\/li>
- Padr\u00e3o de tabelas<\/a><\/li>
- Modelos<\/a>
- Editor de modelos<\/a><\/li><\/ol><\/li>
- Consultas<\/a><\/li>
- D\u00favidas comuns do Via Kondado<\/a><\/li><\/ol><\/li><\/ol>\n\n\n\n
<\/p>\n\n\n\n
Acessando seus dados<\/h2>\n\n\n\n
<\/p>\n\n\n\n<\/i><\/a>\n\n\n\n
Link copia e cola<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
A conex\u00e3o com o Via Kondado \u00e9 realizada via API. Voc\u00ea poder\u00e1 obter facilmente o link de acesso API para qualquer tabela, de maneira similar ao modal abaixo. Voc\u00ea poder\u00e1 alterar o separador de decimal entre v\u00edrgula e ponto e ent\u00e3o clicar no \u00edcone de copiar para obter o link<\/p>\n\n\n\n
![\"\"](\"https:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/06\/via-kondado-br-generic-copy-paste.png\")
<\/figure>\n\n\n\nLink copia e cola de integra\u00e7\u00f5es<\/h4>\n\n\n\n<\/i><\/a>\n\n\n\n
Para obter todos os links das tabelas de sua integra\u00e7\u00e3o, basta acessar sua integra\u00e7\u00e3o e clicar no \u00edcone de compartilhar<\/p>\n\n\n\n
![\"\"](\"https:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/10\/image-3.png\")
<\/figure>\n\n\n\nO link de cada tabela estar\u00e1 tamb\u00e9m dispon\u00edvel ao clicar em DETALHES<\/p>\n\n\n\n
![\"\"](\"https:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/06\/image-7.png\")
<\/figure>\n\n\n\nLink copia e cola de modelos<\/h4>\n\n\n\n<\/i><\/a>\n\n\n\n
![\"\"](\"https:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/10\/image-2.png\")
<\/figure>\n\n\n\nMontando o link manualmente<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
A nossa API de leitura deve ser acessada com uma requisi\u00e7\u00e3o
GET<\/code> no hosthttps:\/\/hub.kondado.io<\/code> e autenticada com o par\u00e2metrotoken<\/code> (query string)<\/p>\n\n\n\nToken de acesso<\/h4>\n\n\n\n<\/i><\/a>\n\n\n\n
Para obter o token de acesso ao seu destino, basta acess\u00e1-lo, clicar nas 3 barras horizontais e ent\u00e3o “Ver token”<\/p>\n\n\n\n
![\"\"](\"https:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/06\/image-9-1024x359.png\")
<\/figure>\n\n\n\nEste token permite acesso aos seus dados. Mantenha-o em um lugar seguro<\/p>\n\n\n\n
Leitura de dados<\/h4>\n\n\n\n<\/i><\/a>\n\n\n\n
Para obter os dados de uma tabela
tabela_x<\/code>, basta acessar o pathdata\/tabela_x<\/code>.<\/p>\n\n\n\nCaso o par\u00e2metro
decimal_sep<\/code> n\u00e3o seja informado, o separador de decimal ser\u00e1 o ponto, utilizedecimal_sep=comma<\/code> para obter seus dados separados por v\u00edrgula, por exemplo:<\/p>\n\n\n\nhttps:\/\/hub.kondado.io\/data\/tabela_x?token=seu_token&decimal_sep=comma<\/code><\/p>\n\n\n\n<\/p>\n\n\n\n
Leitura de metadados<\/h4>\n\n\n\n<\/i><\/a>\n\n\n\n
O path
\/metadata<\/code> retorna metadados de suas tabelas no formato JSON<\/p>\n\n\n\n\/metadata\/show_tables<\/code> retorna um ARRAY de JSONs com a lista das tabelas em seu destino na chavetbl_name<\/code><\/li>\/metadata\/kdd_show_tables<\/code> retorna um ARRAY de JSONs com a lista das tabelas em seu destino, incluindo informa\u00e7\u00f5es de localiza\u00e7\u00e3o desta tabela dentro da Kondado:tbl_name<\/code> informa o nome da tabela<\/li>tbl_id<\/code> informa o id da tabela<\/li>origin_object_type<\/code> informa o tipo de objeto que a tabela referencia.pipeline<\/code> significa integra\u00e7\u00e3o<\/li>kubo<\/code> significa modelo<\/li><\/ul><\/li>origin_object_id<\/code> informa o id deste objeto<\/li>origin_object_sub_location<\/code> informa a localiza\u00e7\u00e3o da tabela dentro do objeto, para integra\u00e7\u00f5es que possuem mais de uma tabela. Retorna vazio caso seja a tabela principal da integra\u00e7\u00e3o ou uma tabela de um modelo<\/li>origin_object_created_rev<\/code> c\u00f3digo interno que indica a vers\u00e3o do objeto que referencia a tabela<\/li>createdAt<\/code> data de cria\u00e7\u00e3o da tabela<\/li>updatedAt<\/code> data de \u00faltima atualiza\u00e7\u00e3o da tabela<\/li><\/ul><\/li>\/metadata\/kdd_show_table_sizes<\/code> retorna um ARRAY de JSONs com a lista das tabelas em seu destino e informa\u00e7\u00f5es sobre os tamanhos destas tabelas:tbl_name<\/code> informa o nome da tabela<\/li>tbl_id<\/code> informa o id da tabela<\/li>num_rows<\/code> n\u00famero de linhas da tabela<\/li>num_cols<\/code> n\u00famero de colunas da tabela<\/li>num_cells<\/code> n\u00famero de c\u00e9lulas da tabela<\/li>size_bytes<\/code> tamanho da tabela em bytes<\/li>billable_mb_size<\/code> tamanho da tabela em megabytes a fim de contagem de acessos<\/li>billable_requests<\/code> quantos acessos a tabela ir\u00e1 consumir ao ser lida<\/li><\/ul><\/li>\/metadata\/schemas\/tabela_x<\/code> retorna o schema da tabelatabela_x<\/code>col_type<\/code> informa o nome do campo (chave\/header)<\/li>col_type<\/code> representa o tipo do campo:text<\/code>,float<\/code>,int<\/code>,timestamp<\/code>,date<\/code> ouboolean<\/code><\/li><\/ul><\/li><\/ul>\n\n\n\nFormato dos dados retornados<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
Sempre que o link de dados (
\/data<\/code>) for acessado, ser\u00e1 retornada a vers\u00e3o mais recente de sua tabela no Via Kondado no formato CSV, o que permite compatibilidade com v\u00e1rias ferramentas de visualiza\u00e7\u00e3o e an\u00e1lise.<\/p>\n\n\n\nO separador de colunas deste arquivo ser\u00e1 a v\u00edrgula e voc\u00ea poder\u00e1 alternar entre v\u00edrgula ou ponto como separador de decimais com o par\u00e2metro<\/a>
decimal_sep<\/code> caso crie o link manualmente ou diretamente no modal de obten\u00e7\u00e3o do link de nossa plataforma.<\/p>\n\n\n\nPara aumentar a compatibilidade e formata\u00e7\u00e3o do CSV, quebras de linha (\/n, \/r e \/r\/n) em campos do tipo
text<\/code> ser\u00e3o removidos nas tabelas de integra\u00e7\u00f5es. Nas tabelas de modelos, esta remo\u00e7\u00e3o apenas ocorrer\u00e1 devido a altera\u00e7\u00f5es realizadas pelo SQL do modelo.<\/p>\n\n\n\nAl\u00e9m disso, boa parte dos acentos e caracteres especiais ser\u00e3o substitu\u00eddos.<\/p>\n\n\n\n
<\/p>\n\n\n\n
Como usar<\/h2>\n\n\n\n<\/i><\/a>\n\n\n\n
Unidades<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
Cada destino Via Kondado pode ser configurado para ter uma certa capacidade, de acordo com a quantidade de unidades<\/strong> alocadas. Uma unidade possui 3 componentes:<\/p>\n\n\n\n
- Acessos<\/strong>
- Cada unidade concede 2 mil acessos\/m\u00eas<\/li><\/ul>
- \u00c9 uma medida de acesso aos dados e indica quantas leituras por m\u00eas a cada 10 mb (megabytes) podem ser realizadas via links de dados<\/a> e metadados<\/a> do destino.<\/li>
- Por exemplo, uma tabela de 5mb consome 1 acesso ao ser lida. Uma tabela de 18mb consome 2 acessos<\/li><\/ul><\/li>
- C\u00e9lulas<\/strong>:
- Cada unidade concede 10 milh\u00f5es de c\u00e9lulas armazenadas por m\u00eas<\/li>
- \u00c9 uma medida de armazenamento de dados. Indica quantas c\u00e9lulas por m\u00eas podem ser armazenadas no destino. De forma similar a uma planilha, uma c\u00e9lula \u00e9 a menor unidade de uma tabela e representa a intersec\u00e7\u00e3o de uma linha e uma coluna. Dentro de um dado m\u00eas, a quantidade de c\u00e9lulas pode ser vari\u00e1vel, j\u00e1 que uma tabela pode aumentar\/diminuir de tamanho, bem como ser removida ou criada a qualquer momento e a contabiliza\u00e7\u00e3o de c\u00e9lulas por m\u00eas reflete esta varia\u00e7\u00e3o<\/li><\/ul><\/li>
- Modelos ativos<\/strong>
- Cada unidade concede 2 modelos<\/a> ativos<\/li><\/ul><\/li><\/ul>\n\n\n\n
Altera\u00e7\u00e3o de unidades<\/h4>\n\n\n\n<\/i><\/a>\n\n\n\n
\u00c9 poss\u00edvel alterar o n\u00famero de unidades diretamente na p\u00e1gina do destino<\/p>\n\n\n\n
![\"\"](\"https:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/06\/image-10.png\")
<\/figure>\n\n\n\nO modal que ser\u00e1 aberto indicar\u00e1 a precifica\u00e7\u00e3o mensal total. Podem ser concedidas unidades gratuitas, a nosso crit\u00e9rio. Basta clicar em SALVAR para aplicar a nova configura\u00e7\u00e3o<\/p>\n\n\n\n
![\"\"](\"https:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/06\/image-11.png\")
<\/figure>\n\n\n\nUnidade gratuita<\/h4>\n\n\n\n<\/i><\/a>\n\n\n\n
A unidade gratuita inclusa no plano do cliente \u00e9 concedida no momento de cria\u00e7\u00e3o ou edi\u00e7\u00e3o das unidades do destino<\/p>\n\n\n\n
Alterar token de acesso<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
Para alterar o token de acesso de seu destino, basta acess\u00e1-lo, clicar nas 3 barras horizontais e ent\u00e3o \u201cAlterar token\u201d<\/p>\n\n\n\n
![\"\"](\"https:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/06\/image-12-1024x345.png\")
<\/figure>\n\n\n\nVoc\u00ea deve alterar seu token sempre que suspeitar que ele foi comprometido. Atera\u00e7\u00f5es frequentes tamb\u00e9m s\u00e3o recomendadas. Ao alterar seu token, ser\u00e1 gerado um novo e o anterior deixar\u00e1 de funcionar, sendo preciso atualizar o novo token em seus links<\/p>\n\n\n\n
Criar<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
Ap\u00f3s seu per\u00edodo de teste gr\u00e1tis, voc\u00ea pode ter quantas inst\u00e2ncias de Via Kondado quiser, cada um conter\u00e1 seus pr\u00f3prios dados e ter\u00e1 seu pr\u00f3prio token de acesso. Para criar um novo destino, basta clicar em “Criar+” na barra superior, escolher Via Kondado, dar um nome e um n\u00famero de unidades ao novo destino<\/p>\n\n\n\n
Desativar e arquivar<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
Para desativar e arquivar seu destino, basta acess\u00e1-lo, clicar nas 3 barras horizontais e ent\u00e3o \u201cDesabilitar e arquivar\u201d. Esta a\u00e7\u00e3o \u00e9 irrevers\u00edvel, remover\u00e1 os dados das tabelas deste destino e o tornar\u00e1 inacess\u00edvel via Link. Integra\u00e7\u00f5es e modelos deste destino ser\u00e3o arquivados<\/p>\n\n\n\n
![\"\"](\"https:\/\/kondado.com.br\/blog\/wiki\/wp-content\/uploads\/sites\/2\/2024\/06\/image-13-1024x345.png\")
<\/figure>\n\n\n\nRemover dados sem desativar o destino<\/h4>\n\n\n\n<\/i><\/a>\n\n\n\n
Voc\u00ea pode arquivar uma integra\u00e7\u00e3o ou modelo para remover estes dados espec\u00edficos de seu destino Via Kondado<\/p>\n\n\n\n
Recomenda\u00e7\u00f5es de seguran\u00e7a<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
Seu token permite acesso aos seus dados, utilize o mais alto grau de seguran\u00e7a em sua manipula\u00e7\u00e3o<\/p>\n\n\n\n
\u00c9 poss\u00edvel obter este token de v\u00e1rias maneiras pela plataforma da Kondado, por isso recomendamos proteger o acesso \u00e0 sua conta da Kondado aplicando configura\u00e7\u00f5es de login adequadas<\/a>, permitindo acesso somente com m\u00e9todos que possuam autentica\u00e7\u00e3o de 2 fatores habilitados e dom\u00ednios restritos.<\/p>\n\n\n\n
Padr\u00e3o de tabelas<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
Nomes de tabelas<\/h4>\n\n\n\n
- N\u00e3o come\u00e7ar com duckdb_<\/em>, pragma_,<\/em> pg_<\/em> ou sqlite_<\/em> <\/li>
- N\u00e3o conter caracteres especiais ou espa\u00e7o<\/li>
- Utilizar sempre caixa baixa<\/li><\/ul>\n\n\n\n
Campos<\/h4>\n\n\n\n
- O n\u00famero m\u00e1ximo de campos por tabela \u00e9 1500<\/li>
- Os anos minimos e maximos para os campos dos tipos
date <\/code><\/strong>etimestamp <\/code><\/strong>s\u00e3o, respectivamente, 1677 e 2262. Caso uma data n\u00e3o esteja dentro deste intervalo ser\u00e1 retornada comovazia<\/code><\/strong>.<\/li><\/ul>\n\n\n\nModelos<\/h3>\n\n\n\n<\/i><\/a>\n\n\n\n
\u00c9 poss\u00edvel utilizar nossa funcionalidade de modelos<\/a> no destino Via Kondado, que utiliza a sintaxe DuckDB<\/a>, com as seguintes particularidades:<\/p>\n\n\n\n
- Seu SQL deve conter apenas um comando do tipo
SELECT<\/code><\/li>- O comando
SHOW<\/code> n\u00e3o \u00e9 permitido em seu SQL<\/li>- Alias de colunas ser\u00e3o normalizados na tabela final, substituindo caracteres n\u00e3o ANSI e espa\u00e7os por “_”<\/li>
- N\u00e3o deve ser utilizada a nota\u00e7\u00e3o de ponto “.” para se referir a tabelas em seu SQL<\/li>
- N\u00e3o \u00e9 permitida a fun\u00e7\u00e3o
RANGE<\/code><\/li>PIVOT<\/code> e - O comando
- Seu SQL deve conter apenas um comando do tipo
- N\u00e3o come\u00e7ar com duckdb_<\/em>, pragma_,<\/em> pg_<\/em> ou sqlite_<\/em> <\/li>
- Cada unidade concede 2 modelos<\/a> ativos<\/li><\/ul><\/li><\/ul>\n\n\n\n
- \u00c9 uma medida de acesso aos dados e indica quantas leituras por m\u00eas a cada 10 mb (megabytes) podem ser realizadas via links de dados<\/a> e metadados<\/a> do destino.<\/li>
- Cada unidade concede 2 mil acessos\/m\u00eas<\/li><\/ul>
- Consultas<\/a><\/li>
- Recomenda\u00e7\u00f5es de seguran\u00e7a<\/a><\/li>
- Criar<\/a><\/li>
- Unidade gratuita<\/a><\/li><\/ol><\/li><\/ol>
- Altera\u00e7\u00e3o de unidades<\/a><\/li>
- Como usar<\/a><\/span>
- Leitura de dados<\/a><\/li>
- Token de acesso<\/a><\/li>
- Link copia e cola de modelos<\/a><\/li><\/ol><\/li><\/ol>
- Link copia e cola de integra\u00e7\u00f5es<\/a><\/li>
- Link copia e cola<\/a>