Gerenciando arquivos de dados
No Qlik Cloud Analytics, você pode gerenciar os arquivos de dados nos espaços em Detalhes do espaço > Arquivos de dados. O gerenciamento de arquivos de dados inclui renomear, duplicar, mover, excluir e adicionar novos arquivos de dados.
Este tópico de ajuda se concentra na interface para gerenciar arquivos de dados em um espaço. Para navegar para essa interface, abra um espaço no catálogo e clique em Detalhes do espaço > Arquivos de dados.
Estruturas de pastas em espaços
Cada espaço no Qlik Cloud Analytics contém sua própria estrutura de pastas organizadas de forma hierárquica. Os arquivos de dados podem ser organizados em uma estrutura de pastas aninhadas. Por exemplo, em seu espaço pessoal, talvez você queira ter pastas separadas para Dados do Pedido e Dados do Orçamento.
A localização de um arquivo ou pasta em um espaço é mostrada em seu caminho. O caminho usa símbolos / para representar quando uma pasta está aninhada em outras pastas.
Por exemplo, suponha que, dentro do seu espaço pessoal, você tenha pastas separadas para Order Data e Budget Data. Se você tiver um arquivo de dados chamado Orders_2024_December.QVD na pasta Order Data, esse arquivo estará localizado no seguinte caminho da pasta em seu espaço pessoal:
Pessoal/Order Data
Tipos de espaço aplicáveis
Você pode organizar arquivos de dados em uma estrutura de pastas hierárquicas nos seguintes tipos de espaços:
-
Espaço pessoal
-
Espaço compartilhado
-
Espaço gerenciado
-
Espaço de dados
Espaços no Qlik Cloud Analytics
No Qlik Cloud Analytics, os arquivos de dados em espaços pessoais, compartilhados e gerenciados podem ser organizados em uma estrutura de pastas hierárquica.
Espaços no Integração de dados
Geralmente, os espaços de dados são usados para armazenar arquivos de saída de projetos do Integração de dados. Arquivos de dados em espaços de dados podem ser usados para análises. No Qlik Cloud Analytics e no Qlik Talend Data Integration, você pode organizar arquivos de dados em espaços de dados em estruturas de pastas hierárquicas. No entanto, deve-se observar que os arquivos de dados em espaços de dados devem ser reorganizados apenas em pastas aninhadas para fins de uso em análises. Se um arquivo de dados gerado de um pipeline de dados for realocado para uma pasta no espaço de dados, o arquivo continuará sendo salvo no caminho de nível superior no espaço (em vez de qualquer pasta aninhada) sempre que o pipeline for executado novamente.
O comportamento de um espaço pessoal no Qlik Talend Data Integration é o mesmo dos espaços de dados.
Navegação
A seção Arquivos de dados de um espaço contém ferramentas para ajudá-lo a organizar e criar conteúdo de dados baseado em arquivos no espaço.
Barra de ferramentas
A barra de ferramentas está localizada na parte superior da interface, acima do seletor de caminhos e da tabela. Na barra de ferramentas, você pode:
-
Pesquisar por arquivos de dados no espaço.
-
Filtrar arquivos por proprietário.
-
Carregar arquivos.
-
Criar pastas.
-
Executar ações em vários arquivos de dados ao mesmo tempo.
-
Alterar a classificação dos arquivos e pastas em sua exibição.
Altere a classificação da opção padrão Última modificação e alterne entre (ordem crescente) e (ordem decrescente).
-
Alterar a aparência dos arquivos e pastas em sua exibição.
Selecione para a exibição de hierarquia, que apresenta arquivos e pastas com recuo para exibir hierarquias visualmente. Na exibição de hierarquia, você precisa selecionar ou expandir um espaço para executar ações em arquivos ou pastas específicos.
Selecione para a exibição em lista, em que arquivos e pastas são mostrados com uma estrutura simples na tabela, juntamente com uma coluna separada exibindo seus caminhos específicos.
Seletor de caminho
O seletor de caminho mostra qual pasta você tem aberta no momento. Os breadcrumbs mostram a hierarquia de pastas. Selecione uma pasta no seletor de caminho para navegar para frente ou para trás em relação ao caminho atual. Selecione a área vazia após o caminho atual para ver as pastas contidas na posição atual e para pesquisar pastas.
Tabela
A tabela mostra todos os arquivos e pastas no espaço ou na pasta selecionada no espaço. A tabela é onde você gerencia os arquivos de dados e pastas. Selecione as pastas na tabela para navegar até elas no seletor de caminho.
Na tabela, você também pode visualizar informações importantes sobre os itens, como o tamanho, o número de pastas, a hora da última atualização e a propriedade.
Criando pastas no espaço
Crie uma pasta para organizar o conteúdo da maneira que preferir.
Faça o seguinte:
-
Em um espaço, clique em Detalhes do espaço e selecione Arquivos de dados.
-
Na barra de ferramentas, na janela Arquivos de dados, clique em .
-
Defina o nome da pasta.
-
Em Caminho, você pode escolher onde na estrutura de pastas do espaço adicionar a nova pasta.
-
Clique em uma barra de caminho e selecione uma pasta de conteúdo no menu suspenso. Como alternativa, digite o caminho de uma localização específica onde você deseja adicionar a pasta.
-
Clique em Criar.
Como alternativa, adicione uma pasta clicando em ao lado de uma pasta existente na tabela e selecionando Adicionar pasta. A nova pasta é adicionada à pasta existente.
As pastas também são criadas automaticamente em um espaço quando são referenciadas na instrução Store. Consulte Fazendo referência da estrutura de pastas do espaço no desenvolvimento de aplicativos e scripts.
Executando ações em vários arquivos e pastas
Você pode usar as opções na barra de ferramentas para executar as seguintes ações em mais de um arquivo ou pasta ao mesmo tempo:
-
(Recortar)
-
(Copiar)
-
(Colar)
-
(Excluir)
Você pode recortar, copiar e colar itens entre espaços ou em diferentes localizações dentro do mesmo espaço. Por exemplo, você pode recortar vários itens e colá-los em um espaço diferente.
Ações de recortar, copiar e colar podem ser usadas para mover arquivos de dados de uma localização para outra. Se você uma alteração das localizações de arquivos para arquivos de dados referenciados em scripts de carregamento, os scripts de carregamento precisarão ser atualizados para refletir a nova localização. Para obter mais informações, consulte Implicações de mover arquivos de dados usados em scripts de carregamento.
Faça o seguinte:
- Em um espaço, clique em Detalhes do espaço e selecione Arquivos de dados.
-
Na tabela, selecione os itens nos quais você deseja executar uma ação.
Nota de dicaPara selecionar mais de um item por vez, clique no primeiro item e, em seguida, use uma combinação de comandos de teclado e cliques para selecionar mais arquivos. Por exemplo:
-
Mantenha pressionada a tecla Shift e clique no último item que deseja selecionar. Isso seleciona todos os itens, do primeiro ao último.
-
Mantenha pressionada a tecla Ctrl (Windows) ou o comando (macOS) e clique em itens adicionais, um de cada vez. Isso seleciona cada item adicional individualmente.
-
-
Na barra de ferramentas, clique em uma ação. As ações disponíveis estão listadas anteriormente nesta seção.
Ao recortar e colar itens entre espaços, você precisa abrir o novo espaço e abrir Detalhes do espaço > Arquivos de dados para executar a ação Colar.
Adicionando um arquivo de dados a um espaço
Você pode adicionar arquivos de dados ao espaço.
Arquivos de dados podem ter até 100 GB. No entanto, ao carregar arquivos de dados muito grandes (acima de 6 GB), você pode enfrentar restrições com a capacidade do mecanismo. É mais provável que essas restrições sejam encontradas com arquivos de dados QVD devido ao uso de memória necessário para carregar arquivos QVD no mecanismo. Para obter mais informações sobre como aumentar a capacidade disponível, consulte Suporte para aplicativos grandes.
Faça o seguinte:
- Em um espaço, clique em Detalhes do espaço e selecione Arquivos de dados.
- Na barra de ferramentas, na janela Arquivos de dados, clique em para carregar um arquivo.
-
Arraste e solte seus arquivos de dados no diálogo Adicionar arquivo.
Como alternativa, clique em Procurar e navegue até seus arquivos de dados.
-
Em Caminho, você pode escolher onde na estrutura de pastas do espaço adicionar o arquivo.
Para adicionar o arquivo a uma pasta específica, clique em na barra de caminho e selecione a pasta no menu suspenso. Como alternativa, digite o caminho da pasta específica.
- Clique em Carregar.
Como alternativa, clique em ao lado de uma pasta na tabela e selecione Carregar arquivo para a pasta.
Para ver mais formas de adicionar arquivos de dados, consulte Adicionando arquivos de dados.
Executando ações de recortar, copiar e colar em um arquivo ou pasta
Ações de recortar, copiar e colar podem ser usadas para mover arquivos de dados de uma localização para outra. Se você uma alteração das localizações de arquivos para arquivos de dados referenciados em scripts de carregamento, os scripts de carregamento precisarão ser atualizados para refletir a nova localização. Para obter mais informações, consulte Implicações de mover arquivos de dados usados em scripts de carregamento.
Faça o seguinte:
-
Em um espaço, clique em Detalhes do espaço e selecione Arquivos de dados.
-
Na tabela, clique em ao lado de um arquivo ou pasta.
-
Clique em Recortar, Copiar ou Colar.
Nota de dicaComo alternativa, você pode selecionar um arquivo e usar atalhos de teclado comuns, como Ctrl+C (Windows) e comando+C (macOS).
Para executar essas ações em mais de um arquivo ou pasta por vez, consulte Executando ações em vários arquivos e pastas.
Renomeando um arquivo de dados ou pasta
Faça o seguinte:
-
Em um espaço, clique em Detalhes do espaço e selecione Arquivos de dados.
-
Na tabela, clique em ao lado de um arquivo ou pasta.
-
Clique em Renomear.
-
Insira o novo nome do arquivo e clique em Salvar.
Quaisquer scripts de carregamento que façam referência ao nome do arquivo ou pasta original precisarão ser atualizados.
Duplicando um arquivo de dados ou pasta
Faça o seguinte:
-
Em um espaço, clique em Detalhes do espaço e selecione Arquivos de dados.
-
Na tabela, clique em ao lado de um arquivo ou pasta.
-
Clique em Duplicar.
Movendo um arquivo de dados ou pasta
Você pode mover arquivos e pastas. Os arquivos e pastas podem ser movidos para espaços ou localizações diferentes dentro do mesmo espaço.
Faça o seguinte:
-
Em um espaço, clique em Detalhes do espaço e selecione Arquivos de dados.
-
Na tabela, clique em ao lado de um arquivo ou pasta.
-
Clique em Mover.
-
Em Caminho, selecione um espaço. Pode ser o espaço atual ou um novo espaço.
-
Selecione novamente a barra de caminhos ou clique em para definir uma pasta específica no espaço selecionado.
Como alternativa, digite o caminho para definir uma pasta específica.
-
Para abrir para a nova localização após mover o arquivo de dados, selecione Navegar para o caminho.
-
Clique em Mover.
Você também pode mover vários itens de uma só vez. Para fazer isso, use as ações Recortar e Colar. Consulte Executando ações em vários arquivos e pastas.
Implicações de mover arquivos de dados usados em scripts de carregamento
Se você mover um arquivo de dados para uma nova localização dentro de um espaço, todos os scripts de carregamento que fazem referência a esse arquivo de dados precisarão ser atualizados para fazer referência ao novo caminho do arquivo. A mesma consideração se aplica aos arquivos que são movidos de um espaço para outro.
Por exemplo, suponha que o script de carregamento do seu aplicativo ou script faça referência ao seguinte arquivo em um espaço pessoal:
Agora, suponha que você mova os arquivos de dados para o espaço TeamSharedSpace e mova orders.csv para uma nova pasta no espaço, chamada Sales Analysis. Todos os aplicativos e scripts que carregam dados de orders.csv precisarão ter a referência do arquivo atualizada para o seguinte no script de carregamento:
Caso contrário, as recargas falharão.
Para obter mais informações sobre como fazer referência a localizações de pastas de espaço em scripts de carregamento, consulte Fazendo referência da estrutura de pastas do espaço no desenvolvimento de aplicativos e scripts.
Excluindo um arquivo de dados ou pasta
Faça o seguinte:
-
Em um espaço, clique em Detalhes do espaço e selecione Arquivos de dados.
-
Na tabela, clique em ao lado de um arquivo ou pasta.
-
Clique em Excluir.
Nota de dicaComo alternativa, você pode selecionar um arquivo e digitar Delete no teclado. - No diálogo, clique em Excluir para confirmar a exclusão.
Você também pode excluir vários itens de uma só vez. Consulte Executando ações em vários arquivos e pastas.
Executando outras ações em um arquivo de dados
Na interface Arquivos de dados, você também pode navegar diretamente para outras ferramentas para realizar a análise de um arquivo específico. As opções a seguir estão disponíveis quando você usa o menu em um arquivo:
-
Análise de impacto: investigue os possíveis efeitos de fazer alterações nos dados do conjunto de dados.
Analisando a análise de impacto para aplicativos, scripts e conjuntos de dados
-
Linhagem: entenda mais sobre o histórico do conjunto de dados.
Analisando a linhagem para aplicativos, scripts e conjuntos de dados
-
Abrir conjunto de dados: abra o conjunto de dados, onde é possível acessar uma visão geral e as informações de perfil do arquivo.
Permissões de espaço
Arquivos de dados são um tipo de fonte de dados no Qlik Cloud Analytics.
Membros de espaço compartilhado com qualquer uma das seguintes funções podem gerenciar fontes de dados nesse espaço:
-
Proprietário
-
Pode gerenciar
-
Pode editar
-
Pode editar dados em aplicativos
Membros de espaço gerenciado com qualquer uma das seguintes funções podem gerenciar fontes de dados nesse espaço:
-
Proprietário
-
Pode gerenciar
-
Pode operar (com Direito de usuário Professional ou Full User)
Membros do espaço com a função Pode consumir dados podem exibir fontes de dados no espaço e podem consumir as fontes de dados nos locais em que têm permissão para criar aplicativos.
Para obter mais informações sobre os requisitos de função de espaço para ações de fonte de dados, consulte:
-
Permissões de espaço compartilhado para usuários com Direito de usuário Professional ou Full User
-
Permissões de espaço compartilhado para usuários com Direito Analyzer
-
Permissões de espaço gerenciado para usuários com Direito de usuário Professional ou Full User
-
Permissões de espaço gerenciado para usuários com Direito Analyzer
Fazendo referência da estrutura de pastas do espaço no desenvolvimento de aplicativos e scripts
Regras para caminhos válidos de pastas de espaço
No Qlik Cloud Analytics, a sintaxe para fazer referência a um arquivo no script de carregamento é:
[lib:// (nome_do_espaço):(nome_da_conexão)/(nome_da_pasta)/(nome_do_arquivo)]
O caminho completo da pasta deve ser fornecido. Não são aceitos caminhos relativos.
Se o espaço não existir, a instrução não poderá ser executada e retornará um erro.
O caminho da pasta pode incluir várias pastas em uma estrutura hierárquica. Cada nome_da_pasta no caminho deve ser delimitado com os caracteres /.
Os itens a seguir não são permitidos no caminho ao fazer referência a arquivos que residem em uma estrutura de pastas:
-
//
-
\
-
\\
-
/./
-
/../
Os símbolos de ponto final (.) no espaço, na pasta ou no nome do arquivo são aceitáveis, desde que não apareçam nas configurações da lista acima.
Exemplos: Sintaxe não compatível
Estes exemplos são considerados sintaxe inválida para o caminho:
Dependendo do tipo de instrução de script que está sendo usada, a sintaxe fora de conformidade pode causar falha de recarregamento ou ainda pode ser executada com um comportamento diferente. Para obter detalhes específicos, consulte:
Carregando dados de arquivos
No Qlik Cloud Analytics, ao carregar dados de um arquivo de dados em um script de carregamento, você pode usar uma instrução LOAD ou inserir o código QVS. Em ambos os casos, as estruturas hierárquicas de pastas de espaço podem ser referenciadas em sua instrução de script. Siga as regras para caminhos válidos de pastas de espaço. Além disso, o arquivo e todas as pastas referenciadas precisam já existir na localização especificada. Caso contrário, a recarga falhará.
Instruções de LOAD no script de carregamento
Exemplos: Referência ao arquivo no caminho de nível superior de um espaço
Esse exemplo carrega o arquivo orders.csv de um espaço pessoal. O arquivo não está localizado em nenhuma pasta específica, mas sim no caminho de nível superior no espaço.
LOAD * FROM [lib://DataFiles/orders.csv];
Esse exemplo carrega o arquivo orders.csv de um espaço compartilhado, um espaço gerenciado ou um espaço de dados. O nome do espaço é TeamSharedSpace. O arquivo não está localizado em nenhuma pasta específica, mas sim no caminho de nível superior no espaço.
LOAD * FROM [lib://TeamSharedSpace:DataFiles/orders.csv];
Exemplos: Referências a um caminho de pasta específico em um espaço
Esse exemplo carrega o arquivo orders_Europe.csv da pasta Orders By Region em um espaço pessoal.
LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv];
Esse exemplo carrega o arquivo orders_Europe.csv da pasta Orders By Region em um espaço compartilhado, um espaço gerenciado ou um espaço de dados. O nome do espaço é SalesSpace.
LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv];
Inserindo o código QVS
Exemplo: Fazendo referência ao arquivo QVSno caminho de nível superior de um espaço
Nesse exemplo, o arquivo test.qvs é referenciado no script de carregamento. O arquivo está localizado no espaço TeamSharedSpace. O arquivo não está localizado em nenhuma pasta específica, mas sim no caminho de nível superior no espaço.
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)
Exemplo: Fazendo referência ao arquivo QVSem um caminho de pasta específico em um espaço
Nesse exemplo, o arquivo test.qvs é referenciado no script de carregamento. O arquivo está localizado na pasta SalesData no espaço TeamSharedSpace.
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)
Armazenando dados em arquivos
Ao usar uma instrução de Store em um script de carregamento no Qlik Cloud, você pode fazer referência à pasta exata em um espaço onde deseja armazenar os arquivos criados. Siga as regras para caminhos válidos de pastas de espaço. Além disso, os comportamentos a seguir também se aplicam e são exclusivos das instruções de Store:
-
Se o espaço existir, mas o caminho de pasta especificado não existir, o caminho será criado em um espaço. Uma ou mais pastas podem ser criadas, dependendo da estrutura de pastas definida. O arquivo é gerado e armazenado ali.
-
Se o espaço existir, mas o caminho de pasta especificado usar delimitadores de pasta inválidos (por exemplo, \, \\, //, /./ ou /../), a instrução Store ainda será executada. Em vez disso, o arquivo de saída será salvo no caminho de nível superior no espaço de destino e terá um nome que contém seu caminho completo, não apenas o nome especificado.
-
Se o espaço não existir, a instrução Store não poderá ser executada e retornará um erro.
Os exemplos a seguir demonstram como fazer referência a um caminho de pasta específico no espaço na sua instrução Store.
Exemplo: Armazenando arquivo no caminho de nível superior de um espaço
Nesse exemplo, a tabela inteira mytable é exportada para o Qlik Cloud Analytics como um arquivo chamado myfile.qvd. O arquivo é adicionado ao espaço compartilhado TeamSharedSpace. O arquivo não está localizado em nenhuma pasta específica, mas sim no caminho de nível superior no espaço.
Store * from mytable into [lib://TeamSharedSpace:DataFiles/myfile.qvd];
Exemplo: Armazenando arquivo em um caminho de pasta específico em um espaço
Nesse exemplo, a tabela inteira mytable é exportada para o Qlik Cloud Analytics como um arquivo chamado myfile.qvd. O arquivo é adicionado à pasta SalesData no espaço TeamSharedSpace.
Store * from mytable into [lib://TeamSharedSpace:DataFiles/SalesData/myfile.qvd];
Administrando arquivos de dados
Os administradores de locatários e os administradores de análises podem gerenciar todos os arquivos de dados no espaço no Administração de Administration. Para obter mais informações, consulte Gerenciando arquivos de dados para administradores de locatários e de análises.