Hologres:Tableau

Contexto

O Tableau é uma plataforma de análise de dados segura e flexível, de ponta a ponta, que oferece um conjunto completo de recursos — da conexão à colaboração. O Hologres é compatível com PostgreSQL, permitindo conectar o Tableau diretamente para análise visual.

Conectar o Tableau Desktop ao Hologres

1. Baixe e instale o Tableau.

   Acesse o site oficial do Tableau, baixe o cliente Tableau adequado e siga as instruções de instalação. Este guia utiliza o Tableau Desktop.

2. Configure o arquivo TDC.

   Para obter desempenho e experiência ideais, configure um arquivo Tableau Datasource Customization (TDC) para personalizar a conexão com a fonte de dados do Hologres. Siga estas etapas:

   1. Baixe o arquivo Tableau Datasource Customization (TDC).

   2. Copie o arquivo TDC para o diretório de instalação.

      • Para o Tableau Desktop, copie o arquivo TDC para o diretório de instalação correspondente. O caminho padrão é Documents\My Tableau Repository\Datasources.

      • Para o Tableau Server, copie o arquivo TDC para a seguinte pasta em cada nó do servidor:

        • Windows: ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources.

        • Linux: /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/.

   3. Reinicie o Tableau Desktop e o Tableau Server.

   Para mais informações sobre arquivos TDC, consulte o Tableau Help.

3. Conecte-se ao Hologres.

   1. Após instalar o cliente, abra-o.

   2. Na barra de navegação à esquerda, na seção Connection > To a Server, selecione PostgreSQL e configure as informações de conexão com o Hologres.

      A tabela a seguir descreve os parâmetros de conexão.

      Parâmetro	Descrição
      Server	O endpoint público da instância do Hologres. Acesse a Instance Details page no Hologres console e localize o endpoint público na seção Network Information.
      Port	A porta da instância do Hologres. Acesse a Instance Details page no Hologres console e localize a porta na seção Network Information.
      Database	O nome do banco de dados criado no Hologres.
      Authentication	Selecione Username and Password.
      Username	O AccessKey ID da sua conta Alibaba Cloud. Acesse AccessKey management para obter seu AccessKey ID.
      Password	O AccessKey Secret da sua conta Alibaba Cloud. Acesse AccessKey management para obter seu AccessKey Secret.
      Require SSL	Desmarque esta caixa de seleção.

   3. (Recomendado) Clique em Initial SQL e use o seguinte comando para definir o parâmetro application_name:

      SET application_name='tableau'

      Definir o parâmetro application_name permite identificar rapidamente as consultas SQL originadas do Tableau nos logs de consulta e nas instruções SQL em execução.

   4. Clique em Sign in.

4. Analise os dados no Tableau.

   Após conectar o Tableau ao Hologres, é possível analisar visualmente os dados das suas tabelas. Para mais detalhes, consulte os tutoriais oficiais do Tableau.

Publicar no Tableau Server

Para publicar uma pasta de trabalho do Tableau Desktop no Tableau Server e gerenciá-la, siga estas etapas:

1. Baixe e instale o Tableau Server.

   Acesse o site oficial do Tableau, baixe o cliente Tableau Server adequado e siga as instruções de instalação.

2. Conecte o Tableau Desktop ao Tableau Server.

   1. Abra o cliente Tableau Desktop e selecione Server > Sign in no menu superior.

   2. Na caixa de diálogo exibida, insira o endereço do seu Tableau Server e clique em Connection.

   3. Na página de login, insira o nome de usuário e a senha do Tableau Server e clique em Sign in.

3. Publique uma pasta de trabalho no Tableau Server.

   1. Após fazer login no Tableau Server, selecione Server > Publish Workbook no menu superior.

   2. Na caixa de diálogo Publish Workbook, configure os parâmetros a seguir.

      Parâmetro	Descrição
      Project	Selecione o projeto de destino.
      Name	Insira um nome para a pasta de trabalho.
      Tags	As tags ajudam os usuários a localizar pastas de trabalho relacionadas ao navegar pelo servidor. Separe as tags por vírgulas ou espaços.
      Permissions	Mantenha as configurações padrão do projeto.
      Data Sources	O Tableau Server oferece suporte a dois tipos de autenticação de fonte de dados: Prompt user Embedded password Ao selecionar Embedded password, o Tableau salva as informações de conexão na pasta de trabalho, permitindo que qualquer usuário com permissão de visualização acesse os dados. Como a conexão ao Hologres requer um AccessKey ID e um AccessKey Secret, incorporar a senha é o método recomendado.

   3. Após configurar os parâmetros, clique em Publish. Em seguida, visualize a pasta de trabalho publicada no Tableau Server.

Perguntas frequentes

• Problema: Os dados TIMESTAMPTZ exibem um fuso horário incorreto nos resultados da consulta.

  • Causa: O Hologres utiliza PRC (Horário Padrão da China) como fuso horário padrão para dados TIMESTAMPTZ, enquanto o Tableau usa UTC por padrão. Essa diferença pode fazer com que os valores de tempo sejam exibidos de forma incorreta.

  • Solução: Defina o fuso horário da conexão com a fonte de dados por meio de um comando Initial SQL no Tableau.

    Nota

    Essa configuração se aplica apenas à fonte de dados especificada.

    O comando Initial SQL pode ser configurado em dois cenários:

    • Na primeira conexão com o Hologres:

      Se estiver conectando ao Hologres pela primeira vez, siga as etapas abaixo.

      Ao conectar o Tableau ao Hologres, insira a seguinte instrução SQL no campo Initial SQL.

      SET TIME ZONE "PRC";

    • Se já existir uma conexão entre o Tableau e o Hologres, siga estas etapas:

      1. Clique em Initial SQL.

         Clique com o botão direito na conexão PostgreSQL no painel Connections à esquerda e selecione Initial SQL... no menu de contexto.

      2. Na caixa de diálogo Initial SQL, insira o seguinte comando SQL.

         SET TIME ZONE "PRC";

      3. Clique em OK.

      4. No canto superior esquerdo da página, clique no ícone para aplicar as configurações.

• Prática recomendada: Configuração de dimensões baseadas em tempo.

  Ao utilizar dimensões baseadas em tempo, defina o tipo de dado correto no Hologres para evitar conversões desnecessárias no Tableau. Por exemplo, para usar a coluna l_shipdate como um valor de data e hora, defina o tipo da coluna como TIMESTAMP ou TIMESTAMPTZ ao criar a tabela no Hologres. Isso evita conversões desnecessárias de tipo de dado.

  No painel Fields na parte inferior da página de fonte de dados do Tableau, clique no menu suspenso de tipo do campo de tempo desejado e altere-o para Date & Time.