how to create and modify a file data source - Quick BI: Central de Documentação do Alibaba Cloud

Cenários

Crie uma fonte de dados a partir de um arquivo local e analise-a em conjunto com fontes de dados online.

Limites

Tipo de arquivo	Limites
Excel	Por padrão, o sistema identifica a primeira linha do arquivo carregado como linha de cabeçalho e começa a ler os dados a partir da segunda linha. Se necessário, ajuste a linha de cabeçalho na página Preview Data. A linha de cabeçalho não deve conter células vazias. Defina o número de linhas de cabeçalho na página Preview Data ou modifique o arquivo e carregue-o novamente. É possível analisar e carregar no máximo cinco planilhas. Para carregar mais de cinco, divida o conteúdo em vários arquivos do Excel. Uma única planilha não pode conter mais de 100 colunas ou células mescladas. O tamanho recomendado do arquivo é de até 50 MB. Por exemplo, se um arquivo tiver 98 colunas e 1 milhão de linhas com tamanho de 80 MB, divida-o em vários arquivos e carregue-os anexando linhas. Evite caracteres especiais nos nomes dos arquivos para garantir compatibilidade e legibilidade. Evite conteúdo calculado por funções do Excel no arquivo carregado, como VLOOKUP e SUMIFS. Um workspace pode conter no máximo 100 fontes de dados.
CSV	Um arquivo pode conter no máximo 100 colunas. O tamanho recomendado do arquivo é de até 50 MB. Por exemplo, se um arquivo tiver 98 colunas e 1 milhão de linhas com tamanho de 80 MB, divida-o em vários arquivos e carregue-os anexando linhas.

Observações

Ao carregar um arquivo, observe o seguinte:

Os tipos de campo suportados são texto, numérico e data. Ao configurar campos, selecione esses tipos ou permita que o sistema os identifique automaticamente com base no conteúdo dos dados. Também é possível modificar os tipos de campo.
Ao carregar um arquivo CSV, converta-o para o formato UTF-8.

O Quick BI identifica com precisão a codificação de arquivos CSV no formato UTF-8. No entanto, a codificação de arquivos CSV nos formatos GBK e GB2312 pode não ser identificada automaticamente, o que pode resultar em texto ilegível.
Utilize o Google Chrome para carregar arquivos.
Em um arquivo carregado, o tipo de dados de uma coluna é determinado pelos valores nas primeiras 100 linhas:
- Se as primeiras 100 linhas contiverem apenas números, o sistema identificará a coluna como numérica.
- Se qualquer uma das primeiras 100 linhas contiver uma string, o sistema identificará a coluna como string.
Campos numéricos não são compatíveis com dados do tipo string. Campos do tipo string são compatíveis com dados numéricos.

Preparações

Confirme os tipos de arquivo suportados:
- Os tipos de arquivo suportados são CSV e Excel. Os formatos do Excel suportados são .xls e .xlsx.
- Para obter mais informações, consulte Observações.
Verifique se o formato e o tamanho do arquivo atendem aos requisitos em Limites.

Pontos de entrada

Faça logon no console do Quick BI e use um dos métodos a seguir para carregar um arquivo local.

Carregue um arquivo local a partir da página Data Sources:

Você deve ter permissões de leitura e gravação para a fonte de dados de destino, e a fonte de dados deve suportar uploads de arquivos. Para obter mais informações sobre quais fontes de dados suportam uploads de arquivos, consulte Recursos avançados de fonte de dados.
Carregue um arquivo local a partir da página de edição de conjunto de dados:

Carregar um arquivo

Na página Upload File, carregue e configure um arquivo local do Excel ou CSV como fonte de dados. O exemplo a seguir utiliza o arquivo Sales data examples .xlsx.

Nota

Ao carregar um arquivo do Excel, é possível carregar no máximo cinco planilhas. Para carregar mais de cinco, divida o conteúdo em vários arquivos do Excel.
Ao carregar um arquivo CSV, utilize o formato UTF-8.

Na página File Upload, clique em no arquivo ou arraste-o para a área de upload. Após a conclusão do upload, a página Preview Data será exibida.

Na página Preview Data, visualize as informações a seguir e faça ajustes conforme necessário.

Conteúdo exibido	Configuração	Operação
Área ① Planilhas e títulos no arquivo carregado	Alternar planilhas	Clique em uma aba para alternar entre planilhas e visualizar os dados. Os dados na Área ④ mudam ao alternar as abas.
	Renomear uma planilha	Clique em duas vezes no nome de uma planilha para renomeá-la conforme suas necessidades de negócios. Por padrão, o Quick BI usa o nome da planilha do arquivo local. Nota Os nomes das planilhas não podem conter caracteres especiais ou espaços à esquerda ou à direita.
	Alterar o status de seleção de uma planilha	Clique em no ícone ao lado do nome de uma planilha para alterar seu status de seleção. Por padrão, todas as planilhas estão selecionadas. Se você desmarcar a caixa de seleção de uma planilha, ela não será carregada. Nota É necessário selecionar pelo menos uma planilha para carregar o arquivo.
	Atalhos de planilha	Clique em no ícone no lado direito da barra de abas e selecione um atalho na lista suspensa. Select only current sheet: Apenas a planilha atual é selecionada. Após o upload, o arquivo conterá apenas os dados da planilha atual. Select all sheets: Todas as planilhas na barra de abas são selecionadas. Após o upload, o arquivo conterá os dados de todas as planilhas. Exclude current sheet: A planilha atual é desmarcada. Após o upload, o arquivo não conterá os dados da planilha atual.
Área ② Nomes de arquivos	Display Name	Nome de exibição do arquivo carregado no Quick BI. O sistema usa o nome do arquivo como padrão. Altere-o conforme necessário. Nota Os nomes de exibição não podem conter caracteres especiais ou espaços à esquerda ou à direita.
Área ② Nomes de arquivos	Physical Table Name	Nome da tabela criada automaticamente no banco de dados após o upload do arquivo. Altere o nome da tabela física conforme necessário. Nota Um nome de tabela física pode conter apenas letras, dígitos e sublinhados (_). O nome não deve ter mais de 150 caracteres.
Área ③ Linha de cabeçalho	Header Row	Altere a linha de cabeçalho da planilha atual. Nota O número deve ser um inteiro maior que 0. Certifique-se de que a linha de cabeçalho não contenha campos vazios. Caso contrário, ocorrerá um erro.
Área ④ Conteúdo de dados do arquivo carregado	Data Preview	Na aba Data Preview, visualize nomes de campos, tipos de campos e dados do arquivo carregado. O sistema identifica automaticamente os tipos de campo e lê os nomes dos campos. Modifique-os se os valores detectados estiverem incorretos. Modificar um nome de campo: Clique em na caixa de texto do nome do campo para alterá-lo. Modificar um tipo de campo: Clique em no ícone de tipo de campo e selecione um tipo na lista suspensa. Os tipos suportados são texto, numérico e data. Nota Se você alterar um tipo de campo para um que não corresponda ao conteúdo dos dados, como mudar um campo de nome para o tipo data, os dados serão exibidos como "-". Se um arquivo contiver dados que não correspondam ao tipo de campo, esses dados serão convertidos em valor nulo durante o upload. Uma janela pop-up solicitará que você confirme o conteúdo dos dados.
Área ④ Conteúdo de dados do arquivo carregado	Field Details	Na aba Field Details, configure o File Field Name, o Database Field Name e o Field Type. Após o upload, o arquivo é armazenado como uma tabela de banco de dados. O nome e o tipo do campo do banco de dados mapeiam para as colunas da tabela gerada, e o nome da coluna do arquivo torna-se o comentário do campo.

Clique em Confirm and Upload na parte inferior da página. Uma caixa de diálogo aparecerá mostrando o progresso do upload para cada planilha. Se o upload falhar, clique em Back (①) na caixa de diálogo de erro para retornar à etapa Preview Data e ajustar detalhes, como tipos de campo e nomes de planilhas. Também é possível clicar em Re-upload (②) para retornar à etapa File Upload e carregar um arquivo corrigido. Alternativamente, clique em na mensagem de erro (③) para visualizar a causa do erro e seu ID de rastreamento.
Após o upload do arquivo, clique em Return to Data Source List para visualizar a fonte de dados do arquivo carregado.

Modificar um arquivo carregado

Após carregar um arquivo, anexe dados, substitua o arquivo ou exclua arquivos antigos conforme as mudanças nas necessidades do negócio.

Clique em no ícone à direita do arquivo de destino para acessar a página Modify File Upload. Nesta página, realize as operações a seguir.

Configuração		Operação
Display Name		Nome de exibição do arquivo no Quick BI. É possível alterar este nome. Nota Os nomes de exibição não podem conter caracteres especiais ou espaços à esquerda ou à direita.
Data Preview	Exibir dados	No painel Append History, alterne entre arquivos para visualizar seus dados.
Data Preview	Modificar campos	Modificar um nome de campo: Clique em na caixa de texto do nome do campo para alterá-lo. Modificar um tipo de campo: Clique em no ícone de tipo de campo e selecione um tipo na lista suspensa. Os tipos suportados são texto, numérico e data. Nota A modificação de campos só é permitida durante a visualização dos Overall Data.
Field Details	Modificar campos	Modificar um nome de campo: Clique em na caixa de texto do nome da coluna do arquivo para alterar o nome do campo. Modificar um tipo de campo: Clique em na lista suspensa de tipo de campo e selecione um tipo. Os tipos suportados são texto, numérico e data. Excluir um campo: Clique em no ícone na coluna Actions do campo de destino para excluí-lo. Nota A modificação de campos só é permitida durante a visualização dos Overall Data.
Add a field		Clique em Add Field no canto superior direito da tabela. Na caixa de diálogo Add Field, insira as informações do novo campo e clique em OK. Nota A adição de campos só é permitida durante a visualização dos Overall Data. Field Display Name: Nome de exibição do campo a ser adicionado na plataforma Quick BI. Physical Field Name: Nome do campo a ser adicionado na tabela física do banco de dados. Field Type: Os tipos suportados são texto, numérico e data.
Append History	Visualizar histórico de anexos	O painel Append History lista os arquivos anexados. Clique em um cartão de arquivo para visualizar o conteúdo anexado.
	Anexar um arquivo	Se novos arquivos de dados de negócios forem gerados devido ao crescimento do negócio, anexe os novos arquivos à tabela correspondente à fonte de dados de arquivo existente. Para obter mais informações, consulte Anexar um arquivo.
	Substituir um arquivo	Se novos dados de negócios precisarem substituir dados antigos devido a mudanças no negócio, substitua o arquivo antigo. Para obter mais informações, consulte Substituir um arquivo.
	Excluir um arquivo	Se um arquivo de dados de negócios contiver dados inconsistentes, exclua o arquivo da lista de arquivos carregados correspondente à tabela. Para obter mais informações, consulte Excluir um arquivo.

Anexar um arquivo

Quando novos dados de negócios forem gerados, anexe-os ao arquivo existente para manter seus dados atualizados e completos.

Faça logon no Workbench e acesse a página Data Sources. Na lista Uploaded Files, localize o arquivo de destino e clique em seu nome (③) ou no ícone (④) na coluna Actions.
Na página Modify File Upload, clique em Append à direita.
No painel Append File, clique em no arquivo que deseja anexar ou arraste-o para a área de upload.
Na página Data Preview, alterne para a aba da planilha (①) que deseja anexar ao arquivo original. Altere a Header Row (②) e o Field Type (③) conforme necessário. Em seguida, clique em Next (④).
Na etapa Field Matching, faça a correspondência dos campos entre o arquivo anexado e o arquivo original. O sistema corresponde campos com o mesmo nome por padrão. Altere manualmente a relação de correspondência se necessário. Para campos com nomes diferentes, arraste-os manualmente da área Fields to Match para a área Field Matching.
Nota
- Garanta que os tipos de campo do arquivo original e do arquivo anexado correspondam. Caso contrário, ocorrerá um erro. As regras de correspondência são as seguintes:
  - Se o campo original for text, ele poderá corresponder a qualquer tipo de campo.
  - Se o campo original for numeric, ele só poderá corresponder ao tipo numeric.
  - Se o campo original for date, ele só poderá corresponder ao tipo date.
- Se o arquivo anexado tiver mais campos que o arquivo original, clique em Add Field para criar os campos correspondentes no arquivo original para fins de correspondência. Se os campos extras não forem necessários, prossiga para a próxima etapa.
- Se o arquivo anexado tiver menos campos que o arquivo original, os campos extras no arquivo original podem permanecer sem correspondência. Prossiga para a próxima etapa.
- Se o arquivo anexado contiver campos duplicados, o sistema tentará corresponder campos com o mesmo nome em ordem. Nesse caso, ajuste manualmente a relação de correspondência na etapa Field Matching. Garanta que cada campo na tabela original corresponda a apenas um campo no arquivo anexado. Para campos duplicados, selecione um para correspondência com base nas necessidades do negócio.
Clique em Confirm and Upload. Após o sucesso do upload, visualize o arquivo anexado no painel de histórico de anexos.
(Opcional) Para substituir um arquivo anexado, acesse o painel Append History e clique em no ícone ao lado do arquivo que deseja substituir. Isso abre a interface Replace File, onde é possível realizar as operações necessárias.

Substituir um arquivo

Se alguns dados no arquivo original precisarem ser atualizados enquanto o restante ainda é válido, substitua-os na fonte de dados existente para manter a precisão.

Na página Modify File Upload, acesse o painel Append History. Selecione o arquivo a ser substituído e clique em no ícone no cartão do arquivo, ou clique em Replace Data no canto superior direito da tabela de dados.
Na página Replace File, clique em no novo arquivo ou arraste-o para a área de upload.

Nota
Apenas a substituição de planilha única é suportada. Se o arquivo carregado tiver várias planilhas, selecione a planilha correta na página de visualização antes de fazer o upload.
Na página Data Preview, alterne para a aba da planilha (①) que deseja usar para substituir o arquivo original. Altere a Header Row (②) e o Field Type (③) conforme necessário. Em seguida, clique em Next (④).
Na etapa Field Matching, faça a correspondência dos campos entre o arquivo de substituição e o arquivo original. O sistema corresponde campos com o mesmo nome por padrão. Altere manualmente a relação de correspondência se necessário. Para campos com nomes diferentes, arraste-os manualmente da área Fields to Match para a área Field Matching.
Nota
- Garanta que os tipos de campo do arquivo original e do arquivo de substituição correspondam. Caso contrário, ocorrerá um erro. As regras de correspondência são as seguintes:
  - Se o campo original for text, ele poderá corresponder a qualquer tipo de campo.
  - Se o campo original for numeric, ele só poderá corresponder ao tipo numeric.
  - Se o campo original for date, ele só poderá corresponder ao tipo date.
- Se o arquivo de substituição tiver mais campos que o arquivo original, clique em Add Field para criar os campos correspondentes no arquivo original para fins de correspondência. Se os campos extras não forem necessários, prossiga para a próxima etapa.
- Se o arquivo de substituição tiver menos campos que o arquivo original, os campos extras no arquivo original podem permanecer sem correspondência. Após a substituição, os campos extras são retidos nos dados. Visualize-os nos Field Details dos dados.
- Se o arquivo de substituição contiver campos duplicados, o sistema tentará corresponder campos com o mesmo nome em ordem. Nesse caso, ajuste manualmente a relação de correspondência na etapa Field Matching. Garanta que cada campo na tabela original corresponda a apenas um campo no arquivo de substituição. Para campos duplicados, selecione um para correspondência com base nas necessidades do negócio.
Clique em Confirm and Upload. Após o sucesso do upload, visualize o arquivo substituído no painel de histórico de anexos.

Excluir um arquivo

Se você não precisar mais de um arquivo de dados de negócios, ou se o arquivo contiver dados inconsistentes, selecione-o e exclua-o no painel Append History na página Modify File Upload.

Arquivos locais de exemplo

Baixe o seguinte arquivo CSV para prática: Sales data examples.csv.
Baixe o seguinte arquivo do Excel para prática: Sales data examples .xlsx.

Os dados de vendas possuem a seguinte estrutura.

Nome do campo	Tipo de campo	Descrição do campo
order_id	varchar	ID do pedido
report_date	datetime	Data do pedido
customer_name	varchar	Nome do cliente
order_level	varchar	Nível do pedido
order_number	double	Quantidade do pedido
order_amt	double	Valor do pedido
back_point	double	Desconto
shipping_type	varchar	Método de envio
profit_amt	double	Valor do lucro
price	double	Preço unitário
shipping_cost	double	Custo de envio
area	varchar	Área
province	varchar	Estado
city	varchar	Cidade
product_type	varchar	Tipo de produto
product_sub_type	varchar	Subtipo de produto
product_name	varchar	Nome do produto
product_box	varchar	Pacote do produto
shipping_date	datetime	Data de envio

Próximos passos

Após criar uma fonte de dados de arquivo, crie um conjunto de dados e analise os dados.

Crie um conjunto de dados a partir da fonte de dados de arquivo. Para obter mais informações, consulte Modelagem de dados.

Nota
A partir da versão 6.0.1, ao criar um novo conjunto de dados a partir de uma fonte de dados de arquivo, adicione um novo campo calculado usando funções integradas do sistema.
Visualize e analise dados usando painéis, pastas de trabalho e dashboards de dados. Para obter mais informações, consulte Análise de dados.
Projete um portal de BI para seus relatórios e configure tarefas de rastreamento e monitoramento de métricas para aplicar seus insights de dados. Para obter mais informações, consulte Aplicação de dados.

Perguntas frequentes

1. O que fazer se o conteúdo de um arquivo CSV carregado contiver texto ilegível?

O Quick BI decodifica com precisão arquivos CSV no formato UTF-8. Geralmente, também decodifica arquivos GBK ou GB2312, mas a decodificação pode falhar ocasionalmente. Se isso acontecer, converta o arquivo para UTF-8.

Abra o arquivo CSV usando o Bloco de Notas.
Selecione Save As.
Clique em na seta suspensa de Encoding.
Na lista Encoding, selecione UTF-8.

2. O que fazer se o erro "Field types do not match" ocorrer ao anexar um arquivo?

Motivo 1: Os tipos de campo na tabela de origem e na tabela anexada são inconsistentes. Altere manualmente o tipo de dados em uma das tabelas ou refaça a correspondência dos campos.

Motivo 2: Se uma coluna no arquivo do Excel anexado contiver apenas células vazias, o Quick BI identificará o campo como texto. Se o campo correspondente na tabela original for numérico, o erro "Field types do not match" ocorrerá. Para resolver esse problema, adicione um valor numérico a qualquer célula na coluna vazia do arquivo do Excel anexado. Em seguida, carregue o arquivo com sucesso.

3. O que fazer se o upload do arquivo falhar com o erro "Excel file parsing failed", ou se os dados estiverem imprecisos após o upload?

Motivo: O formato ou conteúdo do arquivo carregado não atende aos requisitos. Verifique os itens a seguir:

Solução:

Verificação 1: Confirme se o tipo de arquivo é CSV ou Excel. Se for um arquivo do Excel, confirme se o formato é .xls ou .xlsx. Além disso, garanta que o arquivo atenda aos requisitos descritos na seção Observações.
Verificação 2: Confirme se o formato e o tamanho do arquivo atendem aos padrões descritos na seção Limites.

4. Por que não consigo encontrar o botão de upload, ou por que ele está acinzentado?

Motivo 1: Você não tem as permissões necessárias. Para carregar um arquivo e criar uma fonte de dados de arquivo, você deve ser um desenvolvedor com permissões de desenvolvedor ou superiores para o workspace. Alternativamente, você deve ter recebido permissão para usar ou editar a fonte de dados.

Motivo 2: Você não tem permissões de leitura e gravação para a fonte de dados de destino. Garanta que a conta do banco de dados usada para a fonte de dados do Quick BI tenha permissões de leitura e gravação no banco de dados. Sem essas permissões, não é possível carregar arquivos. Entre em contato com um administrador de banco de dados para conceder as permissões necessárias.

5. Por que novos campos não são exibidos no conjunto de dados após eu anexar um arquivo ou adicionar novos campos?

Motivo: A tabela original não continha o campo. Após adicionar um novo campo, ele não é selecionado no conjunto de dados por padrão. Na página de edição do conjunto de dados, acesse a interface de configuração do modelo e marque manualmente a caixa de seleção do campo para exibi-lo.

6. Por que não consigo ver arquivos CSV ao selecionar um arquivo para upload?

Motivo: Em um ambiente Windows, ao clicar em no botão de upload, a caixa de diálogo de seleção de arquivos mostra apenas arquivos .xlsx por padrão. Para encontrar arquivos CSV, selecione All Files nas opções de tipo de arquivo.