Usar instantâneos de entidade
Os instantâneos de entidade fornecem aos administradores de nuvem um registro tabular do conteúdo, dos usuários e dos relacionamentos que compõem seu site. Enquanto os registros de eventos padrão mostram o que ocorreu em um momento específico, os instantâneos de entidade capturam o estado completo de tudo que existia naquele momento. Os instantâneos de entidades estão disponíveis apenas por meio da API REST do Tableau Cloud Manager (TCM), não por meio da integração do Registro de atividade com o S3.
Com os instantâneos de entidade, você pode monitorar e otimizar sua implantação, automatizar o gerenciamento de conteúdo e garantir que seu site atenda aos requisitos de segurança e conformidade.
Antes de começar
Você deve ter uma licença do Tableau Enterprise ou Tableau+.
Você deve ter a função de administrador de nuvem no TCM.
É necessário configurar um token de acesso pessoal (PAT) ou token de acesso unificado (UAT) para autenticar suas sessões de API REST do TCM.
Comparação entre instantâneos de entidade e registros de eventos
Instantâneos de entidade e registros de eventos são ferramentas administrativas valiosas, mas têm propósitos diferentes. Para determinar qual tipo de dados se adapta ao seu caso de uso, considere o seguinte:
| Instantâneos da entidade | Registros de eventos | |
|---|---|---|
| Finalidade | Captura o estado completo de conteúdo do site, usuários e relações em um momento específico. | Captura ações e atividades em locatários e sites conforme elas ocorrem. |
| Frequência de atualização | A cada 60 minutos | Tableau (padrão): 1 dia Advanced Management, Tableau Enterprise e Tableau+: menos de 15 minutos |
| Retenção de dados | 14 dias | Tableau (padrão): 14 dias Advanced Management, Tableau Enterprise, e Tableau+: até 365 dias |
| Formato | Conjuntos de dados tabulares entregues como arquivos Parquet | Registros de eventos semiestruturados entregues como arquivos de texto JSON |
| Access | API REST do Tableau Cloud Manager | API REST do Tableau Cloud Manager ou Amazon S3 |
Recuperar instantâneos da entidade
Para recuperar instantâneos da entidade, use os métodos de dados da plataforma List entity snapshots for site e Get entity snapshots for site na API REST do Tableau Cloud Manager. Para obter mais informações, consulte Dados da plataforma(O link abre em nova janela).
O processo de recuperação envolve estas etapas:
Autenticar a sessão usando um PAT ou UAT.
Identificar o LUID do seu site (identificador exclusivo local).
Gerar URLs de download para os arquivos de instantâneos.
Entender o esquema de instantâneos
Cada download de instantâneo contém um conjunto de tabelas, onde cada tabela representa um tipo específico de entidade no seu site, como pastas de trabalho, usuários ou projetos. Para entender os atributos disponíveis em cada tabela, revise as definições do esquema antes de criar integrações ou painéis. Para obter uma lista completa de tabelas de instantâneos da entidade, consulte Referência de instantâneos da entidade.
Integrar dados de instantâneos
Depois de baixar os arquivos de instantâneos, conclua estas etapas para armazenar e integrar os dados aos seus fluxos de trabalho. Também é possível automatizar esse processo usando o Carregador de dados do Tableau Cloud Platform(O link abre em nova janela), uma ferramenta de código aberto disponível no GitHub.
Copiar para armazenamento centralizado: faça upload de seus arquivos para um repositório em nuvem, como Amazon S3, Azure ou Google Cloud Storage. Se preferir, você também poderá usar o armazenamento de arquivos local.
Importar para data warehouses: importe os dados para data warehouses, como Snowflake, Amazon Redshift ou Google BigQuery.
Criar painéis de monitoramento: combine os dados de instantâneos históricos com eventos do Registro de atividade no Tableau ou outras ferramentas analíticas para criar painéis de conformidade e desempenho do site. Esses painéis também podem ser compartilhados com não administradores por meio da segurança em nível de linha.
Os instantâneos da entidade são atualizados a cada 60 minutos e são retidos por 14 dias. Para frequência de atualização e retenção de dados para eventos do Registro de atividade, consulte Frequência de atualização de eventos e retenção de dados.