Use este artigo para conectar seu workspace Intercom ao Snowflake, configurar o compartilhamento de dados e consultar suas conversas diretamente. O Snowflake Secure Data Sharing elimina a necessidade de criar ou manter pipelines ETL (extract, transform, load) para carregar arquivos exportados no Snowflake, facilitando a análise dos dados do Intercom junto com o restante do seu data warehouse.
Quem pode usar o Snowflake Data Sharing?
O Snowflake Data Sharing é:
Disponível para workspaces com acesso ao recurso.
Configurável por colegas com a permissão Can manage workspace data.
Disponível para contas Snowflake hospedadas na AWS. Contas Snowflake em outras regiões da AWS são suportadas pelo Snowflake Auto-Fulfillment — um recurso que replica automaticamente os dados compartilhados para a região da sua conta.
O que você precisa antes de configurar o Snowflake Data Sharing
Antes de configurar o Snowflake Data Sharing, certifique-se de que você possui:
Uma conta Snowflake.
Seu Data Sharing Account Identifier do Snowflake no formato
<organization>.<account>.Um colega do Intercom com a permissão Can manage workspace data.
Para encontrar seu identificador de conta Snowflake:
Entre na sua conta Snowflake.
Selecione o nome da sua conta no canto inferior esquerdo.
Escolha Account.
Em Account Details, localize Data Sharing Account Identifier.
Copie o identificador e insira-o no Intercom. Deve estar no formato
<organization>.<account>.
Observação: Se sua conta Snowflake estiver hospedada fora da região AWS onde seu workspace Intercom está hospedado, o Snowflake usa automaticamente o Auto-Fulfillment para replicar com segurança os dados compartilhados para a região da sua conta. Nenhuma configuração adicional é necessária.
Como configurar o Snowflake Data Sharing
No Intercom, vá para Settings > Data > Imports & exports > Snowflake data sharing.
Clique em New Snowflake Data Share.
Insira seu Snowflake Data Sharing Account Identifier.
Selecione com que frequência seus dados devem ser atualizados:
Horário
Diário
(Opcional) Ative Export historical data for the last two years para preencher os dados históricos de conversas.
Clique em Create share.
Verifique seu e-mail e clique no link de confirmação para ativar o compartilhamento de dados. Uma vez confirmado, o Intercom provisiona o compartilhamento e seus dados ficam disponíveis no Snowflake após a próxima exportação agendada.
Observação: Nenhum dado é compartilhado até que o e-mail de confirmação seja verificado.
Uma vez confirmado, o Intercom provisiona o compartilhamento de dados. Seus dados ficarão disponíveis no Snowflake após a próxima exportação agendada.
Como acessar seus dados compartilhados no Snowflake
Depois que seu compartilhamento estiver confirmado e ativo, use os comandos SQL a seguir para localizar, importar e consultar seus dados de conversas do Intercom no Snowflake.
1. Localize o listing compartilhado
Execute o SQL a seguir para encontrar o listing do Intercom:
SHOW AVAILABLE LISTINGS IS_SHARED_WITH_ME = TRUE;
SELECT "global_name", "title", "profile", "is_ready_for_import" FROM TABLE(RESULT_SCAN(LAST_QUERY_ID())) WHERE "title" = 'Intercom Conversations Export' AND "profile" LIKE 'PEOSZPH.INTERCOM_DATA_SHARING_%';
Copie o valor retornado na coluna global_name.
2. Solicite o listing e crie o banco de dados
Substitua <global_name> pelo valor do passo anterior.
CALL SYSTEM$REQUEST_LISTING_AND_WAIT('<global_name>');
CREATE DATABASE INTERCOM_CONVERSATIONS FROM LISTING '<global_name>';O procedimento SYSTEM$REQUEST_LISTING_AND_WAIT solicita acesso ao listing e aguarda até que esteja pronto para ser importado.
3. Verifique o banco de dados e consulte suas conversas
DESC DATABASE INTERCOM_CONVERSATIONS;
Cada workspace é exposto por meio de seu próprio schema:
SELECT * FROM INTERCOM_CONVERSATIONS.APP_<numeric_id>.CONVERSATIONS;
Substitua <numeric_id> pelo ID do seu workspace Intercom.
O que esperar após configurar o Snowflake Data Sharing
Após a configuração:
Sua exportação histórica (se selecionada) é processada primeiro.
Conversas novas e atualizadas são compartilhadas automaticamente conforme sua agenda de atualização selecionada.
Exclusões de conversas são automaticamente propagadas para o Snowflake.
Seus dados compartilhados permanecem atualizados sem nenhuma configuração adicional.
Limitações atuais do Snowflake Data Sharing
O Snowflake Data Sharing atualmente tem as seguintes limitações:
O Snowflake Data Sharing atualmente oferece suporte a dados de conversas.
Você pode escolher atualizações horárias ou diárias.
As exportações históricas são limitadas aos dois anos anteriores.
Os dados não são compartilhados até que o administrador confirme o e-mail de verificação.
Alterações para a conta Snowflake de destino exigem a criação de um novo compartilhamento de dados.
Solução de problemas do Snowflake Data Sharing
Não vejo nenhum dado no Snowflake
Os dados ficam disponíveis após a próxima exportação agendada após a confirmação por e-mail. Exportações históricas podem levar mais tempo dependendo da quantidade de dados processados.
Não consigo configurar o Snowflake Data Sharing
Verifique se você tem a permissão Can manage workspace data no Intercom.
Onde posso encontrar meu identificador de conta Snowflake?
No Snowflake, navegue até Account Details e copie o Data Sharing Account Identifier.
Minha conta Snowflake está em outra região AWS
Nada mais é necessário. O Snowflake usa automaticamente o Auto-Fulfillment para replicar os dados compartilhados para a região da sua conta.
Posso usar o Snowflake Data Sharing junto com o Cloud Storage Export?
Sim. O Snowflake Data Sharing e o Cloud Storage Export são configurados independentemente e podem ser usados ao mesmo tempo.