Extensões da tabela

As extensões da tabela permitem que você crie tabelas de dados com um script de extensões do Analytics. Você pode escrever um script TabPy ou Rserve personalizado e, opcionalmente, adicionar uma ou mais tabelas de entrada.

Observação: a extensão da tabela é atualizada sempre que você abre uma pasta de trabalho ou atualiza uma fonte de dados.

Benefícios

As extensões da tabela têm os seguintes benefícios para usuários novos e experientes.

  • Integre facilmente scripts ou funções avançadas no Tableau
  • Arraste facilmente os dados das conexões de dados do Tableau como entrada para os scripts
  • O editor de baixo código facilita a adição de código às fontes de dados
  • Integra-se a Guia de dados e Explique os dados
  • Integra-se com TabPy, Rserve e outras extensões analíticas
  • Os resultados podem ser usados para construir painéis ou visualizações

Pré-requisitos

Antes de poder usar extensões de tabela, você deve preencher a lista a seguir.

  • Abra uma fonte de dados no Desktop ou Criação na Web.
  • Configurar uma extensão de análise

Criar uma extensão de tabela

Para criar uma extensão de tabela, siga as etapas a seguir.

  1. Abra uma pasta de trabalho.
  2. Abra uma fonte de dados ou crie uma.
  3. Em Conexões, escolha Nova extensão de tabela.
  4. Arraste a planilha para o modelo de dados.
  5. (Opcional) Arraste tabelas da conexão de dados para o painel de extensão de tabela para usar como entrada em seu script ou função de extensões analíticas.

    Por padrão, os , dados do Tableau são passados para a extensão analítica e definidos como o variable _arg1, uma estrutura semelhante a um dicionário, como:{‘column_name’: [1,2,3], ‘column_name_2’: [3,4,5]

    • Dados de entrada do Python: os dados de entrada podem ser convertidos em um dataframe do pandas usando o seguinte: import pandas as pddf = (pd.DataFrame(_arg1))
    • Dados de entrada do RServe: os dados de entrada são definidos como variable.arg1 e o tipo de dados é uma lista nomeada de listas.
    • Dados de entrada de SQL personalizado: para fontes de dados relacionais compatíveis, você pode usar o SQL personalizado como uma entrada em uma extensão da tabela. Quando os parâmetros são usados na consulta SQL personalizada, alterar o parâmetro faz com que a consulta seja executada novamente e o script seja recalculado. Isso cria um caminho para atualizar dinamicamente os parâmetros em um painel e filtrar ou passar valores para o script de extensão da tabela.

      Observações: se um parâmetro for usado em uma extensão de tabela, esse parâmetro não poderá ser excluído até que seja removido da extensão. Excluir um parâmetro chamado na extensão de tabela pode desencadear um erro fatal.

      fontes de dados relacionais

  1. Sob Script, insira seu script ou chamada de função. O script deve retornar um dicionário ou lista de listas, como um objeto JSON. Um script para RServe deve retornar um data.frame ou uma lista de listas nomeadas. Um script para Python deve retornar um dicionário.
    • Exemplo de Python: use o comando de retorno explícito a seguir. return df.to_dict(orient='list')
    • Observação: as extensões de tabela não oferecem suporte à chamada direta de pontos de extremidade TabPy se TABPY_EVALUATE_ENABLE estiver desabilitado em TabPy.

  2. Selecione Aplicar para executar o script.

    diálogo de script

  3. (Opcional) Se estiver relacionando a extensão da tabela a outra tabela no modelo de dados, defina a relação entre pelo menos um campo em cada tabela.
  4. Na grade de dados em Tabela de saída, escolha Atualizar agora. Os resultados aparecem na guia Tabela de saída.

    tabela de resultados de saída

Observação: se você não definir uma relação com uma tabela no modelo de dados, a guia Tabela de entrada estará vazia e exibirá a mensagem 'Visualização de dados indisponível'.

  1. (Opcional) No campo Nome, digite um nome para a nova extensão da tabela.
  2. Acesse a guia Planilha para começar a explorar e visualizar os dados.
  3. Publique a pasta de trabalho no Tableau Server. O destino de publicação deve ter uma extensão de análise do tipo apropriado habilitada e configurada.

Dica de solução de problemas: se a extensão da sua tabela apresentar um erro, primeiro certifique-se de que todo o código e a formatação estejam corretos. Em seguida, tente usar o botão circular Atualizar fonte de dados na barra de ferramentas ou clique em Aplicar novamente.

Comparar tipos de extensão

Embora alguns destes produtos não estejam relacionados, as extensões da tabela e as extensões de análise compartilham vários recursos. O recurso de extensões de tabela depende de uma conexão com extensões do Analytics para funcionar. Detalharemos cada recurso.

Extensões de painel

Extensões do painel permitem que aplicativos da Web personalizados sejam adicionados a painéis usando o Dashboard Extension SDK.

Extensões da tabela

As extensões de tabela permitem a você criar uma tabela em uma fonte de dados que pode enviar dados e um script para sua extensão analítica e retornar uma tabela completa como resultado. Os resultados retornados são exibidos como uma tabela no modelo de dados e como medidas e dimensões em uma pasta de trabalho.

Extensões do Analytics

O recurso de extensões do Analytics permite estender os cálculos dinâmicos do Tableau com linguagens de programação como Python, ferramentas externas e plataformas externas.

Depois de criar uma conexão com uma extensão de análise, você pode se comunicar com seu servidor externo por meio de campos calculados chamados SCRIPT_X ou MODEL_EXTERNAL_X, onde X é o tipo de dados dos valores de retorno esperados. Para obter mais informações, consulte Passar expressões com extensões de análise.