Quick BI:Perguntas frequentes sobre conjuntos de dados

Erros de SQL personalizado

Se a execução ou o salvamento do SQL personalizado falhar, verifique as causas comuns abaixo.

1. Sintaxe incorreta de SQL personalizado

O Quick BI pré-processa o SQL personalizado antes de enviá-lo ao banco de dados: analisa placeholders, adiciona uma cláusula de limite e insere comentários SQL. Um erro de sintaxe faz o banco de dados retornar um erro nessa etapa.

Execute a instrução diretamente no banco de dados para verificar a sintaxe. Consulte instruções executadas anteriormente no Histórico.

2. Instruções antes da instrução SELECT

O Quick BI adiciona uma cláusula limit 200 ao executar ou salvar SQL personalizado; portanto, a consulta deve começar com uma instrução SELECT. Inserir qualquer instrução — incluindo instruções HINT — antes do SELECT causa falha na consulta.

Para usar uma instrução HINT, selecione a opção Set HINT Statement em vez de escrevê-la inline.

Para fontes de dados compatíveis com instruções HINT, consulte Lista de recursos de fonte de dados.

3. Placeholders usados sem valores padrão

O SQL personalizado permite passagem de parâmetros por meio de placeholders. Ao visualizar um relatório, os controles de consulta passam valores de placeholder para o SQL subjacente, permitindo filtragem flexível. Para casos de uso e sintaxe de placeholders, consulte Placeholders.

Todo placeholder usado dentro de uma instrução SELECT deve ter um valor padrão. Sem ele, o SQL fica incompleto em tempo de execução e retorna um erro.

No exemplo abaixo, o campo Order Level falha porque o placeholder de valor $val{profit_range} não possui valor padrão. Atribuir um valor padrão de 100 e reexecutar o SQL resolve o problema.

Defina um valor padrão global para placeholders nas instruções SELECT — não apenas um valor padrão no nível do conjunto de dados — para evitar erros quando usuários abrirem o painel sem definir um valor de filtro.

SELECT report_date, order_level, shipping_type,price,order_number,area,
   case when profit_amt< $val{profit_range} then'Loss' 
   when profit_amt> $val{profit_range} then'Profit'
   else 'Break-even'
   end 'Order Level'
from company_sales_record
where $expr{report_date :report_date}
and $expr{order_level :order_level}
and $expr{order_number :order_number}

4. Outros problemas

Siga convenções padrão para comentários e aliases no SQL personalizado. O uso fora do padrão pode fazer o banco de dados retornar nomes de campo inesperados, causar falhas na análise de placeholders ou gerar outros erros.

Não adicione ponto e vírgula (;) no final do SQL personalizado.

Erros em campos calculados

1. Campos calculados referenciam colunas da tabela física. Para converter o tipo de dados de um campo, use a função de conversão apropriada. Alterar o tipo na interface do usuário não modifica o tipo do campo físico subjacente e pode causar erro.

2. Campos calculados de dimensão não podem conter funções de agregação como SUM ou AVG. Para agregar dados, salve o campo como medida.

3. Campos de texto aceitam apenas as agregações COUNT e COUNTD. Funções como SUM, MAX e similares não estão disponíveis para campos de texto. Converta o campo para um tipo numérico antes de executar esses cálculos.

Criação de conjuntos de dados a partir de arquivos locais

Ao criar um conjunto de dados a partir de um arquivo local carregado, use a sintaxe SQL da source de dados de destino. Por exemplo, carregar um arquivo em um espaço de exploração exige a sintaxe do ClickHouse ao criar e consultar o conjunto de dados.

Carregar um arquivo em um espaço de exploração tem duas limitações: não há suporte a SQL personalizado nem a junções entre fontes diferentes. Para usar esses recursos, carregue o arquivo em uma source de dados dentro de um espaço de grupo compatível com junções entre fontes.

Se você carregar um arquivo em uma source de dados de banco de dados e usar SQL personalizado, referencie o nome da tabela física gerado automaticamente no banco de dados, e não o nome original do arquivo. Para encontrar o nome da tabela física, abra a lista de arquivos da source de dados, clique em no ícone de configurações do arquivo e procure o nome na página de edição.

Conversão de timestamps Unix para data/hora

Configuração da exibição de valores nulos ou vazios

1. Configure o estilo de exibição para valores vazios nas configurações do conjunto de dados.

1. Configure o estilo de exibição para valores vazios nas configurações do painel.

Uso de SQL parametrizado para cálculos de proporção

O Quick BI não oferece suporte nativo a cálculos de proporção, mas é possível implementá-los com SQL parametrizado em um conjunto de dados personalizado.

O exemplo a seguir calcula a participação de cada cidade no total de vendas de sua província, com intervalo de datas selecionável pelo usuário e filtros de província/cidade. O conjunto de dados possui quatro campos: data (date), província (province), cidade (city) e valor de vendas (order_amt).

select a.city,sum(fenzi)/sum(fenmu) as ratio
from
(select province,city,sum(order_amt) fenzi
 from  zhanbi_test
 where  $expr{date:date_para}
 and    $expr{province:province_para}
 and    $expr{city:city_para}
 group by province,city
)a
left  join
(select province,sum(order_amt) fenmu
 from  zhanbi_test
 where  $expr{date:date_para}
 and    $expr{province:province_para}
 and    $expr{city:city_para}
 group by province
)b on a.province=b.province

Essa consulta agrega pelo campo city; adapte-a para agregar por outros campos. Após gerar o SQL, converta o campo de data para o tipo data nas configurações de parâmetro do conjunto de dados. Em seguida, crie o conjunto de dados e adicione-o a um painel.

Uso de SQL parametrizado para cálculos cumulativos

select  a.mon_date,avg(a.order_num) order_num,sum(b.order_num) add_num
from (
select date_format(report_date,'%Y/%m') mon_date,count(distinct order_id) order_num,max(date_format(report_date,'%Y/%m')) max_mon_date
from  company_sales_record_copy
where  $expr{report_date:month_date}
group by date_format(report_date,'%Y/%m')
)a
left join(
select date_format(report_date,'%Y/%m') mon_date,count(distinct order_id) order_num
from  company_sales_record_copy
where  $expr{report_date:month_date}
group by date_format(report_date,'%Y/%m')
)b on a.max_mon_date>=b.mon_date
group by a.mon_date        

Quando o controle de consulta está vinculado ao campo de parâmetro no painel, filtrar por um intervalo de meses retorna o valor cumulativo para cada mês a partir do primeiro mês do intervalo.

Consulta dos últimos N dias com uma única data

select   report_date,area,product_type,count(distinct order_id) order_num
from   company_sales_record
where  area in ('Southwest','Northwest','North China')
and    ( $expr{dateadd(report_date,1,'dd'):date1}
or      $expr{dateadd(report_date,2,'dd'):date1}
or      $expr{dateadd(report_date,3,'dd'):date1})
group by area,product_type,report_date

Segurança no nível de linha

Sim. Para mais informações, consulte Segurança no nível de linha.

Limite padrão de exibição de linhas

Por padrão, o sistema exibe 100 linhas.

Paginação na visualização de dados

Não.

Novos campos não exibidos

Uso de dados geográficos em gráficos de mapa

Na página de edição do conjunto de dados, altere o tipo de dimensão do campo geográfico para o tipo de informação geográfica apropriado.

Para detalhes, consulte Criar um conjunto de dados.

Uso de descrições de campo como nomes

Nas configurações do workspace, configure o uso de nomes de tabelas ou observações ao criar conjuntos de dados nesse workspace.

Também é possível selecionar vários campos no painel de configuração em massa de campos do conjunto de dados e aplicar as descrições como nomes de campo em lote.

Atualização de conjuntos de dados após alterações na tabela

Quando um campo físico deixa de ser encontrado, o Quick BI não o remove automaticamente, pois o campo ainda pode estar referenciado em análises ou painéis upstream. Clique em na tabela no canvas para visualizar as alterações de campo no painel à direita e exclua todos os campos inválidos de uma só vez.

Criação de conjuntos de dados a partir de múltiplos bancos de dados

Arraste tabelas de ambas as fontes de dados para o canvas e configure um relacionamento entre elas. Após a aceleração com o Quick Engine, os dados estarão prontos para uso. Para fontes de dados compatíveis com o Quick Engine, consulte Lista de recursos de fonte de dados.

Cópia de conjuntos de dados para outro workspace

Use o recurso de cópia de conjunto de dados entre workspaces. Para detalhes, consulte Copiar um conjunto de dados entre workspaces.

Configuração de modelos de dados para análise de múltiplas tabelas

Para mais informações, consulte Construir um modelo.

Configurar um modelo de dados define relacionamentos JOIN entre tabelas. Faça essa configuração na página de edição do conjunto de dados. Para detalhes, consulte Construir um modelo.

Benefícios do cache de consulta de conjunto de dados

Ativar o cache de resultados de consulta acelera o acesso aos relatórios e reduz a carga no banco de dados. Após a primeira solicitação, as consultas subsequentes dentro da duração do cache são atendidas a partir dele. O banco de dados só é consultado novamente quando o cache expira.

Otimização de consultas lentas de conjunto de dados SQL

1. Otimize a lógica SQL: verifique se os índices estão sendo utilizados e substitua junções complexas por views de banco de dados sempre que possível.

2. Defina valores padrão globais para placeholders SQL para evitar varreduras completas de tabela quando nenhum filtro for aplicado.