Consumir produtos de dados em aplicativos

Os desenvolvedores de análise podem carregar produtos de dados, com seus modelos semânticos, em aplicativos analíticos usando o catálogo de dados. O catálogo de dados gera o script necessário e cria itens mestres para medidas e dimensões.

Quando você consome um produto de dados, o catálogo de dados gera uma instrução de script IncludeModel que carrega as tabelas, os relacionamentos, as medidas e as dimensões selecionados em seu aplicativo. Medidas e dimensões do modelo semântico aparecem automaticamente como itens mestres, prontos para uso em visualizações.

Pré-requisitos

Para consumir um produto de dados e seu modelo semântico, você precisa de:

Permissões

Para consumir o modelo semântico de produtos de dados em espaços compartilhados, gerenciados e de dados, você precisa da permissão Pode consumir dados ou Pode visualizar no espaço que contém o produto de dados.

Para detalhes completos, consulte Funções e permissões de produtos de dados.

Conjuntos de dados acessíveis

Você deve ter acesso aos conjuntos de dados, bem como às conexões com os dados subjacentes, que estão incluídos no modelo semântico.

Nome exclusivo do produto de dados

O produto de dados deve ter um nome exclusivo dentro do espaço. Se um aplicativo já contiver um produto de dados com o mesmo nome, o carregamento do modelo semântico falha.

Consumir um produto de dados e modelo semântico por meio do produto de dados

Você pode criar um aplicativo de análise diretamente de um produto de dados. Você pode refinar o que usar do produto de dados e de seu modelo semântico: conjuntos de dados, campos e itens mestre.

1. Abra o produto de dados, seja selecionando um no marketplace de dados ou navegando pelo catálogo.

2. No cabeçalho do nome do produto de dados, clique em Usar em > Aplicativo.

   

3. Na janela Criar um novo aplicativo, revise o modelo semântico e os dados que serão carregados.
4. Clique em Continuar.

   O Editor de carregamento de dados do aplicativo recém-criado é aberto, e você é direcionado ao catálogo de dados. O produto de dados é selecionado por padrão, mas você pode navegar, refinar sua seleção e revisar os dados antes de carregá-los no aplicativo. Para obter mais informações, consulte Consumir um produto de dados e modelo semântico via Editor de carregamento de dados.

5. Quando estiver pronto, clique em Carregar dados.

Após o carregamento dos dados, você pode começar a adicionar pastas e trabalhar no aplicativo ou navegar até o Editor de carregamento de dados para inspecionar e modificar o script, se necessário. As tabelas, relacionamentos, medidas e dimensões do modelo semântico agora estão disponíveis para uso.

Para obter mais informações sobre a visualização de dados em planilhas, consulte Criando análises e visualizando dados.

Consumir um produto de dados e modelo semântico via Editor de carregamento de dados

O catálogo de dados fornece uma interface para navegar e selecionar dados e informações de modelo semântico de produtos de dados, em vez de inserir script manualmente.

Para carregar um produto de dados e seu modelo semântico:

1. Abra um aplicativo.
2. Clique em Editor da carga de dados na barra de navegação superior.
3. No painel direito Adicionar dados, clique em Adicionar do catálogo de dados.
4. O modal do catálogo de dados é aberto, exibindo os dados disponíveis, incluindo produtos de dados com modelos semânticos.

   

Navegar por produtos de dados

O catálogo de dados exibe produtos de dados que contêm modelos semânticos. Você pode navegar e pesquisar produtos de dados por nome, descrição ou tags.

Clique em um produto de dados para visualizar um resumo do que será carregado no script do aplicativo, incluindo tabelas, medidas e dimensões.

Se um conjunto de dados no modelo semântico estiver inacessível, ele será marcado com um indicador de aviso. Você ainda pode consumir medidas e dimensões relacionadas a ele que estão no modelo semântico, mas os conjuntos de dados inacessíveis e seus campos são excluídos.

Selecionar e refinar um modelo semântico

Após selecionar qual produto de dados usar, você pode refinar sua seleção e escolher com precisão quais componentes do modelo semântico incluir em sua aplicação.

1. Passe o mouse sobre o produto de dados selecionado e clique em Refinar seleção.

   

   Três novas guias estão disponíveis onde você pode navegar pelos elementos do produto de dados:

   • Tabelas/campos
   • Dimensões
   • Medidas
2. Use as caixas de seleção para refinar sua seleção e escolher quais conjuntos de dados, campos, medidas e dimensões incluir.
Nota de dica

Usuários avançados podem alternar Incluir automaticamente itens adicionados ao recarregar para controlar se novos itens serão incluídos automaticamente quando o modelo semântico mudar.

Quando ativado, novos campos, medidas e dimensões adicionados ao modelo semântico são adicionados automaticamente ao modelo de dados e aos itens mestre após a recarga. Isso se aplica apenas quando todos os campos, medidas e dimensões estiverem marcados, respectivamente.

3. Quando sua seleção estiver pronta, clique em Inserir script.

O script IncludeModel gerado é inserido no script de carregamento e pode ser visualizado e editado no Editor de carregamento de dados. Para carregar os dados no aplicativo, clique em Carregar dados.

Depois que os dados forem carregados, você poderá começar a adicionar pastas e trabalhar no aplicativo. Para obter mais informações, consulte Criando análises e visualizando dados.

Entendendo a inclusão automática

O recurso de inclusão automática controla como seu aplicativo responde quando o modelo semântico muda.

Quando a inclusão automática está habilitada para um tipo de componente, o script gerado usa um seletor curinga (*):

• Fields *: Inclui todos os campos da tabela especificada.
• WithMeasures: *: Inclui todas as medidas como itens mestre.
• WithDimensions: *: Inclui todas as dimensões como itens mestres.

Quando a inclusão automática está desativada, o script lista explicitamente os itens selecionados. Por exemplo:

• WithMeasures [Total sales], [Total quantity]: Inclui apenas as medidas especificadas.
• WithDimensions [Region], [Product]: Inclui apenas as dimensões especificadas.

A inclusão automática é recomendada para usuários avançados para reduzir a manutenção e garantir que seu aplicativo se beneficie de melhorias no modelo semântico. Desative a inclusão automática se precisar de controle rigoroso sobre quais itens são incluídos.

Entendendo o script IncludeModel gerado

Os dados geram uma instrução de script IncludeModel que referencia o modelo semântico e especifica quais componentes carregar.

Script de exemplo

IncludeModel [My Example Data Product] FromSpace [My Shared Space]
WithTables
  Table [dataset_dim_dateinfo] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_customer] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_fact_transactions] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_category] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_sales_rep] Fields * Connection [My Shared Space:DataFiles]
WithMeasures *
WithDimensions *;

Parâmetros do script:

• IncludeModel: O nome do produto de dados que contém o modelo semântico.
• FromSpace: Especifica o espaço que contém o produto de dados.
• WithTables: Especifica quais tabelas incluir.
• Table: Especifica uma tabela a ser incluída. Você pode incluir instruções Table para cada tabela que deseja usar, separadas por vírgulas.
• Fields: Especifica quais campos incluir da tabela especificada. Use * para todos os campos ou uma lista de campos separados por vírgula.
• Connection: Especifica a localização da tabela usando o formato environment:space:connection, space:connection ou connection.
• WithMeasures: Especifica quais medidas incluir como medidas mestre. Use * para todas as medidas ou uma lista de nomes de medidas específicas.
• WithDimensions: Especifica quais dimensões incluir como dimensões mestre. Use * para todas as dimensões ou uma lista de nomes de dimensões específicos.

Você pode editar manualmente a instrução IncludeModel para ajustar quais itens são incluídos ou para alternar entre os modos de seleção por curinga e explícita.

Para obter detalhes completos sobre a instrução IncludeModel, consulte IncludeModel.

Nomenclatura de campos e tabelas

Quando um produto de dados é carregado em um aplicativo, os nomes de campos e tabelas podem ser ajustados automaticamente para evitar conflitos de nomenclatura e transformar relacionamentos em associações baseadas em nomes, seguindo os padrões analíticos do Qlik.

• Campos com o mesmo nome sem relacionamento: Se duas tabelas contiverem um campo com o mesmo nome, mas os campos não tiverem um relacionamento, os nomes dos campos serão qualificados automaticamente com o nome de sua tabela (por exemplo, TableName.FieldName) para evitar uma associação automática não intencional no aplicativo.
• Campos que têm um relacionamento: Se os dois campos tiverem um relacionamento, mas nomes diferentes, eles são renomeados para o mesmo nome, o nome do relacionamento, quando carregados em um aplicativo para formar uma associação.

• Chaves compostas: Para chaves compostas, um novo campo chave é adicionado às tabelas envolvidas.

• Tabelas com o mesmo nome: Se duas tabelas tiverem o mesmo nome, elas serão renomeadas automaticamente adicionando um sufixo numérico, por exemplo, TableName_1, TableName_2 e assim por diante.

Trabalhando com itens mestres herdados

Quando você recarrega um aplicativo que inclui uma instrução IncludeModel, as medidas e dimensões do modelo semântico aparecem automaticamente no painel de itens mestres.

Para usar itens mestre de um modelo semântico:

1. Recarregue o aplicativo para carregar dados do modelo semântico.
2. Abra uma pasta no modo de edição.
3. No painel esquerdo, clique em Itens mestre.
4. As medidas e dimensões do modelo semântico aparecem na lista com um indicador de produto de dados.

   

5. Arraste uma medida mestre ou dimensão para uma visualização para usá-la.

Itens mestres herdados de modelos semânticos exibem o nome e a descrição do seu produto de dados de origem. Você pode visualizar a expressão usada pela medida ou dimensão ao passar o cursor sobre ela.

Propriedades de itens mestre

A maioria dos atributos de itens mestres herdados de modelos semânticos é somente leitura no aplicativo consumidor. Alguns outros atributos de item mestre, como aqueles relacionados a visualizações, ainda podem ser editados dentro do aplicativo.

O comportamento de somente leitura se aplica apenas à interface do usuário—você pode definir várias propriedades do item mestre via API:

• Propriedades que são configuráveis no modelo semântico, mas somente leitura na interface do usuário do aplicativo consumidor. Isso inclui título, descrição e tags.

• Propriedades que não estão configuradas no modelo semântico e não estão expostas na interface do usuário do aplicativo consumidor.

As alterações nas propriedades definidas pelo modelo semântico serão sobrescritas quando o aplicativo for recarregado.

Exclusão de item mestre

Em um aplicativo não publicado, você pode excluir um item mestre herdado, mas ele reaparece na próxima recarga se ainda estiver referenciado no script IncludeModel. Para removê-lo permanentemente, remova-o do script primeiro. Você também pode duplicar um item mestre herdado. O item obtido ao duplicar é um item mestre comum do aplicativo e é totalmente editável.

Itens mestres e publicação de aplicativos

Quando um aplicativo é publicado, seus itens mestre herdados permanecem fixos na versão do produto de dados usada quando o aplicativo foi publicado. Recarregar um aplicativo publicado não cria, atualiza ou exclui itens mestres do produto de dados. Para usar medidas e dimensões novas ou alteradas, atualize o aplicativo e publique-o novamente.

Tratando atualizações do modelo semântico em um aplicativo

Se o modelo semântico for alterado após você tê-lo consumido, você poderá atualizar seu aplicativo para refletir as alterações.

Se você usou o modo de inclusão automática com seletores curinga, novas medidas e dimensões são incluídas automaticamente. Se você usou a seleção explícita, apenas os itens que você selecionou originalmente são carregados.

Para adicionar novos itens do modelo semântico:

1. Abra o Editor de carregamento de dados.
2. Localize a instrução IncludeModel em seu script.
3. Edite a instrução para adicionar novos itens ou alterar seletores para * para inclusão automática.
4. Recarregue o aplicativo.

Como alternativa, você pode remover a instrução IncludeModel existente e usar o catálogo de dados para gerar uma nova com as seleções atualizadas.

Consumir produtos de dados em outras ferramentas

Em Script, é possível consumir produtos de dados, mas as medidas e dimensões são ignoradas.

Ao consumir produtos de dados em ativos que não sejam aplicativos e scripts (como fluxos de dados e receitas de tabela), o produto de dados atua como um conjunto de conjuntos de dados confiáveis para escolher. Essas ferramentas usam os conjuntos de dados como fontes e o produto de dados não é exibido como um nó de origem na linhagem.