Atribuições do perfil do usuário

Esta página serve como referência para as visualizações de atributos padrão e personalizados no Snowflake. Há três visualizações para atributos padrão e três visualizações para atributos personalizados, cada uma projetada para um caso de uso específico com suas próprias considerações de performance.

Visualizações disponíveis

Tipo	Visualização	Descrição
Atributo padrão	USER_DEFAULT_ATTRIBUTES_VIEW_SHARED	Instantâneos do perfil do usuário
	USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED	Perfis de usuário em tempo real
	USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED	Registros históricos de alterações
Atributo personalizado	USER_CUSTOM_ATTRIBUTES_VIEW_SHARED	Instantâneos do perfil do usuário
	USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED	Perfis de usuário em tempo real
	USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED	Registros históricos de alterações

Instantâneos do perfil do usuário

Essas exibições fornecem instantâneos periódicos das atribuições do perfil do usuário. Os dados são postergados em até 12 horas, o que os torna úteis para consultas que não exigem atualizações em tempo real.

• USER_DEFAULT_ATTRIBUTES_VIEW_SHARED
• USER_CUSTOM_ATTRIBUTES_VIEW_SHARED

USER_DEFAULT_ATTRIBUTES_VIEW_SHARED

Esquema

Nome da coluna	Tipo de dados
APP_GROUP_ID	VARCHAR
APP_ID	VARCHAR
USER_ID	VARCHAR
TIME	NÚMERO
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
EXTERNAL_ID	VARCHAR
FIRST_NAME	VARCHAR
LAST_NAME	VARCHAR
EMAIL	VARCHAR
GENDER	VARCHAR
PHONE	VARCHAR
DOB	VARCHAR
TIME_ZONE	VARCHAR
HOME_CITY	VARCHAR
COUNTRY	VARCHAR
LANGUAGE	VARCHAR

USER_CUSTOM_ATTRIBUTES_VIEW_SHARED

Esquema

Nome da coluna	Tipo de dados
APP_GROUP_ID	VARCHAR
APP_ID	VARCHAR
USER_ID	VARCHAR
TIME	NÚMERO
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
CUSTOM_ATTRIBUTES	VARIÁVEL

Instantâneos do perfil do usuário - notas de uso

• Fornece um instantâneo das atribuições do usuário com uma postergação de até 12 horas.
• Apresenta bom desempenho para consultas que não exigem precisão em tempo real.
• Execução mais rápida da consulta, especialmente ao filtrar por atribuições diferentes de USER_ID.
• Limitação: Os dados não são atualizados em tempo real.

Visualizações de perfil de usuário em tempo real

Essas exibições fornecem atualizações quase em tempo real sobre as atribuições do perfil do usuário, com postergação de dados de até 10 minutos após a ocorrência de uma atualização no Braze.

• USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED
• USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED

USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED

Esquema

Nome da coluna	Tipo de dados
APP_GROUP_ID	VARCHAR
APP_ID	VARCHAR
USER_ID	VARCHAR
TIME	NÚMERO
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_LTZ
EXTERNAL_ID	VARCHAR
FIRST_NAME	VARCHAR
LAST_NAME	VARCHAR
EMAIL	VARCHAR
GENDER	VARCHAR
PHONE	VARCHAR
DOB	VARCHAR
HOME_CITY	VARCHAR
COUNTRY	VARCHAR
LANGUAGE	VARCHAR
TIME_ZONE	VARCHAR

USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED

Esquema

Nome da coluna	Tipo de dados
APP_GROUP_ID	VARCHAR
USER_ID	VARCHAR
TIME	NÚMERO
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
APP_ID	VARCHAR
CUSTOM_ATTRIBUTES	OBJETO

Visualizações do perfil do usuário em tempo real - notas de uso

• Fornece atribuições atualizadas do usuário com postergação mínima (~10 minutos).
• Útil para análises em tempo real e cenários em que são necessários dados recentes.
• Considerações sobre a performance:
  • As consultas sobre usuários individuais são mais rápidas (menos de um minuto usando um grande depósito).
  • As consultas sem filtros USER_ID exigem agregação em todos os usuários, o que leva a tempos de execução significativamente mais longos.
  • As consultas em um grande conjunto de dados (como mais de 100 milhões de usuários) podem levar muitos minutos.

Registros históricos de alterações

Essas exibições armazenam registros históricos de alterações de atribuições do usuário, capturando alterações com granularidade de 12 horas.

• USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED
• USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED

USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED

Esquema

Nome da coluna	Tipo de dados
APP_GROUP_ID	VARCHAR
USER_ID	VARCHAR
APP_ID	VARCHAR
TIME	NÚMERO
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
EXTERNAL_ID	VARCHAR
FIRST_NAME	VARCHAR
LAST_NAME	VARCHAR
EMAIL	VARCHAR
GENDER	VARCHAR
PHONE	VARCHAR
DOB	VARCHAR
TIME_ZONE	VARCHAR
HOME_CITY	VARCHAR
COUNTRY	VARCHAR
LANGUAGE	VARCHAR
EFF_DT	TIMESTAMP_NTZ
END_DT	TIMESTAMP_NTZ

USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED

Esquema

Nome da coluna	Tipo de dados
APP_GROUP_ID	VARCHAR
USER_ID	VARCHAR
APP_ID	VARCHAR
TIME	NÚMERO
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
CUSTOM_ATTRIBUTES	VARIÁVEL
EFF_DT	TIMESTAMP_NTZ
END_DT	TIMESTAMP_NTZ

Registros históricos de alterações - notas de uso

• Fornece um registro de alterações históricas nas atribuições do usuário.
• Os dados são capturados a cada 12 horas, o que significa que várias atualizações nessa janela são combinadas em um único registro. As alterações individuais dentro desse período não são mantidas separadamente.
• EFF_DT e END_DT marcam o início e o fim do estado de atribuição de um usuário.

Melhores práticas

Uso recomendado da consulta

Caso de uso	Visualizações recomendadas	Notas
Consultas gerais que não requerem atualizações recentes	USER_DEFAULT_ATTRIBUTES_VIEW_SHARED e USER_CUSTOM_ATTRIBUTES_VIEW_SHARED	Execução rápida, com dados de até 12 horas.
Consultas que exigem as atribuições mais recentes do usuário	USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED e USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED	Fornece atualizações quase em tempo real, mas pode ser mais lento para grandes conjuntos de dados.
Rastreamento histórico de alterações de atribuições	USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED e USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED	Armazena alterações de atribuições com granularidade de 12 horas.

Considerações sobre performance

• As consultas em USER_DEFAULT_ATTRIBUTES_VIEW_SHARED ou USER_CUSTOM_ATTRIBUTES_VIEW_SHARED devem retornar em menos de 10 segundos para grandes conjuntos de dados (~1 bilhão de usuários) em um grande armazém.
• As consultas em USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED ou USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED para um único usuário retornam em menos de um minuto, mas são mal dimensionadas sem a filtragem USER_ID.
• Consultas sobre mais de 100 milhões de usuários em USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED ou USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED podem levar vários minutos devido à agregação por usuário.